Linux MinIO安装配置文件说明

Linux 上 MinIO 的安装与配置文件说明

一 安装方式概览

• 二进制方式（通用）
  • 下载 MinIO 二进制到本地，例如：/usr/local/bin/minio，赋权：chmod +x /usr/local/bin/minio；创建数据目录：mkdir -p /data。
  • 直接启动：/usr/local/bin/minio server /data --console-address “:9001”（API 默认 9000，控制台默认 9001）。适合快速试用与容器外部署。
• RPM/DEB 包方式（RHEL/CentOS、Ubuntu/Debian）
  • RPM：wget .rpm & & yum install -y minio.rpm 或 rpm -ivh；DEB：wget .deb & & dpkg -i。
  • 包安装后通常提供 systemd 单元与默认环境文件路径，便于以服务方式运行与开机自启。

二 systemd 服务与 EnvironmentFile 配置

• 服务单元文件：/usr/lib/systemd/system/minio.service（或 /etc/systemd/system/minio.service）
  • 关键项：
    • EnvironmentFile=-/etc/default/minio：加载环境变量文件（以 - 开头表示文件不存在也不报错）。
    • ExecStart=/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES：启动命令；建议将路径、端口等抽离到 EnvironmentFile。
    • Restart=always、LimitNOFILE=65536：可靠性与文件句柄上限。
• 环境变量文件：/etc/default/minio（示例）
  • 必配：
    • MINIO_ROOT_USER：管理员用户名（建议 ≥ 8 字符）
    • MINIO_ROOT_PASSWORD：管理员密码（建议 ≥ 8 字符）
    • MINIO_VOLUMES：数据目录（如 /data 或多盘路径）
  • 常用：
    • MINIO_OPTS=“–console-address :9001”（控制台端口）
    • MINIO_OPTS 追加 “–config-dir /etc/minio”（自定义配置目录）
• 常用命令
  • systemctl daemon-reload（修改单元后）
  • systemctl enable --now minio（开机自启并启动）
  • systemctl status minio（查看状态与日志提示）

三 配置文件 config.json 与环境变量对照

• 配置文件位置
  • 默认：${ HOME} /.minio/config.json
  • 自定义：启动命令加 --config-dir /path（如：/etc/minio），MinIO 会在该目录生成/读取 config.json。
• 常见配置项与对应环境变量
  • 凭据：config.json 的 credential.accessKey / credential.secretKey
    • 对应：MINIO_ROOT_USER / MINIO_ROOT_PASSWORD（推荐）或旧变量 MINIO_ACCESS_KEY / MINIO_SECRET_KEY
  • 区域：config.json 的 region
    • 对应：MINIO_REGION_NAME（默认 us-east-1）
  • 浏览器访问开关：config.json 的 browser
    • 对应：MINIO_BROWSER=off（禁用控制台浏览器访问）
  • 配置目录：命令行 --config-dir（覆盖默认 ${ HOME} /.minio）
  • TLS 证书：默认目录 ${ HOME} /.minio/certs（放置 private.key / public.crt 启用 HTTPS）
• 重要限制（便于排障与规划）
  • 浏览器直传单对象上限 5GB；S3 API 单对象上限 5TB，单次 PUT 上限 5GB，分片数量上限 10000，分片大小 5MB–5GB。

四 常用启动参数与场景示例

• 指定 API 与控制台端口
  • /usr/local/bin/minio server /data --address “:9000” --console-address “:9001”
• 启用自定义配置目录
  • /usr/local/bin/minio server /data --config-dir /etc/minio --console-address “:9001”
• 启用 TLS（证书路径为相对 config-dir 的 certs 目录）
  • 将证书放到 /etc/minio/certs/private.key 与 /etc/minio/certs/public.crt，然后启动：
  • /usr/local/bin/minio server /data --config-dir /etc/minio --console-address “:9001”
• 分布式部署（示例为 4 节点，各自本地盘）
  • minio server http://node{ 1…4} /mnt/disk{ 1…4}
  • 注意：纠删码部署建议至少 4 个驱动器，读仲裁 N/2、写仲裁 N/2+1；更多节点/磁盘可按需扩展。

五 防火墙与网络访问

• 放行端口（firewalld）
  • firewall-cmd --zone=public --add-port=9000/tcp --permanent
  • firewall-cmd --zone=public --add-port=9001/tcp --permanent
  • firewall-cmd --reload
• 访问地址
  • API：http://服务器IP:9000
  • 控制台：http://服务器IP:9001
• 生产建议
  • 修改默认管理员密码，使用强口令与最小权限策略；必要时通过反向代理/负载均衡暴露 9000/9001，并配置 TLS。

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