韩国服务器部署Milvus前要准备哪些依赖,如何验证服务可用?
首次在韩国服务器部署 Milvus,建议先按单机测试或小规模服务的目标准备环境,再使用官方发布包中与 Milvus 版本匹配的 Docker Compose 配置启动。Milvus Standalone 通常还需要 etcd 保存元数据,并需要对象存储保存数据文件;采用官方 Compose 配置时,这些依赖一般会与 Milvus 一起编排。部署前应确认服务器资源、Docker 环境、磁盘空间和访问端口,启动后再分别验证容器状态、健康接口及实际读写查询。

以下以 Linux x86_64 服务器、Docker Compose、Milvus Standalone 为例。韩国机房不会改变 Milvus 的依赖组成,但应确认服务器能够访问所需镜像仓库和软件源;如需远程连接,还要控制防火墙开放范围,避免将内部依赖端口直接暴露到公网。
A5idc数据提供韩国首尔地区的物理服务器资源,覆盖不同CPU、内存、存储及网络线路配置,可作为Milvus Standalone、向量数据库和容器化服务的部署基础。针对向量数据写入、索引构建与查询等业务,品牌可结合业务访问地区、数据规模和程序负载,提供相应的服务器方案,并支持从常规建站资源到更高计算与存储需求的配置组合。
部署前准备
资源与系统条件
单机试运行可将 4 vCPU、8 GB 内存和 SSD 作为起步参考;数据规模、向量维度、并发查询和索引类型都会影响实际资源需求。生产负载较大时,应根据数据量和查询压力单独评估容量,不要把起步配置当作性能保证。
建议准备:
- 受支持的 64 位 Linux 发行版,例如 Ubuntu LTS。
- 可用的 SSD 磁盘空间,并为 Docker 数据目录预留增长余量。
- 具有 sudo 权限的部署账号。
- 能访问 Docker 镜像仓库及 Milvus 发布文件的网络。
- 一个固定的 Milvus 版本,以及与该版本对应的 Compose 配置。
先确认系统架构、磁盘和内存:
uname -m
free -h
df -h
uname -m 应显示 x86_64;若是其他架构,应先核对目标 Milvus 版本及其依赖镜像是否支持,不能直接照搬 x86_64 部署步骤。df -h 用于检查 Docker 数据目录所在文件系统是否有足够空间。
软件依赖与端口规划
部署需要 Docker Engine 和 Docker Compose 插件。先检查是否已安装:
docker --version
docker compose version
两条命令都应返回版本信息。若命令不存在,应按当前 Linux 发行版的官方安装方式安装 Docker Engine 和 Compose 插件,并确认 Docker 服务已启动。不要混用旧版 docker-compose 和新版 docker compose 命令,除非已确认配置兼容。
Milvus 常见访问端口包括:
| 端口 | 用途 | 建议访问范围 |
|---|---|---|
| 19530 | SDK、客户端连接 Milvus | 仅业务服务器或管理网段 |
| 9091 | Milvus 健康检查及管理相关接口 | 本机或受控管理网段 |
| 2379 | etcd 客户端通信 | 仅 Compose 内部网络 |
| 9000、9001 | 对象存储服务接口及控制台 | 仅 Compose 内部网络,确有需要时再单独开放 |
实际映射以下载的 Compose 文件为准。不要因为服务器位于韩国就默认放行所有端口;公网侧通常只需允许受信任的客户端访问 Milvus 服务端口。etcd 和对象存储端口不应直接暴露给公网。
下载并检查部署配置
固定版本并取得官方 Compose 文件
选择一个明确的 Milvus 版本,并使用该版本发布的官方 Standalone Compose 文件。下面以 v2.5.0 展示命令格式;实际部署时,应将版本号替换为计划使用且已核验的版本,避免混用不同版本的配置文件与镜像。
export MILVUS_VERSION=v2.5.0
mkdir -p "$HOME/milvus-deploy"
cd "$HOME/milvus-deploy"
curl -fL \
"https://github.com/milvus-io/milvus/releases/download/${MILVUS_VERSION}/milvus-standalone-docker-compose.yml" \
-o docker-compose.yml
若服务器没有 curl,可使用发行版提供的下载工具。下载失败时,先检查 DNS、出站网络和发布文件版本是否正确,不要改用来源不明的配置文件。
检查文件是否存在并查看实际内容:
test -s docker-compose.yml && echo "Compose 文件已下载"
grep -nE 'image:|ports:|volumes:|etcd|minio|milvus' docker-compose.yml
应能看到 Milvus 及其依赖服务的镜像、端口和数据卷配置。不同发布版本的服务名、镜像标签和配置项可能变化,后续命令以文件中的服务定义为准。
校验配置并拉取镜像
运行配置解析,提前发现 YAML 缩进、变量或 Compose 兼容问题:
docker compose -f docker-compose.yml config
命令成功时会输出解析后的配置;若提示未知字段或缺少变量,应先对照该 Milvus 版本的部署说明处理,不要直接删改不理解的配置项。
启动前拉取镜像:
docker compose -f docker-compose.yml pull
此步骤可能受韩国服务器到镜像仓库的网络状况影响。若拉取失败,先查看报错中的镜像名称、标签及网络错误;不要把依赖镜像替换成未经核验的其他版本。
启动 Milvus Standalone
在配置校验和镜像拉取成功后,启动整组服务:
docker compose -f docker-compose.yml up -d
查看容器状态:
docker compose -f docker-compose.yml ps
预期是 Milvus、etcd、对象存储等所需容器处于 Up 或相应的健康状态。若某个容器持续重启,不要反复执行启动命令掩盖问题,应先查看日志:
docker compose -f docker-compose.yml logs --tail=100
也可以只查看某个服务。服务名需以 Compose 文件为准,例如:
docker compose -f docker-compose.yml config --services
docker compose -f docker-compose.yml logs --tail=100 milvus-standalone
如果配置中的 Milvus 服务不叫 milvus-standalone,将日志命令中的服务名换成 config --services 输出的实际名称。
分层验证服务可用性
检查健康接口和监听端口
先从服务器本机检查 Milvus 健康接口:
curl -i http://127.0.0.1:9091/healthz
健康时通常会返回 HTTP 成功状态及表示正常的响应内容。具体返回文本可能随版本不同而变化,应以 HTTP 状态和对应版本文档为准。若连接被拒绝,检查容器状态、端口映射及启动日志;若本机可访问而远程不可访问,再检查云防火墙、安全组和系统防火墙规则。
检查主机是否在预期端口监听:
ss -lntp | grep -E '19530|9091'
没有输出不一定代表服务未启动:Compose 文件可能只绑定容器内部网络,或将端口绑定到其他地址。应同时检查配置中的 ports 和容器状态,不能仅凭 ss 判断整个服务是否异常。
使用 Python 验证连接、写入和查询
健康接口只能说明服务端具备基本响应能力;还应使用客户端完成一次实际写入和查询。建议在独立虚拟环境中安装与 Milvus 服务版本兼容的 pymilvus,并参考所用版本的兼容说明选择客户端版本。
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install pymilvus
将以下内容保存为 verify_milvus.py。示例使用本机地址和临时集合名;若在另一台机器运行,应将地址换成韩国服务器可达的 IP 或域名,并确保防火墙只允许该客户端来源访问。
from pymilvus import MilvusClient
client = MilvusClient(uri="http://127.0.0.1:19530")
collection_name = "milvus_deploy_check"
if client.has_collection(collection_name):
client.drop_collection(collection_name)
client.create_collection(
collection_name=collection_name,
dimension=4,
)
client.insert(
collection_name=collection_name,
data=[
{"id": 1, "vector": [0.1, 0.2, 0.3, 0.4], "label": "check"}
],
)
result = client.search(
collection_name=collection_name,
data=[[0.1, 0.2, 0.3, 0.4]],
limit=1,
output_fields=["label"],
)
print(result)
client.drop_collection(collection_name)
client.close()
运行验证:
python verify_milvus.py
成功时,程序应完成连接、创建集合、插入数据、搜索并输出命中结果,最后删除本次测试集合。该脚本会删除同名集合,因此应只在新部署的测试环境运行,或先确认该集合没有需要保留的数据。若客户端报连接错误,优先核对地址、端口映射和防火墙;若连接成功但建集合或写入失败,查看 Milvus、etcd 和对象存储日志,确认依赖服务均正常。
常见失败与处理顺序
| 现象 | 优先检查 | 判断与处理 |
|---|---|---|
| 镜像拉取超时或失败 | 出站网络、DNS、镜像标签 | 确认服务器可访问镜像仓库,核对 Compose 中镜像标签是否存在;不要随意更换标签 |
| Milvus 容器反复重启 | Milvus 与依赖服务日志、内存 | 检查 etcd、对象存储是否已启动,查看是否出现内存不足、数据目录权限或配置错误 |
| 健康接口无法连接 | 容器状态、9091 映射 | 确认服务已就绪且配置映射了该端口;按日志判断是启动尚未完成还是服务异常 |
| 本机可连接,远程客户端超时 | 端口映射、防火墙、安全组、路由 | 检查 19530 是否绑定到可达地址,并仅对业务来源开放;不要公开内部依赖端口 |
| 客户端版本不兼容或调用失败 | Milvus 与 PyMilvus 版本、SDK API | 按对应版本兼容说明调整客户端版本和调用方式,再执行连接与读写验证 |
韩国机房与客户端所在地之间的网络质量会影响远程连接时延;服务端本机验证成功,并不等于跨地域客户端网络也已验证。远程验收应从实际业务来源发起连接测试。
结果检查与回滚
验收前逐项确认:
- Docker Engine 和 Compose 命令可正常执行,配置文件通过
docker compose config校验。 - Milvus、etcd、对象存储等必需容器处于运行状态,日志没有持续重启或依赖连接失败信息。
- 本机健康接口返回正常,Milvus 客户端能够完成创建集合、写入、搜索和清理测试。
- 远程访问仅对需要的客户端来源开放;etcd 和对象存储端口未暴露到公网。
- 数据卷和磁盘目录位置明确,已确认后续数据保留策略。
如果部署验证失败,需要停止服务,可在部署目录执行:
docker compose -f docker-compose.yml down
该命令会停止并移除 Compose 容器和网络,通常保留命名数据卷;是否保留应以配置文件中的卷定义为准。不要把 down 与 down -v 混用:-v 会删除 Compose 管理的数据卷,可能造成 Milvus 数据、元数据及对象存储文件丢失。只有确认这是可丢弃的全新测试环境,或已备份并验证恢复方案后,才考虑删除数据卷。
回滚检查应确认容器已停止、服务端口不再监听,并核实数据卷仍按预期保留。若需要恢复部署,先修正配置或资源问题,再重新执行配置校验、启动和客户端读写验证。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8987.html



