存储服务商配置指南

本文档详细介绍 Micro-FileOS 支持的存储服务商配置方式，包括阿里云 OSS、AWS S3 和 S3 兼容存储（MinIO）。

1. 支持的存储服务商清单

服务商	类型	协议	底层实现	适用场景	推荐指数
阿里云 OSS	云服务	OSS	`AliOssServiceImpl`	生产环境、高可用场景	★★★★★
AWS S3	云服务	S3	`S3ServiceImpl`	国际化业务、AWS 生态	★★★★☆
S3 兼容存储（MinIO）	自建服务	S3	`S3ServiceImpl`	私有化部署、成本敏感	★★★☆☆

1.1 OSS 服务商枚举

枚举值	说明
`ALI_OSS`	阿里云 OSS，使用 `aliyun-sdk-oss` SDK
`AWS_S3`	AWS S3，使用 AWS SDK `software.amazon.awssdk:s3`
`S3_COMPATIBLE`	S3 兼容存储（如 MinIO），同样使用 AWS S3 SDK

1.2 Bucket 配置存储

Bucket 配置存储在 mdm_fileos_bucket 数据库表中，通过 REST API 管理，支持多 Bucket、多 OSS 服务商。

字段	类型	必填	说明
`bucket_name`	varchar(127)	是	Bucket 名称，需与 OSS 服务商侧的 Bucket 名称一致
`oss_sp`	varchar(31)	是	OSS 服务商枚举值
`endpoint_inner`	varchar(255)	否	内网 Endpoint，服务端访问 OSS 时优先使用，减少公网流量
`endpoint_outer`	varchar(255)	否	外网 Endpoint，生成预签名 URL 时使用，客户端直传场景必须配置
`region`	varchar(63)	否	区域标识，如 `cn-hangzhou`、`us-east-1`
`access_key`	varchar(255)	是	OSS 访问 Access Key
`secret_key`	varchar(255)	是	OSS 访问 Secret Key
`default_flag`	int	否	默认标识，`1` 表示默认 Bucket，上传时未指定 Bucket 将使用默认 Bucket

2. 阿里云 OSS 配置

2.1 服务简介

阿里云对象存储 OSS（Object Storage Service）是阿里云提供的海量、安全、低成本、高可靠的云存储服务。数据设计持久性不低于 99.9999999999%（12 个 9），服务设计可用性不低于 99.995%。

2.2 通过 API 创建

bash

curl -X POST http://localhost:8080/micro-fileos/bucket/create \
  -H 'Content-Type: application/json' \
  -d '{
    "bucketName": "my-ali-bucket",
    "ossSp": "ALI_OSS",
    "endpointInner": "https://oss-cn-hangzhou-internal.aliyuncs.com",
    "endpointOuter": "https://oss-cn-hangzhou.aliyuncs.com",
    "region": "cn-hangzhou",
    "accessKey": "your-access-key",
    "secretKey": "your-secret-key",
    "defaultFlag": 1
  }'

2.3 各区域 Endpoint 参考

区域	内网 Endpoint	外网 Endpoint
华东1（杭州）	`https://oss-cn-hangzhou-internal.aliyuncs.com`	`https://oss-cn-hangzhou.aliyuncs.com`
华东2（上海）	`https://oss-cn-shanghai-internal.aliyuncs.com`	`https://oss-cn-shanghai.aliyuncs.com`
华北1（青岛）	`https://oss-cn-qingdao-internal.aliyuncs.com`	`https://oss-cn-qingdao.aliyuncs.com`
华北2（北京）	`https://oss-cn-beijing-internal.aliyuncs.com`	`https://oss-cn-beijing.aliyuncs.com`
华南1（深圳）	`https://oss-cn-shenzhen-internal.aliyuncs.com`	`https://oss-cn-shenzhen.aliyuncs.com`

2.4 注意事项

阿里云 OSS 使用 V4 签名，需确保 SDK 版本兼容
内网 Endpoint 仅在阿里云 ECS 同区域时可用，否则请使用外网 Endpoint
预签名上传场景必须配置 endpointOuter，否则客户端无法访问

2.5 申请方式

1. 注册阿里云账号

访问阿里云官网
点击"免费注册"，完成账号注册
完成实名认证（个人或企业）

2. 开通 OSS 服务

登录阿里云控制台
搜索"对象存储 OSS"，进入产品页面
点击"立即开通"
选择计费方式（按量付费或资源包）

3. 创建 AccessKey

进入 AccessKey 管理页面
建议使用 RAM 子用户 AccessKey（更安全）
创建 RAM 用户并授予 AliyunOSSFullAccess 权限
生成 AccessKey ID 和 AccessKey Secret

4. 创建 Bucket

进入 OSS 控制台
点击"创建 Bucket"
配置 Bucket 参数：
- Bucket 名称：全局唯一
- 区域：根据业务选择（建议与应用服务器同区域）
- 存储类型：标准存储（默认）
- 读写权限：私有（推荐）

3. AWS S3 配置

3.1 服务简介

Amazon Simple Storage Service（Amazon S3）是 AWS 提供的对象存储服务，具有高扩展性、数据可用性、安全性和性能。

3.2 通过 API 创建

bash

curl -X POST http://localhost:8080/micro-fileos/bucket/create \
  -H 'Content-Type: application/json' \
  -d '{
    "bucketName": "my-aws-bucket",
    "ossSp": "AWS_S3",
    "endpointInner": null,
    "endpointOuter": "https://s3.us-east-1.amazonaws.com",
    "region": "us-east-1",
    "accessKey": "your-access-key",
    "secretKey": "your-secret-key",
    "defaultFlag": 1
  }'

3.3 各区域 Endpoint 参考

区域	Endpoint
美国东部（弗吉尼亚北部）	`https://s3.us-east-1.amazonaws.com`
美国西部（俄勒冈）	`https://s3.us-west-2.amazonaws.com`
欧洲（爱尔兰）	`https://s3.eu-west-1.amazonaws.com`
亚太（东京）	`https://s3.ap-northeast-1.amazonaws.com`
亚太（新加坡）	`https://s3.ap-southeast-1.amazonaws.com`

3.4 注意事项

AWS S3 无内网/外网区分，endpointInner 可不配置
region 必须与 Bucket 所在区域一致
IAM 策略需授予 s3:PutObject、s3:GetObject、s3:DeleteObject 等必要权限

3.5 申请方式

1. 注册 AWS 账号

访问 AWS 官网
点击"创建 AWS 账号"
完成账号注册和付款方式绑定

2. 创建 IAM 用户

进入 IAM 控制台
创建新用户，选择"编程访问"
授予 AmazonS3FullAccess 权限
获取 Access Key ID 和 Secret Access Key

3. 创建 S3 Bucket

进入 S3 控制台
点击"创建存储桶"
配置 Bucket 参数：
- Bucket 名称：全局唯一
- 区域：根据业务选择
- 公共访问设置：建议阻止公共访问

4. MinIO 配置

4.1 服务简介

MinIO 是高性能的分布式对象存储服务，兼容 Amazon S3 API，适合私有化部署场景。

4.2 通过 API 创建

bash

curl -X POST http://localhost:8080/micro-fileos/bucket/create \
  -H 'Content-Type: application/json' \
  -d '{
    "bucketName": "my-minio-bucket",
    "ossSp": "S3_COMPATIBLE",
    "endpointInner": "http://minio:9000",
    "endpointOuter": "http://192.168.1.100:9000",
    "region": "us-east-1",
    "accessKey": "your-access-key",
    "secretKey": "your-secret-key",
    "defaultFlag": 1,
    "system": "dev"
  }'

4.3 Docker 部署参考

yaml

# docker-compose.yml
version: '3.8'
services:
  minio:
    image: minio/minio:latest
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      MINIO_ROOT_USER: minioadmin
      MINIO_ROOT_PASSWORD: minioadmin
    command: server /data --console-address ":9001"
    volumes:
      - minio-data:/data

volumes:
  minio-data:

4.4 访问控制台

API 地址：http://localhost:9000
控制台地址：http://localhost:9001
默认账号：minioadmin / minioadmin

4.5 注意事项

ossSp 必须设为 S3_COMPATIBLE，底层使用 AWS S3 SDK 的自定义 Endpoint 模式
MinIO 默认 region 为 us-east-1，除非自定义配置
开发环境可使用 HTTP，生产环境建议配置 HTTPS
endpointInner 适用于 Docker 内网或 K8s 集群内部访问

5. 多 Bucket 配置示例

系统支持配置多个 Bucket，分别对接不同的 OSS 服务商或用途。

5.1 场景：按业务分类使用不同 Bucket

bash

# 默认 Bucket — 阿里云 OSS（通用文件）
curl -X POST http://localhost:8080/micro-fileos/bucket/create \
  -H 'Content-Type: application/json' \
  -d '{
    "bucketName": "app-general",
    "ossSp": "ALI_OSS",
    "endpointInner": "https://oss-cn-hangzhou-internal.aliyuncs.com",
    "endpointOuter": "https://oss-cn-hangzhou.aliyuncs.com",
    "region": "cn-hangzhou",
    "accessKey": "your-access-key",
    "secretKey": "your-secret-key",
    "defaultFlag": 1
  }'

# 视频 Bucket — AWS S3（大文件存储）
curl -X POST http://localhost:8080/micro-fileos/bucket/create \
  -H 'Content-Type: application/json' \
  -d '{
    "bucketName": "app-video",
    "ossSp": "AWS_S3",
    "endpointOuter": "https://s3.us-east-1.amazonaws.com",
    "region": "us-east-1",
    "accessKey": "your-access-key",
    "secretKey": "your-secret-key",
    "defaultFlag": 0
  }'

# 开发 Bucket — MinIO（本地开发测试）
curl -X POST http://localhost:8080/micro-fileos/bucket/create \
  -H 'Content-Type: application/json' \
  -d '{
    "bucketName": "app-dev",
    "ossSp": "S3_COMPATIBLE",
    "endpointInner": "http://minio:9000",
    "endpointOuter": "http://localhost:9000",
    "region": "us-east-1",
    "accessKey": "your-access-key",
    "secretKey": "your-secret-key",
    "defaultFlag": 0,
    "system": "dev"
  }'

5.2 上传时指定 Bucket

java

// 使用默认 Bucket（defaultFlag=1）
fileosUploadApi.upload(file, "avatar");

// 指定 Bucket
fileosUploadApi.upload(file, "avatar", "app-video");

6. 存储服务商对比

6.1 功能对比

功能	阿里云 OSS	AWS S3	MinIO
存储容量	无限	无限	取决于硬件
数据持久性	99.9999999999%	99.999999999%	取决于部署
服务可用性	99.995%	99.99%	取决于部署
图片处理	支持	支持	需额外配置
视频处理	支持	支持	需额外配置
CDN 加速	支持	支持	需额外配置
跨区域复制	支持	支持	支持

6.2 成本对比（月费用估算）

假设场景：存储 100GB，月流量 200GB

服务商	存储费用	流量费用	合计
阿里云 OSS	12 元	100 元	112 元
AWS S3	15 元	120 元	135 元
MinIO	服务器成本	带宽成本	视情况

6.3 选型建议

场景	推荐服务商	理由
国内生产环境	阿里云 OSS	稳定性高、生态完善、文档丰富
国际化业务	AWS S3	全球节点、AWS 生态
私有化部署	MinIO	开源免费、数据自主可控
成本敏感	MinIO	无云服务费用

7. 最佳实践建议

7.1 安全建议

使用私有读写：默认使用私有访问，通过签名 URL 授权
最小权限原则：RAM/IAM 用户只授予必要的权限
定期轮换密钥：定期更换 AccessKey
开启日志审计：记录所有访问操作
启用版本控制：防止误删除
跨域配置：如果需要前端直传，需配置 CORS 规则

7.2 性能优化

使用内网 Endpoint：服务端上传免流量费且速度快
开启 CDN 加速：提升用户访问速度
合理设置签名过期时间：避免频繁签名
使用并发上传：大文件分片并发上传
就近选择区域：Bucket 区域应接近用户群体

7.3 成本控制

生命周期规则：自动清理过期文件
存储分级：低频文件转低频存储
购买资源包：大流量场景购买流量包
监控告警：设置费用告警阈值
使用内网 Endpoint：服务端上传免流量费

存储服务商配置指南 ​

1. 支持的存储服务商清单 ​

1.1 OSS 服务商枚举 ​

1.2 Bucket 配置存储 ​

2. 阿里云 OSS 配置 ​

2.1 服务简介 ​

2.2 通过 API 创建 ​

2.3 各区域 Endpoint 参考 ​

2.4 注意事项 ​

2.5 申请方式 ​

1. 注册阿里云账号 ​

2. 开通 OSS 服务 ​

3. 创建 AccessKey ​

4. 创建 Bucket ​

3. AWS S3 配置 ​

3.1 服务简介 ​

3.2 通过 API 创建 ​

3.3 各区域 Endpoint 参考 ​

3.4 注意事项 ​

3.5 申请方式 ​

1. 注册 AWS 账号 ​

2. 创建 IAM 用户 ​

3. 创建 S3 Bucket ​

4. MinIO 配置 ​

4.1 服务简介 ​

4.2 通过 API 创建 ​

4.3 Docker 部署参考 ​

4.4 访问控制台 ​

4.5 注意事项 ​

5. 多 Bucket 配置示例 ​

5.1 场景：按业务分类使用不同 Bucket ​

5.2 上传时指定 Bucket ​

6. 存储服务商对比 ​

6.1 功能对比 ​

6.2 成本对比（月费用估算） ​

6.3 选型建议 ​

7. 最佳实践建议 ​

7.1 安全建议 ​

7.2 性能优化 ​

7.3 成本控制 ​

存储服务商配置指南

1. 支持的存储服务商清单

1.1 OSS 服务商枚举

1.2 Bucket 配置存储

2. 阿里云 OSS 配置

2.1 服务简介

2.2 通过 API 创建

2.3 各区域 Endpoint 参考

2.4 注意事项

2.5 申请方式

1. 注册阿里云账号

2. 开通 OSS 服务

3. 创建 AccessKey

4. 创建 Bucket

3. AWS S3 配置

3.1 服务简介

3.2 通过 API 创建

3.3 各区域 Endpoint 参考

3.4 注意事项

3.5 申请方式

1. 注册 AWS 账号

2. 创建 IAM 用户

3. 创建 S3 Bucket

4. MinIO 配置

4.1 服务简介

4.2 通过 API 创建

4.3 Docker 部署参考

4.4 访问控制台

4.5 注意事项

5. 多 Bucket 配置示例

5.1 场景：按业务分类使用不同 Bucket

5.2 上传时指定 Bucket

6. 存储服务商对比

6.1 功能对比

6.2 成本对比（月费用估算）

6.3 选型建议

7. 最佳实践建议

7.1 安全建议

7.2 性能优化

7.3 成本控制