Windows 下用 mc 将 MinIO 桶 img 全量迁移到本机的实操教程
一 环境与端口要点
- 端口分工
- MinIO 的API 端口通常为 9000，用于 S3 兼容接口（mc、SDK、awscli 等均走此端口）。
- MinIO 的Console 端口通常为 9001，仅用于浏览器管理界面，不能用于 S3 请求。
- 若你的实例启用了TLS/HTTPS，API 仍走9000（证书配置正确即可），不要将 Console 端口当作 API 使用。
- mc 连接格式
- 正确：
http://<host>:9000或https://<host>:9000 - 错误：
http://http://...（重复协议）、或把 Console 端口（如9001）配给 mc。
- 正确：
- 常见报错与含义
- “S3 API Request made to Console port”：把 Console 端口当 API 用了，改为9000。
- “Access Denied”：AK/SK 无权限或桶/前缀策略限制，检查凭证与策略。
- “Unable to prepare URL for copying”：源/目标路径写法不规范（见下文路径规范）。
二 准备与连通性验证
安装 mc（Windows）
- 下载mc.exe，这里为了方便按照官网的启动命令，后续你们可以写脚本后台静默启动，这样不会命令行关闭就结束服务。
- 下载mc.exe，这里为了方便按照官网的启动命令，后续你们可以写脚本后台静默启动，这样不会命令行关闭就结束服务。
正确配置别名（指向 API 端口）
- HTTP 示例：
mc alias set minio_data_local http://localhost:9000 minioadmin minioadmin - HTTPS 示例：
mc alias set minio_data_local https://localhost:9000 minioadmin minioadmin - 校验：
mc alias list、mc ls minio_data_local（能列出桶即连通成功）。
- HTTP 示例：
自签名证书或内网 CA 的注意事项
- 若使用自签名/私有 CA，mc 默认会校验证书；可在命令加–insecure跳过验证（仅测试环境），生产建议导入 CA 证书到系统信任库或使用有效证书。
三 将桶 img 全量下载到本机
创建本地目录
- PowerShell：
mkdir -Force D:\environment\minio\backup\img
- PowerShell：
执行下载（源以斜杠结尾表示“前缀/目录”，目标以反斜杠结尾表示“本地目录”）
mc cp --recursive minio_data_local/img/ D:\environment\minio\backup\img\- 常用增强参数（按需组合）：
- 覆盖已存在：
--overwrite - 并发拷贝：
--max-workers 16（根据 CPU/磁盘/网络调整） - 限速下载：
--limit-download 100M
- 覆盖已存在：
校验结果
- 本地：
dir D:\environment\minio\backup\img /s - 远端：
mc ls --recursive minio_data_local/img/ | Measure-Object -Line（统计对象数）
- 本地：
四 常见问题与排错清单
- 端口与协议
- 必须用API 端口 9000（或启用了 TLS 的 9000），不能用 Console 端口 9001作为 mc 的目标地址。
- URL 规范：只能是scheme://host[:port]/，不能写成
http://http://...；不要在地址中带路径段（如/img应放到 mc 命令的路径部分）。
- 路径规范
- 列举/拷贝目录时，源以/结尾（如
minio_data_local/img/），目标以\结尾（如D:\...\img\），可避免“目录/对象”判定歧义。
- 列举/拷贝目录时，源以/结尾（如
- 权限与策略
- “Access Denied”常见于 AK/SK 权限不足或桶/前缀策略限制；检查策略、必要时用具有s3:ListBucket / s3:GetObject权限的凭证测试。
- 证书问题
- 自签名/私有 CA 场景，mc 默认校验证书；测试可用–insecure，生产建议正确部署证书或导入 CA，避免中间人风险。
- 时间与 NTP
- 签名过期/403 偶发时，确保客户端与服务器时间同步（NTP）。
附 最小可用命令清单（可直接复制执行）
- 配置别名（HTTP）
mc alias set minio_data_local http://localhost:9000 minioadmin minioadmin
- 配置别名（HTTPS，测试环境可加 --insecure）
mc alias set minio_data_local https://localhost:9000 minioadmin minioadmin
- 连通性验证
mc ls minio_data_localmc ls minio_data_local/img/
- 全量下载
mc cp --recursive minio_data_local/img/ D:\environment\minio\backup\img\
- 推送到目标服务器共享
robocopy D:\environment\minio\backup\img \\SERVER2\backup\img /MIR /Z /R:3 /W:3 /MT:16 /V /LOG:C:\robocopy_img.log
以上流程覆盖了端口规范、连通性验证、全量下载的关键环节，并总结了常见报错与修复要点，可直接用于生产或测试环境的标准化操作。
