30分钟跑通LibreChat自托管从零部署到验收的完整实操教程【免费下载链接】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 账号对话记录散落在不同网页里想统一入口、把数据留在自己的服务器上没有现成工具。LibreChat 是一个开源自托管的 AI 聊天平台把 OpenAI、Anthropic、Google、Azure 等主流模型收进一个 ChatGPT 风格界面并附带 Agents、MCP 工具、消息搜索等功能。照着本文做完你将用 Docker Compose 把整套服务跑起来完成验收并掌握日志查看、备份和升级的基本操作。它是什么、适合谁LibreChat 面向想完全掌控 AI 基础设施的个人和团队数据存自己的 MongoDB模型用自己的 API Key界面功能对标 ChatGPT 并持续扩展。核心能力多模型自由切换OpenAI、Anthropic、Google、Azure、DeepSeek、OpenRouter 等Agents 与 MCP无代码搭建自定义助手接入外部工具服务器全量消息搜索Meilisearch 提供跨会话检索代码解释器沙箱内执行 Python、Node.js、Go 等多语言代码图像生成与编辑DALL-E、Stable Diffusion、MCP 图像模型多用户安全认证OAuth2、LDAP、邮箱登录与权限管理官方文档入口在仓库根目录 README.md中文说明见 README.zh.md。先选一条路部署路径上手难度适用对象Docker Compose低一条命令起全套服务个人、小型团队、单机服务器Helm Kubernetes中高需 K8s 集群和 Secret 配置企业级、多节点生产环境源码本地运行中需 Node/Bun 环境并编译贡献代码、深度定制本文主走 Docker ComposeHelm 和源码运行各一句带过即可。从零到跑通1. 克隆仓库把代码拉到你准备部署的机器上。git clone https://gitcode.com/GitHub_Trending/li/LibreChat cd LibreChat做完后应看到当前目录下有docker-compose.yml和.env.example两个文件说明拉取成功。2. 准备配置文件Docker Compose 从仓库根目录的.env读取端口、数据库地址和密钥所以先复制示例文件再改它。cp .env.example .env cp librechat.example.yaml ./librechat.yaml打开.env确认这三行按需填写PORT3080Web 访问端口、OPENAI_API_KEY你的密钥模型调用凭证、MEILI_MASTER_KEYMeilisearch 搜索引擎的访问主密钥留空会导致消息搜索不可用。3. 启动容器一条命令拉起 API、MongoDB、Meilisearch、pgvector 向量库、RAG API 和管理面板六个服务。docker compose up -d docker compose ps4. 配置模型密钥在.env里补上你实际要用的模型厂商密钥保存后重启 API 容器使其生效。docker compose restart apidocker compose ps里各服务状态回到running即配置加载完成。确认它真的跑起来了三条验收动作全部通过才算跑通浏览器访问http://localhost:3080看到登录页注册或登录账号能进入聊天界面健康检查接口curl http://localhost:3080/health返回OK且状态码 200执行docker compose psLibreChat、chat-mongodb、chat-meilisearch等容器均为运行状态无反复重启。常用配置与日常维护端口3080被占用时改.env中PORT或在docker-compose.override.yml里调整ports映射参考 docker-compose.override.yml.example。密钥所有敏感值统一写在.envYAML 里用${ENV_VAR}引用避免明文。资源限制docker-compose.override.yml中给api服务追加mem_limit、cpus限制防止单机内存打满。日志容器日志挂载到宿主机./logstail -f logs/下当日文件即可跟踪。监控定期curl http://localhost:3080/health探活。备份docker exec chat-mongodb mongodump --out ./data-node/backup数据目录就是./data-node。升级仓库自带向导脚本执行node config/update.js自动拉代码、装依赖、重建容器逻辑见 config/update.js。踩坑急救现象可能原因处理办法浏览器打不开localhost:30803080 端口被其他服务占用改.env中PORTdocker compose up -d重启消息搜索无结果、控制台报错MEILI_MASTER_KEY为空填入密钥后docker compose restart meilisearch apidocker compose up卡在拉取镜像网络无法访问镜像仓库docker compose pull单独执行看报错配置代理后重试对话报 401 或模型无响应OPENAI_API_KEY未填或失效更新.env后docker compose restart api容器因权限报错启动失败.env中UID/GID与宿主不符按.env注释填入本机用户 ID至此你手里已经有一个能登录、能切换模型、数据完全在自己服务器上的 LibreChat 实例。后续版本的功能与修复记录关注仓库更新日志遇到部署问题可查阅仓库 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），仅供参考