MinIO 环境搭建:Linux 上安装与配置

一、介绍

MinIO 是一个高性能、S3 兼容的对象存储系统，适用于 AI、大数据、备份归档等场景。它支持单机、分布式部署，提供 Web 控制台、REST API、CLI 工具（mc）及多语言 SDK。

相关链接：

• 下载地址：https://dl.min.io/server/minio/release
• Docker：https://hub.docker.com/r/minio/minio

“

⚠️ 注意：最后免费版本是RELEASE.2025-04-22T22-12-26Z，后续版本（如 2025 年 9 月后）属于 AIStor Object Store（商业产品），需许可证。若需长期免费使用，请锁定上述版本。

二、安装方式

二进制安装（推荐用于生产）

• 直接下载二进制文件

# 创建安装目录sudo mkdir -p /opt/minio# 进入目录cd /opt/minio# 下载最新版 MinIO（以 x86_64 为例）sudo wget https://dl.min.io/server/minio/release/linux-amd64/minio# 赋予执行权限sudo chmod +x minio

• 创建数据目录

# 创建数据存储目录（可自定义路径）sudo mkdir -p /data/minio

• 创建专用运行用户（安全最佳实践）

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

• 配置 systemd 服务

sudo tee /etc/systemd/system/minio.service <<'EOF'[Unit]Description=MinIO Object Storage ServerDocumentation=https://min.io/docs/minio/linux/index.htmlWants=network-online.targetAfter=network-online.targetAssertFileIsExecutable=/opt/minio/minio[Service]WorkingDirectory=/opt/minioUser=minio-userGroup=minio-user# 强烈建议使用强密码并避免硬编码在服务文件中（可通过环境文件加载）Environment="MINIO_ROOT_USER=minioadmin"Environment="MINIO_ROOT_PASSWORD=minioadmin"ExecStart=/opt/minio/minio server /data/minio --console-address ":9001"Restart=alwaysRestartSec=30TimeoutStopSec=10LimitNOFILE=65536[Install]WantedBy=multi-user.targetEOF

• 启动服务

sudo systemctl daemon-reload # 重载 systemd 配置sudo systemctl start minio   # 启动服务sudo systemctl enable minio  # 设置开机自启sudo systemctl status minio  # 查看状态

• 开放防火墙端口（如启用 firewalld）

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

Docker Compose 安装（适合开发/测试）

✅ 推荐使用 最后一个免费版本：RELEASE.2025-04-22T22-12-26Z

• 安装 Docker 和 Docker Compose（略）
• 创建 docker-compose.yml

services:minio:image:minio/minio:RELEASE.2025-04-22T22-12-26Zcontainer_name:miniocommand:server/data--console-address":9001"restart:unless-stoppedenvironment:-MINIO_ACCESS_KEY=superUser-MINIO_SECRET_KEY=KZR1CK0YruTH2L0u1sbSports:-"9000:9000"-"9001:9001"volumes:-./data:/data-./config:/root/.minio

• 启动服务

docker compose up -d

三、验证部署

• 检查进程与端口

ss -tulnp | grep -E ':(9000|9001)'ps aux | grep minio

• 访问 Web 控制台

打开浏览器访问：

http://<服务器IP>:9001

使用配置的账号密码登录（如 minioadmin / minioadmin 或 superUser / ...）。

• 使用 mc（MinIO Client）测试

# 下载 mcwget https://dl.min.io/client/mc/release/linux-amd64/mcchmod +x mc# 添加主机别名./mc alias set myminio http://localhost:9000 minioadmin minioadmin# 列出桶./mc ls myminio

四、常用端口说明

“

📌 自 MinIO v8 起，API 与 Console 分离，必须显式指定 --console-address。

五、常见问题

如何升级 MinIO？

• 二进制方式：替换 /opt/minio/minio 文件，重启服务
• Docker 方式：修改 image 标签，docker-compose pull && docker-compose up -d
• ⚠️ 升级前务必备份数据和配置！

启动失败，提示 “Permission denied”？

• 检查 /data/minio 所属用户是否为 minio-user
• 确保 SELinux 未阻止（可临时 setenforce 0 测试）

无法访问 Web 控制台？

• 检查防火墙/安全组是否开放 9001 端口
• 查看日志：journalctl -u minio -f

六、附录：版本选择建议

“

📢 重要：2025 年 4 月之后的版本属于 AIStor Object Store，功能增强但需商业授权。