Ubuntu系统更新后MinIO如何重新安装

Ubuntu系统更新后MinIO重新安装指南

一 准备与环境检查

• 确认系统架构为amd64/x86_64（MinIO官方二进制通常以此为主），更新索引并安装常用依赖：
  • 执行：sudo apt update && sudo apt install -y wget unzip
• 检查并规划端口：MinIO API默认9000，控制台默认9090/9001（可按需调整）。确保云安全组与防火墙已放行对应端口（如仅内网访问，建议限制来源IP）。

二 卸载旧版本

• 若此前通过APT安装：
  • 执行：sudo systemctl stop minio
  • 执行：sudo apt-get remove --purge minio
  • 清理：sudo apt-get autoremove && sudo apt-get autoclean
• 若此前为手动二进制安装：
  • 执行：sudo systemctl stop minio
  • 删除二进制：sudo rm -f /usr/local/bin/minio（若放在/opt/minio，则删除相应目录）
  • 删除服务与环境：sudo rm -f /etc/systemd/system/minio.service && sudo systemctl daemon-reload
• 清理数据与配置（请先确认已备份）：
  • 执行：sudo rm -rf /data /etc/minio（常见默认路径，如自定义请替换为实际路径）
• 验证是否已移除：which minio 应无输出。

三 三种安装方式

• 方式A 手动二进制安装（通用、可控性高）
  • 下载与授权：
    • 执行：wget https://dl.min.io/server/minio/release/linux-amd64/minio
    • 执行：chmod +x minio && sudo mv minio /usr/local/bin/
  • 准备数据与用户：
    • 执行：sudo mkdir -p /data
    • 建议创建专用用户（可选）：sudo useradd -r -s /usr/sbin/nologin minio-user && sudo chown -R minio-user:minio-user /data
  • 配置环境变量（强烈建议自定义强口令）：
    • 临时：export MINIO_ROOT_USER=admin && export MINIO_ROOT_PASSWORD=YourStrongP@ssw0rd
    • 永久：写入/etc/default/minio或/etc/profile（重启或source使其生效）
  • 启动与自启（示例以9000/9090为例，可按需改为9001/9002）：
    • 前台调试：minio server /data --console-address ":9090"
    • 生产建议用systemd托管（见下方服务文件示例）。
• 方式B APT仓库安装（便于升级）
  • 导入GPG与源并安装：
    • 执行：wget -qO - https://dl.min.io/server/minio/release/linux/amd64/minio-release.gpg.key | sudo apt-key add -
    • 执行：echo "deb https://dl.min.io/server/minio/release/linux/amd64/archive/ minio main" | sudo tee /etc/apt/sources.list.d/minio.list
    • 执行：sudo apt update && sudo apt install -y minio
  • 启动与自启：sudo systemctl enable --now minio
  • 说明：仓库安装后，二进制与配置路径由包管理维护，升级可直接apt upgrade minio。
• 方式C Snap安装（便捷）
  • 执行：sudo snap install minio --classic
  • 启动与自启：sudo systemctl start minio && sudo systemctl enable minio
  • 说明：Snap隔离性较强，数据目录与端口可能与手动安装不同，建议通过snap get minio等命令查看与调整。

四 systemd服务文件示例

• 新建：sudo nano /etc/systemd/system/minio.service
• 内容（按需修改路径与端口；示例将API设为9001，控制台设为9002）：

  [Unit]
  Description=MinIO Server
  Documentation=https://docs.min.io
  Wants=network-online.target
  After=network-online.target
  
  [Service]
  Type=notify
  User=minio-user
  Group=minio-user
  EnvironmentFile=-/etc/default/minio
  ExecStart=/usr/local/bin/minio server /data --address ":9001" --console-address ":9002"
  Restart=always
  LimitNOFILE=65536
  
  [Install]
  WantedBy=multi-user.target
  

• 启用与启动：
  • 执行：sudo systemctl daemon-reload
  • 执行：sudo systemctl enable --now minio
  • 查看状态：sudo systemctl status minio。

五 验证与常见问题

• 访问与登录：
  • API：http://<服务器IP>:9000 或 :9001
  • 控制台：http://<服务器IP>:9090 或 :9002
  • 使用上一步设置的MINIO_ROOT_USER与MINIO_ROOT_PASSWORD登录。
• 客户端验证（mc）：
  • 下载：wget https://download.min.io/mc/release/linux-amd64/mc && chmod +x mc && sudo mv mc /usr/local/bin/
  • 添加主机：mc config host add myminio http://127.0.0.1:9000 <你的AccessKey> <你的SecretKey>
  • 列桶：mc ls myminio
• 常见问题处理：
  • 端口被占用：检查并释放端口，或改用未占用端口（如将API改为9001、控制台改为9002），同时更新防火墙放行规则。
  • 权限错误：确保数据目录（如**/data**）属主为运行MinIO的用户（如minio-user）。
  • 升级后配置丢失：若使用APT/Snap，配置通常由包管理维护；手动安装请保留并备份/etc/default/minio与数据目录后再升级。