支持迁移对象存储到 OSS

2026-08-16 12:19:51 +08:00
parent 4c1fe7439d
commit d2429618f4
10 changed files with 435 additions and 9 deletions
@@ -49,6 +49,30 @@ id -g yml

 后端容器会使用该 UID/GID 运行。部署脚本由 root 执行时会自动把已有日志修正为该属主；非 root 执行且发现旧的 root 日志时，会给出需要执行的 `chown` 命令后停止。

+### 迁移对象存储到阿里云 OSS
+
+创建私有 Bucket 后，先保持 `STORAGE_*` 指向当前 MinIO，在 `backend/.env` 配置 OSS 镜像端：
+
+```text
+STORAGE_MIRROR_ENDPOINT=https://oss-cn-hangzhou-internal.aliyuncs.com
+STORAGE_MIRROR_BUCKET=hfb-sys-assets
+STORAGE_MIRROR_ACCESS_KEY_ID=change-oss-access-key-id
+STORAGE_MIRROR_SECRET_ACCESS_KEY=change-oss-access-key-secret
+STORAGE_MIRROR_REGION=cn-hangzhou
+STORAGE_MIRROR_BUCKET_LOOKUP=dns
+```
+
+RAM 凭证只授予该 Bucket 的列举、读取、写入对象权限，不要使用阿里云主账号 AccessKey。镜像端启用后，新上传文件会同步写入 MinIO 和 OSS；任一镜像写入失败时上传会失败，避免数据库引用未同步文件。
+
+部署支持镜像配置的镜像后，执行以下命令同步历史对象；命令可重复执行，不会删除 MinIO 数据：
+
+```bash
+./scripts/migrate-minio-to-oss.sh
+./scripts/migrate-minio-to-oss.sh --verify
+```
+
+校验通过后，将 `STORAGE_*` 改为同一组 OSS 配置，再清空所有 `STORAGE_MIRROR_*` 配置并重新部署。杭州 ECS 必须使用 `oss-cn-hangzhou-internal.aliyuncs.com`，避免跨公网访问。MinIO 保留至少 30 天后再考虑下线。
+
 ### 同机部署选号网（hfb_show，可选）

 在 `backend/.env` 增加（域名不要带 `https://`）：