搬瓦工 VPS 部署 LobeChat AI 对话界面搭建教程

LobeChat 是一款设计精美的开源 AI 对话平台，以其出色的用户体验和丰富的功能生态著称。它支持多种模型提供商、插件市场、助手市场和知识库管理等高级功能。LobeChat 提供客户端模式和服务端数据库模式两种部署方案。本教程将介绍在搬瓦工 VPS 上部署 LobeChat 的完整流程。

一、LobeChat 核心特点

精美界面：现代化的 UI 设计，支持暗色模式和主题定制。
多模型支持：同时对接 OpenAI、Claude、Gemini、本地模型等多种提供商。
插件市场：丰富的插件扩展功能，如网页浏览、代码执行等。
助手市场：社区共享的预设助手模板。
知识库：上传文件构建 RAG 知识库。
多模态：支持图像、语音等多模态输入输出。

二、环境要求

操作系统：Ubuntu 20.04 或更高版本。
内存：至少 1GB（客户端模式），2GB 以上（数据库模式）。
Docker：需要 Docker 环境。

部署前需安装 Docker，参考 Docker 安装教程。选购 VPS 请参考全部方案。

三、客户端模式部署

客户端模式最为简单，数据存储在浏览器本地，适合个人使用：

docker run -d \
  --name lobe-chat \
  -p 3210:3210 \
  -e OPENAI_API_KEY=not-needed \
  -e OPENAI_PROXY_URL=http://host.docker.internal:8080/v1 \
  -e ACCESS_CODE=your_access_code \
  --extra-host=host.docker.internal:host-gateway \
  --restart unless-stopped \
  lobehub/lobe-chat:latest

主要环境变量说明：

OPENAI_API_KEY：OpenAI API 密钥，对接本地模型时可设为任意值。
OPENAI_PROXY_URL：API 代理地址，用于对接本地推理服务。
ACCESS_CODE：访问密码，保护界面不被未授权访问。

四、服务端数据库模式部署

数据库模式支持多用户和服务端数据存储，适合团队使用：

mkdir -p /opt/lobe-chat && cd /opt/lobe-chat

cat > docker-compose.yml <<'EOF'
version: '3.8'
services:
  postgresql:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_DB: lobe_chat
      POSTGRES_USER: lobe
      POSTGRES_PASSWORD: lobe_password
    volumes:
      - pg_data:/var/lib/postgresql/data
    restart: unless-stopped

  minio:
    image: minio/minio
    ports:
      - "9000:9000"
    volumes:
      - minio_data:/data
    environment:
      MINIO_ROOT_USER: minio_admin
      MINIO_ROOT_PASSWORD: minio_password
    command: server /data
    restart: unless-stopped

  lobe-chat:
    image: lobehub/lobe-chat-database:latest
    ports:
      - "3210:3210"
    environment:
      - APP_URL=http://your-domain.com:3210
      - DATABASE_URL=postgresql://lobe:lobe_password@postgresql:5432/lobe_chat
      - KEY_VAULTS_SECRET=your-vault-secret-at-least-32-chars
      - NEXT_AUTH_SECRET=your-next-auth-secret-string
      - NEXT_AUTH_SSO_PROVIDERS=
      - S3_ENDPOINT=http://minio:9000
      - S3_ACCESS_KEY_ID=minio_admin
      - S3_SECRET_ACCESS_KEY=minio_password
      - S3_BUCKET=lobe-chat
      - OPENAI_API_KEY=not-needed
      - OPENAI_PROXY_URL=http://host.docker.internal:8080/v1
    extra_hosts:
      - "host.docker.internal:host-gateway"
    depends_on:
      - postgresql
      - minio
    restart: unless-stopped

volumes:
  pg_data:
  minio_data:
EOF

docker compose up -d

五、对接本地模型

LobeChat 可以对接部署在同一 VPS 上的各种推理服务：

Llama.cpp：将 OPENAI_PROXY_URL 设为 http://host.docker.internal:8080/v1。
vLLM：设为 http://host.docker.internal:8000/v1。
One API：通过 One API 统一管理多个模型后端。

六、Nginx 反向代理

cat > /etc/nginx/sites-available/lobe-chat <<'EOF'
server {
    listen 80;
    server_name chat.yourdomain.com;

    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_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 300;
        client_max_body_size 100M;
    }
}
EOF
ln -s /etc/nginx/sites-available/lobe-chat /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

七、配置多模型提供商

在 LobeChat 界面的设置中，可以配置多个模型提供商。也可以通过环境变量预设：

# 在 docker-compose.yml 的 environment 中添加
- OPENAI_MODEL_LIST=gpt-3.5-turbo,gpt-4,local-model
- ENABLED_OLLAMA=true
- OLLAMA_PROXY_URL=http://host.docker.internal:11434

八、使用插件

LobeChat 内置了插件市场，常用插件包括搜索引擎、网页浏览器、代码解释器等。在对话界面点击插件图标即可启用。也可以自定义插件扩展功能。

九、更新和维护

# 更新到最新版本
cd /opt/lobe-chat
docker compose pull
docker compose up -d

# 备份数据
docker compose exec postgresql pg_dump -U lobe lobe_chat > /opt/backups/lobe-chat-$(date +%Y%m%d).sql

十、LobeChat 与其他聊天界面对比

LobeChat 的设计最为精美，插件生态最丰富。Open WebUI 功能更全面，特别是用户管理和 RAG 方面。ChatGPT Next Web 最轻量，部署最简单。根据需求选择合适的方案。

十一、常见问题

数据库连接失败

确认 PostgreSQL 容器已正常启动，并且 DATABASE_URL 格式正确：

docker compose logs postgresql
docker compose exec postgresql psql -U lobe -d lobe_chat -c '\l'

总结

LobeChat 以精美的界面和丰富的功能生态成为私有 AI 对话平台的优秀选择。通过数据库模式部署可以支持团队协作使用。选购搬瓦工 VPS 请查看全部方案，使用优惠码 NODESEEK2026 可享受 6.77% 的折扣，购买链接：bwh81.net。