RustFS + Docker 生产环境部署指南

三、生产环境完整配置

3.1 docker-compose.yml

version: '3.8'
services:
  rustfs:
    image: rustfs/rustfs:1.0.0-alpha.69
    container_name: rustfs
    hostname: rustfs
    restart: unless-stopped
    ports:
      - "9000:9000"
      - "9001:9001"
    volumes:
      - ./data:/data
      - ./logs:/logs
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
    environment:
      - RUSTFS_ACCESS_KEY=你的访问密钥
      - RUSTFS_SECRET_KEY=你的安全密钥
      - RUSTFS_REGION=cn-east-1
      - RUSTFS_BROWSER=on
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '1.0'
        reservations:
          memory: 1G
          cpus: '0.5'
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
  redis:
    image: redis:7-alpine
    restart: unless-stopped
    volumes:
      - redis_data:/data
    command: redis-server --appendonly yes
volumes:
  redis_data:

3.2 启动与验证

docker-compose up -d
docker-compose ps
docker-compose logs -f rustfs
docker inspect --format='{{.State.Health.Status}}' rustfs

四、性能优化配置

4.1 存储性能优化

environment:
  - RUSTFS_CACHE_DRIVES=/data/cache
  - RUSTFS_CACHE_MAXSIZE=80
  - RUSTFS_CACHE_EXPIRY=90
  - RUSTFS_CACHE_QUOTA=70

4.2 网络优化

sysctls:
  - net.core.somaxconn=1024
  - net.ipv4.tcp_max_syn_backlog=1024
ulimits:
  nofile:
    soft: 65536
    hard: 65536

五、监控和日志管理

5.1 集成 Prometheus 监控

environment:
  - RUSTFS_PROMETHEUS_AUTH_TYPE=public
  - RUSTFS_PROMETHEUS_URL=http://prometheus:9090

5.2 日志配置

创建 config/logging.json：

{
  "version": "1.0",
  "formatters": {
    "detailed": {
      "format": "%(asctime)s %(name)-15s %(levelname)-8s %(message)s"
    }
  },
  "handlers": {
    "file": {
      "class": "logging.handlers.RotatingFileHandler",
      "filename": "/logs/rustfs.log",
      "maxBytes": 10485760,
      "backupCount": 5
    }
  },
  "root": {
    "level": "INFO",
    "handlers": ["file"]
  }
}

六、备份和恢复

6.1 自动备份脚本

创建 scripts/backup.sh：

#!/bin/bash
BACKUP_DIR="/backup/$(date +%Y%m%d)"
mkdir -p $BACKUP_DIR
docker exec rustfs tar czf /data/metadata.tar.gz /data/.metadata
docker cp rustfs:/data/metadata.tar.gz $BACKUP_DIR/
tar czf $BACKUP_DIR/config.tar.gz ./config
echo "备份完成：$BACKUP_DIR"

6.2 设置定时任务

# 每天凌晨 2 点备份
0 2 * * * /opt/rustfs/scripts/backup.sh

七、常见问题排坑指南

问题 1：控制台无法访问

检查防火墙和 SELinux：

sudo firewall-cmd --add-port=9000-9001/tcp --permanent
sudo firewall-cmd --reload

问题 2：存储空间不足

使用外部存储挂载：

volumes:
  - /mnt/nas/rustfs_data:/data

问题 3：性能瓶颈

启用缓存和调整参数：

environment:
  - RUSTFS_READ_AFTER_WRITE_QUORUM=1
  - RUSTFS_WRITE_QUORUM=1

八、生产级部署脚本

创建 deploy-production.sh：

#!/bin/bash
set -e
echo "开始部署 RustFS 生产环境..."
if ! command -v docker &> /dev/null; then
  echo "安装 Docker..."
  curl -fsSL https://get.docker.com | sh
fi
docker network create rustfs-net 2>/dev/null || true
docker-compose down
docker-compose up -d
echo "等待服务启动..."
sleep 30
if curl -f http://localhost:9000/minio/health/live; then
  echo "RustFS 部署成功！"
  echo "控制台地址：http://你的 IP:9001"
  echo "API 地址：http://你的IP:9000"
else
  echo "部署失败，请检查日志"
  docker-compose logs rustfs
fi

附录：官方资源

• GitHub 仓库：https://github.com/rustfs/rustfs
• 官方文档：https://docs.rustfs.com/