在 VPS 上使用 Docker 部署 LobeChat:打造你的私有全能 AI 助手
进入 2026 年,大模型(LLM)的生态已经极其繁荣。我们不仅有 OpenAI 的 GPT-4o、Anthropic 的 Claude 3.5,更有国产极具性价比且性能强悍的 DeepSeek R1,以及可以通过 Ollama 在本地运行的无数开源模型。
面对这么多优秀的模型,如果每个都去对应的官网使用,来回切换不仅麻烦,而且很多高级功能(如自定义角色、专属插件、多平台同步)往往需要开通高昂的订阅服务。
今天,我们将介绍如何在你自己的 VPS 上,使用 Docker 部署目前最惊艳的开源 AI 交互面板——LobeChat。它不仅颜值极高、支持几乎所有的主流模型接入,还能让你真正将 AI 变成全平台的“个人助理”。
一、 为什么选择自建 LobeChat?
LobeChat 是一款开源的、现代化的、支持丰富特性的 AI 对话客户端。与 ChatGPT 官方网页端相比,自建 LobeChat 拥有以下无可比拟的优势:
- All in One(全能聚合):可以在同一个聊天界面中,一键在 GPT-4、Claude、DeepSeek、Gemini 以及本地 Ollama 模型之间切换。
- 极佳的视觉与交互体验:原生支持 PWA(可以像独立 App 一样安装在手机或电脑上),支持深色模式,界面设计非常符合现代审美。
- 强大的插件生态:支持通过插件访问互联网、搜索网页、生成图表甚至自动化执行脚本。
- 数据隐私与掌控:你的所有对话记录保存在你自己的服务器或本地浏览器中,绝不上传给任何第三方客户端收集者。
- 极低的成本:通过配置 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 应用创建独立的目录,这有助于后期的数据备份与管理。
mkdir -p /opt/lobechat
cd /opt/lobechat2. 编写 docker-compose.yml
在目录中创建一个 docker-compose.yml 文件。我们将使用这个文件来定义 LobeChat 容器的运行参数。
nano docker-compose.yml将以下内容粘贴到文件中:
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 退出),在终端执行:
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 的相关笔记):
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 端口。
- 在 Cloudflare 面板的 Zero Trust 控制台中创建一个 Tunnel。
- 将分配的
cloudflared启动命令在 VPS 终端执行。 - 在 Public Hostname 中,将你的域名(如
chat.example.com)映射到http://localhost:3210。 - 一键保存,立刻就可以通过 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 标记,请自行核实服务条款、价格和可用性,并遵守当地法律法规。