![cover.png](https://developer.qcloudimg.com/http-save/yehe-12550791/cfc2af616724d7625d51e63219b38741.png)

这套 MinIO，在生产上跑了快三年。四个节点，十二块盘，上面存着 CI 产物、备份包和一堆训练数据集，加起来大概 2.3 TB。去年年初 MinIO 社区版归档的消息出来的时候，我还没当回事——能跑就行呗。直到上个月做安全审计，审计方指着那台还在跑 `RELEASE.2024-01` 的节点问："这个版本最后一次安全更新是什么时候？" 我查了一下，答不上来。

那时候才认真开始看迁移方案。

## 两种迁移路径

本文命令基于 RustFS `1.0.0-beta.12`（当前最新 `1.0.0-rc.1`，两条命令通用）。RustFS 在 S3 API 层面支持两种迁移方式，核心都是"两台 S3 兼容存储之间搬对象"：

**路径一：mc mirror（MinIO 官方客户端）**

`mc` 是 MinIO 自己的客户端，但 RustFS 完整兼容 S3，所以 `mc` 能直接当搬运工。优势是会自动保留对象标签（Tags）、Content-Type、自定义元数据和校验和。

**路径二：rclone sync**

`rclone` 是更通用的 S3 同步工具，跨云、跨厂商场景都熟，社区里用得多。优势是并发参数调起来更顺手，断点续传稳。

两条路最终结果一样，选哪个看你手上顺手哪个。我这次用的是 `mc mirror`。
![minio-rustfs-migration-paths.png](https://developer.qcloudimg.com/http-save/yehe-12550791/c34370798084c4f7a9b513f7d484cebe.png)

## 第一步：把目标集群跑起来

先用官方当前推荐的 docker-compose 起一套 RustFS（节选自 RustFS 仓库根目录的 `docker-compose-simple.yml`）：

```yaml
services:
  rustfs:
    image: rustfs/rustfs:beta.12
    container_name: rustfs-server
    ports:
      - "9000:9000"  # S3 API
      - "9001:9001"  # Console
    environment:
      - RUSTFS_VOLUMES=/data/rustfs{0...3}
      - RUSTFS_ADDRESS=0.0.0.0:9000
      - RUSTFS_CONSOLE_ADDRESS=0.0.0.0:9001
      - RUSTFS_CONSOLE_ENABLE=true
      - RUSTFS_ACCESS_KEY=rustfsadmin      # 生产请改掉
      - RUSTFS_SECRET_KEY=rustfsadmin      # 生产请改掉
    volumes:
      - rustfs_data_0:/data/rustfs0
      - rustfs_data_1:/data/rustfs1
      - rustfs_data_2:/data/rustfs2
      - rustfs_data_3:/data/rustfs3
    restart: unless-stopped

volumes:
  rustfs_data_0:
  rustfs_data_1:
  rustfs_data_2:
  rustfs_data_3:
```

起来之后先验证一遍，确认 API 和控制台都活着：

```bash
# S3 API 健康检查
curl -fsS http://localhost:9000/health

# 装好 mc 并配置两端别名
mc alias set minio-old http://minio-old:9000 OLD_ACCESS_KEY OLD_SECRET_KEY
mc alias set rustfs-new http://localhost:9000 rustfsadmin rustfsadmin

# 确认能连上目标端
mc ls rustfs-new
```

## 第二步：预演，别一上来就搬

正式跑之前先用 `--dry-run` 探一遍，确认权限和路径解析没问题，不至于搬一半报错中断：

```bash
mc mirror --dry-run minio-old/ rustfs-new/
```

这一步不会真的动数据，只列出将要执行的操作。我第一次跑就发现有个桶名带大写字母，源端没问题但目标端 policy 配不上去——提前改了，省得半夜爬起来救火。

## 第三步：全量同步

确认无误后开始正式全量复制：

```bash
# 基础全量（支持断点续传）
mc mirror minio-old/ rustfs-new/

# 生产环境推荐加 --watch 做准实时增量
mc mirror --watch --overwrite minio-old/ rustfs-new/
```

`--watch` 会先跑完存量，然后持续监听源端新增对象做增量复制。我们 2.3 TB 的数据，内网 10 Gbps，全量跑了快 6 小时——瓶颈不在带宽，在小文件元数据处理（平均 200 KB 一个的 CI 产物，逐个做 HEAD 校验 overhead 不小）。

> 再跑一次我会先 `--dry-run` 统计对象数和总大小，然后按桶分批并行 `mc mirror`，比单次全量快不少。

## 第四步：增量追平 + 停写切换

全量跑完，源端肯定又写进新数据了。反复跑增量直到秒级：

```bash
mc mirror --overwrite minio-old/ rustfs-new/
# 输出：... 3425 objects transferred, 12m32s

mc mirror --overwrite minio-old/ rustfs-new/
# 输出：... 89 objects transferred, 1m08s

mc mirror --overwrite minio-old/ rustfs-new/
# 输出：... 3 objects transferred, 8s
```

连续两次增量都在秒级，说明基本追平。接下来是停写窗口（我们大概 5 分钟）：

```bash
# 1. 把 MinIO 设为只读，防止新写入
mc admin policy set minio-old read-only

# 2. 最后一次增量（应该秒级完成）
mc mirror --overwrite minio-old/ rustfs-new/

# 3. 校验两边一致
mc diff minio-old/ rustfs-new/
# 无输出 = 完全一致

# 4. 改 Nginx upstream 或 DNS CNAME 指向 RustFS
```

## 第五步：观察期（7 天，别急着下线老集群）

**千万别立刻停掉 MinIO。** 保持只读状态放着，万一 RustFS 那边某个应用报错（我们有个内部工具硬编码了 MinIO Console 的 API 路径，RustFS 控制台接口不完全一样，花了半天改掉），随时切回 `minio-old` 的 endpoint 就行，不用重新搬数据。

## 能迁过去什么，不能迁什么

这是最容易低估的地方。我迁移后逐个验了一遍，给你一份实测清单：

![minio-rustfs-support-matrix.png](https://developer.qcloudimg.com/http-save/yehe-12550791/6cc7b113ec78acaf7d05c695c48e06cf.png)

几个补充的坑：

- **Bucket 策略和生命周期规则**：基础策略能带过来，但复杂的条件表达式（按前缀 + 对象大小组合判断）建议迁移后逐条验证。
- **IAM 用户和 Access Key**：用户和密钥能迁，但 Service Account 和 STS 临时凭证需要重新生成。
- **事件通知**（SNS/Webhook/Redis）：目前不支持。我们一个桶配了 PUT 触发的 webhook，迁移后改成了应用层主动轮询——不够优雅但能用。
- **站点复制（Site Replication）**：不支持。有跨集群复制需求的，迁移后得用外部工具（比如 `rclone sync`）代替。

## 迁移完性能怎么样

切换完成后我跑了组对比（同一台机器、相同数据集、并发 16 线程，数字仅供参考，具体看你的硬件和数据特征）：

| 操作 | MinIO RELEASE.2024-01 | RustFS beta.12 | 趋势 |
|------|---------------------|----------------|------|
| PUT 4KB（小文件） | ~3200 ops/s | ~4100 ops/s | RustFS 领先约 28% |
| PUT 4MB（大文件） | ~580 MB/s | ~720 MB/s | 大文件写优势明显 |
| GET 4KB | ~4500 ops/s | ~5200 ops/s | |
| GET 4MB | ~680 MB/s | ~790 MB/s | |
| LIST（1 万对象） | ~180 ms | ~120 ms | 元数据查询更快 |

趋势跟官方在 beta.10 里程碑里讲的"PUT 反超 MinIO、长尾延迟更稳"一致——Rust 没有 GC 停顿，高并发小文件场景写性能提升比较直观。但别指望"性能翻倍"这类夸张说法，实际提升在 20%–40% 区间，而且高度依赖你的负载特征。

## 我踩过的三个真实坑

**坑一：access key 别用 MinIO 默认值**

MinIO 默认 `MinIOadmin/MinIOadmin`，但 RustFS 用环境变量 `RUSTFS_ACCESS_KEY/SECRET_KEY` 配置（compose 示例里是 `rustfsadmin/rustfsadmin`）。如果你用 `--access-key` 这类参数形式自己指定，记得应用端 credential 也要同步改，否则全报 `InvalidAccessKeyId`。

**坑二：path-style 访问确认一下**

如果你用 path-style URL（`http://host:9000/bucket/object`），确认 RustFS 没强制 virtual-hosted style。大部分 S3 SDK 默认走 virtual-hosted，自建环境一般要显式配成 path-style，否则报 `NoSuchBucket`。

**坑三：控制台端口别暴露公网**

API 在 9000、Console 在 9001——这个端口约定跟 MinIO 一样，改 docker-compose 时顺手检查端口映射，别把 9001 控制台暴露出去。RustFS 的 compose 里有个 `RUSTFS_CONSOLE_CORS_ALLOWED_ORIGINS=*` 是给本地联调用的，生产记得收窄。

## 迁移清单（照着做就行）

1. **盘点现状**：所有 bucket、IAM 用户、生命周期规则、事件通知配置
2. **起目标集群**：用 `rustfs/rustfs:beta.12`（或 `:latest`）的官方 compose，跑通 `mc ls` 和 Put/Get/List
3. **预演**：`mc mirror --dry-run` 确认权限和路径解析
4. **全量同步**：大桶分批并行，`tee sync.log` 留传输明细
5. **增量追平**：反复跑到秒级
6. **停写切换**：只读 → 最后增量 → `mc diff` 验证 → 切 DNS/upstream
7. **观察回滚**：老集群只读保留 7–14 天，逐业务验证
8. **清理**：确认无误后下线老集群，释放资源

整个过程不需要改业务代码——S3 API 是兼容的，换个 endpoint 和 credential 就行。真正花时间的是验证环节：确保每个用到存储的服务都能正常工作。

---

RustFS 项目地址：https://github.com/rustfs/rustfs
RustFS官网：[rustfs.com](http://url.com) 


这套 MinIO，在生产上跑了快三年。四个节点，十二块盘，上面存着 CI 产物、备份包和一堆训练数据集，加起来大概 2.3 TB。去年年初 MinIO 社区版归档的消息出来的时候，我还没当回事——能跑就行呗。直到上个月做安全审计，审计方指着那台还在跑 RELEASE.2024-01 的节点问："这个版本最后一次安全更新是什么时候？" 我查了一下，答不上来。

从 MinIO 迁移到 RustFS：一次 S3 对象存储无缝替换的实战手记

架构设计

后端

云计算

从MinIO迁移至RustFS的完整实战指南，涵盖mcmirror与rclone两种迁移路径、docker-compose部署、全量同步与增量追平步骤、性能对比（小文件PUT提升28%）、关键坑点（AccessKey配置、path-style访问）及7天观察期回滚策略，助你安全完成S3存储替换。

安全审计

数据处理

代码解释

Docker

Redis

对象存储COS新用户低至1元！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

从 MinIO 迁移到 RustFS：一次 S3 对象存储无缝替换的实战手记-腾讯云开发者社区-腾讯云

从 MinIO 迁移到 RustFS：一次 S3 对象存储无缝替换的实战手记

从 MinIO 迁移到 RustFS：一次 S3 对象存储无缝替换的实战手记

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐