Initial commit: knowledge base

2026-08-05 17:12:58 +08:00
commit 695bed03c4
6 changed files with 400 additions and 0 deletions
@@ -0,0 +1,106 @@
+# 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
+```