ubuntu minio安装要注意啥

在 Ubuntu 上安装 MinIO（对象存储，S3 兼容）时，有几个容易踩坑但很关键的点，下面按「安装前 → 安装中 → 安装后」给你梳理一下。

一、安装前要注意

1️⃣ 系统要求

• Ubuntu 18.04 / 20.04 / 22.04 都支持（推荐 22.04）
• 内核较新更好（对文件系统、inode 支持更稳）
• 不建议用 ARM 旧设备跑生产环境

2️⃣ 磁盘 & 文件系统

非常重要：

• ✅ 推荐使用 XFS（MinIO 官方强烈推荐）
• ❌ 不要用 ext4 跑高并发生产
• ❌ 不要挂载在 /home、/tmp

示例：

mkfs.xfs /dev/sdb
mkdir /data/minio
mount /dev/sdb /data/minio

3️⃣ 时间同步（NTP）

MinIO 对时间非常敏感：

timedatectl status

确保：

• 时间同步开启
• 时区正确（Asia/Shanghai）

二、安装方式选择

✅ 推荐方式（生产）

二进制 + systemd

• 稳定
• 易管理
• 官方推荐

❌ 不推荐

• Docker（除非你很熟网络/卷）
• Snap 版本（坑多）

三、安装步骤关键点

1️⃣ 下载 MinIO

wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
mv minio /usr/local/bin/

2️⃣ 创建用户（安全）

useradd -r -s /sbin/nologin minio
chown -R minio:minio /data/minio

3️⃣ 环境变量文件（重点）

/etc/default/minio：

MINIO_ROOT_USER=admin
MINIO_ROOT_PASSWORD=StrongPass123!
MINIO_VOLUMES=/data/minio
MINIO_OPTS="--address :9000 --console-address :9001"

⚠️ 注意：

• 密码 至少 8 位
• 不要用弱密码

四、systemd 配置（别漏）

/etc/systemd/system/minio.service：

[Unit]
Description=MinIO
After=network.target

[Service]
User=minio
Group=minio
EnvironmentFile=/etc/default/minio
ExecStart=/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES
Restart=always

[Install]
WantedBy=multi-user.target

然后：

systemctl daemon-reload
systemctl enable --now minio

五、防火墙 & 端口

ufw allow 9000
ufw allow 9001

六、生产部署额外注意

✅ 多磁盘（分布式）

MINIO_VOLUMES="http://host{1...4}/data/minio"

✅ 反向代理（Nginx）

• 必须支持：
  • 大文件
  • 长连接
  • WebSocket（9001）

✅ 定期备份

• 元数据 + 数据
• 可用 mc mirror

七、常见坑总结

❌ 用 root 跑 MinIO
❌ 数据目录权限不对
❌ 时间不同步导致启动失败
❌ 防火墙没开 9001
❌ ext4 + 高并发 = 性能差

如果你告诉我：

• 单机还是集群
• 是否生产环境
• 是否用 Docker

我可以直接给你一份可复制的完整配置。