本地安装与配置

与 Docker 的对比

方式	优点	适用
Docker	免编译、版本统一、易迁移	学习、开发、多数部署
二进制 / 包管理	更贴近裸机运维	有特定运维规范时

新手优先 Docker；本节补充「装好后要注意什么」。

网络与安全

• 默认无鉴权：仅监听在 localhost 时风险较低；暴露到公网必须加 API Key / 反向代理 / 防火墙。
• TLS：生产应在 Qdrant 前加 Nginx / 云 LB 终止 HTTPS，或按官方文档启用服务端 TLS。

资源建议（经验值）

• 内存：与向量数量、维度、是否量化、索引参数有关；百万级高维需按官方容量规划测算。
• 磁盘：持久化存储 + 快照；SSD 更有利于高并发检索。

API Key（若已启用）

部分部署会设置 API Key，REST 请求头示例：

api-key: <your-api-key>

Python / Java 客户端均支持在构造客户端时传入密钥，详见各 SDK 章节。

版本

教程示例与 Qdrant 1.x 及当前 qdrant-client / java-client 主流版本兼容。升级服务端或客户端大版本时，请阅读 Release Notes。