LobeChat 接入教程 - XiDao Api 文档

什么是 LobeChat?

LobeChat（原 ChatGPT-Next-Web）是一款开源、现代化的一站式 AI 聊天客户端，支持多种 AI 提供商和丰富的扩展能力。

🔓

完全开源

MIT 协议，代码完全开放，可自托管

🤖

多模型支持

同时接入 GPT、Claude、Gemini 等多种模型

🔌

MCP 协议

原生支持 Model Context Protocol

🎨

多模态

支持图片识别、语音合成、文件上传等

📱

PWA 支持

可安装为桌面应用，移动端友好

💾

对话管理

话题分组、收藏、搜索、导出

✅

推荐理由 LobeChat 功能最全面，插件生态丰富，是目前最完善的开源 AI 客户端之一。

方式一：Vercel 一键部署（推荐新手）

Fork 项目

访问 LobeChat GitHub，点击 Fork 将项目 Fork 到你的 GitHub 账号

一键部署

打开 vercel.com/new，导入你 Fork 的仓库，点击 Deploy

配置环境变量

Vercel 部署完成后，进入项目 Settings → Environment Variables，添加以下变量：

Vercel 环境变量

OPENAI_API_KEY=sk-你的API_KEY
OPENAI_PROXY_URL=https://api.xidao.online/v1

💡

Vercel 免费额度足够个人使用。部署后你会获得一个 .vercel.app 域名的访问地址。

方式二：Docker 本地部署（推荐进阶用户）

快速启动（最简配置）

bash

docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY="sk-你的API_KEY" \
  -e OPENAI_PROXY_URL="https://api.xidao.online/v1" \
  lobehub/lobe-chat

Docker Compose 部署（推荐生产环境）

创建 docker-compose.yml 文件：

yaml

version: '3.8'

services:
  lobechat:
    image: lobehub/lobe-chat
    container_name: lobechat
    restart: always
    ports:
      - "3210:3210"
    environment:
      OPENAI_API_KEY: sk-你的API_KEY
      OPENAI_PROXY_URL: https://api.xidao.online/v1
      # 可选：设置访问密码
      # ACCESS_CODE: your_password
    volumes:
      - ./data:/app/data/server
      - ./logs:/app/logs/server

启动服务

运行 docker-compose up -d

访问

浏览器打开 http://localhost:3210

Nginx 反向代理（可选）

如果你有域名并希望使用 HTTPS，可以配置 Nginx 反向代理：

nginx

server {
    listen 443 ssl;
    server_name chat.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    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;
        
        # WebSocket support (for TTS/STT)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

配置 XiDao Api

LobeChat 启动后，点击左下角设置图标进入配置页面：

配置项	值	说明
API 地址 (Base URL)	`https://api.xidao.online/v1`	OpenAI 兼容接口地址
API Key	`sk-你的API_KEY`	你的令牌
默认模型	下拉选择	建议选择 claude-sonnet-4-5-20250929

⚠️

注意如果使用 Anthropic 原生格式（非 OpenAI 兼容），Base URL 应为 https://api.xidao.online（无 /v1 后缀），并在模型提供商中选择 Anthropic 类型。

核心功能亮点

💬

多轮对话

完整的上下文记忆，支持超长对话

🖼️

图像理解

发送图片给 AI 分析和描述

🎤

语音对话

TTS 语音合成 + STT 语音输入

📄

文件处理

PDF/Word/Excel/TXT 文件解析

🌐

联网搜索

内置搜索引擎，实时获取信息

🎨

绘画模式

调用 DALL·E/Midjourney 生成图片

插件系统

LobeChat 拥有丰富的插件市场，可以在设置中一键安装：

推荐插件	功能
搜索引擎增强	Google/Bing/DuckDuckGo 多引擎搜索
代码解释器	运行 Python/JavaScript/Ruby 代码
LaTeX 渲染	数学公式完美渲染
Mermaid 图表	流程图/时序图/类图绘制
思维导图	可视化思维导图生成
翻译助手	多语言实时翻译