LibreChat

挂载 LibreChat 自定义端点配置，让用户提供自己的密钥。

安装与准备

安装 Git、Docker 和 Docker Compose，按 LibreChat Docker 部署克隆仓库、将 .env.example 复制为 .env，并启动含 MongoDB 的 Compose 服务。打开 http://localhost:3080 注册账号。 选择此端点前，每位用户应在 routerra.ai/keys创建自己的网关密钥。

git clone https://github.com/LibreChat-AI/LibreChat.git
cd LibreChat
cp .env.example .env
docker compose up -d

配置连接

在仓库根目录按下例创建 librechat.yaml；version 是 YAML 配置架构版本，不是应用版本。通过 docker-compose.override.yml 将文件挂载到 api 服务的 /app/librechat.yaml。apiKey: user_provided 让每位登录用户选择 routerra.ai 时自行输入 YOUR_API_KEY，无需共享密钥环境变量。若使用共享密钥，改为 apiKey: "${ROUTERRA_API_KEY}"，并在 .env 添加 ROUTERRA_API_KEY=YOUR_API_KEY。

version: 1.3.17
endpoints:
  custom:
    - name: routerra.ai
      apiKey: user_provided
      baseURL: https://routerra.ai/v1
      models:
        default: [YOUR_MODEL_ID]
        fetch: false

挂载配置文件

将此卷配置加入仓库根目录的 docker-compose.override.yml，与已有 api 覆盖配置合并。

services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml:ro

选择模型与排查错误

运行 docker compose up -d --force-recreate 重建服务。选择 routerra.ai，输入密钥并选 YOUR_MODEL_ID，发送短消息。fetch: false 使用明确的 default 列表；改为 true 可从服务器发现模型。端点消失时检查挂载、必填字段 name/baseURL/apiKey/models、YAML 缩进和名称唯一性。用 docker compose logs api 查看启动错误。修改配置后必须重启。