LibreChat 自托管部署与日常运维指南Docker Compose 四步上线【免费下载链接】LibreChatEnhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active项目地址: https://gitcode.com/GitHub_Trending/li/LibreChat把对话数据收进自己的服务器是自托管最现实的理由。LibreChat 是一个支持 OpenAI、Anthropic、Gemini 等多家模型提供商的开源 AI 聊天平台内置消息搜索、代码解释器与多用户权限。读完本文你能完成 LibreChat 自托管部署并掌握健康检查、日志排查与数据备份。项目定位它凭什么替代第三方聊天框LibreChat 是一个开源的增强版 ChatGPT模型调用走你自己的密钥全部对话数据落在你自己的数据库里。核心能力支持 OpenAI、Anthropic、Azure、Gemini、DeepSeek、Groq 等 20 提供商会话内随时切换模型消息全文搜索、书签、共享链接代码解释器Code Interpreter、DALL-E-3 绘图、ArtifactsMCP、Skills、Agents 等插件化扩展机制多用户安全认证与角色权限选型指南单机 Compose 还是集群 K8s维度Docker ComposeHelm Kubernetes上手成本低一条命令起全部服务较高需 K8s 基础扩展能力单机多副本、可横向扩展发布方式重启容器Helm 滚动升级适用场景个人、小团队企业多节点、高可用结论没有多节点需求就选 Docker Compose简单且够用只有当你需要集群化、自动扩缩容时再上 K8s。快速上手Docker Compose 四步完成 LibreChat 部署第 1 步拉取代码git clone https://gitcode.com/GitHub_Trending/li/LibreChat cd LibreChat预期看到本地出现docker-compose.yml、.env.example、librechat.example.yaml。判据clone 无报错。第 2 步配置密钥cp .env.example .env打开.env至少补全三项OPENAI_API_KEY你要用的模型提供商密钥、MEILI_MASTER_KEYMeilisearch 主密钥任意随机串、JWT_SECRET会话签名密钥。更细的提供商与界面配置写在 YAML 配置文件中参考 librechat.example.yaml 里的注释。判据三个变量都有真实值无空占位。第 3 步启动服务docker compose up -d预期看到MongoDB、Meilisearch、API 等容器依次拉起一两分钟后docker compose ps全部在线。判据没有容器停留在 Exited 状态。第 4 步验证访问curl http://localhost:3080/health预期看到返回OK。再用浏览器打开http://localhost:3080出现注册/登录页。判据能创建出第一个账号并发起一次对话 集群进阶Helm K8s 部署三步走修改 helm/librechat/values.yaml必改字段global.librechat.existingSecretName指向集群里已创建的 Secret 名global.librechat.existingSecretApiKeySecret 中模型密钥的键名如OPENAI_API_KEYSecret 内需包含JWT_SECRET、MEILI_MASTER_KEY等其余环境变量放librechat.configEnv部署helm install librechat ./helm/librechat -n librechat --create-namespace验证kubectl get pods -n librechat判据所有 Pod 为Running且 RESTARTS 为 0。运维清单每天两件事定期两件事每天健康检查curl http://localhost:3080/health应始终返回OK建议挂进 cron 或监控告警看日志docker compose logs -f api看实时报错Compose 模式下日志会挂到宿主机./logs目录留意是否有持续增长的错误日志 ✅定期升级node config/update.js会拉新代码、更新依赖并重启服务脚本逻辑见 config/update.js数据备份docker exec chat-mongodb mongodump --out /data/backup导出 MongoDB再用docker cp拷回宿主机Meilisearch 数据在本地挂载目录一并打包判据备份文件能在测试环境恢复并查到历史会话问题速查现象启动后 3080 端口被占用原因主机上已有其他服务占用了该端口。 解决把.env里的PORT改成 3081 之类未占用的端口或调整 docker-compose.yml 中的端口映射然后重启容器。现象服务起不来或界面频繁 500原因配置错误——密钥缺失、格式不对或数据库连接串错误。 解决docker compose logs -f api定位报错最常见的是MEILI_MASTER_KEY未设置或MONGO_URI与实际 Mongo 地址不一致。现象并发一高就卡顿甚至内存告警原因API 容器受限于宿主机资源且请求重复计算。 解决在 Compose 中为 api 服务限制 CPU/内存K8s 则调高 requests/limits同时确认配置中cache: true已启用缓存 ⚠️从单机试用到集群上线这条路径能覆盖绝大多数团队的 LibreChat 自托管需求。现在就执行docker compose up -d把属于你的聊天系统跑起来吧。【免费下载链接】LibreChatEnhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active项目地址: https://gitcode.com/GitHub_Trending/li/LibreChat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
LibreChat 自托管部署与日常运维指南：Docker Compose 四步上线
LibreChat 自托管部署与日常运维指南Docker Compose 四步上线【免费下载链接】LibreChatEnhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active项目地址: https://gitcode.com/GitHub_Trending/li/LibreChat把对话数据收进自己的服务器是自托管最现实的理由。LibreChat 是一个支持 OpenAI、Anthropic、Gemini 等多家模型提供商的开源 AI 聊天平台内置消息搜索、代码解释器与多用户权限。读完本文你能完成 LibreChat 自托管部署并掌握健康检查、日志排查与数据备份。项目定位它凭什么替代第三方聊天框LibreChat 是一个开源的增强版 ChatGPT模型调用走你自己的密钥全部对话数据落在你自己的数据库里。核心能力支持 OpenAI、Anthropic、Azure、Gemini、DeepSeek、Groq 等 20 提供商会话内随时切换模型消息全文搜索、书签、共享链接代码解释器Code Interpreter、DALL-E-3 绘图、ArtifactsMCP、Skills、Agents 等插件化扩展机制多用户安全认证与角色权限选型指南单机 Compose 还是集群 K8s维度Docker ComposeHelm Kubernetes上手成本低一条命令起全部服务较高需 K8s 基础扩展能力单机多副本、可横向扩展发布方式重启容器Helm 滚动升级适用场景个人、小团队企业多节点、高可用结论没有多节点需求就选 Docker Compose简单且够用只有当你需要集群化、自动扩缩容时再上 K8s。快速上手Docker Compose 四步完成 LibreChat 部署第 1 步拉取代码git clone https://gitcode.com/GitHub_Trending/li/LibreChat cd LibreChat预期看到本地出现docker-compose.yml、.env.example、librechat.example.yaml。判据clone 无报错。第 2 步配置密钥cp .env.example .env打开.env至少补全三项OPENAI_API_KEY你要用的模型提供商密钥、MEILI_MASTER_KEYMeilisearch 主密钥任意随机串、JWT_SECRET会话签名密钥。更细的提供商与界面配置写在 YAML 配置文件中参考 librechat.example.yaml 里的注释。判据三个变量都有真实值无空占位。第 3 步启动服务docker compose up -d预期看到MongoDB、Meilisearch、API 等容器依次拉起一两分钟后docker compose ps全部在线。判据没有容器停留在 Exited 状态。第 4 步验证访问curl http://localhost:3080/health预期看到返回OK。再用浏览器打开http://localhost:3080出现注册/登录页。判据能创建出第一个账号并发起一次对话 集群进阶Helm K8s 部署三步走修改 helm/librechat/values.yaml必改字段global.librechat.existingSecretName指向集群里已创建的 Secret 名global.librechat.existingSecretApiKeySecret 中模型密钥的键名如OPENAI_API_KEYSecret 内需包含JWT_SECRET、MEILI_MASTER_KEY等其余环境变量放librechat.configEnv部署helm install librechat ./helm/librechat -n librechat --create-namespace验证kubectl get pods -n librechat判据所有 Pod 为Running且 RESTARTS 为 0。运维清单每天两件事定期两件事每天健康检查curl http://localhost:3080/health应始终返回OK建议挂进 cron 或监控告警看日志docker compose logs -f api看实时报错Compose 模式下日志会挂到宿主机./logs目录留意是否有持续增长的错误日志 ✅定期升级node config/update.js会拉新代码、更新依赖并重启服务脚本逻辑见 config/update.js数据备份docker exec chat-mongodb mongodump --out /data/backup导出 MongoDB再用docker cp拷回宿主机Meilisearch 数据在本地挂载目录一并打包判据备份文件能在测试环境恢复并查到历史会话问题速查现象启动后 3080 端口被占用原因主机上已有其他服务占用了该端口。 解决把.env里的PORT改成 3081 之类未占用的端口或调整 docker-compose.yml 中的端口映射然后重启容器。现象服务起不来或界面频繁 500原因配置错误——密钥缺失、格式不对或数据库连接串错误。 解决docker compose logs -f api定位报错最常见的是MEILI_MASTER_KEY未设置或MONGO_URI与实际 Mongo 地址不一致。现象并发一高就卡顿甚至内存告警原因API 容器受限于宿主机资源且请求重复计算。 解决在 Compose 中为 api 服务限制 CPU/内存K8s 则调高 requests/limits同时确认配置中cache: true已启用缓存 ⚠️从单机试用到集群上线这条路径能覆盖绝大多数团队的 LibreChat 自托管需求。现在就执行docker compose up -d把属于你的聊天系统跑起来吧。【免费下载链接】LibreChatEnhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active项目地址: https://gitcode.com/GitHub_Trending/li/LibreChat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
