如何在 Linux 虚拟机中使用 Docker 快速搭建 MinIO 对象存储并配置开机自启
前言
MinIO 是一个基于 Go 语言编写的高性能、兼容 Amazon S3 API 的开源对象存储服务。它非常适合用于存储非结构化数据,比如图片、视频、日志文件,同时也经常被用作 Milvus 等向量数据库的底层存储组件。
本文将详细介绍如何在 Linux 虚拟机环境中,通过 Docker 快速拉取并部署 MinIO,并配置其开机自动重启,确保服务的高可用性。
一、环境准备
- 操作系统:Linux (本文以 CentOS/RHEL 环境为例)
- 容器引擎:Docker (请确保已安装并启动)
- 虚拟机 IP:
192.168.52.128(请替换为你自己的实际 IP) - 使用的镜像:
milvusdb/minio:RELEASE.2024-12-18T13-15-44Z(基于 Red Hat UBI 9 Micro 构建,体积小巧且安全)
二、操作步骤
1. 拉取 MinIO 镜像
在终端中执行以下命令拉取指定版本的镜像:
docker pull milvusdb/minio:RELEASE.2024-12-18T13-15-44Z
2. 创建数据持久化目录
为了防止容器重启或删除后数据丢失,我们需要将容器内的数据目录映射到宿主机上。
# 创建宿主机上的数据存储目录
mkdir -p /root/minio/data
3. 启动 MinIO 容器
使用 docker run 命令启动容器。MinIO 默认需要暴露两个端口:
9000:API 端口(供应用程序通过 S3 协议调用)9001:Web 控制台端口(供管理员在浏览器访问)
执行以下命令启动:
docker run -d \
--name minio \
-p 9000:9000 \
-p 9001:9001 \
-v /root/minio/data:/data \
-e "MINIO_ROOT_USER=minioadmin" \
-e "MINIO_ROOT_PASSWORD=minioadmin" \
milvusdb/minio:RELEASE.2024-12-18T13-15-44Z server /data --console-address ":9001"
参数说明:
-d:后台运行容器。--name minio:为容器命名为minio。-p:端口映射,格式为宿主机端口:容器端口。-v:目录挂载,将宿主机的/root/minio/data挂载到容器内的/data。-e:设置环境变量,这里设置了默认的登录账号 (minioadmin) 和密码 (minioadmin)。--console-address ":9001":指定 Web 控制台的监听端口。
4. 验证容器运行状态
执行以下命令查看容器是否成功启动:
docker ps
如果看到 minio 容器的状态为 Up,且端口映射包含 0.0.0.0:9000-9001->9000-9001/tcp,则说明启动成功。
三、访问与使用
1. 访问 Web 控制台
打开浏览器,访问:http://192.168.52.128:9001
输入前面设置的账号密码(minioadmin / minioadmin)即可登录 MinIO 的管理界面,进行创建 Bucket、上传文件等操作。
2. 验证 API 端口
你可以通过健康检查接口验证 API 服务是否正常:
curl http://127.0.0.1:9000/minio/health/live
如果返回 OK,说明服务运转正常。
四、高阶配置:设置容器开机自启
为了保证虚拟机重启后 MinIO 能够自动恢复运行,我们需要为其配置 Docker 的重启策略。
1. 配置 Docker 服务自启
首先,确保 Docker 引擎本身在虚拟机开机时会自动启动:
systemctl enable docker
2. 配置 MinIO 容器自启
通常我们会在 docker run 时加上 --restart=always 参数。但如果是已经运行中的容器,可以使用 docker update 命令动态修改:
docker update --restart=always minio
💡 踩坑记录:No such container 报错
在实操过程中,你可能遇到执行上述命令时报错 Error response from daemon: No such container: minio。
这通常是因为 Docker 守护进程在解析容器名称时出现了短暂的异常,或者名称中包含了不可见字符。
解决方法:
绕过容器名称,直接使用容器的 短 ID 进行更新。先通过 docker ps 查看到 MinIO 的 CONTAINER ID(例如 3d6ae904ea82),然后取其前几位执行:
docker update --restart=always 3d6ae
验证策略是否生效:
docker inspect -f '{{.HostConfig.RestartPolicy.Name}}' 3d6ae
如果输出 always,则配置成功。
总结
通过以上步骤,你已经成功在虚拟机中部署了一个支持数据持久化、且具备开机自启能力的 MinIO 对象存储服务。在实际生产环境中,建议将默认的账号密码修改为复杂度较高的字符串,并配合 Nginx 反向代理配置 HTTPS 证书,以保障数据的安全传输。

浙公网安备 33010602011771号