接入架构

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

开始前的准备

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

配置服务器变量

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"

挂载配置并重新启动

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 和目标模型。

管理模型列表

完成联调验证

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

保护账号和服务端密钥

• 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 日志中的配置校验结果。
• 更新后复测登录、模型列表、对话、标题生成和历史记录；异常时回到已验证的版本。

常见故障排查

上线检查清单

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