如何在 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 证书,以保障数据的安全传输。

posted @ 2026-11-18 11:41  小张睡不醒~  阅读(2)  评论(0)    收藏  举报