一、LobeChat 简介

LobeChat 是一个开源的 Web 聊天应用框架，支持调用多种大语言模型（如 OpenAI、Ollama、ChatGLM 等），并通过插件和知识库功能扩展 AI 的上下文能力。

知识库版本（Knowledge Base Edition）使得 LobeChat 能够：

  • 上传 PDF、Markdown、TXT 等文档；

  • 基于文档内容进行上下文问答；

  • 支持向量化搜索与嵌入模型比对；

  • 自定义知识分区与多文档管理。

二、环境准备

1. 基础环境要求

组件

镜像

postgres

pgvector/pgvector:pg16

lobe-chat-database

lobehub/lobe-chat-database

腾讯云COS

存储随意

2. 服务器要求

  • 系统：Linux / macOS / Windows

  • CPU：2核（推荐 4 核）

  • 内存：2GB

  • 磁盘：至少 10GB 可用空间

三、腾讯云COS存储KEY获取

68ff7d136c26e.png

四、Logto统一登陆系统部署(1Panel)

  • 1Panel部署即可

68ff81af71cf8.png

  • 配置Logto

  • 一定要按照格式填写

五、LobeChat启动！

  • 创建启动配置文件：lobe-chat.env

# 网站域名
APP_URL=https://lobe.codesphere.chat

# DB 必须的环境变量
# 用于加密敏感信息的密钥，可以使用 openssl rand -base64 32 生成
KEY_VAULTS_SECRET='aaa木材批发'
# Postgres 数据库连接字符串
# 格式：postgres://username:password@host:port/dbname 
DATABASE_URL=postgres://lobechat:aaa木材批发@1.1.1.1:5432/lobechat

# NEXT_AUTH 相关，可以使用 auth0、Azure AD、GitHub、Authentik、zitadel、logto 等，如有其他接入诉求欢迎提 PR
# 配置链接：https://lobehub.com/zh/docs/self-hosting/advanced/auth/next-auth/logto

# 用于加密敏感信息的密钥，可以使用 openssl rand -base64 32 生成
NEXT_AUTH_SECRET=aaa木材批发
# 选择 LoboChat 的单点登录提供商。使用 Logto 请填写 logto。
NEXT_AUTH_SSO_PROVIDERS=logto 
# 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。https://lobe.example.com/api/auth
NEXTAUTH_URL=https://lobe.codesphere.chat/api/auth
# Logto App 详情页的 Client ID
AUTH_LOGTO_ID=aaa木材批发
# Logto App 详情页的 Client Secret
AUTH_LOGTO_SECRET=aaa木材批发
# Logto 提供程序的 OpenID Connect 颁发者
AUTH_LOGTO_ISSUER=https://lobe.example.com/oidc

# 腾讯云 COS
# 存储桶的名称
S3_BUCKET=lobechat
# 存储桶的请求端点，注意没有前面的桶名 https://lobechat(删掉).cos.ap-beijing.myqcloud.com
S3_ENDPOINT=https://cos.ap-beijing.myqcloud.com
# 桶的区域
S3_REGION=ap-beijing
# 存储桶对外的访问域名(完整链接)
S3_PUBLIC_DOMAIN=https://lobechat.cos.ap-beijing.myqcloud.com
# 访问密钥
S3_ACCESS_KEY_ID=AKI
# 访问密钥
S3_SECRET_ACCESS_KEY=FF

# 网页爬虫
# CRAWLER_IMPLS="native"

# 联网搜索
SEARCH_PROVIDERS="searxng"
SEARXNG_URL=https://chaihl.master-jsx.top  # 我部署的公共网络搜索引擎

# 特性标志
FEATURE_FLAGS="+commercial_hide_github,+commercial_hide_docs"

# 其他环境变量，视需求而定
ENABLED_OLLAMA=0 # 是否开启 Ollama
ENABLED_COMFYUI=0 # 是否开启 Comfyui
ENABLED_FAL=0  # 是否开启 Fal

# OpenAI
ENABLED_OPENAI=1 # 是否开启 OpenAI
OPENAI_API_KEY=
OPENAI_PROXY_URL=https://api.codesphere.chat/v1
OPENAI_MODEL_LIST=-all,chatgpt-4o-latest,gpt-3.5-turbo,gpt-4.1,gpt-4.1-2025-04-14,gpt-4.1-mini,gpt-4.1-mini-2025-04-14,gpt-4.1-nano,gpt-4.1-nano-2025-04-14,gpt-4o,gpt-4o-2024-05-13,gpt-4o-2024-08-06,gpt-4o-2024-11-20,gpt-4o-mini,gpt-4o-mini-2024-07-18,gpt-5,gpt-5-2025-08-07,gpt-5-chat-latest,gpt-5-codex,gpt-5-mini,gpt-5-mini-2025-08-07,gpt-5-nano,gpt-5-nano-2025-08-07,o1,o1-2024-12-17,o1-mini,o1-mini-2024-09-12,o1-preview,o1-preview-2024-09-12,o3,o3-2025-04-16,o3-mini,o3-mini-2025-01-31,o4-mini,o4-mini-2025-04-16,openai/gpt-oss-120b,openai/gpt-oss-20b

# DeepSeek
DEEPSEEK_PROXY_URL=https://api.codesphere.chat/v1
DEEPSEEK_API_KEY=
DEEPSEEK_MODEL_LIST=-all,deepseek-chat,deepseek-r1,deepseek-reasoner,deepseek-v3,deepseek-v3.1,deepseek-v3.1-terminus,deepseek-v3.2-exp

# Anther Claude
ENABLE_ANTHROPIC=1
ANTHROPIC_API_KEY=
ANTHROPIC_PROXY_URL=https://api.codesphere.chat
ANTHROPIC_MODEL_LIST=-all,claude-haiku-4-5-20251001,claude-3-7-sonnet-20250219,claude-opus-4-1-20250805,claude-opus-4-20250514,claude-sonnet-4-20250514,claude-sonnet-4-5-20250929

# Google
ENABLE_GOOGLE=1
GOOGLE_API_KEY=
GOOGLE_PROXY_URL=https://api.codesphere.chat
GOOGLE_MODEL_LIST=-all,gemini-2.0-flash,gemini-2.5-flash,gemini-2.5-flash-lite,gemini-2.5-pro

# Xai
ENABLE_XAI=1
XAI_API_KEY=
XAI_PROXY_URL=https://api.codesphere.chat/v1
XAI_MODEL_LIST=-all,grok-3,grok-3-mini,grok-4,grok-4-fast-non-reasoning,grok-4-fast-reasoning,grok-code-fast-1

# Qwen
ENABLE_QWEN=1
QWEN_API_KEY=
QWEN_PROXY_URL=https://api.codesphere.chat/v1
QWEN_MODEL_LIST=-all,qwen3-coder-plus,qwen3-max

  • 创建 docker-compose.yml 启动文件(大伙应该都会吧)

services:
  lobe-postgres:
    image: pgvector/pgvector:pg16
    container_name: lobe-postgres
    environment:
      POSTGRES_PASSWORD: "aaa木材批发"
      POSTGRES_USER: "lobechat"
      POSTGRES_DB: "lobechat"
    volumes:
      - ./postgres/data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    networks:
      - pg
    restart: always

  lobe-chat-database:
    image: lobehub/lobe-chat-database
    container_name: lobe-chat-database
    env_file:
      - ./lobe-chat.env
    ports:
      - "3210:3210"
    depends_on:
      - lobe-postgres
    networks:
      - pg
    restart: always

networks:
  pg:
    driver: bridge

  • 启动！

docker-compose up -d

六、参考资料

LobeChat 官方文档

GitHUB链接

LobeChat配置文档

LobeChat链接