LobeChat是什么

LobeChat是GitHub上最受欢迎的开源ChatGPT替代品。它提供了一个与ChatGPT几乎一模一样的聊天界面，但运行在你自己服务器上，数据完全私有。相比ChatGPT网页版，LobeChat有三大优势：1）支持30+大模型API（OpenAI、Claude、Gemini、智谱、DeepSeek等）；2）内置知识库功能，可以基于私有文档对话；3）插件系统丰富，支持联网搜索、图片生成、PDF阅读等。安装只需一条Docker命令，是新手友好的私有AI方案。

第一步：环境准备

  1. 硬件：4核CPU、8GB内存（运行模型需更高）
  2. 系统：Ubuntu 22.04 / macOS 13+ / Windows 11 with WSL2
  3. 安装Docker Desktop或Docker Engine
  4. 验证Docker：docker --version 输出版本号即正常
  5. 安装Docker Compose：docker compose version
  6. 开放80或3210端口（容器内部端口，可选）

第二步：编写Docker Compose文件

  1. 创建工作目录：mkdir lobechat && cd lobechat
  2. 创建 docker-compose.yml 文件
  3. 复制以下配置（基础版）：
    version: '3.8'
    services:
    lobe-chat:
    image: lobehub/lobe-chat:latest
    container_name: lobe-chat
    ports:
    - "3210:3210"
    environment:
    - OPENAI_API_KEY=sk-xxx
    - ACCESS_CODE=lobe123456
    volumes:
    - ./data:/app/data
    restart: unless-stopped
  4. 替换OPENAI_API_KEY为你的真实Key（其他模型Key在Web界面添加）
  5. 设置ACCESS_CODE：访问密码，防止被别人访问

提示：环境变量里的API_KEY只是默认值，用户登录后可以在Web界面添加更多模型Key，灵活性更高

第三步：启动LobeChat

  1. 在docker-compose.yml目录执行：docker compose up -d
  2. 等待镜像拉取（约300MB，首次约2分钟）
  3. 查看启动状态：docker compose ps
  4. 查看日志：docker compose logs -f （无报错即可Ctrl+C退出）
  5. 访问 http://localhost:3210 在浏览器打开
  6. 首次访问会提示输入ACCESS_CODE，输入设置的密码
  7. 进入设置页面，配置模型供应商

第四步：接入多种模型API

  1. 点击右上角头像 → “设置” → “语言模型”
  2. 可以看到已经预配置的OpenAI
  3. 添加新供应商：
    服务商：Anthropic
    API Key：sk-ant-xxx
    模型：Claude Sonnet 4.5、Claude Haiku 4.5
  4. 同理添加：智谱GLM（用之前申请过的Key）
  5. 添加DeepSeek、Qwen等国产模型
  6. 添加Google Gemini Key（需要魔法上网）
  7. 所有模型会在对话界面下拉菜单显示

第五步：使用知识库功能

知识库是LobeChat的杀手锏，让AI回答基于你的私有文档：

  1. 进入”知识库”页面，点击”新建知识库”
  2. 上传文档：支持PDF、Word、Markdown、TXT，最多同时上传50个
  3. LobeChat自动分块、向量化、存入本地向量数据库
  4. 新建对话，选择”知识库对话”模式
  5. 在对话中AI自动检索相关文档片段作为上下文
  6. 回答会标注来源，可以跳转到原文段落

知识库实战场景：

  • 上传公司规章制度，做HR问答机器人
  • 上传产品手册，做客服智能助手
  • 上传个人读书笔记，做知识检索工具
  • 上传学术论文，做文献综述助手

第六步：安装插件

  1. 进入”插件市场”，浏览插件列表
  2. 推荐插件：
    • 联网搜索（Search）：让AI联网获取最新信息
    • 图片生成（DALL-E）：AI直接生成图片
    • 思维导图：自动生成知识图谱
    • 代码执行：在沙箱运行Python代码
    • Wolfram Alpha：数学计算神器
  3. 点击”安装”，插件立即生效

第七步：定制外观

  1. 设置 → “外观”：选择主题（暗色/亮色/自定义）
  2. 支持自定义CSS，打造专属风格
  3. 设置 → “系统提示词”：为所有对话预置System Prompt
  4. 设置 → “快捷键”：自定义键盘快捷方式

安全加固建议

  • 外网访问：用Nginx反向代理 + HTTPS证书
  • 多人使用：用OAuth认证（GitHub、Google）
  • API Key保护：定期轮换，避免泄露
  • 数据备份：定期备份 ./data 目录
  • 版本升级：docker compose pull && docker compose up -d

效率数据

实测性能：4核8G服务器可稳定支持10人同时在线对话。知识库100MB文档检索平均响应3秒。相比订阅ChatGPT Plus（$20/月）自部署LobeChat，约6个月回本（按团队计）。