自动追番方案 BangumiStack 部署

1. 简介#

追番时手动找资源、下载、整理太麻烦，于是用 Docker Compose 把三个服务整合到一起，实现从 RSS 订阅到媒体库的全自动流程。

整套方案叫 BangumiStack，由三个容器组成：

服务	作用
AutoBangumi	解析 RSS 订阅，自动识别番剧并推送下载任务
qBittorrent	BT 下载客户端，负责实际下载
Jellyfin	媒体服务器，统一管理和播放下载好的番剧

工作流程：

1
RSS 订阅 → AutoBangumi 解析 → qBittorrent 下载 → Jellyfin 媒体库

2. docker-compose.yml#

1
version: "3.8"
2

3
services:
4
  qbittorrent:
5
    image: superng6/qbittorrent
6
    container_name: qbittorrent
7
    environment:
8
      - WEBUI_PORT=8080
9
    volumes:
10
      - ./qbittorrent/config:/config
11
      - ./qbittorrent/downloads:/downloads
12
    ports:
13
      - "8080:8080"   # WebUI
14
      - "6881:6881"   # BT
15
      - "6881:6881/udp"
16
    restart: unless-stopped
17

18
  autobangumi:
19
    image: estrellaxd/auto_bangumi
20
    container_name: autobangumi
21
    environment:
22
      - AB_DOWNLOADER=qbittorrent
23
      - AB_DOWNLOAD_PATH=/downloads/Bangumi
24
      - AB_RSS_HOST=qbittorrent:8080
25
      - AB_RSS_USER=admin
26
      - AB_RSS_PASS=adminadmin
27
    volumes:
28
      - ./autobangumi/config:/app/config
29
    ports:
30
      - "7892:7892"
31
    depends_on:
32
      - qbittorrent
33
    restart: unless-stopped
34

35
  jellyfin:
36
    image: jellyfin/jellyfin
37
    container_name: jellyfin
38
    volumes:
39
      - ./jellyfin/config:/config
40
      - ./jellyfin/cache:/cache
41
      - ./qbittorrent/downloads:/media:ro
42
    ports:
43
      - "8096:8096"
44
    restart: unless-stopped

几个关键点：

数据卷共享：qBittorrent 的 downloads 目录被 Jellyfin 以只读方式（:ro）挂载为 /media，下载完成的番剧能直接被媒体库读取。
服务依赖：autobangumi 通过 depends_on 等 qbittorrent 先启动。
容器内通信：AutoBangumi 用 qbittorrent:8080 而不是 localhost，走的是 Compose 默认网络的服务名解析。
重启策略：全部设为 unless-stopped，宿主机重启后服务自动拉起。

3. 目录结构#

1
BangumiStack/
2
├── docker-compose.yml
3
├── qbittorrent/
4
│   ├── config/         # qBittorrent 配置
5
│   └── downloads/      # 下载目录
6
│       └── Bangumi/    # AutoBangumi 自动归类的番剧
7
├── autobangumi/
8
│   └── config/         # AutoBangumi 配置
9
└── jellyfin/
10
    ├── config/         # Jellyfin 配置
11
    └── cache/          # Jellyfin 缓存

配置和数据全部用相对路径挂载到项目目录下，迁移备份时直接打包整个文件夹即可。

4. 部署#

1
# 进入项目目录
2
cd BangumiStack
3

4
# 启动全部服务
5
docker compose up -d
6

7
# 查看日志
8
docker compose logs -f

5. 服务访问#

服务	地址	说明
qBittorrent	http://localhost:8080	BT 下载客户端
AutoBangumi	http://localhost:7892	自动追番管理
Jellyfin	http://localhost:8096	媒体服务器

qBittorrent 默认账号 admin / adminadmin，首次登录后立即修改密码。注意：如果改了密码，要同步更新 docker-compose.yml 里 autobangumi 的 AB_RSS_PASS，否则 AutoBangumi 连不上下载器。

6. 配置说明#

6.1 AutoBangumi#

环境变量在 docker-compose.yml 中配置：

变量	说明	默认值
`AB_DOWNLOADER`	下载器类型	qbittorrent
`AB_DOWNLOAD_PATH`	下载路径	/downloads/Bangumi
`AB_RSS_HOST`	qBittorrent 地址	qbittorrent:8080
`AB_RSS_USER`	qBittorrent 用户名	admin
`AB_RSS_PASS`	qBittorrent 密码	adminadmin

启动后在 WebUI 中添加番剧 RSS 订阅链接（常用源如 Mikan Project），AutoBangumi 会自动解析剧集并归类。

6.2 Jellyfin#

首次访问 WebUI 后需要：

创建管理员账号
添加媒体库，目录选择 /media
媒体类型选择「电视剧」

之后 Jellyfin 会自动刮削番剧元数据（封面、简介等）。

7. 常用命令#

1
# 启动
2
docker compose up -d
3

4
# 停止
5
docker compose down
6

7
# 重启单个服务
8
docker compose restart autobangumi
9

10
# 查看指定服务日志
11
docker compose logs -f autobangumi
12

13
# 更新镜像
14
docker compose pull
15
docker compose up -d

8. 常见问题#

8.1 AutoBangumi 无法连接 qBittorrent#

确保 qBittorrent 已启动，依次检查：

qBittorrent WebUI 能否正常访问
用户名密码是否与 AB_RSS_USER / AB_RSS_PASS 一致
容器网络是否正常（同一 Compose 网络下用服务名 qbittorrent 通信）

8.2 下载的文件在哪里#

文件存储在 ./qbittorrent/downloads/Bangumi/ 目录下，由 AutoBangumi 按番剧名称自动归类。

8.3 Jellyfin 媒体库不显示内容#

确认 AutoBangumi 已下载并完成归类
在 Jellyfin 手动刷新媒体库
检查文件命名是否符合 Jellyfin 识别规范

9. 小结#

整套方案的核心思路是用 Docker Compose 把三个独立服务串成一条流水线，依靠共享数据卷打通下载目录与媒体库，依靠容器网络服务名解决服务间通信。部署完成后，订阅一次 RSS 就能实现新番自动下载、归类、入库。