Skip to content

OSS文件存储

为了提升与云存储厂商的兼容性,sz-admin 采用了 AWS S3 协议作为统一的接口标准,使得所有遵循 S3 协议的云存储服务提供商都能够轻松集成。

配置指南

以下是如何在配置文件中设置 OSS 存储的详细步骤:

yaml
oss:
  # 云存储服务提供商,支持 S3 协议的厂商(如 ALIYUN, QINIU, TENCENT, MINIO 等)
  provider: MINIO
  # 服务访问地址,包括端口号或域名
  endpoint: 192.168.56.101:9000
  # 访问密钥
  accessKey: a4jtJvgEmk4ead5dzac6
  # 密钥
  secretKey: UW6kxTGRetIAahV759rFkgoQ8ilXLRUMW0ULdIoo
  # 存储桶名称
  bucketName: test
  # 自定义访问域名
  domain: http://192.168.56.101:9000
  # 是否启用 HTTPS。如果 endpoint 没有指定 http 或 https 前缀,则自动添加
  is-https: false
  # 文件命名策略:UUID 或 ORIGINAL(保留原文件名,冲突时添加时间戳)
  naming: original

使用场景

文件上传操作非常简便:

java
// MultipartFile file 文件, String dirTag 上传目录tag
ossClient.upload(file, dirTag)

文件上传成功后的返回结果示例:

json
{
    "code": "0000",
    "message": "SUCCESS",
    "data": {
        "url": "https://your_domain.com//user/20241126/logo (151006.576).jpg",
        "filename": "logo (151006.576).jpg",
        "objectName": "user/20241126/logo (151006.576).jpg",
        "dirTag": "user",
        "contextType": "image/jpeg",
        "size": 20207,
        "etag": "23825BD07858662908BD1C3B6504B9FF"
    },
    "param": {}
}