平台功能（自研）可视化配置
存储配置
存储配置维护平台的文件存储服务，数据保存在 sys_oss_config。上传头像、应用截图、应用安装包、插件前端产物都依赖它。
全新部署默认没有启用任何存储。不配置也能登录后台，但上传会失败。这是刻意设计，避免把演示环境的密钥带进交付物。
配置项
| 字段 | 说明 |
|---|---|
| 配置 key | 服务商标识，如 minio、aliyun、qcloud、qiniu |
| 访问站点 | 服务端点，例如 oss-cn-hangzhou.aliyuncs.com |
| 自定义域名 | 对外访问域名，可与访问站点不同 |
| accessKey | 访问密钥 ID |
| secretKey | 访问密钥 Secret，加密存储 |
| 桶名称 | Bucket |
| 前缀 | 对象键前缀，用于隔离环境或租户 |
| 是否 HTTPS | 生成 URL 时使用 https:// 或 http:// |
| 桶权限类型 | private / public / custom |
| 区域 | 服务商 Region |
| 备注 | 运维备注 |
启用流程
- 在云厂商或 MinIO 创建 Bucket；
- 创建最小权限的 AccessKey（只允许该 Bucket 的读写）；
- 在「存储配置」新增一条配置，填写端点、密钥、桶名；
- 在列表中启用该配置（同一时间只有一个启用项）；
- 到「文件管理」上传一个测试文件，确认可访问。
常见服务商
| 服务商 | 配置 key | 端点示例 | Region |
|---|---|---|---|
| MinIO | minio | minio.example.com | us-east-1 |
| 阿里云 OSS | aliyun | oss-cn-hangzhou.aliyuncs.com | oss-cn-hangzhou |
| 腾讯云 COS | qcloud | cos.ap-guangzhou.myqcloud.com | ap-guangzhou |
| 七牛云 | qiniu | s3-cn-east-1.qiniucs.com | cn-east-1 |
具体驱动以 wujies-common-oss 中已注册的实现为准；不在列表中的服务商需要自行扩展。
私有桶与预览
private：对象默认不可匿名访问，后端生成带签名的临时 URL。public：对象可直接通过 URL 访问，适合头像、商品图等公开资源。custom：由自定义域名 / CDN 控制访问策略。
安全配置中的「OSS 预览列表资源」只控制文件管理页是否展示预览，不改变桶的访问权限。
多租户
sys_oss_config 带租户维度。不同租户可以使用不同的桶或前缀；上传时按当前租户选择启用配置。
应用包与前端产物
应用市场部署时会把安装包与前端目录落到宿主本地磁盘（plugin-dir / frontend-dir），不经过 OSS。OSS 只负责上架时的安装包存储与页面图片。
安全
secretKey加密存储，列表不返回明文；查看明文需要system:ossConfig:secretQuery。- 使用最小权限密钥，不要用主账号 AccessKey。
- 私有桶不要为了方便改成公开；需要公开的资源单独放公共桶或 CDN。
- 定期轮换密钥，轮换后同步更新配置并重新上传验证。
排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 上传报「未配置存储」 | 没有启用的配置 | 在列表中启用一条 |
AccessDenied | 密钥权限不足 / 桶策略拒绝 | 检查 RAM 策略与桶 ACL |
| 上传成功但图片 404 | 自定义域名未解析 / 桶私有 | 检查域名与访问策略 |
The specified bucket does not exist | 桶名或 Region 错误 | 核对服务商控制台 |
| HTTPS 证书错误 | 自定义域名未配证书 | 使用服务商域名或补证书 |