Docker 安裝 Qdrant 向量庫(kù)的教程文章，適用于 Windows 環(huán)境下通過(guò) Docker 部署 Qdrant 服務(wù)。

引言

在 Windows 系統(tǒng)上直接安裝 Qdrant 服務(wù)環(huán)境時(shí)，可能會(huì)因?yàn)橐蕾?lài)或權(quán)限等問(wèn)題導(dǎo)致安裝失敗。這時(shí)可以借助 Docker 容器來(lái)部署 Qdrant 服務(wù)，只需下載并運(yùn)行官方鏡像，即可快速啟動(dòng)向量數(shù)據(jù)庫(kù)。本文將從 Docker 環(huán)境配置開(kāi)始，帶你一步步完成 Qdrant 服務(wù)的部署，并在飛算 JavaAI 中配置向量庫(kù)地址，實(shí)現(xiàn)智能分析功能。

一、前提條件

• 已在 Windows 上安裝并啟動(dòng) Docker 服務(wù)。
• 對(duì)容器有網(wǎng)絡(luò)訪問(wèn)需求，能拉取官方鏡像或已準(zhǔn)備好離線安裝包。

二、配置 Docker 鏡像加速器

1.打開(kāi) C:\ProgramData\docker\config\daemon.json。若不存在，請(qǐng)手動(dòng)創(chuàng)建該文件夾及文件。

2.編輯 daemon.json，添加常用鏡像源列表并啟用 BuildKit：

{
  "registry-mirrors": [
    "https://dhub.kubesre.xyz",
    "https://docker.m.daocloud.io",
    "https://docker.registry.cyou",
    "https://docker-cf.registry.cyou",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://mirror.aliyuncs.com",
    "https://dockerproxy.com",
    "https://mirror.baidubce.com",
    "https://docker.m.daocloud.io",
    "https://docker.nju.edu.cn",
    "https://docker.mirrors.sjtug.sjtu.edu.cn",
    "https://docker.mirrors.ustc.edu.cn",
    "https://mirror.iscas.ac.cn",
    "https://docker.rainbond.cc",
    "https://docker.m.daocloud.io/",
    "https://huecker.io/",
    "https://dockerhub.timeweb.cloud",
    "https://noohub.ru/",
    "https://dockerproxy.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.nju.edu.cn",
    "https://xx4bwyg2.mirror.aliyuncs.com",
    "http://f1361db2.m.daocloud.io",
    "https://registry.docker-cn.com",
    "http://hub-mirror.c.163.com",
    "http://docker-mirror.aigc2d.com",
    "http://hub.rat.dev",
    "http://docker.1ms.run",
    "http://docker.1panel.live",
    "https://docker.xunyuan.me"
  ],
  "experimental": true,
  "features": {
    "buildkit": true
  }
}

3.保存后，通過(guò) PowerShell（以管理員身份）或命令提示符重啟 Docker 服務(wù)：

Restart-Service docker

三、下載 Qdrant 鏡像

注意：務(wù)必使用 1.14.1 版本，否則可能導(dǎo)致與飛算 JavaAI 分析插件不兼容。

docker pull qdrant/qdrant:1.14.1

如果服務(wù)器無(wú)法訪問(wèn)外網(wǎng)，你可以在可聯(lián)網(wǎng)的機(jī)器上執(zhí)行以上命令，然后將鏡像導(dǎo)出并移至目標(biāo)機(jī)器（詳見(jiàn)后文“離線安裝”章節(jié)）。

四、驗(yàn)證鏡像

docker images | grep qdrant

你會(huì)看到已下載的 qdrant/qdrant 鏡像及其版本號(hào)。

五、運(yùn)行容器并映射端口

Qdrant 服務(wù)提供兩種端口：

• HTTP/Web UI：容器內(nèi)固定為 6333，需映射到宿主機(jī)（本文示例映射到 6335）
• gRPC：容器內(nèi)固定為 6334，需映射到宿主機(jī)（本文示例映射到 6356）

命令說(shuō)明

• -d：后臺(tái)運(yùn)行
• -p <宿主機(jī)端口>:<容器端口>：端口映射
• qdrant/qdrant:1.14.1：指定鏡像及版本

啟動(dòng) Web UI：

docker run -d -p 6335:6333 qdrant/qdrant:1.14.1

啟動(dòng) gRPC 服務(wù)：

docker run -d -p 6356:6334 qdrant/qdrant:1.14.1

如果想將兩者合并在一個(gè)命令中啟動(dòng)（同一個(gè)容器同時(shí)映射兩個(gè)端口），可執(zhí)行：

docker run -d -p 6335:6333 -p 6356:6334 qdrant/qdrant:1.14.1

六、檢查容器狀態(tài)

docker ps | grep qdrant

確認(rèn)容器已啟動(dòng)并處于運(yùn)行狀態(tài)。

七、查看日志

docker logs -f <容器ID>

若日志中出現(xiàn) Qdrant server has been successfully started 等字樣，表示服務(wù)已正常運(yùn)行。

八、訪問(wèn) Web 管理界面

在瀏覽器中輸入：http://<宿主機(jī)IP>:6335/dashboard#

即可打開(kāi) Qdrant Dashboard，監(jiān)控與管理向量庫(kù)。

提醒：此處端口須與第 5 步中映射的宿主機(jī)端口一致。

九、飛算 JavaAI 中配置向量庫(kù)

1.打開(kāi)飛算 JavaAI 客戶端，進(jìn)入 高級(jí)設(shè)置。

2.找到 向量庫(kù)地址，填寫(xiě)：<宿主機(jī)IP>:6356

其中 6356 為第 5 步映射的 gRPC 端口。

3.應(yīng)用設(shè)置并啟動(dòng) 智能分析 功能。

十、離線環(huán)境下的鏡像加載

當(dāng)目標(biāo)服務(wù)器無(wú)法訪問(wèn) Docker Hub 時(shí)，可參考以下步驟進(jìn)行離線安裝：

1.在可聯(lián)網(wǎng)機(jī)器上執(zhí)行：

docker pull qdrant/qdrant:1.14.1
docker save -o qdrant_1.14.1.tar.gz qdrant/qdrant:1.14.1

2.將 qdrant_1.14.1.tar.gz 傳輸?shù)侥繕?biāo)服務(wù)器后：

docker load -i qdrant_1.14.1.tar.gz

3.然后即可從第 4 步開(kāi)始，按照相同命令啟動(dòng)容器。

結(jié)語(yǔ)

通過(guò)上述步驟，你已在 Windows 上使用 Docker 成功部署了 Qdrant 向量庫(kù)，并在飛算 JavaAI 中完成了向量數(shù)據(jù)庫(kù)的配置。后續(xù)可根據(jù)業(yè)務(wù)需求，自行調(diào)整資源限制、數(shù)據(jù)持久化掛載卷等高級(jí)配置，進(jìn)一步優(yōu)化向量搜索性能與穩(wěn)定性。

以上就是Windows下使用Docker部署Qdrant向量庫(kù)鏡像服務(wù)詳細(xì)教學(xué)的詳細(xì)內(nèi)容，更多關(guān)于Docker部署Qdrant的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論