Minio部署

程小虎2025-12-23 21:21:01

📂 Minio部署


📌 文档信息

  • 作者: 程小虎
  • 创建时间: 2025-12-04
  • 最近修订: 2025-12-06
  • 版本号: v1.0

✨ 介绍

  • 本教程使用脚本安装,可实现一键安装,整个安装过程只需要一条命令即可
  • 支持 单机、集群 安装
  • 脚本会自动通过keepalived配置VIP(虚拟IP),对外访问统一通过VIP。当主节点宕机后,会自动切换到权重较高的从节点

🔧 环境准备

在开始安装之前,请确保满足以下环境要求(生产环境建议 >= 8C 32G):

  • 大于等于3台Linux服务器:每台服务器将作为一个 Minio 节点。
  • root用户或配置了sudo免密的用户及密码,且所有节点密码必须相同
  • 需要 节点数+ 1 个可用IP。其中一个作为VIP,对外统一使用这个VIP进行连接

✅ 支持的系统

目前脚本实测支持以下Linux发行版

支持 单机/集群,适配 X86_64是否支持
Redhat、CentOS、OracleLinux、RockyLinux、AlmaLinux >= 7 全系
OpenEuler >= 20 全系
Ubuntu >= 20 全系
AnolisOS >= 7 全系
统信 UOS V20 1070a/1070e
银河麒麟 Kylin >= V10 全系
中标麒麟 NeoKylin V7 全系
中科方德 NFSCNS 4.0 全系
磐宁 NingOS V3.0 全系

📝 脚本参数说明

📋 所有参数说明

通过 bash MinioShellInstall.sh -h 可以参看脚本所有参数说明

-ou    [必填] 操作用户名,用户配置SSH互信,必须是root用户或者配置sudo免密的用户                 
-oup   [必填] 操作用户对应的密码,用户配置SSH互信                                                   
-sp    [可选] SSH端口号,不传默认为22,若修改过则必须填写修改后的实际端口号               
-mip   [必填] 安装主路径                                                       
-mu    [必填] minio用户名                                                        
-mp    [必填] minio密码                                                           
-ip    [必填] 集群节点IP,多个以逗号隔开,例如:-ip 192.168.80.81,192.168.80.82,192.168.80.83,或 -ip 192.168.80.{81..83}                                                   
-vip   [可选] 虚拟IP,集群模式必填,用于配置 keepalived

🚀 单机模式命令示例

bash MinioShellInstall.sh \
  -mip "/dhm" `# 安装主目录`\
  -mu OppleSie_dev `# minio用户名`\
  -mp 'uXnr7j3ydMGlke' `# minio密码`

🚀 集群模式命令示例

bash MinioShellInstall.sh \
  -ou root `# 操作用户名`\
  -oup 'admin' `# 操作用户对应的密码`\
  -mip "/dhm" `# 安装主目录`\
  -mu OppleSie_dev `# minio用户名`\
  -mp 'uXnr7j3ydMGlke' `# minio密码`\
  -ip "192.168.80.{81..83}" `# 集群节点IP`\
  -vip "192.168.80.88" `# 虚拟IP`

🛠️ 安装过程

安装过程中需要使用root用户进行安装,若系统当前用户为非root用户(必须是配置了sudo免密),则先执行下面命令切换为root用户

sudo su - root

执行下面命令,创建文件上传目录

mkdir /soft

将安装包 上传至 /soft 路径下,若一开始登录的时非root用户,可以先上传到 /tmp 路径下,然后移动到 /soft

  • minio_pkg:所有安装所需的安装包
  • MinioShellInstall.sh:Minio一键安装脚本
[root@huge ~]# cd /soft/minio/
[root@huge minio]# ll
总用量 40
drwxr-xr-x. 2 root root    95 1130 19:01 minio_pkg
-rw-r--r--. 1 root root 38225 1130 19:02 MinioShellInstall.sh

🔍 查看帮助

执行 bash MinioShellInstall.sh -h 查看脚本使用说明

[root@huge minio]# bash MinioShellInstall.sh -h

             ██████   ██████ █████ ██████   █████ █████    ███████   
            ░░██████ ██████ ░░███ ░░██████ ░░███ ░░███   ███░░░░░███ 
             ░███░█████░███  ░███  ░███░███ ░███  ░███  ███     ░░███
             ░███░░███ ░███  ░███  ░███░░███░███  ░███ ░███      ░███
             ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███ ░███      ░███
             ░███      ░███  ░███  ░███  ░░█████  ░███ ░░███     ███ 
             █████     █████ █████ █████  ░░█████ █████ ░░░███████░  
            ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░    ░░░░░░░    

注意:本脚本仅用于新服务器上实施部署使用,若需要在已运行的服务器主机上执行,务必确保数据安全,以免发生数据丢失或者损坏,造成不可挽回的损失!!!                                                                                  

用法: MinioShellInstall.sh [选项] 对象 { 命令 | help }                                                                                  

参数说明:                                                                                       

-ou                  [必填] 操作用户名,用户配置SSH互信,必须是root用户或者配置sudo免密的用户               
-oup                 [必填] 操作用户对应的密码,用户配置SSH互信                                                   
-sp                  [可选] SSH端口号,不传默认为22,若修改过则必须填写修改后的实际端口号                                                   
-mip                 [必填] 安装主路径                                                       
-mu                  [必填] minio用户名                                                        
-mp                  [必填] minio密码                                                           
-ip                  [必填] 集群节点IP,多个以逗号隔开,例如:-ip 192.168.80.81,192.168.80.82,192.168.80.83,或 -ip 192.168.80.{81..83}                                                   
-vip                 [可选] 虚拟IP,集群模式必填,用于配置 keepalived                                                   

单机模式命令示例:                                                                                  

bash MinioShellInstall.sh \
  -mip "/dhm" `# 安装主目录`\
  -mu OppleSie_dev `# minio用户名`\
  -mp 'uXnr7j3ydMGlke' `# minio密码`
                                                                                    

集群模式命令示例:                                                                                  

bash MinioShellInstall.sh \
  -ou root `# 操作用户名`\
  -oup 'admin' `# 操作用户对应的密码`\
  -mip "/dhm" `# 安装主目录`\
  -mu OppleSie_dev `# minio用户名`\
  -mp 'uXnr7j3ydMGlke' `# minio密码`\
  -ip "192.168.80.{81..83}" `# 集群节点IP`\
  -vip "192.168.80.88" `# 虚拟IP`

🚀 单机版安装

根据脚本参数说明,执行下面命令,安装Minio单机版。执行脚本之后有个模式确认,输入 si 即可开始单机安装

安装成功之后,会打印管理命令以及账号信息

[root@huge minio]# bash MinioShellInstall.sh \
>   -mip "/dhm" `# 安装主目录`\
>   -mu OppleSie_dev `# minio用户名`\
>   -mp 'uXnr7j3ydMGlke' `# minio密码`

             ██████   ██████ █████ ██████   █████ █████    ███████   
            ░░██████ ██████ ░░███ ░░██████ ░░███ ░░███   ███░░░░░███ 
             ░███░█████░███  ░███  ░███░███ ░███  ░███  ███     ░░███
             ░███░░███ ░███  ░███  ░███░░███░███  ░███ ░███      ░███
             ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███ ░███      ░███
             ░███      ░███  ░███  ░███  ░░█████  ░███ ░░███     ███ 
             █████     █████ █████ █████  ░░█████ █████ ░░░███████░  
            ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░    ░░░░░░░    

注意:本脚本仅用于新服务器上实施部署使用,若需要在已运行的服务器主机上执行,务必确保数据安全,以免发生数据丢失或者损坏,造成不可挽回的损失!!!                                                                                  

请选择安装模式 [单机(si)/集群(cl)] : si

Minio开始安装,详细安装过程可查看日志: tail -2000f /soft/minio/print_shell_install_20251130190543.log                                                                                  

正在进行安装前检查,请稍等......                                                                                  

校验Minio安装包是否上传......已完成 (耗时: 1)
安装Minio单机版......已完成 (耗时: 7)

恭喜!Minio 一键安装完成(耗时: 8)。请使用以下地址访问:                                                                                  

==============================================
        启动服务:systemctl start minio
        重启服务:systemctl restart minio
        停止服务:systemctl stop minio
        Web访问地址:192.168.80.12:19901
        API调用地址:192.168.80.12:19900
        用户:OppleSie_dev
        密码:uXnr7j3ydMGlke
==============================================     

安装过程中,可以新打开一个窗口,执行上面的命令,查看实时安装日志,此处就不展示详细安装日志了

[root@minio minio]# tail -2000f /soft/minio/print_shell_install_20251130190543.log

🚀 集群安装

1)

2)根据脚本参数说明,执行下面命令,安装Redis集群。执行脚本之后有个模式确认,输入 cl 即可开始集群安装

3)执行前注意一定要根据上面的参数说明,将示例中的参数信息改为,一定不要直接复制粘贴就直接执行

[root@huge ~]# df -h
文件系统                 容量  已用  可用 已用% 挂载点
devtmpfs                 3.9G     0  3.9G    0% /dev
tmpfs                    3.9G     0  3.9G    0% /dev/shm
tmpfs                    3.9G   13M  3.9G    1% /run
tmpfs                    3.9G     0  3.9G    0% /sys/fs/cgroup
/dev/mapper/centos-root  190G  4.0G  186G    3% /
/dev/sda1                2.0G  172M  1.9G    9% /boot
tmpfs                    797M  8.0K  797M    1% /run/user/42
tmpfs                    797M     0  797M    0% /run/user/0
/dev/mapper/minio-data    20G   45M   19G    1% /dhm  # 数据所在目录
[root@huge minio]# bash MinioShellInstall.sh \
>   -ou root `# 操作用户名`\
>   -oup 'admin' `# 操作用户对应的密码`\
>   -mip "/dhm" `# 安装主目录`\
>   -mu OppleSie_dev `# minio用户名`\
>   -mp 'uXnr7j3ydMGlke' `# minio密码`\
>   -ip "192.168.80.{81..83}" `# 集群节点IP`\
>   -vip "192.168.80.88" `# 虚拟IP`

             ██████   ██████ █████ ██████   █████ █████    ███████   
            ░░██████ ██████ ░░███ ░░██████ ░░███ ░░███   ███░░░░░███ 
             ░███░█████░███  ░███  ░███░███ ░███  ░███  ███     ░░███
             ░███░░███ ░███  ░███  ░███░░███░███  ░███ ░███      ░███
             ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███ ░███      ░███
             ░███      ░███  ░███  ░███  ░░█████  ░███ ░░███     ███ 
             █████     █████ █████ █████  ░░█████ █████ ░░░███████░  
            ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░    ░░░░░░░    

注意:本脚本仅用于新服务器上实施部署使用,若需要在已运行的服务器主机上执行,务必确保数据安全,以免发生数据丢失或者损坏,造成不可挽回的损失!!!                                                                                  

请选择安装模式 [单机(si)/集群(cl)] : cl

Minio开始安装,详细安装过程可查看日志: tail -2000f /soft/minio/print_shell_install_20251130191820.log                                                                                  

正在进行安装前检查,请稍等......                                                                                  

校验Minio安装包是否上传......已完成 (耗时: 1)
校验数据目录是否单独挂载......已完成 (耗时: 1)
校验vip不能已被占用......已完成 (耗时: 2)
配置SSH互信......已完成 (耗时: 5)
集群节点初始化配置......已完成 (耗时: 21)
解压Minio安装包......已完成 (耗时: 3)
安装Minio......已完成 (耗时: 2)
安装nginx......已完成 (耗时: 9)
安装 keepalived......已完成 (耗时: 37)

恭喜!Minio 一键安装完成(耗时: 81)。请使用以下地址访问:                                                                                  

==============================================
        启动服务:systemctl start minio
        重启服务:systemctl restart minio
        停止服务:systemctl stop minio
        Web访问地址:192.168.80.88:19901
        API调用地址:192.168.80.88:19900
        用户:OppleSie_dev
        密码:uXnr7j3ydMGlke
==============================================         

安装过程中,可以新打开一个窗口,执行上面的命令,查看实时安装日志,此处就不展示详细安装日志了

[root@minio01 minio]# tail -2000f /soft/minio/print_shell_install_20251130191820.log

🔌 连接测试

打开浏览器,输入上面账号信息进行连接

Web访问地址:192.168.80.88:19901
API调用地址:192.168.80.88:19900
用户:OppleSie_dev
密码:uXnr7j3ydMGlke
最近更新 3/19/2026, 9:06:05 AM