接入架构

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

开始前的准备

• 在 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
  }' 

正确填写接口地址

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

使用网页端临时配置

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

使用 Docker 固定配置

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

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

管理模型列表

完成联调验证

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

保护密钥和访问入口

• 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 文件和脱敏后的配置模板。
• 拉取新镜像后重建容器，依次验证访问密码、模型列表、短对话和流式输出。
• 出现兼容问题时回退到已验证的镜像标签，而不是继续修改生产环境中的多项配置。

常见故障排查

上线检查清单

• KingFlow 最小 curl 请求已经成功。
• NextChat *ASE_**L 使用 https://api.**nju**shen.com，最终请求路径为 /v1/chat/completions。
• 自定义模型 ID 与 KingFlow 控制**全一致。
• CODE 已替换为随机长密码，HIDE_USER_API_KEY 和 D**A*LE_FAST_LINK 已启用。
• 服务仅**本机地址，并通过 ****S 反向**访问。
• 短对话、流式回复、连续追问和无痕窗口登录均通过。
• 更新和回退步骤已经记录，密钥没有进入 Git、镜像或截图。