Ubuntu系统安装MinIO的详细教程

Ubuntu 安装与部署 MinIO 详细教程

一 环境准备与版本选择

• 系统建议：Ubuntu 20.04/22.04 LTS（64 位），已更新至最新补丁，具备 sudo 权限。
• 架构匹配：选择对应的 amd64/arm64 版本，以下以 amd64 为例。
• 资源建议：至少 2 核 CPU、8GB 内存、500GB 磁盘，并配置静态 IP与防火墙放行策略。
• 访问端口：API 端口 9000，控制台端口 9001（建议与 API 分离，便于安全与运维）。

二 方式一 二进制安装并配置 systemd 服务（推荐）

• 1）下载与安装
  • 更新索引并安装依赖
    • sudo apt update & & sudo apt install -y wget ca-certificates
  • 下载二进制并安装到系统路径
    • wget https://dl.min.io/server/minio/release/linux-amd64/minio
    • chmod +x minio
    • sudo mv minio /usr/local/bin/
• 2）创建系统用户与数据目录
  • sudo useradd -r minio-user -s /sbin/nologin
  • sudo mkdir -p /data/minio /etc/minio
  • sudo chown -R minio-user:minio-user /data/minio /etc/minio
• 3）配置环境变量
  • sudo nano /etc/default/minio
  • 写入（请自定义强密码，长度≥8）：
    • MINIO_ROOT_USER=admin
    • MINIO_ROOT_PASSWORD=YourStrongP@ssw0rd
    • MINIO_VOLUMES=“/data/minio”
    • MINIO_OPTS=“–address :9000 --console-address :9001”
• 4）配置 systemd 服务
  • sudo nano /etc/systemd/system/minio.service
  • 写入：
    • [Unit]
      • Description=MinIO Object Storage
      • Documentation=https://docs.min.io
      • Wants=network-online.target
      • After=network-online.target
    • [Service]
      • User=minio-user
      • Group=minio-user
      • EnvironmentFile=/etc/default/minio
      • ExecStart=/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES
      • Restart=always
      • LimitNOFILE=65536
    • [Install]
      • WantedBy=multi-user.target
• 5）启动与开机自启
  • sudo systemctl daemon-reload
  • sudo systemctl enable --now minio
  • sudo systemctl status minio
• 6）防火墙放行
  • sudo ufw allow 9000,9001/tcp
  • sudo ufw reload
• 7）访问验证
  • 控制台：http://< 服务器IP> :9001
  • API：http://< 服务器IP> :9000
  • 使用上一步设置的 MINIO_ROOT_USER / MINIO_ROOT_PASSWORD 登录控制台。

三 方式二 Docker 快速部署（可选）

• 1）准备目录
  • sudo mkdir -p /opt/minio/{ data,config}
• 2）启动容器
  • docker run -d
    –name minio
    -p 9000:9000
    -p 9001:9001
    –restart=always
    -v /opt/minio/data:/data
    -v /opt/minio/config:/root/.minio
    -e “MINIO_ROOT_USER=admin”
    -e “MINIO_ROOT_PASSWORD=YourStrongP@ssw0rd”
    minio/minio:RELEASE.2022-01-04T07-41-07Z
    server /data --console-address “:9001”
• 3）访问与验证
  • 控制台：http://< 服务器IP> :9001
  • API：http://< 服务器IP> :9000
  • 使用设置的账号密码登录。

四 反向代理与 HTTPS 配置（Nginx + Let’s Encrypt）

• 1）安装 Nginx
  • sudo apt install -y nginx
• 2）申请证书（Certbot）
  • sudo apt install -y certbot python3-certbot-nginx
  • sudo certbot --nginx -d minio.example.com
• 3）Nginx 站点配置示例（/etc/nginx/sites-available/minio.example.com）
  • server {
    • listen 80;
    • server_name minio.example.com;
    • return 301 https://$host$request_uri;
    • }
  • server {
    • listen 443 ssl http2;
    • server_name minio.example.com;
    • ssl_certificate /etc/letsencrypt/live/minio.example.com/fullchain.pem;
    • ssl_certificate_key /etc/letsencrypt/live/minio.example.com/privkey.pem;
    • client_max_body_size 0;
    • location / {
      • proxy_pass http://127.0.0.1:9000;
      • proxy_set_header Host $http_host;
      • proxy_set_header X-Real-IP $remote_addr;
      • proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      • proxy_set_header X-Forwarded-Proto $scheme;
      • }
    • location /console/ {
      • proxy_pass http://127.0.0.1:9001/;
      • proxy_set_header Host $http_host;
      • proxy_set_header X-Real-IP $remote_addr;
      • proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      • proxy_set_header X-Forwarded-Proto $scheme;
      • }
    • }
• 4）启用站点并重启
  • sudo ln -s /etc/nginx/sites-available/minio.example.com /etc/nginx/sites-enabled/
  • sudo nginx -t & & sudo systemctl reload nginx
• 5）访问
  • 控制台：https://minio.example.com/console/
  • API：https://minio.example.com/
• 说明：也可使用 MinIO 官方工具（如早期 certbot 插件或 minio-certgen）管理证书；证书到期需自动续期（Certbot 默认自动续期）。

五 常见问题与运维要点

• 权限与运行用户：始终以非 root用户运行（如 minio-user），并确保 /data/minio /etc/minio 属主正确。
• 强口令与密钥：使用 MINIO_ROOT_USER / MINIO_ROOT_PASSWORD 设置强密码；避免在生产使用 minioadmin/minioadmin 默认凭据。
• 端口与防火墙：放行 9000/9001（或反向代理端口 80/443）；云厂商安全组同样需要放通。
• 资源与性能：生产建议 ≥2 核 CPU、8GB 内存、500GB 磁盘，并关注磁盘 IOPS 与网络带宽。
• 日志与监控：journalctl -u minio 查看服务日志；建议接入监控告警与定期巡检。
• 升级与备份：升级前备份 /data/minio 与 /etc/minio；变更窗口内执行滚动升级与回滚预案。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！