deploy-ops/02-LobeHub部署流程.md

LobeHub Docker 部署流程

部署日期

2026-08-05

目录结构

/lobehub/
├── docker-compose.yml
├── .env
├── bucket.config.json
├── searxng-settings.yml
└── data/            # 持久化数据（Postgres、Redis、RustFS）

安装步骤

1. 下载配置

mkdir /lobehub && cd /lobehub
curl -O https://raw.githubusercontent.com/lobehub/lobehub/HEAD/docker-compose/deploy/docker-compose.yml
curl -O https://raw.githubusercontent.com/lobehub/lobehub/HEAD/docker-compose/deploy/.env.example
mv .env.example .env

2. 修改 .env 关键配置

# 域名
APP_URL=https://suyushi.top

# 端口（内部使用 3210）
LOBE_PORT=3210

# 安全密钥（必须用 openssl rand -base64 32 生成）
KEY_VAULTS_SECRET=<随机生成>
AUTH_SECRET=<随机生成>

# 数据库密码
POSTGRES_PASSWORD=<你设的密码>

3. 修复 rustfs-init 依赖

rustfs-init 容器因缺少 bucket.config.json 会失败，修改 docker-compose.yml 将 rustfs-init 的 condition 从 service_completed_successfully 改为 service_started：

sed -i '/rustfs-init:/,/condition: service_completed_successfully/{s/condition: service_completed_successfully/condition: service_started/}' docker-compose.yml

4. 启动

docker compose up -d

核心服务

服务	容器名	端口	说明
LobeHub	lobehub	3210(内部)	Web 应用主程序
Postgres	lobe-postgres	5432	数据库（ParadeDB + pgvector + pg_search）
Redis	lobe-redis	6379	缓存和会话
RustFS	lobe-rustfs	9000	S3 兼容对象存储
SearXNG	lobe-searxng	8080	隐私搜索引擎

AI 模型配置

只启用 DeepSeek V4 Flash，禁用其他所有提供商：

# .env 配置
DEEPSEEK_API_KEY=sk-xxxxxxxx
DEEPSEEK_PROXY_URL=https://api.deepseek.com/v1
OPENAI_API_KEY=sk-xxxxxxxx
OPENAI_PROXY_URL=https://api.deepseek.com/v1
OPENAI_MODEL_LIST=-all,+deepseek-v4-flash=DeepSeek V4 Flash<131072:fc>

# 禁用其他提供商
ENABLED_OPENAI=1
ENABLED_ANTHROPIC=0
ENABLED_GOOGLE=0
... (所有其他 ENABLED_*=0)

# 禁用模型市场
FEATURE_FLAGS=-market,-welcome_suggest

注意： DeepSeek API 兼容 OpenAI 格式，所以通过 OPENAI 通道接入，但实际调用的是 DeepSeek。

常用管理命令

cd /lobehub

# 查看所有容器状态
docker compose ps

# 查看 lobe 日志
docker compose logs lobe | tail -50

# 重启 lobe
docker compose restart lobe

# 完全重建 lobe（.env 修改后必须用这个）
docker compose down lobe && docker compose up -d lobe

# 查看全部日志
docker compose logs 2>&1 | tail -100