Ubuntu MinIO如何配置网络设置

Ubuntu 上 MinIO 网络设置实操指南

一 监听地址与端口

• 关键端口：S3 API 端口 9000、控制台端口 9001。建议仅在内网开放 9000，控制台 9001 通过反向代理或仅内网访问。
• 绑定方式：
  • 命令行参数：使用 –address 指定 API 监听地址，–console-address 指定控制台监听地址。
  • 环境变量：使用 MINIO_OPTS=“–address :9000 --console-address :9001” 集中管理。
• 示例（仅监听内网接口）：
  • 二进制前台：
    minio server --address 192.168.1.10:9000 --console-address 192.168.1.10:9001 /data
  • Systemd 环境文件（/etc/default/minio）：
    MINIO_OPTS=“–address 192.168.1.10:9000 --console-address 192.168.1.10:9001”

二 防火墙与云安全组

• UFW（Ubuntu 常用防火墙）：
  • 开放端口：sudo ufw allow 9000；sudo ufw allow 9001
  • 或一次性开放范围：sudo ufw allow 9000:9001/tcp
• 云厂商安全组：放行入站 TCP 9000、9001（来源按需限制为内网或办公网段）。
• 路由器端口转发（家庭/办公网络场景）：将公网端口映射到内网 Ubuntu IP:9000/9001。

三 TLS 加密与证书

• 证书目录：将证书放在 ${HOME}/.minio/certs/（推荐）或用 –config-dir 指定配置目录，证书放入该目录的 certs 子目录。
• 自签名证书（示例）：
  • 生成：certgen -host your-domain-or-ip
  • 部署：将生成的 public.crt 与 private.key 放到 ~/.minio/certs/（或相应配置目录的 certs 下），重启 MinIO。
• 访问方式：启用 TLS 后使用 https://<IP或域名>:9001 访问控制台；API 使用 https://<IP或域名>:9000。注意自签名证书浏览器会告警，需手动信任。

四 反向代理与域名访问（Nginx 示例）

• 目标：对外仅暴露 443，API 与控制台通过域名分流，隐藏 9000/9001。
• 示例配置片段（/etc/nginx/sites-available/minio）：
  • API（S3）：
    server { listen 443 ssl; server_name s3.example.com;
    location / { proxy_pass http://127.0.0.1:9000; proxy_set_header Host $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; } }
  • 控制台：
    server { listen 443 ssl; server_name console.example.com;
    location / { proxy_pass http://127.0.0.1:9001; proxy_set_header Host $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; } }
• 说明：证书放在 Nginx（或证书代理）上更便于统一管理；若由 MinIO 直接终止 TLS，则证书放在 ~/.minio/certs/。

五 分布式集群与常见排错

• 集群节点通信：每个节点启动命令中列出所有节点地址，例如：
  minio server http://192.168.1.11:9000 http://192.168.1.12:9000 http://192.168.1.13:9000 --console-address “:9001”
  控制台可访问任一节点的 9001 端口查看集群状态与健康信息。
• 常见排错要点：
  • 端口与防火墙：确认云安全组/UFW 已放行 9000/9001，本机监听地址为 0.0.0.0 或期望网卡 IP。
  • 证书路径与权限：证书需位于 ~/.minio/certs/（或 --config-dir 指定目录的 certs），权限与属主正确；MinIO 不会自动重定向 HTTP→HTTPS，需使用 https:// 访问控制台。
  • 日志与诊断：
    • 查看服务日志：sudo systemctl status minio；sudo journalctl -u minio -f
    • 若 systemd 日志不足，可查系统日志：sudo grep minio /var/log/syslog
  • 配置持久化：直接二进制启动不会生成传统配置文件，网络与凭据建议通过 环境变量/命令行参数 管理；如需导出/导入配置，可用 mc admin config export/import。