主题
Docker 本地私有化部署 LibreChat:一键接入 DeepSeek/OpenAI/Claude 打造全能 AI 工作台 (2026最新)
在 2026 年,随着 DeepSeek-R1、OpenAI o1、Claude 3.5 Sonnet 及 Google Gemini 1.5 Pro 等大模型的爆发,许多开发者和企业团队面临着一个共同痛点:
- 每次切换模型都需要登录不同的官网后台,不仅需要开通多份昂贵的月度会员,而且对话记录分散各处;
- 商业网页端存在对话数据被用于云端模型训练的隐私隐患;
- 官方 Web 端由于国内网络阻断,频繁遭遇 403 拒访报错。
如何搭建一个界面完全媲美官方 ChatGPT、支持多模型自由无缝切换、对话数据 100% 本地加密私有化存储的专属 AI 工作台?
开源项目 LibreChat 就是目前全网公认的最佳终极解法。
本文为您送上 2026 最新 LibreChat 极速 Docker Compose 私有化部署与 API 中转接入保姆级教程。
💎 什么是 LibreChat?核心特性一览
LibreChat 是目前 GitHub 上星标最高、体验最完美的开源全功能 AI 对话平台:
- 多模型自由混用:在同一个聊天窗口内,随时下拉切换 DeepSeek-R1、OpenAI o1、Claude 3.5 Sonnet、Mistral 等主流大模型;
- 完全支持 Artifacts 与代码实时预览:拥有类似 Claude Artifacts 的独立分屏代码与 HTML/React 网页实时渲染能力;
- 多模态与文件深度分析:支持上传 PDF、Excel、Word 文档进行 RAG 知识库问答与 DALL-E 3 绘图;
- 100% 数据私有化:所有 Prompt、历史对话与配置均存储在本地 MongoDB 数据库中,杜绝数据泄露。
🚀 步骤一:准备 Docker Compose 配置文件
在您的电脑或云服务器(Linux / macOS / Windows)上新建一个文件夹(例如 librechat),并在其中创建 docker-compose.yml 文件:
yaml
version: '3.8'
services:
api:
image: ghcr.io/danny-avila/librechat:latest
container_name: LibreChat
ports:
- "3080:3080"
depends_on:
- mongodb
environment:
- HOST=0.0.0.0
- PORT=3080
- MONGO_URI=mongodb://mongodb:27017/LibreChat
- DOMAIN_CLIENT=http://localhost:3080
- DOMAIN_SERVER=http://localhost:3080
- JWT_SECRET=your_jwt_secret_key_2026_ygjc
- JWT_REFRESH_SECRET=your_jwt_refresh_key_2026_ygjc
- CREDS_KEY=f34be41386de96d4f92a53a73e80cb7b
- CREDS_IV=e5b341a46041107d67b1c621666f2206
volumes:
- ./librechat.yaml:/app/librechat.yaml
- ./images:/app/client/public/images
restart: always
mongodb:
image: mongo:latest
container_name: chat-mongodb
volumes:
- ./data-node:/data/db
restart: always⚙️ 步骤二:编写 librechat.yaml 接入多模型 API
在同一个目录下创建 librechat.yaml,填入您的 DeepSeek 与 OpenAI 中转 API 密钥:
yaml
version: 1.1.5
custom:
# 接入 DeepSeek-R1 / V3
- name: "DeepSeek"
apiKey: "${DEEPSEEK_API_KEY}"
baseURL: "https://api.deepseek.com/v1"
models:
default: ["deepseek-chat", "deepseek-reasoner"]
titleConvo: true
modelDisplayLabel: "DeepSeek R1"
# 接入 OpenAI o1 / GPT-4o
- name: "OpenAI"
apiKey: "${OPENAI_API_KEY}"
baseURL: "https://api.openai.com/v1"
models:
default: ["gpt-4o", "o1-preview", "o1-mini"]
titleConvo: true结合 Cursor 与 VS Code API 中转接入 或 DeepSeek-R1 本地 Ollama 部署,您可以以极低成本获得顶级 AI 算力。
🐳 步骤三:一键启动与后台访问
在终端进入该目录,运行以下指令启动容器:
bash
docker compose up -d启动完成后,打开浏览器访问:http://localhost:3080。
- 首次访问点击 “Sign up (注册)” 创建首个账户,该账户将自动获取最高管理员权限;
- 在设置中可将语言切换为简体中文,开启深色模式与代码渲染。
🌐 网络代理与服务器出海建议
如果您的服务器部署在大陆境内,Docker 容器请求 api.openai.com 或 api.anthropic.com 会因网络阻断而报错超时:
- 解决方案:在服务器上部署科学上网客户端(如开启 Clash Verge Rev TUN 模式),或者直接购买海外免翻墙轻量 VPS。推荐搭配拥有稳定 IEPL 专线中转的机场节点(如 红杏云 或 鹿语云)为服务器代理保驾护航。
四、 总结与延伸阅读
通过 Docker 私有化部署 LibreChat,您可以彻底告别官方多账号切换的繁琐,实现真正属于个人的全能 AI 生产力终端。
延伸阅读:
国家利益和民族团结高于一切
使用网络时请严格遵守国家法律法规规定,请勿从事色情、暴恐、破坏国家安全等违反国家法律的活动,科学上网,不谈政治,不谈宗教,不碰黄赌毒。龙的传人需自律,有损国家利益和民族团结的事情,坚决不做!


