首页 / 教程 / 客户端配置

LobeChat 接入教程:开源聚合聊天工作台

用惯了几款 AI 客户端,多少会遇到同样的麻烦:换个模型要重新配一遍,对话散落在不同工具里,哪天想统一整理却发现数据都在别人服务器上。开源的 LobeChat 想解决的正是这件事——它把「界面」和「模型」拆开,界面自己部署,模型想接哪家接哪家。

它和普通客户端差在哪

LobeChat 是一个开源的聊天前端,部署在自己电脑或服务器上,用浏览器访问。和只能装在一台机器上的桌面客户端相比,最大的区别是「一次部署、处处可用」:手机、平板、电脑打开同一个地址,接着聊就是了。

它更像一个聚合入口。同一个界面里可以挂多家服务商,换模型不用换工具;对话记录、助手设定、常用提示词也都留在自己的部署里,哪天想搬走,打包带走即可。

它不是某一个模型,而是把所有模型收进同一张桌面的工作台。

三步把它接上自建接口

第一步是把服务跑起来。官方提供现成的容器镜像,一条命令就能启动,默认监听 3210 端口:装在服务器上就访问服务器地址,装在本机就访问本地端口。想长期用,建议把配置和数据目录挂载到容器外面,这样升级镜像不会丢对话。

第二步是填服务商信息。在设置里新增一个 OpenAI 兼容的服务商,接口地址填 https://api.aigcbreeze.cn/v1 ,密钥填控制台里创建的 sk- 开头的 Key。想省事也可以走环境变量,启动时带上对应的密钥和代理地址,省去界面里手填。

第三步是把模型加进来。部分版本会自动拉取模型列表;拉不到时,就在自定义模型里手动补上要用的模型 ID,保存后新开一个对话,在顶部就能切换。整个过程不用改代码,填配置即可。

几个值得先开的设置

助手预设是最省时间的一项:把常用的角色各存一个助手,比如翻译、审校、周报整理,之后一句话切过去,不用每次重写提示词。角色设定写得越具体,复用效果越好。

第二项是数据与备份。对话默认存在部署环境里,记得定期导出备份;换服务器时迁移数据目录即可,历史记录和助手设定都能带走。

第三项是访问控制。自建实例一旦放到公网,先设访问密码,或者干脆只在内网使用——一个没有鉴权的聊天入口,等于把接口额度敞开给人用。

常见问题

必须用 Docker 吗?

不是,但容器方式最省事。也可以按官方文档用 Node 环境从源码启动,代价是要自己处理依赖和后续升级,适合愿意折腾的人。

接上之后模型列表是空的怎么办?

多数是两处原因:地址少写了 /v1,或密钥不对、额度用尽。先确认接口地址以 /v1 结尾,再用别的工具测同一个 Key,通常一次就能定位。

手机能用吗?

能。它是网页应用,浏览器打开即可,也可以加到手机主屏当应用用。前提是部署的地址从手机能访问到,放到公网时记得先做鉴权。

用自建接口搭一个自己的聊天台

这类前端把界面和模型彻底拆开了:界面自己掌握,模型按需接入。用站内接口填上去,一个地址加一把 Key 就能跑通,按量计费,换模型时改配置即可,不必重装。

留言交流

有问题、有补充,写两句吧~留言会实时显示在下方(无需注册)。

留言加载中…
← 上一篇:Open WebUI 接入教程:自建私有 AI 工作台 下一篇:编码工具接入 API 站 →