一、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

# 其他环境变量，视需求而定
# OPENAI_API_KEY=sk-xxxx
OPENAI_PROXY_URL=https://api.codesphere.chat/v1
# OPENAI_MODEL_LIST=...
# ...

  • 创建 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链接