This commit is contained in:
2026-09-17 10:57:21 +08:00
parent e2e1a98348
commit e7ed791a48
4 changed files with 483 additions and 4 deletions
@@ -254,6 +254,8 @@ ALB 会持续健康检查并自动屏蔽异常后端,具体配置见阿里云
## 8. OSS 怎么开、怎么接
本节说明云资源开通和通用上线要求。File Service 的已冻结接入方式、代码边界、失败处理、双区域文件链路和评审结论以《[阿里云 OSS 文件中心接入设计与评审](阿里云OSS文件中心接入设计与评审.md)》为准。
### 8.1 必须创建两个 Bucket
建议命名,实际名称需增加公司/账号随机后缀以满足全局唯一:
@@ -285,11 +287,11 @@ OSS 官方控制台步骤见《[OSS 控制台快速入门](https://help.aliyun.c
### 8.3 访问方式
- 浏览器/PDA 不持有 OSS 长期 AccessKey;
- 上传可以由 File 服务中转,或由 File 服务签发短时上传凭证/预签名 URL;
- 下载由业务服务先校验账号、客户、文件用途和权限,再返回短时预签名 URL;
- 第一阶段上传和下载统一由 File 服务中转,保留现有 Admin、Client、PDA 接口和业务权限校验;
- 短时上传凭证和预签名下载 URL 属于第二阶段优化,只有真实上传耗时、失败率或带宽指标证明需要时才启用;
- URL 有效期尽量短,日志不得记录完整签名 URL;
- Bucket 不设公共读,不能把“知道 URL”当作权限控制;
- CORS 只允许正式 Admin/Client 域名和必要方法/Header,不使用任意来源 `*`;PDA 原生上传不依赖浏览器 CORS。
- 第一阶段不需要 OSS CORS;启用 Web 直传时只允许正式 Admin/Client 域名和必要方法/Header,不使用任意来源 `*`;PDA 原生上传不依赖浏览器 CORS。
### 8.4 生命周期建议
@@ -323,7 +325,7 @@ logs/ OSS 访问日志
- RAM 角色/临时凭证接入;
- 上传内容类型、大小、用途和客户范围校验;
- 文件元数据仍落 File 数据库,业务表只保存稳定 `fileId`;
- 预签名上传/下载 URL;
- 第一阶段服务端流式上传/下载;第二阶段按监控结果决定是否增加预签名上传/下载 URL;
- 上传失败、重复提交、超时、断点续传和孤儿对象清理;
- 国内/海外 Bucket 路由;
- 迁移或测试文件的校验方案。