Lazy loaded image
在HuggingFace部署Qdrant
字数 1217阅读时长 4 分钟
2025-7-22
2025-10-8
type
status
date
slug
summary
tags
category
icon
password
最近 RooCode 更新了代码库索引的 codebase 功能,这个功能通过将整个代码库向量化,实现了更高精度的上下文理解和代码问答。不过需要qdrant来作为向量数据库,qdrant通过本地docker部署是很方便的, 既然有免费的云端服务,那不利用起来就太可惜了!

一、登录HF

  1. 打开 Hugging Face 官网:https://huggingface.co/
  1. 如果有账户,直接登录。如果没有,花一分钟注册一个。


二、在HF账号的Space页面下创建新的docker容器空间

登录后,我们开始创建用于托管 Qdrant 的容器空间。
  1. 点击页面右上角的头像,在下拉菜单中选择 “New Space”
notion image
notion image
2.在创建页面,你需要填写以下信息:
  • Owner:选择你的用户名。
  • Space name:给你的项目起一个名字,比如 my-qdrant-db 或者 RooCode-Qdrant。这个名字会成为你服务URL的一部分。
  • License:选择一个开源协议,例如 mit 或 apache-2.0
  • Select the Space SDK这是最关键的一步! 请务必选择 Docker
  • Hardware:选择默认的 CPU basic 即可。它提供的 16GB RAM 对于 Qdrant 来说绰绰有余。
  • Visibility:保持 Public
3.点击 “Create Space” 按钮。HF 会为你初始化一个 Git 仓库,并引导你进入下一步。
notion image

三、配置docker文件

创建好 Space 后,我们需要告诉 HF 如何运行我们的 Qdrant 服务。这需要通过两个核心文件来完成:Dockerfile 和 README.md
你可以通过 git clone 到本地修改后 git push 上去,但更简单的方式是直接在网页上操作。
  1. 进入你的 Space 页面,点击 “Files and versions” 标签页。
  1. 点击 “Add file” → “Create a new file”

1. 创建 Dockerfile

这个文件定义了如何构建我们的 Docker 镜像。
  • 文件名Dockerfile (没有后缀)
  • 文件内容
notion image
notion image
notion image
文件内容:

2. 创建或修改 README.md

这个文件除了展示介绍信息外,还有一个特殊作用:配置 Space 的元数据,比如应用端口
  • 文件名README.md
  • 文件内容:在文件最上方添加以下 YAML 配置块:
完成这两个文件的创建和提交后,Hugging Face 会自动开始构建你的服务。

四、配置Qdrant的API-KEY

进入Space的Setting选项,往下滑动找到 Variables and secrets
notion image
notion image
填写入Qdrant-API-KEY的标准环境变量 QDRANT__SERVICE__API_KEY
Value就是密码,填写你自己的即可:
notion image

五、等待容器启动

提交文件后,你可以切换到 “Logs” 标签页查看实时构建日志。
你会看到系统依次经历 Building → Running (Provisioning) 的状态。首次构建可能需要几分钟时间,请耐心等待。
当日志滚动停止,并且页面顶部的状态标志变为绿色的 “Running” 时,恭喜你,你的云端 Qdrant 数据库已经成功启动并在线运行了!

六、RooCode配置

打开 RooCode ,配置 Qdrant URL 和之前的 KEY 即可:
notion image
配置项
应填写的值
解释
Qdrant URL
https://<你的HF用户名>-<你的Space名>.hf.space
这是 HF 分配给你的公开访问地址。注意是 https 且不需要加端口号
Qdrant API 密钥
留空
我们的部署方式未设置 API 密钥,因此数据库是公开访问的。
举个例子:如果我的 HF 用户名是 BigYellow12138,Space 名是 my-qdrant-db,那么我应该填写的 URL就是:https://bigyellow12138-my-qdrant-db.hf.space
配置完成后,保存设置。RooCode 现在应该可以成功连接到你的云端 Qdrant 数据库了。

七、Enjoy yourself

OK了!直接尝试 RooCode 的 Codebase 功能吧!
上一篇
Netlify、Vercel反代网站
下一篇
Serv00搭建Gemini Balance教程

评论
Loading...