安装向量数据库ChromaDB

1. 安装 Python 环境
   • 登录宝塔面板 → 软件商店 → 搜索 Python 项目管理器 → 安装 → 安装后点击版本管理 → 安装 Python 3.8+（推荐 3.10）。
2. 创建虚拟环境（可选但推荐）
   • 进入 Python 项目管理器 → 虚拟环境 → 添加虚拟环境 → 选择 Python 版本、设置环境名称和路径 → 提交。
3. 安装 ChromaDB
   • 方式 1：虚拟环境中安装找到刚创建的虚拟环境 → 点击终端 → 执行命令：pip install chromadb
   • 方式 2：全局安装（服务器命令行）
   • 宝塔面板 → 终端 → 登录服务器 → 执行：pip3 install chromadb
4. 验证安装
   • 终端执行以下命令，无报错则安装成功：python -c "import chromadb; print(chromadb.__version__)"

常见问题处理

• 若出现 gcc 编译错误 → 宝塔软件商店安装 GCC 编译器。
• 若提示 grpcio 安装失败 → 执行 pip install grpcio –no-binary grpcio。
• 若内存不足导致安装中断 → 升级服务器内存或开启虚拟内存（宝塔 → 系统工具 → 虚拟内存）。

Docker 安装 ChromaDB 步骤

1. 安装 Docker宝塔面板 → 软件商店 → 搜索 Docker 管理器 → 安装，安装完成后启动 Docker 服务。
2. 拉取 ChromaDB 镜像宝塔面板 → 终端 → 执行命令：bash运行 docker pull chromadb/chroma
3. 启动 ChromaDB 容器基础启动命令（持久化数据 + 暴露端口）：bash运行 docker run -d \ --name chromadb \ -p 8000:8000 \ -v /data/chroma:/chroma/chroma \ chromadb/chroma
   • 参数说明：
     • -d：后台运行容器
     • --name chromadb：容器命名为 chromadb
     • -p 8000:8000：映射宿主机 8000 端口到容器 8000 端口
     • -v /data/chroma:/chroma/chroma：宿主机 /data/chroma 目录挂载到容器，实现数据持久化
4. 验证容器运行执行命令查看容器状态：bash运行 docker ps 或访问地址验证服务：plaintext http://你的服务器IP:8000/api/v1/heartbeat 返回 {"nanosecond heartbeat": xxxxx} 则运行正常。
5. Node.js 客户端连接 Docker 版 ChromaDB修改客户端初始化代码，指定服务地址：javascript运行 import { ChromaClient } from 'chromadb'; // 连接 Docker 中运行的 ChromaDB 服务 const client = new ChromaClient({ path: "http://你的服务器IP:8000" });