LibreChat：运营共享 AI 界面，而不只是聊天页面
部署 LibreChat：镜像、内网数据服务与可恢复存储
将开发导向的 Compose 示例转成明确部署方案，审查镜像和秘密，并把备份恢复纳入上线条件。
部署 LibreChat：镜像、内网数据服务与可恢复存储知识学习CN编辑简报更新 2026-09-18
你将学会
- 核对镜像和端口
- 示例凭据不是完成配置
- 先验证数据恢复
开始前需要
- 基本命令行与配置阅读能力
- 能够在独立且获准的环境中试验
设计只读监控，区分进程可达、应用就绪与模型对话成功，并为缺失样本保留未知状态。
先看结论
- 仓库固定不代表 latest 镜像固定。
- 示例公开部署前仍需安全配置。
- 回退必须考虑数据兼容性。
核对镜像和端口
固定 Compose 中应用及 RAG API 使用开发版 latest 标签。可重复发布应改为审阅过的版本或摘要，并记录组合；固定仓库提交并不会自动固定拉取到的镜像。
示例发布 API 和管理面板端口。要明确允许访问的接口和网络，并将公网入口放在获准的 TLS 与认证边界后；数据库服务应保留在受限内部网络。
示例凭据不是完成配置
MongoDB 在示例中使用 --noauth，向量数据库包含字面的示例账号密码。不能把这些服务暴露到公网，也不能把示例称为安全生产默认值；认证、可达范围和秘密存储都要审查。
管理面板要求 ADMIN_PANEL_SESSION_SECRET，审阅文件中的安全 Cookie 设置默认却为 false。需要按实际 HTTPS 环境配置，绝不能将示例秘密直接用于公开服务。
先验证数据恢复
盘点数据库、上传文件、图片、搜索数据及应用数据卷，在隔离环境验证恢复后再升级。回退容器镜像不一定能撤销数据库迁移，也不能自动恢复丢失的上传文件。
使用 /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
替换示例秘密，审查服务认证。
- 3
完成备份恢复和就绪验证。
可复制示例
json
{
"deploymentProposal": true,
"imageDigests": [],
"databasePublic": false,
"restoreTested": false,
"readinessPath": "/readyz"
}常见问题
可以原样发布 Compose 吗？
其中有开发标签和未完成的安全设置，应先审查。
只回退镜像够吗？
数据或迁移不兼容时不够。
资料来源
- LibreChat / docker-compose.yml来源核查 2026-09-18
- LibreChat / api/server/index.js来源核查 2026-09-18