Next.js 构建，可 Vercel/Docker 一键自部署的 Web/PWA 聊天框架；设置里可加 Custom Provider（Request Format=OpenAI、Proxy URL、API Key），可 Fetch models 拉模型列表；有 Agent 市场、插件/MCP、TTS/STT、知识库。适合 LIN 给团队/客户演示「部署一个自己品牌的聊天站，底座接我的 API」。

适用场景：小团队自部署一个内网聊天页，全员共用 LIN 的网关 Key 或各自 Key；个人用云端界面填自定义服务商。

LobeChat LobeHub 自部署 Web PWA Agent市场 插件

操作步骤

  1. 二选一：用现成界面或按 README 用 Vercel/Docker 自部署（环境变量含 OPENAI_API_KEY、ACCESS_CODE、OPENAI_PROXY_URL）
  2. App Settings→AI Providers→Add Custom Provider
  3. Provider ID 用小写英文且创建后不可改、Name 自定义、Request Format 选 OpenAI
  4. Proxy URL 填 https://tokenbuddy.cc（带 /v1）、API Key 填 {{API_KEY}}
  5. Use Client Request Mode 先保持关闭（浏览器直连模式易出网络错误，该文明确建议无理由不开）
  6. 点 Connectivity Check 通过后 Fetch models 拉列表并启用需要的模型（拉不到就用 curl /v1/models 查 ID 后手动 Add Model）
  7. 在 Agent 设置里选该服务商的模型再开聊

配置说明

自部署时服务端环境变量与界面内用户配置有优先级之分（中文教程专门提醒改页面后仍吃部署默认值要查优先级）；设 ACCESS_CODE 防止自部署实例被路人白嫖烧 Key。

开源项目信息

  • 仓库：https://github.com/lobehub/lobe-chat
  • Stars 口径：来源差异很大：dev.to 称 ~60,000、open-source-tools 称 69.1k（2025-12-16 快照）、Hostinger 称 75,000+、某评测称 79K+——只能写『搜索来源报约 6万–7.9万，随时点变化』，发布时以点开仓库当天为准
  • 许可：来源冲突：较早 README 镜像写 Apache 2.0、评测站写 'LobeHub Community License, based on Apache 2.0 with additional commercial-use conditions'，另有页面误写 MIT——专栏发布应写『社区许可（基于 Apache 2.0 + 附加商用条件），以仓库 LICENSE 原文为准』，不要单写 MIT

注意事项

  • ⚠️ 把内置 OpenAI 服务商直接改掉导致文件索引等功能受影响（实操文建议另建 Custom Provider、别动内置）
  • ⚠️ Anthropic 格式地址误带 /v1
  • ⚠️ 开了 Client Request Mode 后因 CORS/网络报错误判 Key 失效
  • ⚠️ 自部署不设访问码公开暴露

来源：https://dev.to/xiaomodern/lobechat-the-60k-star-open-source-chatgpt-alternative-nobody-talks-about-and-why-it-matters-40nl；自定义服务商实操 http://dev.to/mupromax/lobechat-lobehub-with-claude-and-gpt-custom-provider-docker-env-vars-and-the-v1-rule-3ee7