🚀 快速开始指南

使用 docker-compose 一键部署 sehuatang-crawler + PostgreSQL，默认端口 8000，数据与日志均持久化到 Docker 卷。

1) 环境要求

• 操作系统:支持docker的x86机型

• 依赖：Docker 24+、Docker Compose v2+

• 网络：能访问目标站点；如需代理请准备好 HTTP/HTTPS 代理地址

⸻

2) 准备 docker-compose.yml

将下面内容保存为 docker-compose.yml（你已经有了，可直接用）：

1
version: '3.8'
2

3
services:
4
  sehuatang-crawler:
5
    image: wyh3210277395/magnetboard:latest
6
    container_name: sehuatang-crawler
7
    ports:
8
      - "8000:8000"
9
    environment:
10
      # 数据库配置
11
      - DATABASE_HOST=postgres
12
      - DATABASE_PORT=5432
13
      - DATABASE_NAME=sehuatang_db
14
      - DATABASE_USER=postgres
15
      - DATABASE_PASSWORD=postgres123
16

17
      # 应用配置
18
      - PYTHONPATH=/app/backend
19
      - ENVIRONMENT=production
20
      - ADMIN_PASSWORD=admin123
21

22
      # 代理配置（可选）
23
      - HTTP_PROXY=http://your-proxy:port
24
      - HTTPS_PROXY=http://your-proxy:port
25
      - NO_PROXY=localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12
26

27
      # Telegram 机器人配置（可选）
28
      - TELEGRAM_BOT_TOKEN=你的Bot_Token
29
      - TELEGRAM_BOT_WEBHOOK_URL=  # 可选，留空使用轮询模式
30
      - TELEGRAM_BOT_WEBHOOK_SECRET=  # 可选
31

32
      # CloudDrive2 配置（可选）
33
      - CLOUDDRIVE_HOST=你的CD2主机地址
34
      - CLOUDDRIVE_PORT=你的CD2端口
35

36

37
    volumes:
38
      - sehuatang_data:/app/data
39
      - sehuatang_logs:/app/logs
40

41
    depends_on:
42
      - postgres
43

44
    restart: unless-stopped
45

46
  postgres:
47
    image: postgres:15-alpine
48
    container_name: sehuatang-postgres
49
    ports:
50
      - "5432:5432"
51
    environment:
52
      - POSTGRES_DB=sehuatang_db
53
      - POSTGRES_USER=postgres
54
      - POSTGRES_PASSWORD=postgres123
55

56
    volumes:
57
      - postgres_data:/var/lib/postgresql/data
58

59
    restart: unless-stopped
60

61
volumes:
62
  sehuatang_data:
63
  sehuatang_logs:
64
  postgres_data:
65

66
networks:
67
  default:
68
    name: sehuatang-network

3) 启动

1
docker compose up -d

首次启动时间：约 10–60 秒（取决于镜像拉取与数据库初始化速度）。

访问地址：http://<你的IP或域名>:8000

接口文档：http://<你的IP或域名>:8000/docs

如果你的反向代理占用了 8000 端口，修改 ports: “8000:8000” 的左侧为其它端口即可（例如 18000:8000）。

4) 首次登录与面板入口

• 默认管理员密码：ADMIN_PASSWORD 环境变量（compose 里配置的值）

• 登录后可看到以下菜单：

• 【爬虫管理中心】｜【定时任务】｜【数据总览】｜【订阅监控】｜【订阅总览】｜【下载器配置】

⸻

5) 基本配置（3 分钟搞定）

（可选）代理：在 docker-compose.yml 里填上 HTTP_PROXY / HTTPS_PROXY / NO_PROXY，docker compose up -d 重启生效。
订阅爬虫 Cookie：在【订阅监控】粘贴色花堂账号 Cookie（必填，否则订阅类任务无法运行）。
下载器对接（智能推送）：在【下载器配置】连接 qBittorrent / CD2 / 115，并为每个“板块分类”设置保存目录（目录最后一级名称需与分类完全一致）。
定时任务：（番号定时爬虫记得任务时间间隔开，否则会一直撞cf墙）

• 番号爬虫 → 在【定时任务】里设定计划（cron/间隔）

• 订阅爬虫 → 在【订阅监控】里创建订阅定时任务

6) 常用命令

1
# 查看运行状态
2
docker compose ps
3

4
# 查看应用日志 / 数据库日志
5
docker compose logs -f sehuatang-crawler
6
docker compose logs -f sehuatang-postgres
7

8
# 重启服务
9
docker compose restart
10

11
# 停止并移除容器（保留数据卷）
12
docker compose down

7) 数据持久化与备份

• 应用数据：sehuatang_data（Docker 卷）

• 应用日志：sehuatang_logs（Docker 卷）

• 数据库数据：postgres_data（Docker 卷）

8) 更新/回滚

1
# 拉取最新镜像
2
docker pull wyh3210277395/magnetboard:latest
3
# 重启生效
4
docker compose down && docker compose up -d

9) 可选集成（按需）

• Telegram Bot：设置 TELEGRAM_BOT_TOKEN（以及 Webhook 可选项），用于群内提醒/控制。

• CloudDrive2（CD2）：CLOUDDRIVE_HOST / CLOUDDRIVE_PORT，用于智能推送到网盘。

• MetaTube：METATUBE_URL，用于元数据/预处理（暂时不可用）。

10) 故障排查（FAQ）

• 网页打不开：确认容器在运行（docker compose ps），端口未被占用，防火墙已放行。

• 数据库起不来：若绑定的是宿主目录，请确保数据目录归属正确（例如 chown -R 999:999 <你的pg目录>）；用 Docker 卷通常不会有权限问题。

• 订阅抓不到：大多是 Cookie 失效，请在【订阅监控】更新后重试。

• 智能推送失败：检查下载器是否连通；目录末级名是否与分类完全一致；目录是否存在且可写。

• 网络受限：配置 HTTP_PROXY/HTTPS_PROXY/NO_PROXY 后重启容器。

⸻

🔗 GitHub 仓库：https://github.com/wyhfx/sehuatang-crawler

有问题可到仓库提 Issue，或在 TG 群反馈。