手把手30分钟搞定Khoj本地AI知识库：断网照样能搜

手把手30分钟搞定Khoj本地AI知识库断网照样能搜【免费下载链接】khojYour AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.项目地址: https://gitcode.com/GitHub_Trending/kh/khoj收藏了300篇技术文章真要用时却翻不到要点。Khoj 是一个能自己跑起来的本地AI知识库直接对着你的文档搜索、问答数据全程留在自己的硬盘上。你能带走什么部署一套完整的 Khoj 服务浏览器打开 http://localhost:42110 即用接入 Ollama 离线模型断网也能继续搜索和聊天配好局域网访问手机、平板能打开同一套本地AI知识库开通 Tailscale 安全远程连接外出不在家也能用排查服务起不来、登不进后台的问题照着文章两步定位克隆仓库用 Docker Compose 从零拉起 Khoj你的电脑上只需要装好 Docker。官方 compose 文件里已带数据库、搜索、代码沙箱等全部容器不用自己配环境。先按硬件选档位8GB 内存可稳定跑 3B 参数模型16GB 以上再考虑 7B。建独立目录并克隆代码把 Khoj 的全部文件集中放在一处方便日后更新。mkdir -p ~/.khoj cd ~/.khoj git clone https://gitcode.com/GitHub_Trending/kh/khoj.git .克隆进度走完、目录里能看到docker-compose.yml说明成功。打开docker-compose.yml只需改 server 段里的三个安全参数。第一个是随机字符串终端执行openssl rand -hex 16即可生成后两个是管理后台的登录凭据记牢。environment: - KHOJ_DJANGO_SECRET_KEY随机字符串 - KHOJ_ADMIN_EMAIL你的邮箱 - KHOJ_ADMIN_PASSWORD强密码 # …其余字段保持默认随机字符串、你的邮箱、强密码替换成你自己的密码至少 8 位且含大小写字母和数字。一条命令启动再跟踪日志确认状态。docker-compose up -d docker-compose logs -f server首次运行要下载镜像视网络情况 5~15 分钟。日志打印出 Khoj is ready to engage 即启动完成按 CtrlC 退出跟踪即可。验证部署浏览器打开 http://localhost:42110看到聊天首页界面服务就算上线了。登录管理后台把文档登记进本地AI知识库服务起来后先去管理后台确认账号然后就可以喂文档了。打开 http://localhost:42110/server/admin用刚才设置的邮箱和密码登录。⚠️ 访问后台请用localhost而不是127.0.0.1否则会撞上 CSRF 错误Safari 登不上时换 Chrome 或 Firefox 试试。回到首页上传文档把 PDF、Markdown、Word 直接拖进聊天框或点输入框左下角的回形针图标逐个选择。索引完成后在聊天框里问我的笔记里写了哪天生日。Khoj 若从你自己的文档里给出答案本地AI知识库就跑通了。离线模型三步接入断网照样能聊默认配置要调用商业模型聊天既依赖网络也依赖 API key。Ollama 能把开源模型跑在你本机对外固定暴露 11434 端口的 OpenAI 兼容接口官方 compose 里已经为容器预留了host.docker.internal的地址映射所以你只需改动两行配置。先按硬件选模型模型下载体积内存要求速度参考qwen2.5:3b约 2GB8GB秒级响应入门首选qwen2.5:7b约 5GB16GB比 3B 慢 2~3 倍llama3.1:8b约 5GB16GB与 7B 接近安装 Ollama 并拉取模型。从 Ollama 官网安装Windows 用安装包Linux 和 Mac 用官方一键脚本然后下载 3B 模型。ollama pull qwen2.5:3b下载完成后执行ollama list能看到该模型说明就位。修改docker-compose.yml打开 Ollama 连接让容器指向宿主机上的 Ollama。environment: - OPENAI_BASE_URLhttp://host.docker.internal:11434/v1/ - KHOJ_DEFAULT_CHAT_MODELqwen2.5:3b # …其余字段保持默认重启并验证。执行docker-compose down docker-compose up -d重启日志再次出现 ready 输出后刷新页面在聊天里切换到这个本地模型提问——断开网线还能正常回答即接入成功。更多模型接入方式LM Studio、vLLM 等见 Ollama 接入文档。局域网放行手机和平板也能访问 Khoj默认只有运行服务的机器自己能打开 Khoj。想让同一 WiFi 下的手机、平板共用这套本地AI知识库做两件事。告诉 Khoj 实际访问用的地址。先查到服务器的局域网 IP一般是 192.168.x.x修改 composeenvironment: - KHOJ_DOMAIN服务器IP - KHOJ_NO_HTTPSTrue # …其余字段保持默认服务器IP替换成你自己的例如 192.168.1.100。重启服务并放行防火墙端口。docker-compose down docker-compose up -d sudo ufw allow 42110/tcp命令跑完后用手机浏览器打开http://服务器IP:42110出现和电脑一致的界面即放行成功。⚠️ 若出现 400 Bad Request 或 DISALLOWED HOST检查KHOJ_DOMAIN是否与实际访问地址一致若服务直接起不来先用docker-compose logs -f server看日志42110 端口被占用和内存不足是最常见的原因。手机上用 Chrome 打开页面从菜单选安装应用Khoj 就会变成主屏图标点开即聊。多端接入后的实际体验大致如此Tailscale 远程接入从外网安全打开连接需要在公司或路上用的话直接把 42110 端口暴露到公网风险太大。Tailscale 在设备间建加密隧道不用开放任何公网端口服务器继续待在你的路由后面。在服务器和访问设备上都装 Tailscale并用同一个账号登录两台设备随即进入同一私有网络。查到服务器的 Tailscale IP100.x.x.x 格式替换 compose 里的KHOJ_DOMAINenvironment: - KHOJ_DOMAINTailscale IP # …其余字段保持默认Tailscale IP替换成你自己的。执行docker-compose down docker-compose up -d重启然后在任意外部设备浏览器打开http://Tailscale IP:42110页面能打开即外网通道打通。详细步骤见 Tailscale 接入文档。到这里你拥有一套 7×24 运行在家庭网络里的 Khoj 本地AI知识库手机和外地设备都已接入。下一步可以接入 Notion 数据源自动同步笔记或动手开发自定义智能体。卡在哪一步欢迎去 Issue 区聊聊。【免费下载链接】khojYour AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.项目地址: https://gitcode.com/GitHub_Trending/kh/khoj创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考