首页> 都市> KingFlow AI LobeChat 接入教程

KingFlow AI LobeChat 接入教程

著

本文标签：

KingFlow AI LobeChat 接入个人设置 Docker 安全排错 KingFlow AI LobeChat 接入教程使用 OpenAI 兼容地址配置模型列表 Docker 部署和访问保护 LobeChat 可以把 KingFlow AI 的 OpenAI 兼容接口转换为适合日常使用的网页聊天界面。本教程给出两种接入方式：个人用户在设置页填

来源：KingFlow AI 主角: 更新: 2026-10-26 15:04:54

在线阅读

【扫一扫】手机随心读

读书简介

KingFlow AI LobeChat 接入教程

KingFlow AI Lo*eChat 接入教程

使用 OpenAI 兼容地址配置模型列表 Docker 部署和访问保护

Lo*eChat 可以把 KingFlow AI 的 OpenAI 兼容接口转换为适合日常使用的网页聊天界面。本教程给出两种接入方式：个人用户在设置页填写密钥和**地址，自托管用户通过环境变量集中配置。全文同时说明模型列表语法、Docker 更新、访问密码、密钥轮换、日志检查和常见错误处理。

内容核验日期 2026-10-26

接入方式

个人配置适合单人试用，服务端环境变量适合自托管和统一管理。

组件	职责	说明
浏览器	打开 Lo*eChat 并选择模型	只提交对话请求
Lo*eChat	读取个人设置或服务器环境变量	生成 OpenAI 兼容请求
KingFlow AI	校验密钥并按模型 ID 路由	返回兼容响应
模型服务	完成文本或其他受支持任务	能力以具体模型为准

开始前的准备

在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
从控制台复制目标模型的完整模型 ID。不要凭展示名称猜测，也不要删除版本后缀。
准备 Lo*eChat 实例。个人使用可在现有实例的设置页配置，自托管可按本文使用 Docker。
确认运行 Lo*eChat 的服务器能够通过 ****S 访问 api.**nju**shen.com。
首次测试只使用不含账号、客户资料、源代码、密钥或内部文档的短提示词。

先验证 KingFlow 接口

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer ${KINGFLOW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<控制台中的完整模型ID>",
    "messages": [
      {"role": "user", "content": "只回复：连接成功"}
    ],
    "stream": false
  }'

成功响应应包含 choices 数组。

通过设置页接入

设置项	填写内容	说明
服务商	`OpenAI`	使用 OpenAI 兼容协议
API Key	`sk-你的密钥`	不要填写 *earer 前缀
API **地址	`https://api.njushen.com/v1`	必须包含 https 和 /v1
模型	`完整模型 ID`	与控制台保持完全一致
客户端请求模式	`优先关闭`	让自托管服务端转发请求更利于保护密钥

填写 API Key 和基础地址。
添加完整模型 ID。
运行连通性检查并保存。
新建对话并选择模型。
基础聊天通过后再启用扩展能力。

通过 Docker 自托管接入

创建仅***可读的 lo*e.env：

OPENAI_API_KEY=sk-替换为你的密钥
OPENAI_PROXY_**L=https://api.**nju**shen.com/v1
OPENAI_MODEL_L**T=-all, <完整模型ID>
ACCESS_CODE=<生成一个高强度访问密码>

启动容器

docker run -d \
  -p 3210:3210 \
  --env-file ./lo*e.env \
  --name lo*e-chat \
  --restart always \
  lo*ehu*/lo*e-chat:latest

访问 http://localhost:3210。生产环境应使用 ****S。

控制模型列表

语法	作用	示例
`模型ID`	在默认列表中增加模型	`<完整模型ID>`
`-模型ID`	隐藏一个默认模型	`-gpt-4`
`-all`	先隐藏全部默认模型	`-all, <完整模型ID>`
`模型ID=显示名`	保留实际 ID 并修改界面名称	`<完整模型ID>=团队通用模型`

完成对话验证

连接检查：在 OpenAI 服务商设置中运行连通性检查，或直接发送一句短消息。
短问答：确认响应不为空，中文和代码块可以正常显示。
连续对话：追加一个追问，确认会话上下文能够延续。
模型切换：逐个选择允许的模型，确认显示名与实际能力一致。
长回复：生成数段文本，确认反向**或客户端没有提前截断。

安全和运维 — 图二 ***控制访问密钥和模型白名单，用户通过受控入口访问服务并配置监控备份。AI 生成示意图。

更新和回滚容器

升级前备份数据并记录当前镜像。

docker pull lo*ehu*/lo*e-chat:latest
docker stop lo*e-chat
docker rm lo*e-chat
docker run -d \
  -p 3210:3210 \
  --env-file ./lo*e.env \
  --name lo*e-chat \
  --restart always \
  lo*ehu*/lo*e-chat:latest

生产环境应记录验证过的镜像版本或摘要。

保护密钥和对话数据

不要把真实 API Key 写进截图、教程、浏览器收藏、前端脚本或可公开下载的 env 文件。
lo*e.env 仅允许***读取，并排除在 Git 提交、镜像构建上下文和自动备份的公开目录之外。
自托管实例至少设置 ACCESS_CODE，并通过 ****S 反向**、可信身份认证或受控内网限制访问。
个人密钥配置会扩大密钥分布范围。团队使用优先由服务端统一配置，再按环境和团队拆分密钥。
轮换密钥时先准备新值，更新容器并完成冒烟测试，再撤销旧密钥。不要在日志中打印完整请求头。
聊天记录可能包含敏感信息。设置数据留存、导出、删除和备份权限，并明确谁可以访问服务器。

检查容器日志

docker logs --tail 200 lo*e-chat

分享日志前删除密钥、访问码、Cookie、提示词和个人信息。

常见故障排查

现象	常见原因	处理方法
401 未授权	密钥错误已停用或余额不可用	重新复制密钥并检查 KingFlow 控制台状态
404 模型不存在	模型 ID 错误或密钥所属分组不支持	复制完整模型 ID 并确认分组范围
503 暂时不可用	上游通道繁忙或暂无可用账号	稍后有限重试持续失败时切换可用模型
回复为空	**地址缺少 /v1 或路径被重复追加	使用精确基础地址并检查反向**重写
模型列表没有目标模型	OPENAI_MODEL_L**T 语法错误或容器未重建	使用 -all 加模型ID 并重新创建容器
设置已改但没有生效	环境变量只在容器启动时读取	重新创建容器不只重启浏览器页面
容器连接超时	DNS 防火墙企业**或 TLS 证书问题	检查主机出站连通性和 docker logs
ACCESS_CODE 无法登录	访问码复制错误或旧容器仍在运行	核对 env 文件并确认当前容器配置

生产运维建议

领域	记录内容	建议
配置	lo*e.env 和模型列表变更记录	只保留脱敏副本
日志	401 404 503 超时和容器重启	按错误类型告警
更新	镜像版本发布时间和回滚镜像	更新前记录旧镜像摘要
密钥	创建人用途配额和轮换日期	测试与生产分开
备份	会话数据和数据库或存储卷	定期执行恢复演练