跳轉到內容

在 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 标记,请自行核实服务条款、价格和可用性,并遵守当地法律法规。

最後更新於: