如何扩容Docker部署的Bitnami Minio分布式集群？

算力阿峰

2026-8-18

Minio分布式集群（4→8节点）正确扩容方法

错误原因说明

直接修改MINIO_DISTRIBUTED_NODES添加新节点会失败，因为原集群的format.json已固化初始4节点的磁盘配置，新节点数与原有元数据不匹配；同时新节点未加入集群信任列表，导致连接拒绝错误。Minio分布式集群扩容必须通过加入现有集群的方式完成，不能直接修改节点数参数。

具体扩容步骤

1. 确认原有集群状态

确保4个原有Minio容器均处于运行状态，集群健康。可进入任意原有容器执行命令验证：

mc admin info myminio

（若未配置mc客户端，需先在容器内执行mc alias set myminio http://localhost:9000 <你的ROOT_USER> <你的ROOT_PASSWORD>）

2. 准备新节点环境

为4个新节点创建独立的存储目录，权限与原有节点保持一致（例如chmod 777 /data/minio/node5）。
确保所有节点（原有+新）处于同一Docker网络（若未创建，可执行docker network create minio-cluster-net，所有容器启动时加上--network minio-cluster-net参数）。

3. 启动新节点并加入集群

逐个启动新节点，启动命令需指定join参数指向任意一个原有节点地址，同时MINIO_DISTRIBUTED_NODES需包含所有8个节点的完整地址。示例命令：

docker run -d \
  --name minio-node5 \
  --network minio-cluster-net \
  -p 9005:9000 \
  -v /data/minio/node5:/data \
  -e MINIO_ROOT_USER=your-root-user \
  -e MINIO_ROOT_PASSWORD=your-root-password \
  -e MINIO_DISTRIBUTED_NODES=http://minio-node1:9000/data,http://minio-node2:9000/data,http://minio-node3:9000/data,http://minio-node4:9000/data,http://minio-node5:9000/data,http://minio-node6:9000/data,http://minio-node7:9000/data,http://minio-node8:9000/data \
  -e MINIO_CLUSTER_DOMAIN=minio-cluster \
  bitnami/minio:2022.8.22-debian-11-r1 server join http://minio-node1:9000

每启动一个新节点后，等待1-2分钟，用mc admin info myminio确认节点已成功加入集群，再启动下一个。

4. 更新原有节点配置

所有新节点加入完成后，逐个重启原有节点，更新MINIO_DISTRIBUTED_NODES为包含8个节点的列表。示例重启命令：

docker stop minio-node1 && docker rm minio-node1
docker run -d \
  --name minio-node1 \
  --network minio-cluster-net \
  -p 9001:9000 \
  -v /data/minio/node1:/data \
  -e MINIO_ROOT_USER=your-root-user \
  -e MINIO_ROOT_PASSWORD=your-root-password \
  -e MINIO_DISTRIBUTED_NODES=http://minio-node1:9000/data,http://minio-node2:9000/data,http://minio-node3:9000/data,http://minio-node4:9000/data,http://minio-node5:9000/data,http://minio-node6:9000/data,http://minio-node7:9000/data,http://minio-node8:9000/data \
  -e MINIO_CLUSTER_DOMAIN=minio-cluster \
  bitnami/minio:2022.8.22-debian-11-r1 server

同样，每重启一个原有节点后，确认集群状态正常，再操作下一个。

5. 验证扩容结果

所有节点重启完成后，执行mc admin info myminio，确认输出中显示8个节点均为online状态，磁盘总数与配置一致。

关键注意事项

所有节点的MINIO_ROOT_USER和MINIO_ROOT_PASSWORD必须完全相同，否则无法加入集群。
扩容过程中不要停止所有原有节点，必须保证至少一半以上原有节点处于运行状态，避免集群不可用。
新节点的存储目录必须为空，不能有旧的Minio数据文件。

内容的提问来源于stack exchange，提问作者AEGG