对象存储
对象存储用于配置租户文件上传和访问方式，影响素材、知识库文件、AI 生成结果、图片视频资源等文件能否正常保存和展示。
对象存储用于配置租户文件上传和访问方式，影响素材、知识库文件、AI 生成结果、图片视频资源等文件能否正常保存和展示。
你可以在这里做什么
| 目标 | 操作入口 | 影响范围 |
|---|---|---|
| 使用平台存储 | 平台默认存储 | 文件由平台统一存储并按租户隔离 |
| 使用独立 OSS | 阿里云 OSS | 文件进入租户自己的 Bucket |
| 配置访问域名 | 自定义域名 | 文件外链展示和 CDN 加速 |
| 设置公开访问 | 公共读 | 控制上传文件是否使用公开链接 |
| 验证配置 | 连接测试 | 检查 Bucket 和密钥是否可用 |
一、选择存储方式
| 存储方式 | 适合场景 | 特点 |
|---|---|---|
| 平台默认存储 | 快速上线、无需自建云资源 | 由平台统一维护，租户按目录隔离 |
| 阿里云 OSS | 企业要求数据独立存储或自有 CDN | 数据进入企业自己的 Bucket，配置成本更高 |
如果企业没有明确的数据隔离或合规要求，平台默认存储更适合快速上线。
二、配置平台默认存储
- 进入「对象存储」。
- 选择「平台默认存储」。
- 点击连接测试。
- 测试成功后保存配置。
平台默认存储不需要填写 Bucket、AccessKey 或域名。
三、配置阿里云 OSS
- 在阿里云创建或确认已有 Bucket。
- 准备 Bucket 对应的 Endpoint、Bucket 名称、AccessKey ID 和 AccessKey Secret。
- 进入「对象存储」，选择「阿里云 OSS」。
- 填写 Endpoint，例如
oss-cn-hangzhou.aliyuncs.com。 - 填写 Bucket Name。
- 填写 AccessKey ID 和 AccessKey Secret。
- 如需使用 CDN 或自定义访问域名，填写自定义域名。
- 根据 Bucket 权限决定是否开启公共读。
- 点击连接测试。
- 测试成功后保存配置。
保存后系统会清理当前租户的 OSS 缓存，新上传文件会按新配置处理。
详细教程文档：
四、关键字段说明
| 字段 | 说明 | 注意事项 |
|---|---|---|
| Endpoint | OSS 地域节点 | 要与 Bucket 所在地域一致 |
| Bucket Name | 存储桶名称 | 必须真实存在并允许当前密钥访问 |
| AccessKey ID | 云账号访问密钥 ID | 建议使用最小权限子账号 |
| AccessKey Secret | 云账号访问密钥 Secret | 页面会脱敏展示，修改时需重新填写 |
| 自定义域名 | 文件访问域名 | 需在 OSS 或 CDN 中完成绑定 |
| 公共读 | 文件是否公开访问 | Bucket 权限必须与开关一致 |
五、公共读怎么判断
开启公共读后，系统会倾向于使用不带签名的公开链接访问文件。适合公开素材、公开图片、公开视频等场景。
不建议公开读的内容包括：
- 用户上传的私密资料。
- 企业内部知识库文档。
- 未发布的营销素材。
- 包含个人信息或合同信息的文件。
如果 Bucket 本身没有设置公共读，但后台开启了公共读，文件可能上传成功但无法访问。
六、注意事项
- 修改 OSS 配置会影响后续上传文件，不一定自动迁移历史文件。
- 使用独立 OSS 前，先确认 Bucket 跨域、权限和自定义域名配置。
- AccessKey 建议只授予目标 Bucket 的必要读写权限。
- 连接测试成功只说明当前密钥和 Bucket 可访问，仍需在用户端验证文件展示。
- 切换存储方式前，应评估历史文件访问路径是否受影响。
七、常见问题
连接测试失败怎么办？
检查 Endpoint、Bucket 名称、AccessKey 是否匹配，确认密钥有目标 Bucket 的读写权限。
上传成功但图片不显示怎么办？
检查公共读设置、自定义域名绑定、Bucket 防盗链和 CDN 配置。
为什么 Secret 显示为星号？
系统会脱敏展示敏感字段。未修改时保存会保留原密钥；如需更换密钥，需要重新输入。
立即构建您的专属 AI 智能体与自动化矩阵
井云 Studio 为您提供多租户底座、工作流编排、资产分发与计费闭环，助您快速上线高质量 AI SaaS 产品。
