Skip to content
银河录像局gpt

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 对话平台:

  1. 多模型自由混用:在同一个聊天窗口内,随时下拉切换 DeepSeek-R1、OpenAI o1、Claude 3.5 Sonnet、Mistral 等主流大模型;
  2. 完全支持 Artifacts 与代码实时预览:拥有类似 Claude Artifacts 的独立分屏代码与 HTML/React 网页实时渲染能力;
  3. 多模态与文件深度分析:支持上传 PDF、Excel、Word 文档进行 RAG 知识库问答与 DALL-E 3 绘图;
  4. 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.comapi.anthropic.com 会因网络阻断而报错超时:

  • 解决方案:在服务器上部署科学上网客户端(如开启 Clash Verge Rev TUN 模式),或者直接购买海外免翻墙轻量 VPS。推荐搭配拥有稳定 IEPL 专线中转的机场节点(如 红杏云鹿语云)为服务器代理保驾护航。

四、 总结与延伸阅读

通过 Docker 私有化部署 LibreChat,您可以彻底告别官方多账号切换的繁琐,实现真正属于个人的全能 AI 生产力终端。

延伸阅读:


国家利益和民族团结高于一切

使用网络时请严格遵守国家法律法规规定,请勿从事色情、暴恐、破坏国家安全等违反国家法律的活动,科学上网,不谈政治,不谈宗教,不碰黄赌毒。龙的传人需自律,有损国家利益和民族团结的事情,坚决不做!