Docker 安装 RustFS

RustFS 是一款高性能、100% 兼容 S3 的开源分布式对象存储系统。单节点单盘（SNSD）部署模式下，后端采用零纠删校验，不提供额外的数据冗余，适合本地测试与小规模场景。本文以 RustFS 官方 Linux 二进制包为基础，通过自定义 Dockerfile ，将 RustFS 及其运行时环境打包进容器，并配置数据卷与环境变量，即可一键启动服务。

一、前置准备

主机要求

已安装 Docker（≥ 20.10）并能正常拉取镜像与运行容器
本地路径 /mnt/rustfs/data（或自定义路径）用于挂载对象数据

网络与防火墙

确保宿主机 9000 端口对外开放（或自定义端口一致）

配置文件准备

在宿主机 /etc/rustfs/config.toml 中，定义监听端口、管理员账号、数据路径等（详见第四节）

二、快速拉取 RustFS 官方镜像

使用官方 Ubuntu 基础镜像，快速拉取 RustFS 官方镜像：

bash

docker pull rustfs/rustfs

三、运行 RustFS 容器

RustFS SNSD Docker 运行方式，结合上述镜像与配置，执行：

bash

 docker run -d \
  --name rustfs_local \
  -p 9000:9000 \
  -p 9001:9001 \
  -v /mnt/rustfs/data:/data \
  rustfs/rustfs:latest \
  /data

各参数说明：

-p 9000:9000：映射宿主机 9000 Endpoint端口到容器
-p 9001:9001：映射宿主机 9001 Console端口到容器
-v /mnt/rustfs/data:/data：挂载数据卷
--name rustfs_local：容器自定义名称
-d：后台运行

完整参数配置示例

bash

docker run -d \
  --name rustfs_container \
  -p 9000:9000 \
  -p 9001:9001 \
  -v /mnt/rustfs/data:/data \
  -e RUSTFS_ACCESS_KEY=rustfsadmin \
  -e RUSTFS_SECRET_KEY=rustfsadmin \
  -e RUSTFS_CONSOLE_ENABLE=true \
  -e RUSTFS_SERVER_DOMAINS=example.com \
  rustfs/rustfs:latest \
  --address :9000 \
  --console-enable \
  --server-domains example.com \
  --access-key rustfsadmin \
  --secret-key rustfsadmin \
  /data

参数说明与对应方法

环境变量方式 (推荐):

bash

-e RUSTFS_ADDRESS=:9000 \
-e RUSTFS_SERVER_DOMAINS=example.com \
-e RUSTFS_ACCESS_KEY=rustfsadmin \
-e RUSTFS_SECRET_KEY=rustfsadmin \
-e RUSTFS_CONSOLE_ENABLE=true \

命令行参数方式:

--address :9000 \
--server-domains example.com \
--access-key rustfsadmin \
--secret-key rustfsadmin \
--console-enable \

必需参数:
- <VOLUMES>: 在命令最后指定，如 /data

常用配置组合

基础配置:

bash

docker run -d \
  -p 9000:9000 \
  -p 9001:9001 \
  -v /mnt/data:/data \
  rustfs/rustfs:latest \
  /data

启用控制台:

bash

docker run -d \
  -p 9000:9000 \
  -p 9001:9001 \
  -v /mnt/data:/data \
  -e RUSTFS_CONSOLE_ENABLE=true \
  rustfs/rustfs:latest \
  --console-enable \
  /data

自定义认证密钥:

bash

docker run -d \
  -p 9000:9000 \
  -p 9001:9001 \
  -v /mnt/data:/data \
  -e RUSTFS_ACCESS_KEY=rustfsadmin \
  -e RUSTFS_SECRET_KEY=rustfsadmin \
  rustfs/rustfs:latest \
  --access-key rustfsadmin \
  --secret-key rustfsadmin \
  /data

注意事项

端口映射要对应：
- 服务端口默认 9000 (-p 9000:9000)
数据卷要持久化：
- -v /host/path:/container/path
环境变量和命令行参数可以混合使用，但命令行参数优先级更高

如果使用 TLS，需要额外挂载证书路径：

bash

-v /path/to/certs:/certs \
-e RUSTFS_TLS_PATH=/certs \

Docker Compose 安装

RustFS 官方提供了 Docker Compose 的安装方式，docker-compose.yml文件中包含多个服务，包括 grafana、prometheus、otel-collector、jaeger 等，主要围绕可观测性。如果你想同时部署这些服务，克隆 RustFS 代码仓库到本地：

git clone git@github.com:rustfs/rustfs.git

然后在根目录下执行：

docker compose --profile observability up -d

会启动如下容器：

CONTAINER ID   IMAGE                                             COMMAND                  CREATED         STATUS                            PORTS                                                                                                                                     NAMES
c13c23fe3d9d   rustfs/rustfs:latest                              "/entrypoint.sh rust…"   6 seconds ago   Up 5 seconds (health: starting)   0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp                                                                             rustfs-server
e3f4fc4a83a2   grafana/grafana:latest                            "/run.sh"                7 seconds ago   Up 5 seconds                      0.0.0.0:3000->3000/tcp, :::3000->3000/tcp                                                                                                 grafana
71ef1b8212cf   prom/prometheus:latest                            "/bin/prometheus --c…"   7 seconds ago   Up 5 seconds                      0.0.0.0:9090->9090/tcp, :::9090->9090/tcp                                                                                                 prometheus
e7db806b2d6f   jaegertracing/all-in-one:latest                   "/go/bin/all-in-one-…"   7 seconds ago   Up 5 seconds                      4317-4318/tcp, 9411/tcp, 0.0.0.0:14250->14250/tcp, :::14250->14250/tcp, 14268/tcp, 0.0.0.0:16686->16686/tcp, :::16686->16686/tcp          jaeger
1897830a2f1e   otel/opentelemetry-collector-contrib:latest       "/otelcol-contrib --…"   7 seconds ago   Up 5 seconds                      0.0.0.0:4317-4318->4317-4318/tcp, :::4317-4318->4317-4318/tcp, 0.0.0.0:8888-8889->8888-8889/tcp, :::8888-8889->8888-8889/tcp, 55679/tcp   otel-collector

如果你仅仅想安装 rustfs，不想启动其他服务，那么你需要在 docker-compose.yml 中注释掉：

#depends_on:
#  - otel-collector

然后执行命令：

docker compose -f docker-compose.yml up -d rustfs

只启动了 rustfs-server 这一个服务：

docker ps
CONTAINER ID   IMAGE                                             COMMAND                  CREATED         STATUS                           PORTS                                                           NAMES
e07121ecdd39   rustfs/rustfs:latest                              "/entrypoint.sh rust…"   2 seconds ago   Up 1 second (health: starting)   0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp   rustfs-server

不管是单独启动 rustfs-server 还是和可观测性的服务一起启动，对于 RustFS 实例的访问都是通过 http://localhost:9000，并使用默认用户名和密码（均为 rustfsadmin）。

四、验证与访问

查看容器状态与日志：

bash

docker logs rustfs_local

日志应显示服务启动成功，并监听 9000 端口。

测试 S3 API：

使用 mc 或其他 S3 客户端：

bash

mc alias set rustfs http://localhost:9000 rustfsadmin ChangeMe123!
mc mb rustfs/mybucket
mc ls rustfs

如能成功创建并列举 bucket，则部署生效。

五、其他建议

生产环境建议：

使用多节点部署架构
启用 TLS 加密通信
配置日志轮转策略
设置定期备份策略

存储建议：

使用本地 SSD/NVMe 存储
避免使用网络文件系统 (NFS)
保证存储目录独占访问

小结

本文结合 RustFS 单节点单盘容器化最佳实践，详细演示了如何通过 Docker 自行构建 RustFS 镜像并部署 SNSD 环境。该方案易于快速启动与试验，后续可在 Kubernetes、Swarm 等平台上采用同样思路扩展为多节点多盘生产级集群。

Linux安装

核心概念

存储桶管理

对象管理

IAM管理

SDK

Docker 安装 RustFS

一、前置准备

二、快速拉取 RustFS 官方镜像

三、运行 RustFS 容器

完整参数配置示例

参数说明与对应方法

常用配置组合

注意事项

Docker Compose 安装

四、验证与访问

五、其他建议

小结

Docker 安装 RustFS ​

一、前置准备 ​

二、快速拉取 RustFS 官方镜像 ​

三、运行 RustFS 容器 ​

完整参数配置示例 ​

参数说明与对应方法 ​

常用配置组合 ​

注意事项 ​

Docker Compose 安装 ​

四、验证与访问 ​

五、其他建议 ​

小结 ​

Docker 安装 RustFS

一、前置准备

二、快速拉取 RustFS 官方镜像

三、运行 RustFS 容器

完整参数配置示例

参数说明与对应方法

常用配置组合

注意事项

Docker Compose 安装

四、验证与访问

五、其他建议

小结