30分钟搞定！Khoj家庭服务器搭建教程：打造你的本地AI知识库

【免费下载链接】khoj An AI copilot for your second brain. Search and chat with your personal knowledge base, online or offline 项目地址: https://gitcode.com/GitHub_Trending/kh/khoj

还在担心云端AI助手的隐私问题？想拥有一个完全掌控的个人知识库却不知从何下手？本文将带你30分钟内完成Khoj家庭服务器的搭建，无需专业技术背景，让你的个人数据安全留在本地网络，随时享受AI驱动的知识管理体验。

读完本文你将学会：

• 使用Docker快速部署Khoj服务
• 配置本地模型实现完全离线运行
• 安全设置家庭网络访问权限
• 多设备同步与远程访问技巧
• 常见问题排查与性能优化

为什么选择本地部署Khoj？

Khoj作为一款开源的AI知识库助手，支持本地部署带来三大核心优势：

数据隐私保护：所有文档和对话记录存储在本地硬盘，无需上传至第三方服务器。官方架构图清晰展示了数据处理流程：

完全离线运行：通过配置本地LLM模型，即使断网也能正常使用搜索和聊天功能，特别适合网络不稳定的环境。

硬件资源可控：可根据家庭服务器配置灵活调整模型参数，平衡性能与资源占用，最低仅需8GB内存即可运行基础功能。

准备工作：硬件与软件要求

推荐配置

• CPU：四核及以上处理器
• 内存：至少8GB RAM（推荐16GB以上）
• 存储：20GB可用空间（含模型下载）
• 系统：Windows 10/11、macOS 12+或Linux发行版
• 网络：稳定的家庭局域网环境

必备软件

• Docker Desktop：用于容器化部署
• Git：用于获取项目代码
• 终端工具：Windows推荐WSL2，macOS/Linux使用系统终端

快速部署：Docker一键启动

1. 获取项目代码

mkdir -p ~/.khoj && cd ~/.khoj
git clone https://gitcode.com/GitHub_Trending/kh/khoj.git .

2. 配置环境变量

编辑docker-compose.yml文件，重点修改以下安全参数：

environment:
  - KHOJ_DJANGO_SECRET_KEY=生成随机安全字符串
  - KHOJ_ADMIN_EMAIL=你的邮箱地址
  - KHOJ_ADMIN_PASSWORD=强密码（至少8位含大小写字母和数字）
  - KHOJ_DEBUG=False  # 生产环境必须设为False

完整配置文件参考：docker-compose.yml

3. 启动服务

docker-compose up -d

首次启动会自动下载约3GB的镜像和模型文件，根据网络情况可能需要5-15分钟。当终端显示🌖 Khoj is ready to engage时表示启动成功。

4. 验证部署

打开浏览器访问http://localhost:42110，看到以下界面说明部署成功：

本地模型配置：完全离线使用

1. 安装Ollama服务

Ollama是轻量级本地LLM管理工具，支持一键部署多种开源模型：

# Linux/macOS
curl https://ollama.com/install.sh | sh

# Windows
# 从官网下载安装包：https://ollama.com/download

2. 下载推荐模型

ollama pull qwen2:7b  # 阿里通义千问7B模型
# 或选择更小的模型：ollama pull phi3:3.8b

3. 配置Khoj连接本地模型

修改docker-compose.yml添加Ollama连接参数：

environment:
  # 取消以下行的注释并修改
  - OPENAI_BASE_URL=http://host.docker.internal:11434/v1/
  - KHOJ_DEFAULT_CHAT_MODEL=qwen2:7b

详细配置可参考官方文档：documentation/docs/advanced/ollama.mdx

4. 重启服务使配置生效

docker-compose down && docker-compose up -d

家庭网络配置：多设备访问

本地网络访问设置

1. 查找家庭服务器的局域网IP（通常为192.168.x.x格式）
2. 修改docker-compose.yml添加局域网访问权限：

environment:
  - KHOJ_DOMAIN=192.168.1.100  # 替换为你的服务器IP
  - KHOJ_NO_HTTPS=True  # 局域网内可禁用HTTPS

2. 防火墙设置（以UFW为例）：

sudo ufw allow 42110/tcp  # 允许Khoj端口访问
sudo ufw reload

现在同一网络下的手机、平板等设备可通过http://服务器IP:42110访问Khoj服务。

安全远程访问（高级）

对于需要外网访问的场景，推荐使用Tailscale实现安全连接：

1. 在服务器和访问设备上安装Tailscale
2. 获取服务器的Tailscale IP
3. 配置Khoj允许Tailscale访问：

environment:
  - KHOJ_DOMAIN=100.x.x.x  # 替换为你的Tailscale IP
  - KHOJ_ALLOWED_DOMAIN=server  # 允许容器内部访问

详细步骤参考官方文档：documentation/docs/advanced/tailscale.md

客户端配置：多平台同步

桌面客户端

1. 下载对应系统的客户端：src/interface/desktop
2. 安装后在设置中配置服务器地址：http://服务器IP:42110
3. 启用自动同步功能，保持知识库最新

Obsidian插件

1. 在Obsidian社区插件中搜索"Khoj"安装
2. 配置服务器地址和API密钥
3. 使用命令面板调用Khoj功能：Khoj: Search或Khoj: Chat

移动设备访问

通过浏览器访问服务器地址，推荐添加到主屏幕以获得接近原生应用的体验：

维护与优化

定期更新

# 进入项目目录
cd ~/.khoj
# 拉取最新代码
git pull
# 重建并启动服务
docker-compose up --build -d

性能优化建议

1. 模型选择：根据硬件配置选择合适的模型，低配置服务器推荐3B参数模型
2. 资源限制：在docker-compose.yml中添加资源限制：

deploy:
  resources:
    limits:
      cpus: '4'
      memory: 8G

3. 缓存清理：定期清理未使用的模型缓存：

# 清理未使用的Docker资源
docker system prune -a

常见问题排查

• 服务启动失败：检查日志docker-compose logs server，常见原因为端口冲突或资源不足
• 无法访问管理界面：确保使用localhost而非127.0.0.1访问，参考CSRF错误解决
• 模型加载缓慢：确认模型文件完整下载，可手动检查khoj_models卷挂载情况

总结与进阶方向

通过本文的步骤，你已经成功搭建了属于自己的Khoj家庭服务器。这个本地AI知识库不仅保护了你的数据隐私，还能在没有网络的情况下正常工作。

进阶探索方向：

• 配置文档自动同步：data-sources/notion_integration.md
• 实现语音交互功能：features/voice-chat.md
• 开发自定义插件：contributing/development.mdx

如果觉得本教程对你有帮助，请点赞收藏，关注获取更多Khoj使用技巧和最佳实践！有任何问题欢迎在项目Issue中交流。

项目地址：https://gitcode.com/GitHub_Trending/kh/khoj

【免费下载链接】khoj An AI copilot for your second brain. Search and chat with your personal knowledge base, online or offline 项目地址: https://gitcode.com/GitHub_Trending/kh/khoj