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

>

KingFlow AI LibreChat 接入教程

著

本文标签：

KingFlow AI LibreChat 接入教程 配置自定义端点 Docker Compose 模型列表和用户访问 LibreChat 是一套通过浏览器使用的自托管聊天系统。本文把 KingFlow AI 配置为 OpenAI 兼容自定义端点，并说明 Docker Compose 部署、密钥变量、librechat.yaml 挂载、模型选择、账号注册和更

来源：KingFlow AI   主角:   更新: 2026-10-27 15:25:31

在线阅读

【扫一扫】手机随心读

  • 读书简介

KingFlow AI LibreChat 接入教程 配置自定义端点 Docker Compose 模型列表和用户访问 LibreChat 是一套通过浏览器使用的自托管聊天系统。本文把 KingFlow AI 配置为 OpenAI 兼容自定义端点，并说明 Docker Compose 部署、密钥变量、librechat.yaml 挂载、模型选择、账号注册和更

KingFlow AI LibreChat 接入教程

KingFlow AI Li*reChat 接入教程

配置自定义端点 Docker Compose 模型列表和用户访问

Li*reChat 是一套通过浏览器使用的自托管聊天系统。本文把 KingFlow AI 配置为 OpenAI 兼容自定义端点，并说明 Docker Compose 部署、密钥变量、li*rechat.yaml 挂载、模型选择、账号注册和更新备份。完成后，用户只需登录 Li*reChat 即可选择***批准的 KingFlow 模型，真实 API Key 保留在服务器端。

内容核验日期 2026-10-27

LibreChat 接入 KingFlow AI

接入架构

Li*reChat 在服务器端保存端点密钥并处理用户身份、对话和模型选择。

组件职责边界
浏览器用户登录并选择端点和模型不能直接读取服务端 API Key
Li*reChat API处理认证 会话和模型请求读取环境变量与自定义配置
MongoD* 和搜索服务保存账号 对话与检索数据需要随部署一起备份
KingFlow AI验证密钥并按模型 ID 路由使用 OpenAI 兼容 /v1 接口

开始前的准备

  • 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
  • 复制目标模型的完整模型 ID。建议先选一个文本模型完成联调，再逐步增加其他模型。
  • 准备 Git、Docker Desktop 或 Docker Engine，以及可以访问 3080 端口的本机环境。
  • 公网部署提前准备域名、****S 反向**和账号策略。服务端统一密钥不应配合开放注册直接上线。
  • 首次测试使用无敏感信息的提示词，确认模型、流式响应和费用归属后再导入正式数据。

先验证 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
  }'

安装 Li*reChat

git clone https://githu*.com/Li*reChat-AI/Li*reChat.git
cd Li*reChat
cp .env.example .env
docker compose up -d
文件用途管理原则
.env密钥 登录开关和服务器变量包含敏感信息 不提交版本库
li*rechat.yaml自定义端点 模型和界面设置需要挂载到 API 容器
docker-compose.yml官方服务定义升级时不要直接修改
docker-compose.override.yml本地挂载和端口覆盖保留自定义内容并随更新复用

配置服务器变量

KINGFLOW_API_KEY=sk-你的密钥
ALLOW_EMAIL_LOGIN=true
ALLOW_REG**TRATION=false
ALLOW_SOCIAL_LOGIN=false
ALLOW_SOCIAL_REG**TRATION=false
ALLOW_SHARED_LINKS_PU*LIC=false
# 需要强制本地账号启用两步验证时取消下一行注释
# ENFORCE_TWO_FACTOR_AUTHENTICATION=true

配置 KingFlow 自定义端点

version: 1.3.18
cache: true

endpoints:
  custom:
    - name: "KingFlow"
      apiKey: "${KINGFLOW_API_KEY}"
      *ase**L: "https://api.**nju**shen.com/v1"
      models:
        default:
          - "<完整模型ID>"
        fetch: false
      titleConvo: true
      titleModel: "<完整模型ID>"
      modelDisplayLa*el: "KingFlow AI"
字段示例值作用
nameKingFlow端点内部名称
apiKey${KINGFLOW_API_KEY}从 .env 读取密钥
*ase**Lhttps://api.**nju**shen.com/v1填写 /v1 根地址
models.default完整模型 ID界面可选模型列表
models.fetchfalse避免模型发现失败影响显示
titleModel完整模型 ID用于生成对话标题

挂载配置并重新启动

services:
  api:
    volumes:
      - type: **nd
        source: ./li*rechat.yaml
        target: /app/li*rechat.yaml
  1. 在 Li*reChat 项目根目录复制 .env.example 为 .env，并把教程中的环境变量追加到文件末尾。
  2. 创建 li*rechat.yaml，粘贴自定义端点配置，***模型占位符替换为真实模型 ID。
  3. 复制 docker-compose.override.yml.example 或新建同名文件，并挂载 li*rechat.yaml。不要直接改官方 docker-compose.yml。
  4. 执行 docker compose down && docker compose up -d，使密钥、端点和挂载同时生效。
  5. 运行 docker compose logs api 检查 YAML 校验和端点加载结果。出现校验错误时先修复缩进或字段名。
  6. 访问 http://localhost:3080，登录后从模型选择器选择 KingFlow AI 和目标模型。

管理模型列表

策略配置方式适用情况
单模型联调只列一个已验证模型最容易定位密钥和路由问题
多模型使用在 default 中逐行增加模型 ID每个模型先单独验证能力
自动发现把 fetch 改为 true仅在 /v1/models 稳定可用时开启
标题模型选择便宜且稳定的文本模型必须属于当前密钥可用分组

完成联调验证

  • 登录验证：关闭注册后，新浏览器不能自行创建账号。
  • 端点验证：模型选择器显示 KingFlow AI，并且只列出配置中的模型。
  • 短对话：发送一句短问题，确认流式回复完整且无 401、404 或 503。
  • 连续对话：追问三轮，检查上下文是否延续，标题是否正常生成。
  • 权限验证：普通用户不能查看其他用户的对话或服务端环境变量。
  • 重启验证：重新创建容器后，账号、对话和自定义端点仍然存在。
LibreChat 安全运维
图二 账号验证、两步认证、****S、密钥保护、配置校验、备份和监控构成部署安全边界。AI 生成示意图。

保护账号和服务端密钥

  • Li*reChat 默认允许邮箱注册。公网实例如果保存统一 KingFlow Key，应在开放访问前设置 ALLOW_REG**TRATION=false，并同时检查社交注册入口。
  • 单租户部署的第一个注册账号会获得***权限。应在本机或受限网络完成首次初始化，再关闭注册并对外开放。
  • 把 KINGFLOW_API_KEY 放在 .env 或受控密钥系统中，不要写进 li*rechat.yaml、Git、镜像层、聊天记录或截图。
  • 需要新增本地用户时，可运行 docker compose exec api npm run create-user，无需重新开放公共注册。
  • 正式环境可启用 ENFORCE_TWO_FACTOR_AUTHENTICATION=true。外部身份提供商的多因素认证由对应身份系统负责。
  • 使用 ****S 反向**，限制管理入口和异常请求频率。除非确有需求，保持 ALLOW_SHARED_LINKS_PU*LIC=false。

备份和更新

  • 备份 MongoD* 数据卷、MeiliSearch 或向量相关数据卷、.env、li*rechat.yaml 和 override 文件。只备份配置无法恢复用户对话。
  • 更新前记录当前镜像版本和配置文件版本，并保存脱敏副本。
  • 拉取新版本后重新应用 override，启动后检查 API 日志中的配置校验结果。
  • 更新后复测登录、模型列表、对话、标题生成和历史记录；异常时回到已验证的版本。

常见故障排查

现象常见原因处理方法
端点没有出现配置未挂载或容器未重启检查 override 挂载后重新创建容器
API 容器立即退出YAML 缩进 字段名或版本错误查看 docker compose logs api 并修复校验错误
401 未授权密钥错误 已停用或额度不可用重新复制密钥并检查 KingFlow 控制台
404 模型不存在模型 ID 错误或密钥分组不支持从控制台复制完整模型 ID
503 暂时不可用上游通道繁忙或暂无可用账号稍后有限重试或切换已授权模型
模型列表为空自动发现失败且默认列表为空设置 fetch false 并明确填写 default
回复被截断模型参数或**默认上限不匹配核对模型限制 必要时为端点增加明确参数
公网费用异常注册入口未关闭或账号泄露立即撤销密钥 关闭注册并审计账号

上线检查清单

  • KingFlow 最小 curl 请求已经成功。
  • KINGFLOW_API_KEY 只保存在服务器端，没有写入 YAML 或 Git。
  • li*rechat.yaml 已挂载到 /app/li*rechat.yaml 并通过配置校验。
  • 目标模型 ID 与 KingFlow 控制台一致，模型选择器显示正常。
  • 公网访问前已关闭不需要的注册和公开分享入口。
  • 短对话、连续对话、权限验证和容器重启验证均通过。
  • 数据库、搜索数据和配置文件已经纳入备份及回退方案。
文中的 API Key 和模型 ID 均为占位内容，请替换为自己的配置。

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

相关小说

为您推荐

小说标签