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

KingFlow AI NextChat 接入教程

著

本文标签：

KingFlow AI NextChat 接入教程配置自定义接口模型列表 Docker 部署和访问控制 NextChat 是一款可自行部署的多端聊天界面。本文使用它的 OpenAI 兼容通道连接 KingFlow AI，覆盖接口预检、网页端临时配置、Docker 固定配置、模型列表、访问密码、反向代理和更新回滚。最容易出错的是 BASE_URL：Next

来源：KingFlow AI 主角: 更新: 2026-10-26 15:05:06

在线阅读

【扫一扫】手机随心读

读书简介

KingFlow AI NextChat 接入教程

配置自定义接口模型列表 Docker 部署和访问控制

NextChat 是一款可自行部署的多端聊天界面。本文使用它的 OpenAI 兼容通道连接 KingFlow AI，覆盖接口预检、网页端临时配置、Docker 固定配置、模型列表、访问密码、反向**和更新回滚。最容易出错的是 *ASE_**L：NextChat 会自动追加 /v1，因此服务器环境变量应填写不带 /v1 的主机地址。

内容核验日期 2026-10-26

接入架构

NextChat 提供聊天界面和会话管理，KingFlow AI 提供兼容 OpenAI 的模型接口。

组件	职责	边界
用户设备	通过浏览器或桌面壳访问聊天界面	不要在共享设备保存个人密钥
NextChat	管理会话模型参数和界面设置	服务端部署可集中保存接口密钥
KingFlow AI	验证密钥并按模型 ID 路由	使用 OpenAI 兼容的 /v1 接口
上游模型	生成文本或处理受支持的输入	能力和上下文限制以具体模型为准

开始前的准备

在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
复制目标模型的完整模型 ID，保留大小写、连字符和版本后缀。
决定采用网页端临时配置还是服务端固定配置。个人试用可先用网页端，团队和长期使用建议 Docker。
Docker 部署准备一个强访问密码、****S 域名和反向**；不要把 3000 端口直接暴露到不可信网络。
先用无敏感内容的短问题联调，确认模型路由和计费归属后再投入正式使用。

先验证 KingFlow 接口

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

正确填写接口地址

使用位置	填写地址	拼接规则
curl 和多数通用客户端	https://api.njushen.com/v1	客户端自己追加 /chat/completions
NextChat ASE_*L	https://api.njushen.com	NextChat 自动追加 /v1
不要填写	https://api.njushen.com/v1/chat/completions	会造成路径重复或路由错误

NextChat 的 *ASE_**L 应填写 https://api.**nju**shen.com，程序会自动追加 /v1。

使用网页端临时配置

打开可信的 NextChat 部署，进入 Settings 或设置页面。
找到自定义接口地址和 API Key。不同构建版本的标签可能略有差异。
接口主机填写 https://api.**nju**shen.com。如果当前版本明确要求完整 API Root，再改用 https://api.**nju**shen.com/v1 并观察请求路径。
粘贴 KingFlow API Key，并在自定义模型列表加入控制台中的完整模型 ID。
新建会话，选择刚添加的模型，发送短问题完成首次验证。

使用 Docker 固定配置

环境变量	示例值	作用
OPENAI_API_KEY	sk-你的密钥	服务端调用 KingFlow 使用的密钥
ASE_*L	https://api.njushen.com	不带 /v1 不带具体端点
CODE	随机长密码	页面访问密码可用英文逗号分隔多个密码
CUSTOM_MODELS	-all, 完整模型ID	清空默认列表后只显示指定模型
DEFAULT_MODEL	完整模型ID	设置默认模型
HIDE_USER_API_KEY	1	不允许普通用户在界面输入自己的密钥
D*ALE_FAST_LINK	1	禁止通过链接导入设置

docker pull yi****a/chatgpt-next-we*

docker run -d \
  --name nextchat \
  --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -e OPENAI_API_KEY="sk-你的密钥" \
  -e *ASE_**L="https://api.**nju**shen.com" \
  -e CODE="请替换为随机长密码" \
  -e CUSTOM_MODELS="-all, <完整模型ID>" \
  -e DEFAULT_MODEL="<完整模型ID>" \
  -e HIDE_USER_API_KEY=1 \
  -e D**A*LE_FAST_LINK=1 \
  yi****a/chatgpt-next-we*:latest

使用 Compose 管理配置

services:
  nextchat:
    i**ge: yi****a/chatgpt-next-we*:latest
    container_name: nextchat
    restart: unless-stopped
    ports:
      - "127.0.0.1:3000:3000"
    env_file:
      - .env

OPENAI_API_KEY=sk-你的密钥
*ASE_**L=https://api.**nju**shen.com
CODE=请替换为随机长密码
CUSTOM_MODELS=-all, <完整模型ID>
DEFAULT_MODEL=<完整模型ID>
HIDE_USER_API_KEY=1
D**A*LE_FAST_LINK=1

修改环境变量后需要重新创建容器。

管理模型列表

语法	作用	示例
模型ID	把自定义模型加入列表	my-model
-模型ID	隐藏一个模型	-gpt-3.5-tur*o
-all	隐藏全部默认模型	-all, my-model
原名=显示名	修改界面显示名称	model-id=团队默认模型

完成联调验证

访问验证：未输入 CODE 时不能直接使用服务器端密钥。
模型验证：模型下拉列表只显示预期模型，默认模型与部署配置一致。
短对话：发送一句短问题，确认回复完整且没有 401、404 或 503。
流式验证：观察回复是否持续输出；部分模型可能要求 stream 为 true。
长对话：连续追问三轮，检查上下文是否延续，Token 使用是否符合预期。
新浏览器验证：使用无痕窗口重新登录，确认访问密码和用户设置边界有效。

NextChat 安全运维 — 图二 NextChat 通过访问密码、****S、密钥保险库、容器更新和监控建立安全边界。AI 生成示意图。

保护密钥和访问入口

CODE 只是有限的页面访问控制，不应替代完整身份系统。面向互联网或多人使用时，应在反向**或统一身份服务增加更强认证。
把 OPENAI_API_KEY 保存在服务端环境变量或受控密钥系统，不要提交到 Git、镜像层、聊天记录或截图。
设置 HIDE_USER_API_KEY=1，避免普通用户误填或暴露个人密钥。设置 D**A*LE_FAST_LINK=1，减少通过链接导入恶意配置的风险。
只** 127.0.0.1，再通过 ****S 反向**对外提供服务。限制来源、请求体大小和异常频率。
为测试、生产和不同团队使用独立 KingFlow Key，并设置额度、有效期和用途说明，发现异常时可以单独撤销。
NextChat 聊天记录主要保存在客户端或所选同步服务。共享设备应退出并清理浏览器数据，正式资料应遵循组织的数据处理**。

更新和回退

记录当前镜像标签、环境变量名称、模型列表和反向**配置。不要把真实密钥写入公开变更记录。
更新前导出需要保留的会话，并备份 Compose 文件和脱敏后的配置模板。
拉取新镜像后重建容器，依次验证访问密码、模型列表、短对话和流式输出。
出现兼容问题时回退到已验证的镜像标签，而不是继续修改生产环境中的多项配置。

常见故障排查

现象	常见原因	处理方法
401 未授权	密钥错误已停用或额度不可用	重新复制密钥并检查 KingFlow 控制台
404 或路径异常	ASE_*L 错写为带 /v1 的地址	Docker 环境变量改为 https://api.njushen.com
404 模型不存在	模型 ID 错误或密钥分组不支持	从控制台复制完整模型 ID
503 暂时不可用	上游通道繁忙或暂无可用账号	稍后有限重试或切换已授权模型
列表没有自定义模型	CUSTOM_MODELS 语法错误或容器未重建	核对加号逗号和模型 ID 后重建容器
配置改了但未生效	旧容器仍在运行	重新创建容器并检查实际环境变量
网页端可访问但无法对话	访问密码通过但接口配置失败	先跑 curl 再查看容器日志中的状态码
流式回复中断	**缓存或超时	关闭响应缓存并延长反向**读取超时