# LobeHub Docker 部署流程

## 部署日期
2026-08-05

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

## 安装步骤

### 1. 下载配置
```bash
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 关键配置
```bash
# 域名
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`：
```bash
sed -i '/rustfs-init:/,/condition: service_completed_successfully/{s/condition: service_completed_successfully/condition: service_started/}' docker-compose.yml
```

### 4. 启动
```bash
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，禁用其他所有提供商：

```bash
# .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。

## 常用管理命令

```bash
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
```