LibreChat 自托管教程3 条命令跑起私有 AI 聊天平台的完整部署与运维指南【免费下载链接】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/LibreChatAI 服务用着不自由对话记录存在别人服务器上、模型切换受限、团队没法统一管理和计费——这些问题的答案其实都指向同一个动作自己部署一套 LibreChat。它是一个开源的增强版 ChatGPT 客户端把 OpenAI、Anthropic、DeepSeek、Gemini、Groq、Ollama 等主流模型聚合在一个界面里还内置了 Agents、MCP 工具接入、代码解释器、消息全文搜索和多用户安全认证数据全部落在你自己的机器上。这篇文章按先跑起来 → 再懂配置 → 后做选型 → 最后会运维的顺序展开全程面向新手不需要你懂 Kubernetes。为什么值得自己部署一套 LibreChat在动手之前先说清楚它和直接用官方网页版差在哪避免你为了部署而部署模型自由切换不被单一平台锁定一个账号里同时挂 OpenAI、Claude、DeepSeek、本地 Ollama 的 key聊天中途随时换模型、换预设。支持 Apple MLX 这类本地推理框架敏感数据甚至可以不出内网。对话数据归你MongoDB、Meilisearch、向量库全部跑在你自己的容器里消息、文件、分享链接都不经过第三方服务器。多用户场景有内置的 OAuth2 / LDAP / 邮箱登录和权限体系给团队用不用另找认证方案。功能超出聊天框的范畴内置 Agents 构建器可挂 MCP 服务器、Skills、代码执行、DALL-E-3 等图像生成、对话导入导出支持从 ChatGPT 迁移、断点续传的流式响应还有浏览器管理面板在线改配置而不用重新部署。如果你只是个人尝鲜单机 Docker Compose 足够如果是团队或生产环境后面的 Helm 章节再来看。最快上手路径3 条命令先让 LibreChat 跑起来这一步的目标只有一个先把界面看到。密钥可以后面慢慢补服务本身先跑起来。git clone https://gitcode.com/GitHub_Trending/li/LibreChat cd LibreChat cp .env.example .env docker compose up -d浏览器打开http://localhost:3080就能看到登录/注册界面注册第一个账号即为管理员。docker compose up实际拉起的不止一个容器。看 docker-compose.yml 可以确认整个技术栈容器作用LibreChatapi主服务前端 后端 API对外端口 3080admin-panel浏览器管理面板端口 3000chat-mongodbMongoDB 8.0存用户、会话、消息chat-meilisearchMeilisearch消息全文搜索vectordbrag_apipgvector RAG API文档问答用数据都写在项目目录里data-node/、meili_data_v1.35.1/、logs/、uploads/这也直接决定了后面怎么备份。如果端口 3080 被占用在.env里把PORT改成别的值即可compose 文件会跟随变量映射不用动 YAML。关键配置详解只改这几个地方跑通之后别急着用完就跑有 4 组参数建议花 5 分钟过一遍。环境变量在.env模板是 .env.example模型端点和高级功能在librechat.yaml模板是 librechat.example.yaml。1. 模型密钥决定你能聊什么按你实际要用的供应商在.env里填对应的 key例如OPENAI_API_KEY。不用的供应商留空即可不填不影响启动。想让本地模型出现在列表里在librechat.yaml里启用 Ollama 端点并指向http://host.docker.internal:11434。2. 会话安全强烈建议改JWT_SECRET一段足够长的随机字符串JWT_SECRET是登录令牌的签名密钥留空意味着任何拿到代码的人都能伪造你的登录态。同样道理管理面板需要ADMIN_PANEL_SESSION_SECRET不设置时 admin-panel 容器会拒绝启动——这个报错是特性不是 bug。3. 搜索开关SEARCHtrue MEILI_MASTER_KEY随机长字符串两者同时设置后消息全文搜索才真正启用。Meilisearch 的 master key 是它的唯一口令务必别用网上公开的默认值。4. 端口与域名PORT3080控制对外端口DOMAIN_CLIENT/DOMAIN_SERVER在你要挂到自定义域名配合反向代理时填成实际域名否则保持默认的http://localhost:3080。改完配置后重启生效docker compose up -d部署方案选型单机还是集群前面是怎么做这里回答怎么选。三种典型路径方案适用场景特点Docker Compose单机个人、小团队、内网一条命令起步配置全在本机目录备份就是拷目录手动反向代理 独立数据服务已有 MongoDB/Meilisearch 的中间件环境复用现成中间件省去容器里的重复实例运维链路自己拼Helm Kubernetes企业多节点、需要弹性扩缩声明式配置配合 Secret 管理密钥升级可滚动Kubernetes 部署要点Helm chart 在 helm/librechat/密钥不要明文写进 values 文件先创建 Kubernetes Secret再在 values.yaml 里引用global: librechat: existingSecretName: librechat-credentials-env existingSecretApiKey: OPENAI_API_KEY安装并验证helm install librechat ./helm/librechat --namespace librechat --create-namespace kubectl get pods -n librechat需要横向扩展流式响应时按仓库说明接入 Redisredis-config/目录内有现成的集群脚本和 TLS 配置示例。一个经验法则用户少于 50 人停在 Docker Compose 就够了把时间花在配置和功能上比花在编排上更划算。运维与排障按症状 → 定位 → 解决来处理日常运维就四件事看状态、看日志、更新、备份。出问题时按下面对照排查。服务是否活着curl http://localhost:3080/health健康检查端点定义在 api/server/index.js。返回正常就基本排除主进程问题异常则继续看日志。服务起不来 / 白屏 / 报错docker compose logs -f api按日志定位三类高频原因Meilisearch 连接失败、搜索不工作→ 检查.env里SEARCH和MEILI_MASTER_KEY是否成对配置MEILI_HOST与 compose 里的http://meilisearch:7700是否一致。登录态异常、刷新即掉线→JWT_SECRET被改过或为空。admin-panel 容器反复重启→ADMIN_PANEL_SESSION_SECRET未设置面板故意拒绝启动。日常日志日志落在项目目录的logs/容器挂载自/app/logs按天分文件tail -f logs/debug-$(date %F).log版本更新仓库自带更新脚本 config/update.js拉代码、装依赖、重启一条龙node config/update.js升级前看一眼 README.md 里的 Changelog 说明确认没有 breaking change 再执行。数据备份所有对话数据都在 MongoDB定期 dump 一份docker exec chat-mongodb mongodump --out /data/backup/$(date %Y%m%d)注意容器内的挂载路径compose 里是./data-node:/data/db宿主机侧把data-node/、meili_data_v1.35.1/、uploads/三个目录一并纳入备份范围即可。高并发场景的性能调节在docker-compose.override.yml仓库提供 docker-compose.override.yml.example 作为参考中给 api 服务加资源限制例如 2 核 CPU / 2G 内存避免单机被单一实例吃满。下一步把它变成团队入口到这里你已经有一台自己掌控的 AI 聊天平台3 条命令起步、4 组关键配置、一套按症状排障的运维节奏。建议接着做三件事去管理面板端口 3000给团队成员开账号、配角色权限在librechat.yaml里把真正要用的模型端点固定下来做成团队默认预设把mongodump备份写进 crontab别让数据只活在一个目录里。遇到 bug 或想要新功能直接到 README.md 提到的官方 Issue 渠道反馈翻译贡献也长期开放。自托管的意义在于出了问题你能打开源码看懂它祝部署顺利。【免费下载链接】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），仅供参考