MinIO 安装配置教程（Linux 通用版）

本文最后更新于：2025年8月20日

MinIO 是一个高性能的分布式对象存储系统，简单易用且开源。它兼容亚马逊的 S3 云存储服务，适合存储图片、视频、日志等海量非结构化数据。MinIO 轻量快速，支持私有化部署和弹性扩展，适合企业搭建自己的“云存储”。无论是开发测试还是生产环境，它都能提供稳定、安全的数据存储方案，就像你的私人数据仓库，随存随取，高效可靠。

以下是 MinIO 在 Linux 环境下的安装教程，两种方式任选其一：

方式一：正常安装

一、准备操作

1. MinIO 默认使用 9000 端口，根据自己的操作系统开放端口：

CentOS：

1 2	`firewall-cmd --zone=public --add-port=9000/tcp --permanent firewall-cmd --reload`

Ubuntu/Debian：

1	`ufw allow 9000/tcp`

2. MinIO 有 Web 管理界面，也需要使用端口，这里需要开放 9001 端口：

CentOS：

1 2	`firewall-cmd --zone=public --add-port=9001/tcp --permanent firewall-cmd --reload`

Ubuntu/Debian：

1	`ufw allow 9001/tcp`

3. 由于 MinIO 管理界面默认需要登录，我们可以通过配置环境变量配置管理账号的用户名和密码。这里我将用户名定义为 admin，密码为 12345678（具体环境请以你们实际情况而定，密码长度至少 8 位，生产环境不能使用过于简单的密码！），这里我将数据写入到 .bashrc 文件中，依次执行如下命令：

1
2
3

echo 'export MINIO_ROOT_USER="admin"' >> ~/.bashrc
echo 'export MINIO_ROOT_PASSWORD="12345678"' >> ~/.bashrc
source ~/.bashrc

说明：如果忘记密码，请使用 cat 命令查看 ~/.bashrc 文件即可找回用户名和密码。

二、下载并启动 Minio

1. 下载 minio，执行如下命令：

1	`wget https://dl.minio.org.cn/server/minio/release/linux-amd64/archive/minio.RELEASE.2024-07-10T18-41-49Z`

2. 为下载好的文件重命名：

1	`mv minio.RELEASE.2024-07-10T18-41-49Z minio`

3. 为下载的文件赋予可执行的权限：

1	`chmod 744 minio`

4. 新建一个文件夹，用于存储 MinIO 中的数据：

1	`mkdir -p /opt/minio/storage1`

5. 启动 MinIO，执行如下命令（这里我的主机 IP 地址是 192.168.40.200，具体 IP 地址以你们的为准）：

1	`./minio server --console-address 192.168.40.200:9001 /opt/minio/storage1`

6. 如果控制台出现了如下信息，就说明 MinIO 成功启动：

7. 打开浏览器，在上方输入 http://IP地址:9001 即可打开 MinIO 登陆页面，默认情况下登陆账户名和密码是前面我们配置过的：

8. 此时 MinIO 就可以正常使用了：

9. 如需停止 Minio，只需要到控制台按 CtrlC即可停止服务。

方式二：在Docker上部署

一、准备操作

1. 请确保 Linux 上已经安装了 Docker，需要安装的小伙伴，请根据 Linux 发行版本查看对应的安装教程：

CentOS	Ubuntu/Debian
点我查看	点我查看

2. 上述操作准备完成后，我们需要到 Github 上拉取 Dockerhub 中的镜像，以下是操作教程：点我查看

二、拉取 MinIO 镜像

1. 打开 Dockerhub：点我查看

2. 在上方搜索框中搜索 minio，然后按一下回车：

3. 第一个搜索结果就是 MinIO 的镜像，点击进入：

4. 点击 Tags，在搜索框中搜索 2024，查询结果是 2024 年发布的相关镜像，找到以RELEASE-时间格式的镜像，这里我要拉取的是 RELEASE.2024-12-18T13-15-44Z 版本镜像：

5. 复制 docker pull 命令后面的内容，如下图：

6. 打开 Github 我们 fork 的仓库，找到 images.txt，点击进入：

7. 点击右上角的铅笔按钮开始编辑，将第5步复制的内容粘贴到最后一行，效果图如下，完成后点击 Commit changes：

此时会有一个弹窗提示，点击 Commit Changes：

8. 点击上方的 Actions，此时 Github 正在拉取镜像并推送到阿里云本地，预计需要等待几分钟的时间，期间可以通过刷新页面查看状态：

9. 点击右侧链接，登录到阿里云容器镜像服务（个人版）控制台界面：点我查看

10. 点击左侧的镜像仓库，此时我们就可以看到 Github 成功将镜像数据推送到了阿里云个人镜像仓库：

11. 点击进入 minio 镜像详情页面：

12. 复制第一行命令到命令行并执行，此时会提示输入密码，这个密码就是阿里云镜像仓库的访问凭证：

13. 返回阿里云管理界面，复制如下内容（复制到冒号）到控制台（先不执行）

在命令行的效果图如下：

14. 返回阿里云管理界面，点击左侧镜像版本，鼠标点击一下版本即可显示完整的版本信息，复制版本号：

15. 返回命令行，将上一步版本号信息粘贴到冒号后面，效果图如下：

16. 执行上述命令，拉取镜像，此过程需要1~2分钟时间，请耐心等待：

17. 如果出现如下提示，说明 MinIO 镜像拉取成功！

三、启动 MinIO

1. 使用如下命令查看拉取下来的镜像信息：

1	`docker images`

2. 这里我们需要留意一下 REPOSITORY 和 TAG，一会会用到：

3. 新建一个文件夹用于存储 Minio 数据文件：

1	`mkdir -p /opt/docker/minio/storage`

4. 自行修改如下命令复制如下命令到命令行：

docker run \
   -id \
   -p 9000:9000 \
   -p 9001:9001 \
   --name minio \
   -v /opt/docker/minio/storage:/data \
   -e "MINIO_ROOT_USER=用户名" \
   -e "MINIO_ROOT_PASSWORD=密码" \
   REPOSITORY:TAG server /data --console-address ":9001"

这里我们需要修改：用户名、密码、REPOSITORY、TAG。用户名和密码自行指定，这里我设置用户名为 admin，密码是 admin123。REPOSITORY 和 TAG 来自第2步使用 docker images 中的相关信息进行替换即可，修改后命令的效果图如下：