Linux MinIO安装后的配置指南

Linux MinIO安装后的配置指南

一 基础配置与环境变量

• 创建数据与证书目录，建议使用独立磁盘或分区挂载到数据目录，便于容量扩展与权限隔离：
  • 示例：mkdir -p /mnt/data；如需挂载新盘：fdisk 创建分区 → mkfs.ext4 → mount → 写入 /etc/fstab（使用 blkid 获取 UUID）。
• 创建系统用户与权限（安全最佳实践）：
  • groupadd -r minio-user；useradd -M -r -g minio-user minio-user；chown -R minio-user:minio-user /mnt/data；chmod -R 755 /mnt/data。
• 配置环境变量（推荐写入环境文件，便于 systemd 加载）：
  • 编辑 /etc/default/minio，设置：
    • MINIO_ROOT_USER=admin（至少 8 位）
    • MINIO_ROOT_PASSWORD=StrongPassw0rd!（至少 8 位）
    • MINIO_VOLUMES=/mnt/data
    • MINIO_OPTS=“–address :9000 --console-address :9001”
  • 说明：旧变量名 MINIO_ACCESS_KEY / MINIO_SECRET_KEY 仍可用，但建议使用新的根用户变量；首次未设置时，控制台默认账号/密码为 minioadmin/minioadmin。

二 以 systemd 托管并设置开机自启

• 创建服务文件 /etc/systemd/system/minio.service：
  • [Unit]
    • Description=MinIO
    • Documentation=https://docs.min.io
    • Wants=network-online.target
    • After=network-online.target
  • [Service]
    • Type=notify
    • EnvironmentFile=/etc/default/minio
    • ExecStart=/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES
    • ExecReload=/bin/kill -s HUP $MAINPID
    • Restart=on-failure
    • RestartSec=5
  • [Install]
    • WantedBy=multi-user.target
• 启动与开机自启：
  • systemctl daemon-reload
  • systemctl enable --now minio
  • systemctl status minio
• 日志排查：
  • journalctl -u minio.service -xe
  • 如采用前台日志或自定义路径，可用 tail -f /var/log/minio.log 或实际日志文件路径。

三 网络访问与安全配置

• 防火墙放行端口（示例）：
  • firewalld：firewall-cmd --zone=public --add-port=9000/tcp --permanent；firewall-cmd --zone=public --add-port=9001/tcp --permanent；firewall-cmd --reload
  • ufw：ufw allow 9000,9001/tcp
• 访问控制台：浏览器打开 http://服务器IP:9001；API 端口 9000 用于 S3 兼容接口。
• 启用 TLS/HTTPS（自签名或 CA 签发证书）：
  • 方式一：将证书放入目录并启动指定证书目录
    • mkdir -p /etc/minio/certs
    • cp server.crt /etc/minio/certs/public.crt；cp server.key /etc/minio/certs/private.key
    • 在 /etc/default/minio 添加：MINIO_OPTS=“–address :9000 --console-address :9001 --certs-dir /etc/minio/certs”
  • 方式二：启动时直接指定证书文件
    • minio server /data --certs /etc/ssl/certs/minio-cert.pem,/etc/ssl/private/minio-key.pem
• 反向代理与域名接入（可选，便于对外统一域名与证书管理）：
  • 使用 Nginx 反向代理 9000/9001，设置 client_max_body_size 0、proxy_buffering off、X-Forwarded-Proto $scheme 等，支持大对象与控制台 WebSocket。

四 客户端 mc 与常见运维操作

• 安装与添加别名：
  • 下载 mc，chmod +x，mv 至 /usr/local/bin
  • mc alias set myminio http://服务器IP:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD
• 常用命令：
  • mc ls myminio
  • mc mb myminio/mybucket
  • mc cp /path/file myminio/mybucket/
  • mc cp myminio/mybucket/file /path/dir
• 权限与策略（示例）：
  • 为应用创建用户与策略：mc admin user add myminio appuser StrongPass!
  • 通过控制台或 mc 设置 Bucket Policy（只读/读写/自定义）以适配业务最小权限原则。

五 性能优化与分布式扩展

• 单机多盘与性能调优：
  • 多数据目录可提升并发与吞吐：minio server /data1 /data2 /data3
  • 在 /etc/default/minio 中结合硬件调整：MINIO_OPTS 可加入 –server-threads、–worker-threads 等参数；确保 MINIO_VOLUMES 覆盖所有数据目录。
• 纠删码与高可用：
  • 单节点多盘默认使用 纠删码（非简单多副本），可在启动命令中加入 –enable-erasure-coding 明确启用；生产建议至少 4 盘以获得更优容错与空间效率。
• 分布式部署要点（多节点多盘）：
  • 准备 ≥4 节点（推荐 ≥3 节点，每节点 ≥2 块盘），低时延网络（建议 <10ms）
  • 各节点创建数据目录并以相同用户运行，使用统一启动命令指定所有卷地址：
    • minio server http://node{1…4}/mnt/data{1…2}
  • 通过域名或负载均衡暴露 9000/9001，证书与反向代理策略与单机一致。