MinIO安装教程Ubuntu版详细指南

一、安装前准备

1. 系统要求：Ubuntu 18.04及以上版本（推荐22.04 LTS，稳定性更佳）；
2. 权限要求：需要root权限或使用sudo命令；
3. 网络要求：服务器需联网（用于下载软件包、依赖及后续验证）。

二、方法一：使用APT仓库安装（推荐，最便捷）

1. 更新系统包

sudo apt update && sudo apt upgrade -y

确保系统包为最新版本，避免依赖冲突。

2. 安装必要依赖

sudo apt install -y wget curl software-properties-common

wget用于下载文件，curl用于网络请求，software-properties-common用于管理APT仓库。

3. 添加MinIO官方GPG密钥（验证软件包完整性）

wget -qO - https://dl.min.io/server/minio/release/linux-amd64/minio-release.gpg | sudo apt-key add -

输入OK确认添加，确保后续下载的MinIO软件包未被篡改。

4. 添加MinIO APT仓库

sudo add-apt-repository 'deb https://dl.min.io/server/minio/release/linux-amd64/ /'

将MinIO的官方仓库添加到系统源列表，以便后续通过apt安装。

5. 再次更新系统包

sudo apt update

同步仓库信息，使系统识别MinIO软件包。

6. 安装MinIO服务器

sudo apt install -y minio

自动下载并安装MinIO服务器及相关依赖，安装完成后会提示“Setting up minio”（设置完成）。

三、方法二：手动下载二进制文件安装（灵活，适合自定义路径）

1. 下载MinIO二进制文件

wget https://dl.min.io/server/minio/release/linux-amd64/minio

选择最新的稳定版本（如linux-amd64对应64位Ubuntu），下载到当前目录。

2. 赋予执行权限

chmod +x minio

使二进制文件可执行，否则无法运行。

3. 移动到系统路径（可选但推荐）

sudo mv minio /usr/local/bin/

将minio命令移动到/usr/local/bin/（系统全局路径），方便在任何目录下调用。

4. 创建数据存储目录

sudo mkdir -p /data/minio
sudo chown -R $(whoami):$(whoami) /data/minio

• /data/minio为数据存储路径（可根据需求修改，如/mnt/minio）；
• chown命令将目录所有权赋予当前用户（避免权限问题）。

四、配置MinIO服务（两种方法均需执行）

1. 创建数据目录（若未创建）

sudo mkdir -p /data/minio
sudo chown -R $(whoami):$(whoami) /data/minio

确保MinIO有权限读写数据目录。

2. 配置环境变量（设置访问密钥和存储路径）

sudo nano /etc/default/minio

在文件中添加以下内容（替换YOUR_ACCESS_KEY和YOUR_SECRET_KEY为自定义密钥，建议使用强密码）：

MINIO_ROOT_USER=YOUR_ACCESS_KEY
MINIO_ROOT_PASSWORD=YOUR_SECRET_KEY
MINIO_VOLUMES="/data/minio"

保存并退出（Ctrl+O→Enter→Ctrl+X）。

3. 创建systemd服务文件（管理MinIO为系统服务）

sudo tee /usr/lib/systemd/system/minio.service <<EOF
[Unit]
Description=MinIO Server
Documentation=https://docs.min.io
Wants=network-online.target
After=network-online.target

[Service]
EnvironmentFile=/etc/default/minio
ExecStart=/usr/local/bin/minio server \$MINIO_VOLUMES --console-address ":9001"
Restart=on-failure
LimitNOFILE=1048576
User=$(whoami)
Group=$(whoami)

[Install]
WantedBy=multi-user.target
EOF

• ExecStart：指定MinIO启动命令，--console-address ":9001"将控制台端口改为9001（避免与API端口9000冲突）；
• User/Group：以当前用户身份运行（避免权限过高）。

4. 重载systemd并启动服务

sudo systemctl daemon-reload
sudo systemctl start minio
sudo systemctl enable minio

• daemon-reload：重新加载systemd配置；
• start：立即启动MinIO服务；
• enable：设置开机自启（服务器重启后自动运行）。

五、验证安装

1. 检查服务状态

sudo systemctl status minio

若显示“active (running)”（运行中），则说明服务启动成功。

2. 查看MinIO版本

minio version

输出类似minio version RELEASE.2025-01-20T14-49-07Z，确认版本信息。

3. 测试API连通性

curl -i http://localhost:9000

若返回HTTP/1.1 200 OK及MinIO欢迎信息，则说明API服务正常。

六、访问MinIO控制台

1. 开放防火墙端口（若启用防火墙）：

   sudo ufw allow 9000/tcp  # API端口
   sudo ufw allow 9001/tcp  # 控制台端口
   sudo ufw reload
   

2. 打开浏览器：访问http://<your-server-ip>:9001（控制台端口）；
3. 登录：使用/etc/default/minio中设置的MINIO_ROOT_USER和MINIO_ROOT_PASSWORD登录；
4. 开始使用：控制台提供对象存储、桶管理、文件上传下载等功能。

七、常见问题解决

1. 服务无法启动

• 查看日志：journalctl -u minio -f（实时查看MinIO日志）；
• 常见原因：数据目录权限不足、环境变量配置错误（如路径拼写错误）。

2. 忘记访问密钥

• 修改/etc/default/minio中的MINIO_ROOT_USER和MINIO_ROOT_PASSWORD，然后重启服务：

  sudo systemctl restart minio
  

3. 升级MinIO

• APT方式：sudo apt update && sudo apt upgrade minio；
• 手动方式：重复手动安装步骤，覆盖旧版本二进制文件。

通过以上步骤，您可在Ubuntu系统上成功安装并运行MinIO对象存储服务。根据需求选择安装方式（推荐APT仓库安装，最便捷），并注意配置强访问密钥以保障数据安全。