Linux(CentOS7)安装MinIO 2024稳定版
哈喽~ 很多小伙伴在Linux上装MinIO总踩坑,要么启动失败、要么访问不了控制台,要么不知道怎么设置持久化,新手全程摸不着头脑。
今天这份教程,只讲MinIO安装,步骤清晰、命令可直接复制,全程无冗余、无多余内容,新手也能一步到位,建议收藏备用!
本文以 CentOS 7.x 为例,安装 MinIO 2024 稳定版(最常用、兼容性最好),包含启动、开机自启、端口开放、控制台访问,所有命令复制粘贴即可执行,无需手动输入,全程避坑!
一、前期准备(2个必做前提,缺一不可)
MinIO安装简单,无需复杂依赖,只需检查旧版本、创建数据存储目录,两步搞定准备工作:
1.1 检查并卸载旧版本MinIO(无则跳过)
执行检查命令,查看是否已安装MinIO(避免版本冲突):
# 查看MinIO进程(有进程说明已安装)ps -ef | grep minio# 查看MinIO安装目录(若有,记录目录便于删除)find / -name minio
若有旧版本,先停止进程,再删除安装文件和数据目录(替换为你的实际目录):
# 停止MinIO进程(进程ID通过上面ps命令获取)kill -9 进程ID# 删除MinIO安装文件(示例)rm -rf /usr/local/minio# 删除MinIO数据目录(示例,谨慎操作,避免误删数据)rm -rf /data/minio
1.2 创建MinIO数据存储目录(必做)
MinIO需要专门的目录存储文件数据,建议创建在/data目录下(空间充足,便于管理),执行命令:
# 创建数据目录(可自定义路径,后续需对应修改)mkdir -p /data/minio# 赋予目录读写权限(避免启动报错)chmod -R 777 /data/minio
✅ 提示:路径可自定义(比如 /home/minio/data),后续启动命令中对应修改即可,建议保持默认路径,减少出错。
二、下载并安装MinIO(核心步骤,2步搞定)
采用官方二进制文件安装(最稳定、最快,无需编译,新手首选),步骤简单,全程复制命令即可:
2.1 下载MinIO二进制文件
进入/usr/local目录(推荐安装目录,便于全局调用),下载官方稳定版MinIO:
cd /usr/local# 下载MinIO 2024稳定版(官方地址,速度稳定)wget https://dl.min.io/server/minio/release/linux-amd64/minio
2.2 赋予执行权限,完成安装
下载完成后,赋予MinIO文件执行权限(否则无法启动),执行命令:
✅ 提示:执行后无任何输出,即为安装成功,下一步直接启动MinIO即可。
三、启动MinIO(核心步骤,两种启动方式可选)
MinIO有两种启动方式:临时启动(测试用,重启终端失效)和后台启动(推荐,长期使用),新手直接选后台启动即可。
3.1 后台启动MinIO(推荐,永久生效)
执行以下命令,后台启动MinIO,指定数据目录和控制台端口(默认9000端口):
# 后台启动,指定数据目录和端口(直接复制,无需修改,数据目录与前面一致)nohup /usr/local/minio server /data/minio --console-address ":9001"
🔍 关键说明: 1. nohup + & :实现后台启动,关闭终端后MinIO依然运行; 2. /data/minio :前面创建的数据存储目录,不可写错; 3. --console-address ":9001" :指定控制台端口为9001(避免与其他软件端口冲突,可自定义)。
3.2 临时启动MinIO(测试用)
若只是测试安装是否成功,可执行临时启动命令(关闭终端即停止):
/usr/local/minio server /data/minio --console-address ":9001"
3.3 验证启动是否成功
执行以下命令,查看MinIO进程(有进程说明启动正常):
也可查看启动日志(无报错即正常):
✅ 启动成功提示:日志中出现「Console: http://xxx.xxx.xxx.xxx:9001」,即为启动成功。
四、设置MinIO开机自启(关键!避免重启失效)
默认情况下,服务器重启后,MinIO会停止运行,需设置开机自启,步骤如下,全程复制命令即可:
4.1 新建MinIO系统服务文件
vi /etc/systemd/system/minio.service
4.2 粘贴服务配置(直接复制,无需修改)
进入编辑模式后,粘贴以下内容,按「Esc」+「:wq」保存退出(注意数据目录和端口与前面一致):
[Unit]Description=MinIO ServerAfter=network.target[Service]Type=forking# 启动命令(数据目录、端口与前面启动命令一致)ExecStart=/usr/local/minio server /data/minio --console-address ":9001"# 停止命令ExecStop=pkill minioRestart=alwaysUser=root[Install]WantedBy=multi-user.target
4.3 生效开机自启配置
依次执行以下3条命令,设置完成后,服务器重启,MinIO会自动启动:
# 重新加载系统服务systemctl daemon-reload# 设置开机自启systemctl enable minio# 查看MinIO运行状态(确认启动正常)systemctl status minio
出现「active (running)」字样,说明开机自启配置生效,MinIO运行正常 ✅
五、开放MinIO相关端口(访问+文件上传必做)
MinIO需要开放两个核心端口,缺一不可,否则无法访问控制台、无法上传文件,执行命令开放:
1. 9000端口(核心必开):用于文件存储、API交互,文件上传/下载依赖此端口; 2. 9001端口(控制台必开):用于浏览器访问MinIO控制台,管理文件和配置。
# 开放9000、9001端口(直接复制,一次性开放)firewall-cmd --add-port=9000/tcp --permanentfirewall-cmd --add-port=9001/tcp --permanentfirewall-cmd --reload
✅ 提示:若自定义了控制台端口(不是9001),替换命令中的9001为自定义端口即可。
六、访问MinIO控制台(验证安装成功)
1. 浏览器访问地址(替换为你的服务器IP,端口为9001):
2. 登录账号密码(默认账号密码,首次登录必须修改):
账号:minioadmin密码:minioadmin
3. 首次登录操作:
- 登录后,系统会自动弹出「修改默认密码」弹窗(安全提醒,必须修改,否则无法正常使用控制台),详细步骤如下:
3.1 控制台修改默认密码(推荐,简单直观)
① 弹窗中输入信息(按提示填写,密码需满足复杂度要求):
- Current Password(当前密码):minioadmin(默认密码)
- New Password(新密码):设置自定义密码(建议8位以上,包含大小写+数字,避免简单密码)
- Confirm Password(确认新密码):重复输入上面设置的新密码
② 填写完成后,点击「Save」按钮,提示「Password updated successfully」即为修改成功;
③ 修改成功后,系统会自动退出登录,重新用「新账号(仍为minioadmin)+ 新密码」登录即可。
3.2 命令行修改密码(备用,适合无界面操作)
若控制台无法弹出弹窗,可通过命令行修改,步骤如下(直接复制命令):
# 1. 停止MinIO服务systemctl stop minio# 2. 用新密码启动MinIO(替换为你的新密码,仅执行一次)nohup /usr/local/minio server /data/minio --console-address ":9001" --console-minio-username minioadmin --console-minio-password 你的新密码 &# 3. 重启MinIO服务,使密码生效systemctl restart minio
⚠️ 注意:
1. 密码建议设置复杂一些(如MinIO@2024),避免被暴力破解;
2. 修改密码后,务必牢记新密码,后续登录控制台、通过API操作MinIO都需要用到;
3. 若忘记新密码,可停止MinIO服务,删除数据目录下的配置文件(rm -rf /data/minio/.minio.sys),重启后恢复默认密码(不推荐,会丢失所有数据)。
- 密码修改完成后,点击「Create Bucket」创建存储桶(相当于文件夹),即可开始上传文件,验证MinIO正常使用。
七、MinIO常用命令(收藏备用)
# 启动MinIOsystemctl start minio# 停止MinIOsystemctl stop minio# 重启MinIO(配置修改后需执行)systemctl restart minio# 查看MinIO运行状态systemctl status minio# 查看MinIO启动日志cat /usr/local/nohup.out# 查看MinIO进程ps -ef | grep minio
八、常见问题排查(新手必看)
1. 启动失败:检查数据目录是否创建、权限是否为777,或端口是否被占用(执行「netstat -tlnp | grep 9000」排查);
2. 控制台访问不了:检查9001端口是否开放、服务器IP是否正确、MinIO是否正常运行;
3. 开机自启失效:检查minio.service服务文件内容是否正确,重新执行daemon-reload和enable命令;
4. 无法上传文件:检查9000端口是否开放、存储桶是否创建,或数据目录权限是否足够;
5. 启动报错「no such file or directory」:检查MinIO安装路径、数据目录路径是否写错。
💡 温馨提示:所有命令直接复制粘贴,不要手动输入(避免空格、符号错误),全程按照步骤来,基本不会踩坑~ MinIO默认是单机模式,适合开发/测试,生产环境可配置集群。
如果需要配置MinIO集群、修改默认端口,或者设置文件访问权限,评论区留言即可获取对应教程!