Windows下使用Docker部署Qdrant向量库镜像服务详细教学

更新时间：2025年06月27日 09:41:13 作者：猫头虎

在 Windows 系统上直接安装 Qdrant 服务环境时,可能会因为依赖或权限等问题导致安装失败,这时可以借助 Docker 容器来部署 Qdrant 服务,下面就跟随小编一起来看看具体操作步骤吧

引言

在 Windows 系统上直接安装 Qdrant 服务环境时，可能会因为依赖或权限等问题导致安装失败。这时可以借助 Docker 容器来部署 Qdrant 服务，只需下载并运行官方镜像，即可快速启动向量数据库。本文将从 Docker 环境配置开始，带你一步步完成 Qdrant 服务的部署，并在飞算 JavaAI 中配置向量库地址，实现智能分析功能。

一、前提条件

已在 Windows 上安装并启动 Docker 服务。
对容器有网络访问需求，能拉取官方镜像或已准备好离线安装包。

二、配置 Docker 镜像加速器

1.打开 C:\ProgramData\docker\config\daemon.json。若不存在，请手动创建该文件夹及文件。

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.保存后，通过 PowerShell（以管理员身份）或命令提示符重启 Docker 服务：

Restart-Service docker

三、下载 Qdrant 镜像

注意：务必使用 1.14.1 版本，否则可能导致与飞算 JavaAI 分析插件不兼容。

docker pull qdrant/qdrant:1.14.1

如果服务器无法访问外网，你可以在可联网的机器上执行以上命令，然后将镜像导出并移至目标机器（详见后文“离线安装”章节）。

四、验证镜像

docker images | grep qdrant

你会看到已下载的 qdrant/qdrant 镜像及其版本号。

五、运行容器并映射端口

Qdrant 服务提供两种端口：

HTTP/Web UI：容器内固定为 6333，需映射到宿主机（本文示例映射到 6335）
gRPC：容器内固定为 6334，需映射到宿主机（本文示例映射到 6356）

命令说明

-d：后台运行
-p <宿主机端口>:<容器端口>：端口映射
qdrant/qdrant:1.14.1：指定镜像及版本

启动 Web UI：

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

启动 gRPC 服务：

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

如果想将两者合并在一个命令中启动（同一个容器同时映射两个端口），可执行：

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

六、检查容器状态

docker ps | grep qdrant

确认容器已启动并处于运行状态。

七、查看日志

docker logs -f <容器ID>

若日志中出现 Qdrant server has been successfully started 等字样，表示服务已正常运行。

八、访问 Web 管理界面

在浏览器中输入：http://<宿主机IP>:6335/dashboard#

即可打开 Qdrant Dashboard，监控与管理向量库。

提醒：此处端口须与第 5 步中映射的宿主机端口一致。

九、飞算 JavaAI 中配置向量库

1.打开飞算 JavaAI 客户端，进入 高级设置。

2.找到 向量库地址，填写：<宿主机IP>:6356

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

3.应用设置并启动 智能分析 功能。

十、离线环境下的镜像加载

当目标服务器无法访问 Docker Hub 时，可参考以下步骤进行离线安装：

1.在可联网机器上执行：

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 传输到目标服务器后：

docker load -i qdrant_1.14.1.tar.gz

3.然后即可从第 4 步开始，按照相同命令启动容器。

结语

通过上述步骤，你已在 Windows 上使用 Docker 成功部署了 Qdrant 向量库，并在飞算 JavaAI 中完成了向量数据库的配置。后续可根据业务需求，自行调整资源限制、数据持久化挂载卷等高级配置，进一步优化向量搜索性能与稳定性。

以上就是Windows下使用Docker部署Qdrant向量库镜像服务详细教学的详细内容，更多关于Docker部署Qdrant的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Docker 私有仓库恢复实例详解
这篇文章主要介绍了Docker 私有仓库恢复实例详解的相关资料,这里提供了详细的实现步骤，及注意事项，完成docker私有仓库的恢复，需要的朋友可以参考下
2016-11-11
Docker 教程之Docker Hub详细介绍
这篇文章主要介绍了Docker 教程之Docker Hub详细介绍的相关资料,需要的朋友可以参考下
2016-12-12
docker如何在一个容器内部署多个服务
这篇文章主要介绍了docker如何在一个容器内部署多个服务,思路是这样的首先拿到你的httpd,以及你的springBoot,合并他们的Dockerfile,然后打包,然后启动的时候启动多个端口(httpd的端口和你服务的端口),需要的朋友可以参考下
2024-01-01
Docker容器服务编排利器详解
这篇文章主要介绍了Docker容器服务编排利器,主要包括使用使用Docker Compose必要性及定义及一些Docker Compose应用参考资料，本文给大家介绍的非常详细，需要的朋友可以参考下
2022-07-07
Jenkins构建Docker镜像并推送至Harbor仓库的实现
本文主要介绍了Jenkins构建Docker镜像并推送至Harbor仓库，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-09-09
Docker Buildx镜像压缩的实现
本文主要介绍了Docker Buildx镜像压缩的实现,显著减小镜像体积并提升构建效率,适用于多平台构建、CI/CD流水线等场景,支持多架构并行构建与高效压缩算法,优化存储与传输性能,降低部署成本,感兴趣的可以了解一下
2026-05-05
Docker制作镜像的两种实现方式
本文主要介绍了Docker制作镜像的两种实现方式，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-07-07
Docker中Mysql容器忽略大小写方式
数据迁移中因源库与目标库大小写处理差异导致服务异常,通过Docker构建中间MySQL容器并配置忽略大小写,实现兼容性,此为实践经验,供参考
2025-09-09
https的harbor部署与升级实现过程
文章简要介绍了Harbor的部署与升级流程：包括安装Docker、配置HTTPS、部署Harbor及测试；小版本升级需备份后替换；大版本升级则需额外注意兼容性,同样执行备份、替换和测试操作
2025-09-09
docker将镜像打包为.tar包实现方法
使用tar包格式进行压缩,方便在不同的docker主机之间进行迁移和备份,下面这篇文章主要给大家介绍了关于docker将镜像打包为.tar包的实现方法,需要的朋友可以参考下
2024-07-07