Deploying Magnetboard with Docker: A Sehuatang-Based Crawler for Automated AV Subscription Downloads

Preface#

CAUTION

Update: The author has decided to charge for the project.

This is a new AV download project, different from the previous MDC. Many of its resources are fetched via 98堂. Compared to M-Team, it can obtain Chinese-subbed and uncensored AV releases more quickly. The whole project is AI-driven and is essentially the author’s personal toy. It’s pseudo-open-source; according to the author, the source code can be provided if needed.

Conceptually, the project crawls Sehuatang posts and historical metadata, stores them in a local database for search, and then exposes features like pushing magnets to qBittorrent, etc. Because of this, the project will likely impose a non-trivial load on the Sehuatang site.

CAUTION

It’s not recommended to hook this directly into your Emby library or similar, especially if you already have a large existing library. Isolation is critical: due to the particularities of Vibe Coding, do not casually connect it to your primary library. My suggestion is to treat it purely as an auxiliary downloader.

Docker Hub repo: hub.docker.com

Author’s documentation: Magnetboard Complete Usage Guide

Project Highlights#

• Visualized index management – Manage your magnet links with an intuitive UI
• Smart search & filtering – Quickly locate the content you want
• Batch operations – Batch copy and push magnet links
• Multiple downloader support – Works with mainstream clients like qBittorrent
• 115 Cloud integration – Supports 115 offline download
• Automated pushing – Scheduled jobs and automatic pushing rules
• Telegram bot – Remote control and notification features

Deployment#

If you often read my blog, you should already be familiar with Docker; I won’t repeat the basic initialization here. What you need to do is create a folder and put a docker-compose.yaml file inside it.

The container image is relatively large, close to 1 GB, so for users in mainland China, it’s recommended to use a mirror registry when pulling. It is not recommended to expose the database port directly to the public internet; keep it internal.

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"  # 仅暴露 Web 界面
9
    environment:
10
      # -----------------------------
11
      # 数据库配置（内部连接）
12
      # -----------------------------
13
      - DATABASE_HOST=postgres
14
      - DATABASE_PORT=5432
15
      - DATABASE_NAME=sehuatang_db
16
      - DATABASE_USER=postgres
17
      - DATABASE_PASSWORD=postgres123
18

19
      # -----------------------------
20
      # 应用配置
21
      # -----------------------------
22
      - PYTHONPATH=/app/backend
23
      - ENVIRONMENT=production
24
      - ADMIN_PASSWORD=admin123
25

26
      # -----------------------------
27
      # 代理配置（可选）
28
      # -----------------------------
29
      - HTTP_PROXY=http://your-proxy:port
30
      - HTTPS_PROXY=http://your-proxy:port
31
      - NO_PROXY=localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12
32

33
      # -----------------------------
34
      # Telegram 机器人配置（可选）
35
      # -----------------------------
36
      - TELEGRAM_BOT_TOKEN=你的Bot_Token
37
      - TELEGRAM_BOT_WEBHOOK_URL=
38
      - TELEGRAM_BOT_WEBHOOK_SECRET=
39

40
      # -----------------------------
41
      # CloudDrive2 配置（可选）
42
      # -----------------------------
43
      - CLOUDDRIVE_HOST=你的CD2主机地址
44
      - CLOUDDRIVE_PORT=你的CD2端口
45

46
    volumes:
47
      - sehuatang_data:/app/data
48
      - sehuatang_logs:/app/logs
49

50
    depends_on:
51
      - postgres
52

53
    restart: unless-stopped
54

55
  postgres:
56
    image: postgres:15-alpine
57
    container_name: sehuatang-postgres
58
    environment:
59
      - POSTGRES_DB=sehuatang_db
60
      - POSTGRES_USER=postgres
61
      - POSTGRES_PASSWORD=postgres123
62
    volumes:
63
      - postgres_data:/var/lib/postgresql/data
64
    restart: unless-stopped
65

66
volumes:
67
  sehuatang_data:
68
  sehuatang_logs:
69
  postgres_data:
70

71
networks:
72
  default:
73
    name: sehuatang-network

First startup time: about 10–60 seconds (depending on image pull speed and DB initialization).

Web UI: http://<your IP or domain>:8000

API docs: http://<your IP or domain>:8000/docs

If your reverse proxy is already using port 8000, simply change the left side of ports: "8000:8000" to another port (for example, 18000:8000).