RustFS 是基于 Rust 语言开发的高性能分布式对象存储系统，完全兼容 Amazon S3 协议。本文详细介绍基于 Docker 的 RustFS 部署流程，包括 Docker Run 快速测试和 Docker Compose 生产环境方案。内容涵盖环境准备、服务验证、Web 控制台使用、基本存储桶操作以及生产环境的安全加固、数据持久化和资源限制优化。旨在为开发者提供比 MinIO 更轻量高效的对象存储替代方案，适用于 AI 训练和大数据处理场景。
在进入具体部署步骤前，我们先快速了解 RustFS 的核心优势。RustFS 是一个基于 Rust 语言开发的高性能分布式对象存储系统，完全兼容 Amazon S3 协议，具有以下显著特点：
特别值得一提的是，RustFS 在 AI 训练和大数据处理场景下表现出色，是构建现代云原生应用的理想存储基础。
在开始部署前，请确保你的系统满足以下基本要求：
使用以下命令检查 Docker 环境是否就绪：
# 检查 Docker 版本
docker -v
# 输出示例：Docker version 20.10.0, build 7287ab3
# 检查 Docker 服务状态
systemctl status docker
# 确保状态为 active (running)
# 检查 Docker Compose 版本（如使用）
docker compose version
# 输出示例：Docker Compose version v2.19.0
如果 Docker 未安装，请先参考官方文档安装 Docker 引擎。
根据你的使用习惯，可以选择以下任意一种部署方式。
这是最简单的部署方式，适合快速体验和测试环境：
# 拉取最新版 RustFS 镜像
docker pull rustfs/rustfs:latest
# 创建数据存储目录
mkdir -p /data/rustfs/{data,logs}
# 运行 RustFS 容器
docker run -d \
--name rustfs \
--restart unless-stopped \
-p 9000:9000 \
# API 端口，用于 S3 接口访问
-p 9001:9001 \
# 控制台端口，用于 Web 管理界面
-v /data/rustfs/data:/data \
# 数据持久化目录
-v /data/rustfs/logs:/logs \
# 日志目录
-e RUSTFS_ACCESS_KEY=admin \
# 管理员账号（可自定义）
-e RUSTFS_SECRET_KEY=your_strong_password_here \
# 管理员密码（请修改）
rustfs/rustfs:latest
参数说明：
-p 9000:9000：映射 API 端口，用于应用程序通过 S3 协议访问-p 9001:9001：映射控制台端口，用于 Web 管理界面-v /data/rustfs/data:/data：数据持久化，确保容器重启后数据不丢失-e RUSTFS_ACCESS_KEY：设置管理员用户名，默认建议使用 admin-e RUSTFS_SECRET_KEY：设置管理员密码，生产环境务必修改对于生产环境，强烈推荐使用 Docker Compose，便于管理和维护：
步骤 1：创建部署目录和配置文件
# 创建项目目录
mkdir -p /opt/rustfs && cd /opt/rustfs
步骤 2：创建 docker-compose.yml 文件
version: '3.8'
services:
rustfs:
image: rustfs/rustfs:latest
container_name: rustfs
restart: unless-stopped # 自动重启，确保服务高可用
ports:
- "9000:9000" # S3 API 端口
- "9001:9001" # Web 控制台端口
environment:
RUSTFS_ACCESS_KEY: "admin" # 管理员用户名
RUSTFS_SECRET_KEY: "your_strong_password" # 管理员密码，生产环境务必修改！
RUSTFS_DEFAULT_REGION: "us-east-1" # 默认区域
volumes:
- ./data:/data # 数据持久化
- ./logs:/logs # 日志持久化
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
interval: 30s
timeout: 10s
retries: 3
步骤 3：启动 RustFS 服务
# 后台启动服务
docker compose up -d
# 查看服务状态
docker compose ps
# 查看实时日志
docker compose logs -f
部署完成后，我们需要确认 RustFS 是否正常运行。
# 检查容器运行状态
docker ps | grep rustfs
# 预期输出示例：
# CONTAINER ID IMAGE STATUS PORTS NAMES
# a1b2c3d4e5f6 rustfs/rustfs:latest Up 5 minutes 0.0.0.0:9000-9001->9000-9001/tcp rustfs
# 查看容器详细状态
docker inspect rustfs | grep Status
# 预期输出："Status": "running"
# 检查服务健康状态
curl http://localhost:9000/minio/health/live
# 预期输出：OK
http://你的服务器 IP:9001默认登录信息：
admin（或你在环境变量中设置的用户名）your_strong_password（你设置的密码）在部署过程中可能会遇到一些常见问题，以下是解决方案：
如果 9000 或 9001 端口已被占用，可以修改为其他端口：
# 在 docker-compose.yml 中修改端口映射
ports:
- "9090:9000" # 将外部访问端口改为 9090
- "9091:9001" # 将控制台端口改为 9091
如果遇到目录权限错误，需要确保 Docker 有权限访问挂载目录：
# 授予目录适当权限
sudo chmod -R 755 /opt/rustfs
sudo chown -R $USER:$USER /opt/rustfs
# 或者直接放宽权限（仅用于测试环境）
sudo chmod -R 777 /opt/rustfs
如果拉取镜像缓慢，可以配置国内镜像源：
# 编辑 Docker 配置
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com"
]
}
EOF
# 重启 Docker 服务
sudo systemctl daemon-reload
sudo systemctl restart docker
部署成功后，我们来快速体验 RustFS 的基本功能。
通过 Web 界面上传：
通过 AWS CLI 上传（适合开发人员）：
# 配置 AWS CLI（需要先安装 awscli）
aws configure set aws_access_key_id admin
aws configure set aws_secret_access_key your_strong_password
aws configure set default.region us-east-1
aws configure set default.endpoint_url http://localhost:9000
# 上传文件
aws s3 cp myfile.txt s3://my-first-bucket/ --endpoint-url http://localhost:9000
当你准备将 RustFS 用于生产环境时，考虑以下优化措施：
environment:
RUSTFS_ACCESS_KEY: "改为复杂用户名"
RUSTFS_SECRET_KEY: "改为强密码" # 长度至少 16 位，含大小写数字特殊字符
MINIO_ROOT_USER: "改为复杂用户名" # 兼容 MinIO 的环境变量
MINIO_ROOT_PASSWORD: "改为强密码" # 兼容 MinIO 的环境变量
建议使用外部存储而非本地目录：
volumes:
- rustfs_data:/data # 使用 Docker 卷
- rustfs_logs:/logs
volumes:
rustfs_data:
driver: local
driver_opts:
type: none
o: bind
device: /path/to/secure/storage # 指定专用存储设备
防止容器占用过多资源：
deploy:
resources:
limits:
memory: 2G
cpus: '2.0'
reservations:
memory: 1G
cpus: '0.5'
# 查看实时日志
docker compose logs -f rustfs
# 查看资源使用情况
docker stats rustfs
# 定期健康检查
curl -f http://localhost:9000/minio/health/live || echo "服务异常"
定期备份重要数据：
#!/bin/bash
BACKUP_DIR="/backup/rustfs-$(date +%Y%m%d)"
mkdir -p $BACKUP_DIR
# 备份数据卷
docker run --rm -v rustfs_data:/data -v $BACKUP_DIR:/backup alpine \
tar czf /backup/rustfs-data-$(date +%Y%m%d).tar.gz -C /data .
echo "备份完成：$BACKUP_DIR"
通过本文的详细教程，你应该已经成功在 Docker 环境中部署了 RustFS，并了解了基本的使用方法。RustFS 作为一个新兴的高性能对象存储解决方案，在性能、资源消耗和易用性方面都表现出色，是 MinIO 的有效替代方案。
下一步学习建议：
以下是深入学习 RustFS 的推荐资源：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online