Docker 运行

为什么用 Docker

最快在本地或服务器上跑 Qdrant，且版本与官方镜像一致，适合学习与联调。

单机快速启动

docker pull qdrant/qdrant:latest

docker run -p 6333:6333 -p 6334:6334 \
  -v "$(pwd)/qdrant_storage:/qdrant/storage:z" \
  qdrant/qdrant

端口	用途
6333	REST API、Web 控制台（Dashboard）
6334	gRPC（Java 官方客户端默认使用）

浏览器访问：**http://localhost:6333/dashboard**（部分版本根路径即为控制台，以实际镜像为准）。

数据持久化

-v ...:/qdrant/storage 将数据目录挂载到宿主机，容器删除后数据仍可保留。生产环境请使用稳定卷与备份策略。

常用环境变量（了解即可）

• QDRANT__SERVICE__GRPC_PORT、QDRANT__SERVICE__HTTP_PORT：修改监听端口时需与客户端一致。
• 生产建议查阅官方 Configuration 文档，配置日志、TLS、资源限制等。

验证服务

curl http://localhost:6333/

若返回 JSON 含版本等信息，说明 HTTP 服务正常。

下一步

• 在 Web 控制台 里创建集合并看点（见下一节「本地与配置」可补充生产注意点）。
• Java 客户端请连接 6334；Python 常用 6333（REST）或也可走 gRPC。