腾讯ima客户端不支持私有化部署，但其开源内核weknora可本地部署实现数据100%本地化；推荐通过docker一键启动，需配置ollama_model、vector_db和upload_dir，并验证rag链路是否通达。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯IMA知识库官方客户端（ima.qq.com）本身不支持私有化部署，但其底层技术内核已开源为WeKnora框架，可本地搭建等效知识库系统。
区分IMA与WeKnora的部署性质
IMA是面向个人用户的SaaS服务，运行在腾讯云服务器上，所有数据存储于腾讯云端；WeKnora是IMA的技术开源版本，代码完全公开，允许企业或个人在自有服务器上完整部署，实现数据100%本地化。
直接访问ima.qq.com或安装Windows/Mac客户端，本质都是调用腾讯托管的后端服务——【你上传的文档、笔记、问答记录全部留在腾讯服务器上】，无法导出原始向量库或检索索引。
WeKnora本地部署实操路径
方法一：Docker一键启动（推荐新手）
1. 确保服务器已安装Docker 24.0+与docker-compose 2.20+；旧版本可能因容器镜像签名机制报错退出。
2. 克隆仓库并进入目录：git clone https://github.com/Tencent/WeKnora.git && cd WeKnora
3. 复制环境配置：cp .env.example .env，用vim打开.env文件，重点修改以下三项：
— OLLAMA_MODEL=qwen2:7b（若本地无Ollama，改用QWEN_API_BASE=http://your-llm-server:8000/v1）
— VECTOR_DB=chroma（默认Chroma轻量，生产环境建议改qdrant并配置独立Qdrant容器）
— UPLOAD_DIR=/data/weknora/uploads（务必指向有写权限的绝对路径，否则文档解析会静默失败）
4. 执行启动脚本：./scripts/start_all.sh，等待终端输出weknora-backend-1 Running和weknora-frontend-1 Running两行状态即完成。
验证部署是否成功
浏览器访问http://localhost:3000（若为远程服务器，需将localhost替换为服务器IP，并确认3000端口已放行）。
首次加载会进入初始化向导页，点击“创建新知识库” → 上传一份PDF测试文档 → 等待右上角进度条消失 → 在搜索框输入文档内任意关键词，能即时返回高亮片段即表示RAG链路通达。
注意：若搜索无结果，大概率是.env中UPLOAD_DIR路径权限不足，或Docker未挂载该目录到容器内——【必须在docker-compose.yml中显式声明volumes映射】。
