首页> 都市> KingFlow AI Open WebUI 接入教程

>

KingFlow AI Open WebUI 接入教程

著

本文标签：

KingFlow AI Open WebUI 接入 连接 模型 安全 排错 KingFlow AI Open WebUI 接入教程 配置 OpenAI 兼容连接 模型白名单和多人使用策略 Open WebUI 可以把 KingFlow AI 的 OpenAI 兼容接口变成团队可直接使用的网页聊天入口。管理员只需集中维护连接、密钥和可见模型，成员即可在统一界面

来源：KingFlow AI   主角:   更新: 2026-10-24 10:15:52

在线阅读

【扫一扫】手机随心读

  • 读书简介

KingFlow AI Open WebUI 接入 连接 模型 安全 排错 KingFlow AI Open WebUI 接入教程 配置 OpenAI 兼容连接 模型白名单和多人使用策略 Open WebUI 可以把 KingFlow AI 的 OpenAI 兼容接口变成团队可直接使用的网页聊天入口。管理员只需集中维护连接、密钥和可见模型，成员即可在统一界面

KingFlow AI Open WebUI 接入教程

KingFlow AI Open We*UI 接入教程

配置 OpenAI 兼容连接 模型白名单和多人使用策略

Open We*UI 可以把 KingFlow AI 的 OpenAI 兼容接口变成团队可直接使用的网页聊天入口。***只需集中维护连接、密钥和可见模型，成员即可在统一界面创建对话。本教程从 Docker 部署、接口自测和**连接讲起，并覆盖模型筛选、默认模型、多**限、密钥轮换、备份和故障排查。

内容核验日期 2026-10-24

Open WebUI 连接 KingFlow AI

接入架构

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

组件职责边界
浏览器用户选择获准模型并发起对话不接触平台级 API Key
Open We*UI保存全局连接并转发请求统一入口 会话与权限
KingFlow AI按 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 中添加连接。

设置项建议值说明
ProviderDefault适用于标准 OpenAI 兼容接口
**Lhttps://api.**nju**shen.com/v1填写基础地址 不要追加 chat/completions
API Keysk-你的密钥粘贴真实密钥 不写 *earer 前缀
API TypeChat Completions与 KingFlow 的兼容接口保持一致
Model IDs完整模型 ID自动发现失败或需要限模时手动添加
Forward cookiesOff第三方 API 连接保持关闭
Ena*ledOn验证后保存并启用连接
  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减少误选和成本失控
高成本模型单独连接或仅向特定用户开放便于权限和额度治理
测试模型放在非生产实例或独立连接避免试验影响正式会话
下线模型先通知 再移出 Model IDs避免旧会话突然不可继续

完成第一次对话测试

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

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

设置默认模型和岗位入口

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

多人使用和安全运维
图二 ***控制连接和模型，多名用户共享服务并保留可选个人连接。AI 生成示意图。

规划多人使用方式

能力由谁配置适用方式
全局连接***维护 **L 密钥和模型范围团队共享同一配置
用户默认模型用户在个人设置选择常用模型只影响个人使用偏好
Workspace 模型为底层模型添加名称 系统提示词 知识或工具形成面向岗位的入口
Direct Connections如***启用 用户可配置个人连接适合自带密钥 需另行评估

团队场景优先使用***维护的全局连接。启用 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、可信身份认证和最小权限***账号开放服务，并在反向**层设置访问控制和速率限制。

常见故障排查

现象常见原因处理方法
连接验证失败但地址可达上游未提供兼容的模型列表接口在 Model IDs 中手动加入完整模型 ID 再发起真实对话
模型下拉列表为空连接未启用 模型 ID 未保存或列表缓存未刷新启用连接 核对 Model IDs 并刷新页面
401 未授权密钥错误 已停用或额度不可用重新复制密钥并在 KingFlow 控制台检查状态和余额
404 模型不存在模型 ID 错误或当前分组不支持从控制台复制完整 ID 并确认密钥所属分组
503 暂时不可用上游通道繁忙或暂无可用账号稍后有限重试 持续失败时更换可用模型或联系支持
Docker 中请求超时容器 DNS ** 防火墙或 TLS 出站受限检查容器日志和服务器到域名的 ****S 连通性
回复为空或工具调用异常模型能力或工具格式不兼容先关闭工具和附件 用纯文本非流式对话定位
修改后用户仍看到旧配置连接或模型列表缓存尚未更新保存后重新打开会话 必要时重启服务窗口

运维和备份

领域建议观察或保存操作重点
可用性连接成功率 401 404 503 和超时区分配置错误与临时故障
成本按团队 模型和时段观察消耗为高成本模型设置准入规则
变更记录 **L 模型 ID 密钥轮换和回滚时间每次变更后执行冒烟测试
备份定期备份 /app/*ackend/**ta 对应数据卷恢复演练比只保留备份更重要

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

上线检查清单

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

《KingFlow AI Open WebUI 接入教程》资讯列表：

相关小说

为您推荐

小说标签