6333 是什么
6333 是向量数据库 Qdrant 的 REST API 端口,gRPC 走 6334。RAG、语义检索、推荐等场景把它当作向量检索的数据面:集合管理、向量写入与相似度查询都通过 HTTP 接口完成。Qdrant 支持 api-key 与只读 key,但默认不开启鉴权,一个裸奔的 6333 等于把整库检索能力连同原始 payload 一起交出去。
基本信息
| 服务 | Qdrant(REST 6333,gRPC 6334) |
|---|---|
| 端口/协议 | 6333,HTTP/JSON |
| 典型数据 | 向量、payload、集合结构 |
| 鉴权 | 可选 api-key,也可配只读 key |
| 安全等级 | 仅应用网段,生产必须开鉴权 |
典型使用场景
- RAG 检索服务:应用通过 6333 做相似度查询与元数据过滤
- 知识库入库:批量写入向量与 payload,建立集合与索引
- 运维巡检:查看集合数量、向量条数、索引状态与磁盘占用
- 性能排查:定位检索延迟时区分网络、检索参数与索引问题
- 安全核查:确认是否开启了 api-key、是否只允许应用网段访问
探测与鉴权调用
探测与鉴权调用
curl -s http://qdrant01:6333/collections | head -c 300 # 无鉴权时可直接列举集合
curl -s -H 'api-key: <KEY>' http://qdrant01:6333/collections # 带 key 的调用
curl -s http://qdrant01:6333/collections/<name>/points/scroll -H 'Content-Type: application/json' -d '{"limit":5}' # 抽样读取
ss -lntp | grep -E ':(6333|6334) ' # 监听地址核查
grep -i -E 'api_key|read_only' /etc/qdrant/config.yaml 2>/dev/null # 核对鉴权配置端口与接口分工
| 端口 | 协议 | 用途 |
|---|---|---|
| 6333 | HTTP/JSON | REST 接口与内置看板(/dashboard) |
| 6334 | gRPC | 高吞吐写入与低延迟检索 |
| — | api-key | 请求头携带,可配只读 key 供检索侧使用 |
| — | payload | 与向量同存的原始数据,常含业务敏感字段 |
加固顺序建议:先在配置里启用 api-key,再限制监听地址到应用网段,最后考虑只读 key 区分读写。别把鉴权寄托在「内网可信」上——向量库里往往堆着业务语料与用户数据,是最容易被整库拖走的一类资产。
排查「检索突然变慢」时先确认是否有人大批量 scroll 导出数据:全量遍历会显著抢占 IO 与内存。把集合的向量数量、索引进度和内存占用对齐看,比单看接口耗时更有效。
把向量库纳入数据分类分级:集合里的 payload 往往直接存放文档原文、对话记录或用户标识,敏感级别通常不低。接口权限、备份文件与测试环境副本都要按同一级别管理,避免数据面被当成「只是索引」而疏于保护。