LibreChat：运营共享 AI 界面，而不只是聊天页面
LibreChat 首次运行：先验证文本聊天再增加工具
准备本地试验，安全检查 Compose 配置，并区分应用尚未就绪与供应商连接失败。
LibreChat 首次运行：先验证文本聊天再增加工具知识学习CN编辑简报更新 2026-09-18
你将学会
- 准备受控版本
- 就绪后再发送对话
- 检查状态并正常退出
开始前需要
- 基本命令行与配置阅读能力
- 能够在独立且获准的环境中试验
设计只读监控，区分进程可达、应用就绪与模型对话成功，并为缺失样本保留未知状态。
先看结论
- 就绪与供应商连通性是不同检查。
- 展开配置可能泄露秘密。
- 普通停机不要删除持久数据卷。
准备受控版本
选择审阅过的发布版本或固定检出，并按照对应版本设置环境文件。Compose 引用 PORT、UID 和 GID 等变量，应明确填写，不能假设其他机器的示例可以原样使用。
解析后的 Compose 输出可能包含秘密，不要发布完整展开配置。可以使用 docker compose config --quiet 做语法检查，再在合适的本地环境中查看敏感设置。
就绪后再发送对话
启动经过审阅的服务后，在实际 API 端口检查 /livez 和 /readyz。源码允许存活检查成功而就绪仍为失败，此时新对话被拒绝，不应立刻归因于模型供应商。
使用实例配置的认证方式和一个获准供应商，发送简短的虚构问题，记录模型标识并检查返回文本。首次结果不需要上传文件、执行代码或接入外部代理工具。
检查状态并正常退出
重新加载对话，并在可丢弃试验中重启应用，检查历史是否保留。若记录消失，先查数据挂载和数据库连接，不要优先修改与持久化无关的模型配置。
希望继续试验时，停止服务但不要删除数据卷，保留脱敏日志供排查。下方命令描述的是检查路径，不代表本系列已经真实运行了这套服务。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
不打印秘密地验证配置。
- 2
启动受控服务并等待 /readyz。
- 3
发送文本问题并检查重启后的历史。
可复制示例
sh
docker compose config --quiet
docker compose up -d
# 3080 只是示例，请使用配置的 API 端口。
curl --fail http://127.0.0.1:3080/readyz常见问题
/livez 成功但聊天失败怎么办？
先看 /readyz 和脱敏初始化日志，判断是否仍未就绪。
第一次应该上传私人文件吗？
先用虚构文本，待数据处理范围获准后再扩大。
资料来源
- LibreChat / README.md来源核查 2026-09-18
- LibreChat / docker-compose.yml来源核查 2026-09-18
- LibreChat / api/server/index.js来源核查 2026-09-18