Ubuntu MinIO安装教程（多种方法）

MinIO是高性能分布式对象存储系统，支持S3协议，适用于云存储、备份等场景。以下是Ubuntu系统安装MinIO的详细步骤，涵盖Snap包、APT仓库、手动二进制三种常用方法。

前提条件

• Ubuntu 18.04及以上版本（推荐20.04/22.04 LTS）；
• 服务器联网（需下载安装包）；
• root权限或sudo权限；
• 至少1GB内存、1核CPU、10GB可用磁盘空间（生产环境建议更高配置）。

方法一：使用Snap包安装（最简方式）

Snap是Ubuntu官方软件包管理工具，安装过程无需手动配置依赖。

1. 更新系统包列表

   sudo apt update
   

2. 安装Snapd（若未安装）
   Snapd是Snap的核心守护进程，用于管理Snap包：

   sudo apt install -y snapd
   

3. 通过Snap安装MinIO
   使用--classic参数授予MinIO访问系统资源的权限：

   sudo snap install minio --classic
   

4. 启动MinIO服务并设置开机自启

   sudo systemctl start minio
   sudo systemctl enable minio
   

5. 验证安装
   查看MinIO服务状态，确认运行正常：

   sudo systemctl status minio
   

   若显示active (running)则表示安装成功。

方法二：使用APT仓库安装（推荐生产环境）

通过APT仓库安装可获得自动更新和安全补丁，适合长期运行的生产环境。

1. 更新系统包列表

   sudo apt update
   

2. 安装依赖工具
   用于下载和解压软件包：

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

3. 添加MinIO官方GPG密钥
   确保下载的软件包未被篡改：

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

4. 添加MinIO APT仓库
   替换bionic为你的Ubuntu版本代号（如focal对应20.04、jammy对应22.04）：

   sudo add-apt-repository "deb https://dl.min.io/server/minio/release/ubuntu $(lsb_release -cs) main"
   

5. 再次更新包列表并安装MinIO

   sudo apt update
   sudo apt install minio
   

6. 验证安装

   minio --version
   

   输出类似minio version RELEASE.2025-05-09T00-00-00Z即表示成功。

方法三：手动下载二进制文件（适合自定义场景）

若需完全控制安装路径或版本，可手动下载二进制文件。

1. 下载MinIO二进制文件
   替换linux-amd64为你的系统架构（如linux-arm64对应ARM设备）：

   wget https://dl.min.io/server/minio/release/linux-amd64/minio -O /usr/local/bin/minio
   

2. 赋予执行权限

   sudo chmod +x /usr/local/bin/minio
   

3. 创建数据存储目录
   用于存储MinIO的数据文件（可自定义路径）：

   sudo mkdir -p /data/minio
   sudo chown -R $USER:$USER /data/minio
   

4. 启动MinIO服务器
   使用--console-address指定控制台端口（默认9000为API端口，9001为控制台端口）：

   /usr/local/bin/minio server /data/minio --console-address ":9001"
   

   终端会显示存储路径、访问密钥（默认minioadmin）和Web界面URL（http://<服务器IP>:9001）。

配置MinIO（可选但推荐）

1. 设置永久访问密钥

默认的minioadmin/minioadmin密钥安全性低，建议修改：

minio admin user add myaccesskey mysecretkey

替换myaccesskey和mysecretkey为你自定义的强密钥。

2. 配置HTTPS（加密传输）

生成自签名证书（生产环境建议使用CA颁发的证书）：

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ~/minio.key -out ~/minio.crt

启动MinIO时启用HTTPS：

/usr/local/bin/minio server --certs-dir ~/ /data/minio

3. 设置开机自启（手动二进制安装）

创建systemd服务文件：

sudo nano /etc/systemd/system/minio.service

粘贴以下内容（替换数据目录和密钥）：

[Unit]
Description=MinIO Server
After=network.target

[Service]
WorkingDirectory=/data/minio
User=$USER
Group=$USER
Environment="MINIO_ROOT_USER=myaccesskey"
Environment="MINIO_ROOT_PASSWORD=mysecretkey"
ExecStart=/usr/local/bin/minio server /data/minio --console-address ":9001"
Restart=always
RestartSec=5
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

保存后执行以下命令启用服务：

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

使用MinIO控制台

1. 访问Web界面
   打开浏览器，输入http://<服务器IP>:9001（若配置了HTTPS则为https://<服务器IP>:9001）。

2. 登录
   使用默认或自定义的访问密钥（如myaccesskey/mysecretkey）登录。

3. 基本操作

   • 创建存储桶：点击“Buckets”→“Create Bucket”；
   • 上传对象：选择存储桶→点击“Upload”→选择文件；
   • 管理权限：通过“IAM”模块设置用户和策略。

常见问题解决

• 无法访问控制台：检查防火墙是否开放9001端口（sudo ufw allow 9001）；
• 权限不足：确保数据目录的属主为用户（如sudo chown -R $USER:$USER /data/minio）；
• 服务无法启动：查看日志定位问题（journalctl -u minio -f）。