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

 更新时间:2025年06月27日 09:41:13   作者:猫头虎  
在 Windows 系统上直接安装 Qdrant 服务环境时,可能会因为依赖或权限等问题导致安装失败,这时可以借助 Docker 容器来部署 Qdrant 服务,下面就跟随小编一起来看看具体操作步骤吧

Docker 安装 Qdrant 向量库的教程文章,适用于 Windows 环境下通过 Docker 部署 Qdrant 服务。

引言

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

一、前提条件

二、配置 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的网络模式,包括bridge、none、container、host和用户自定义网络,并详细说明了docker0网络的特点和自定义网络的创建
    2025-01-01
  • 在Ubuntu 16.04上用Docker Swarm和DigitalOcean创建一个Docker容器集群的方法

    在Ubuntu 16.04上用Docker Swarm和DigitalOcean创建一个Docker容器集群的方法

    这篇文章主要介绍了在Ubuntu 16.04上用Docker Swarm和DigitalOcean创建一个Docker容器集群的方法,需要的的朋友参考下吧
    2017-01-01
  • Docker Registry搭建与使用详解

    Docker Registry搭建与使用详解

    这篇文章主要介绍了Docker Registry搭建与使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-05-05
  • docker官方mysql镜像自定义配置详解

    docker官方mysql镜像自定义配置详解

    这篇文章主要介绍了docker官方mysql镜像自定义配置详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-11-11
  • Docker 阿里云镜像仓库CR使用小结

    Docker 阿里云镜像仓库CR使用小结

    阿里云提供了免费的容器镜像服务,更重要的是支持公开和私有仓库,本文主要介绍了Docker 阿里云镜像仓库CR使用小结,具有一定的参考价值,感兴趣的可以了解一下
    2024-02-02
  • Docker存储空间清理以及另外的一些命令

    Docker存储空间清理以及另外的一些命令

    大家在使用一段时间的docker容器后,会发现堆叠了很多无用的垃圾文件,比如,终止的容器、限定不要的镜像,混乱的存储等,这篇文章主要介绍了Docker存储空间清理以及另外的一些命令的相关资料,需要的朋友可以参考下
    2024-03-03
  • Docker部署XXL-JOB分布式任务调度中心的完整指南

    Docker部署XXL-JOB分布式任务调度中心的完整指南

    XXL-Job是一个开源的分布式任务调度中心,它提供了一个可视化的任务管理界面,可以方便地创建,编辑和监控任务,本文小编就来和大家详细讲讲Docker如何部署XXL-JOB吧
    2025-06-06
  • Docker如何给Springboot项目动态传参的实现方法

    Docker如何给Springboot项目动态传参的实现方法

    这篇文章主要介绍了Docker如何给Springboot项目动态传参的实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • Docker部署RabbitMQ镜像的保姆级教程

    Docker部署RabbitMQ镜像的保姆级教程

    RabbitMQ 的镜像队列集群(Mirrored Queues Cluster)是实现高可用性的一种模式,它通过在集群中的多个节点之间复制队列,确保消息在集群的某些节点宕机时不会丢失,本文介绍了Docker部署RabbitMQ镜像的保姆级教程,需要的朋友可以参考下
    2024-12-12
  • 腾讯云服务器docker开启端口后无法访问的解决方法

    腾讯云服务器docker开启端口后无法访问的解决方法

    本文主要介绍了腾讯云服务器docker开启端口后无法访问的解决方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-06-06

最新评论