跳转到内容

在 VPS 上使用 Docker 部署 LobeChat:打造你的私有全能 AI 助手

LobeChat Deployment Banner

进入 2026 年,大模型(LLM)的生态已经极其繁荣。我们不仅有 OpenAI 的 GPT-4o、Anthropic 的 Claude 3.5,更有国产极具性价比且性能强悍的 DeepSeek R1,以及可以通过 Ollama 在本地运行的无数开源模型。

面对这么多优秀的模型,如果每个都去对应的官网使用,来回切换不仅麻烦,而且很多高级功能(如自定义角色、专属插件、多平台同步)往往需要开通高昂的订阅服务。

今天,我们将介绍如何在你自己的 VPS 上,使用 Docker 部署目前最惊艳的开源 AI 交互面板——LobeChat。它不仅颜值极高、支持几乎所有的主流模型接入,还能让你真正将 AI 变成全平台的“个人助理”。


一、 为什么选择自建 LobeChat?

LobeChat 是一款开源的、现代化的、支持丰富特性的 AI 对话客户端。与 ChatGPT 官方网页端相比,自建 LobeChat 拥有以下无可比拟的优势:

  1. All in One(全能聚合):可以在同一个聊天界面中,一键在 GPT-4、Claude、DeepSeek、Gemini 以及本地 Ollama 模型之间切换。
  2. 极佳的视觉与交互体验:原生支持 PWA(可以像独立 App 一样安装在手机或电脑上),支持深色模式,界面设计非常符合现代审美。
  3. 强大的插件生态:支持通过插件访问互联网、搜索网页、生成图表甚至自动化执行脚本。
  4. 数据隐私与掌控:你的所有对话记录保存在你自己的服务器或本地浏览器中,绝不上传给任何第三方客户端收集者。
  5. 极低的成本:通过配置 API 密钥,你可以直接按量付费使用大模型(例如便宜到令人发指的 DeepSeek API),再也不用每月支付 20 美元的订阅费。

二、 部署前的准备工作

在开始部署之前,你需要准备以下基础设施:

  • 一台 VPS:推荐 1核 CPU、1GB 以上内存。操作系统建议使用 Debian 12 或 Ubuntu 22.04/24.04。如果你还没有 VPS,可以参考我的 RackNerd 优惠购买指南 或寻找其他的海外高性价比主机。
  • 已安装 Docker 和 Docker Compose:Docker 是目前部署服务端应用最方便的工具。如果你还没有安装,可以在 SSH 终端中运行以下一键脚本安装:
    bash
    curl -fsSL https://get.docker.com | sh
  • 一个域名:为了安全地通过 HTTPS 访问 LobeChat,并方便记忆,你需要一个域名并将其解析到你的 VPS IP 上。

三、 使用 Docker 部署 LobeChat

登录到你的 VPS 终端(推荐使用 Tabby 或任何你喜欢的 SSH 客户端),按照以下步骤操作:

1. 创建应用目录

良好的习惯是为每个 Docker 应用创建独立的目录,这有助于后期的数据备份与管理。

bash
mkdir -p /opt/lobechat
cd /opt/lobechat

2. 编写 docker-compose.yml

在目录中创建一个 docker-compose.yml 文件。我们将使用这个文件来定义 LobeChat 容器的运行参数。

bash
nano docker-compose.yml

将以下内容粘贴到文件中:

yaml
version: '3.8'

services:
  lobechat:
    image: lobehub/lobe-chat:latest
    container_name: lobechat
    restart: always
    ports:
      - '3210:3210'
    environment:
      # (选填)这里可以预设你的 Access Code,作为访问你的 LobeChat 的密码
      - ACCESS_CODE=Your_Super_Secret_Password_123!
      
      # (选填)预设 OpenAI API Key
      - OPENAI_API_KEY=sk-xxxxxx
      
      # (选填)如果使用 API 代理地址,填入代理 URL
      # - OPENAI_PROXY_URL=https://api.openai-proxy.com/v1
      
      # (选填)预设 DeepSeek API Key
      - DEEPSEEK_API_KEY=sk-xxxxxx
      
      # 关闭官方日志遥测,保护隐私
      - NEXT_TELEMETRY_DISABLED=1

参数说明:

  • ports: '3210:3210':左侧的 3210 是暴露给 VPS 宿主机的端口,右侧是容器内端口。
  • ACCESS_CODE:强烈建议设置!这是你专属的访问密码,防止互联网上的陌生人滥用你的 API 额度。
  • 你可以直接在部署时将各种 API Key 写死在环境变量中,也可以不写,等部署完成后在网页端的设置中手动输入(推荐后者,更加灵活)。

3. 启动容器

保存并退出编辑器后(Nano 按 Ctrl+O 存盘,Enter 确认,Ctrl+X 退出),在终端执行:

bash
docker compose up -d

等待镜像拉取完毕并启动。执行 docker compose logs -f 如果看到类似 Ready on http://localhost:3210 的提示,说明部署已经成功。

此时,你可以通过 http://你的VPS_IP:3210 在浏览器中访问 LobeChat 面板。但这非常不安全,接下来我们需要配置反向代理和 HTTPS 加密访问。


四、 配置域名与反向代理

让 LobeChat 支持 HTTPS 是非常重要的步骤,这不仅是为了防止中间人嗅探你的聊天记录和 API Key,很多浏览器特性(如麦克风语音输入、PWA 离线安装)也都强制要求在 HTTPS 环境下运行。

方案 A:使用 Nginx 反向代理

如果你的 VPS 已经安装了 Nginx,可以直接添加一个虚拟主机配置(请参考本站关于配置 Nginx 的相关笔记):

nginx
server {
    listen 80;
    server_name ai.yourdomain.com;
    
    # 强制跳转 HTTPS
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name ai.yourdomain.com;

    # 这里替换为你申请好的 SSL 证书路径
    ssl_certificate /etc/nginx/ssl/yourdomain.com.crt;
    ssl_certificate_key /etc/nginx/ssl/yourdomain.com.key;

    location / {
        proxy_pass http://127.0.0.1:3210;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_addrs;
        
        # 支持 WebSocket,LobeChat 的某些实时功能需要
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

配置完成后,重启 Nginx:systemctl restart nginx

方案 B:使用 Cloudflare Tunnel(最省心推荐)

如果你不想折腾 Nginx 和 SSL 证书申请,使用 Cloudflare Tunnel 是目前最优雅的解决方案。它能直接将内网服务暴露给公网,自带 HTTPS,并且不需要在 VPS 的防火墙上开放 3210 端口。

  1. 在 Cloudflare 面板的 Zero Trust 控制台中创建一个 Tunnel。
  2. 将分配的 cloudflared 启动命令在 VPS 终端执行。
  3. 在 Public Hostname 中,将你的域名(如 chat.example.com)映射到 http://localhost:3210
  4. 一键保存,立刻就可以通过 HTTPS 安全访问你的 LobeChat 了。

五、 LobeChat 的核心配置与进阶玩法

成功访问你的域名后,你将看到 LobeChat 极其惊艳的用户界面。输入你刚才在 Docker 环境变量中配置的 ACCESS_CODE,进入系统设置。

1. 配置 DeepSeek 等大模型 API

LobeChat 的最大魅力在于对模型生态的支持极其全面。 进入左下角的设置 (Settings) -> 语言模型 (Language Models)

  • 找到 DeepSeek 服务商,填入你在官方申请的 API Key。检查连通性,即可开启 V3 和 R1 模型。
  • 同样的,你可以填入 OpenAI、Anthropic (Claude)、Google (Gemini) 的 API Key。
  • 开启按需计费的 API 后,你会发现日常使用的成本往往不到官方月费的十分之一!

2. 接入本地 Ollama 模型

如果你按照我们的 Ollama 部署教程 在另一台有 GPU 的机器(甚至就是你的这台 VPS)上运行了本地大模型,你可以轻松将其接入 LobeChat。

在模型设置中找到 Ollama,输入 Ollama 服务的 API 地址(默认是 http://你的IP:11434)。LobeChat 会自动获取并展示你本地已下载的所有模型。这样,当你需要处理极端私密的代码或数据时,只需切换到本地模型,即可实现 100% 的物理级隐私保护。

3. 安装角色与插件

在应用商店(Marketplace)里,你可以发现大量的用户共享的“助手预设(Agents)”。它们通过精调的 System Prompt(系统提示词),让 AI 可以立刻变成专业的翻译官、资深前端程序员、雅思口语陪练老师。

同时,不要忘了探索插件 (Plugins)。开启插件功能后,LobeChat 可以:

  • 联网搜索最新的新闻。
  • 通过 DALL-E 3 或者 Midjourney 接口画图。
  • 直接读取并总结给定的网页链接或 PDF 文档。

🛡️ 结语

恭喜你!通过这套方案,你已经在这个 AI 爆发的 2026 年,建立了一个属于自己、数据可控、并且支持几乎全网顶级大模型的终极个人助理。

不论是在电脑前工作,还是在手机端通勤,只需打开浏览器或者 PWA 应用,你的 LobeChat 随时待命。它不仅极大提升了信息获取和内容生产的效率,更重要的是,它让你真正成为了 AI 工具的主人,而不是大厂订阅制的打工仔。

快去调教属于你的第一个 AI 角色吧!


延伸阅读

免责声明

本文仅供技术交流和学习参考。涉及第三方服务的链接可能包含 sponsored 标记,请自行核实服务条款、价格和可用性,并遵守当地法律法规。