# 对象存储配置

本文档为《基础配置管理》下的独立配置页面设计，用于描述该配置项目的配置清单、界面设计、业务规则和验收关注点。

上级文档：[基础配置管理](../08-基础配置管理.md)

## 配置清单

对象存储配置用于维护基础平台文件上传、导出文件、图片资源、附件等通用文件存储服务。

推荐配置：

| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
| --- | --- | --- | --- |
| 对象存储启用开关 | 是否启用对象存储能力 | 平台级 | 必须 |
| 存储服务商 | 当前使用的对象存储服务商 | 平台级 | 必须 |
| 访问地址 | 对象存储 Endpoint 或服务地址 | 平台级 | 必须 |
| 存储桶名称 | 文件存储使用的 Bucket | 平台级 | 必须 |
| 访问凭证 | AccessKey、SecretKey 等连接凭证 | 平台级 | 必须 |
| 默认访问域名 | 文件访问使用的默认域名 | 平台级 | 建议 |
| 文件路径前缀 | 基础平台文件存储路径前缀 | 平台级 | 建议 |
| 公有读开关 | 是否允许文件公开访问 | 平台级 | 建议 |
| 配置连通性测试 | 保存前或保存后测试对象存储是否可用 | 平台级 | 必须 |

支持的对象存储服务商：

| 服务商 | 说明 |
| --- | --- |
| 阿里云 OSS | 阿里云对象存储 |
| 腾讯云 COS | 腾讯云对象存储 |
| 华为云 COS/OBS | 华为云对象存储，实际产品命名以云厂商接口为准 |
| MinIO | 私有化对象存储 |
| RustFS | 私有化对象存储 |

## 界面设计

对象存储配置页用于维护基础平台通用文件存储服务参数。

展示方式：

- 采用分组表单展示。
- 分组包括：服务商配置、连接参数、访问控制、连通性测试。
- 页面底部固定操作按钮：取消、保存、测试连接。

表单字段：

| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
| --- | --- | --- | --- |
| 对象存储启用开关 | Switch | 人工选择 | 控制对象存储能力是否启用 |
| 存储服务商 | 下拉框 | 阿里云 OSS、腾讯云 COS、华为云 COS/OBS、MinIO、RustFS | 必填 |
| Endpoint / 服务地址 | 文本输入框 | 人工录入 | 必填 |
| Region | 文本输入框 / 下拉框 | 服务商区域或人工录入 | 公有云建议填写 |
| Bucket | 文本输入框 | 人工录入 | 必填 |
| AccessKey | 文本输入框 | 人工录入 | 必填，敏感字段 |
| SecretKey | 密码输入框 | 人工录入 | 必填，敏感字段 |
| 默认访问域名 | 文本输入框 | 人工录入 | 选填 |
| 文件路径前缀 | 文本输入框 | 人工录入 | 选填 |
| 公有读开关 | Switch | 人工选择 | 控制上传文件是否允许公开访问 |
| HTTPS 访问开关 | Switch | 人工选择 | 控制文件访问地址是否默认使用 HTTPS |
| 备注 | 多行文本框 | 人工录入 | 选填 |

页面规则：

- 存储服务商、Endpoint / 服务地址、Bucket、AccessKey、SecretKey 为必填。
- SecretKey 保存后不在页面明文回显，仅展示脱敏结果。
- 切换存储服务商时，需要提示不同服务商参数可能不兼容。
- 保存前建议先执行测试连接；测试失败时允许保存草稿但不允许启用。
- 启用对象存储配置前，必须通过连接测试。
- 停用对象存储配置时，需要提示文件上传、导出文件、图片资源等能力可能不可用。