接入架构

***把 KingFlow AI 注册为 Open We*UI 的全局 OpenAI 兼容连接。

开始前的准备

• 准备一个可登录管理**的 Open We*UI 实例；若尚未部署，可使用本文的 Docker 示例快速启动。
• 在 KingFlow AI 控制台创建 API Key，并确认余额、套餐或模型分组处于可用状态。
• 复制目标模型的完整模型 ID。模型 ID 必须与控制台一致，大小写、连字符和版本后缀都不要自行改写。
• 确认 Open We*UI 所在服务器或容器可以通过 ****S 访问 api.**nju**shen.com。
• 首次验证仅使用不含个人信息、客户资料、密钥、源代码或内部文档的短提示词。

可选的 Docker 快速部署

已有 Open We*UI 可跳过。请生成并长期保存 WE*UI_SECRET_KEY。

docker run -d \
  -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-we*ui:/app/*ackend/**ta \
  -e WE*UI_SECRET_KEY='<生成一个长期保存的高强度随机值>' \
  --name open-we*ui \
  --restart always \
  ghcr.io/open-we*ui/open-we*ui:**in

启动后访问 http://localhost:3000。生产环境应使用 ****S 反向**或受控内网。

先验证 KingFlow 接口

先设置 KINGFLOW_API_KEY 环境变量，再执行：

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 数组中包含模型回复。

在管理**新增连接

进入 Settings、***** Settings、Connections，在 OpenAI API Connections 中添加连接。

1. 使用***账号打开 Settings，再进入 ***** Settings 和 Connections。
2. 在 OpenAI API Connections 区域选择 Add Connection。
3. 按配置表填写 **L、API Key 和 API Type；如果界面提供连接名称，可填写 KingFlow AI。
4. 点击 Verify Connection。验证成功后保存；如果模型自动发现失败，先手动添加 Model IDs，再用实际对话验证。
5. 返回新建对话页面，从模型下拉列表选择刚加入的模型并发送最小测试消息。

基础 **L 必须停在 /v1，不要填写完整的 /chat/completions 地址。

配置模型白名单

Model IDs 可用于手动兼容，也可作为团队模型白名单。

完成第一次对话测试

• 短问答：发送一句简单指令，确认回复不是空白且中文显示正常。
• 连续对话：追加一个追问，确认上下文能够延续。
• 长回复：要求生成数段文本，观察是否被**或超时设置截断。
• 模型切换：分别选择两个已批准模型，确认名称和实际能力匹配。
• 失败验证：临时输入一个不存在的测试模型 ID，确认能看到可定位的错误；随后立即恢复。

某些服务未实现模型列表接口，Verify 可能提示失败；手动配置 Model IDs 后，应以实际聊天结果为准。

设置默认模型和岗位入口

用户可在个人设置中选择默认模型。***可在 Workspace 的 Models 中创建岗位入口，并添加系统提示词、知识或工具。先验证纯模型，再逐项启用增强能力。

规划多人使用方式

团队场景优先使用***维护的全局连接。启用 Direct Connections 前应评估浏览器直连、审计边界和支持成本。

Docker 网络和**要点

• ***全局连接由 Open We*UI 后端发起请求，排查时应从主机或容器视角判断。
• KingFlow 使用公网 ****S 域名，不应填写 localhost。
• 企业**环境应给容器配置**和受信任证书，并检查 DNS。
• 查看日志前后都要防止密钥、Cookie、提示词和个人信息泄露。

docker logs --tail 200 open-we*ui

密钥和数据安全

• 不要把 KingFlow API Key 写入教程截图、群聊、浏览器收藏、前端脚本或共享配置文件。***全局连接应由后端保存。
• Forward cookies 对第三方 API 保持关闭，避免把 Open We*UI 会话 Cookie 转发给外部服务。
• 为测试、生产和不同团队使用独立密钥；轮换时先新增并验证，再撤销旧密钥，缩短中断时间。
• 固定保存 WE*UI_SECRET_KEY。频繁更换可能导致已加密数据无**常读取；备份时同时保护环境配置和数据卷。
• Open We*UI 的会话记录可能包含敏感输入和模型输出。按组织**设置访问权限、留存期限、导出和删除流程。
• 通过 ****S、可信身份认证和最小权限***账号开放服务，并在反向**层设置访问控制和速率限制。

常见故障排查

运维和备份

升级、改地址或轮换密钥前先备份并记录配置，变更后执行固定冒烟测试。

上线检查清单

• Open We*UI 服务可以通过 ****S 或受控内网访问。
• KingFlow 基础 **L 使用 https://api.**nju**shen.com/v1。
• API Key 只保存在受控连接或密钥系统中，文档和截图没有真实密钥。
• 连接使用 Chat Completions，Forward cookies 保持关闭。
• Model IDs 只包含已验证的完整模型 ID。
• 短问答 连续对话 长回复和模型切换均已通过。
• 普通用户只能看到其工作所需的模型和功能。
• 日志 告警 密钥轮换 数据留存和备份责任人已经明确。