ANI-RSS：基于 RSS 的自动追番、订阅、下载、刮削与洗版

还在为每周手动翻 RSS、找种子、下番剧而烦恼？ANI-RSS 是一款开源的自动追番工具：你只需订阅一次 RSS，剩下的下载、重命名、刮削、洗版全部自动完成。本文将从软件介绍、Docker Compose 部署到日常使用，带你完整上手 ANI-RSS。

一、软件简介

1.1 ANI-RSS 是什么

ANI-RSS 是一款基于 RSS 的自动追番工具，核心定位是一站式打通「订阅 → 下载 → 刮削 → 洗版」的完整链路。它以蜜柑计划（Mikan）等站点发布的 RSS 源为输入，自动识别番剧集数并推送到下载器，下载完成后自动重命名为媒体库友好的 S01E01 格式，配合 Emby / Jellyfin 即可实现无人值守的追番体验。

项目官方文档地址：https://docs.wushuo.top

合规提示：ANI-RSS 是一个中立性技术辅助工具，通过自动化程序抓取互联网公开分享的种子文件链接（非存储内容），并向用户指定的下载工具推送任务指令。工具本身不具备资源存储、分发及内容审查功能，用户需确保下载行为符合所在国家/地区法律法规。另外，项目作者明确要求不要在 B 站或中国大陆社交平台发布视频/文章宣传本项目，如有需要请使用简称 ASS。

1.2 核心功能

功能	说明
自动订阅	按固定间隔轮询 RSS 源，自动发现新番更新
自动下载	将种子/磁力链接推送到下载器，支持 qBittorrent、Transmission、Aria2、OpenList 四种下载工具
自动重命名	按模板将视频与字幕重命名为 `番剧名 S01E01` 标准格式，便于媒体库刮削
自动刮削	从 TMDB / Bangumi 获取海报、简介、演员信息等元数据，生成 nfo
自动洗版	通过「备用 RSS」先用快源看番，主源更新后自动替换为高质量版本并删除旧文件
通知推送	支持 Telegram、邮箱、Server酱、Emby 媒体库刷新、文件移动、OpenList 上传等多种通知方式

1.3 主要特点

多下载器支持：兼容 qBittorrent、Transmission、Aria2、OpenList 四种下载工具。其中 qBittorrent 功能支持最完整（自动下载、下载时重命名、下载完成后重命名、做种时修改下载位置、自动刮削等全项支持），官方强烈推荐使用 qBittorrent。
元数据生态：深度整合 TMDB 与 Bangumi，自动获取标题、年份、集标题、总集数、评分等信息。
灵活的模板系统：保存路径与重命名规则均支持 ${title}、${seasonFormat}、${subgroup} 等变量，可自由定制。
智能检测机制：支持自动跳过已下载集、遗漏检测（缺集通知）、摸鱼检测（主源长期不更新时提醒）、自动禁用完结订阅。
多平台部署：提供 Docker、Linux、macOS、Windows、群晖 DSM 等多种部署方式，其中 Docker 为官方首推。

1.4 适用场景

NAS / 家庭服务器用户，希望搭建自动化的番剧媒体库；
追新番数量较多，手动管理 RSS 和下载效率低；
使用 Emby / Jellyfin，需要标准化的文件命名与元数据刮削；
希望「先尝鲜、后洗版」，用快字幕组兜底、主字幕组洗版的用户。

二、Docker Compose 部署教程

2.1 环境要求

已安装 Docker 与 Docker Compose（Linux 服务器、NAS、软路由等均可）；
准备一个可用的下载器（推荐 qBittorrent，下文以它为例）；
一个用于保存番剧的目录（例如 /volume2/wushuo/Media）；
能够正常访问 Mikan、Bangumi、TMDB 的网络环境（如有问题可后续配置代理）。

关键警告：使用 Docker 部署时，务必让 ani-rss 与「下载器」的挂载路径保持一致，否则自动跳过、自动删除、重命名等功能会出现异常。

2.2 镜像版本选择

镜像	架构	底层镜像	JDK	说明
`wushuo894/ani-rss:latest`	linux/amd64, linux/arm64	alpine:latest	eclipse-temurin	镜像体积更小
`wushuo894/ani-rss:openj9`	linux/amd64, linux/arm64	ubuntu:noble	ibm-semeru-runtimes	内存占用更少
`wushuo894/ani-rss:arm32v7`	linux/arm32v7	ubuntu:noble	eclipse-temurin	适用于 32 位 ARM 设备

一般用户直接选择 latest 即可；内存吃紧的设备可考虑 openj9。

2.3 编写 docker-compose.yml

以下是一个同时包含 ani-rss 与 qBittorrent 的完整示例：

services:
  ani-rss:
    image: wushuo894/ani-rss:latest
    container_name: ani-rss
    # 自定义 DNS
    # dns: 8.8.8.8
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
      - SERVER_PORT=7789          # ani-rss 端口
      - CONFIG=/config
      - TZ=Asia/Shanghai
      - SWAGGER_ENABLED=false
      - MCP_ENABLED=false
      - JAVA_OPTS=-Xms64m -Xmx512m -Xss256k -XX:+UseG1GC
    volumes:
      - /volume1/docker/ani-rss/config:/config
      - /volume2/wushuo/Media:/Media   # 番剧挂载路径，两侧须保持一致
    restart: always
    network_mode: host

  qBittorrent:
    image: linuxserver/qbittorrent:latest
    container_name: qBittorrent
    environment:
      - PUID=0
      - PGID=0
      - WEBUI_PORT=8080           # qBittorrent 端口
      - TZ=Asia/Shanghai
    volumes:
      - /volume1/docker/qBittorrent/config:/config
      - /volume2/wushuo/downloads:/downloads
      - /volume2/wushuo/Media:/Media   # 番剧挂载路径，两侧须保持一致
    restart: always
    network_mode: host

注意再次强调：/volume2/wushuo/Media:/Media 这一挂载在两个服务中必须完全一致——ani-rss 会按自身视角的路径去检查、重命名和删除文件，路径不一致是绝大多数问题的根源。

2.4 启动容器

在 docker-compose.yml 所在目录执行：

docker compose up -d

查看日志确认启动状态：

docker compose logs -f ani-rss

提示：qBittorrent 初次启动时会为 admin 用户生成一个随机密码，请通过 docker logs qBittorrent 查看容器日志获取初始密码，登录后建议立即修改。

启动完成后，浏览器访问 http://<宿主机IP>:7789 即可进入 ani-rss 后台。

2.5 常见配置参数说明

ani-rss 支持通过环境变量进行配置：

环境变量	示例	说明
`CONFIG`	`/config`	指定设置与数据存放位置
`SERVER_PORT`	`7789`	指定服务端口
`SERVER_ADDRESS`	`0.0.0.0`	指定绑定 IP 地址
`SWAGGER_ENABLED`	`false`	是否启用 Swagger 接口文档（启用后访问 `/swagger-ui/index.html`）
`MCP_ENABLED`	`false`	是否启用 MCP（接入类型 `streamable`，端点 `/api/mcp`，Header 携带 `api-key`）
`TZ`	`Asia/Shanghai`	时区
`PUID` / `PGID`	`0`	运行用户/用户组，涉及文件权限
`UMASK`	`022`	文件创建权限掩码
`JAVA_OPTS`	`-Xms64m -Xmx512m`	JVM 参数

裸机部署对应的启动参数为：--config、--server.port、--server.address、--gui（图形界面菜单）、--swagger-enabled、--mcp-enabled。

2.6 与下载器配套的参数

如果使用了上述 Compose 配置，请在 ani-rss 后台「下载设置」中填写：

条目	内容
下载工具	qBittorrent
地址	`http://[宿主机IP]:8080`
用户名	`admin`
密码	qBittorrent 的 WebUI 密码
保存位置	`/Media/番剧/${title}/Season ${season}`
剧场版保存位置	`/Media/剧场版/${title}`

三、使用教程

3.1 首次登录与安全设置

浏览器打开 http://127.0.0.1:7789（Docker/局域网/反代环境请使用实际地址）。
默认账号密码均为 admin，首次登录后务必立刻修改。
前往「登录设置」，重点关注：
- 登录有效期（单位小时）：家庭局域网可适当调长，公网环境建议缩短；
- IP 校验：IP 变化时登录失效，适合公网固定出口场景；移动网络或频繁切换出口的用户不建议开启；
- IP 白名单：名单内 IP 免登录，支持单 IP、通配符（192.168.*.*）、CIDR（192.168.5.0/24）与 IP 范围四种写法；
- 信任的反代 IP：配合 Nginx/Caddy/Traefik 反向代理时，用于正确获取 X-Forwarded-For 中的真实客户端 IP；只有明确可信的代理才可加入；
- API Key：供第三方脚本、自动化工具调用接口时鉴权，请像密码一样妥善保管。

如需对 Docker 容器内的 ani-rss 设置本机跳过身份验证，请留意登录日志内的 IP 信息。

3.2 配置下载器（关键步骤）

进入「下载设置」：

下载工具：选择 qBittorrent（功能最全），填入地址、用户名、密码，点击「测试」，出现「登录成功」即配置正确。
- qBittorrent 侧需开启 WebUI 并生成 API 密钥，先在浏览器确认 WebUI 可正常访问。
- 各下载器功能支持差异：Aria2 不支持下载时重命名与下载完成通知；Transmission 不支持下载时复杂解构重命名；OpenList 可离线下载到 115、123、PikPak、迅雷云盘。
保存位置：默认模板 /Media/番剧/${title}/Season ${season}，支持 ${letter}（拼音首字母）、${year}、${quarter}、${title}、${tmdbid}、${jpTitle}、${subgroup}、${season}、${seasonFormat} 等变量。注意设置里的地址不要末尾不要加/
剧场版保存位置：默认 /Media/剧场版/${title}。剧场版不使用重命名功能，Emby 会依据文件夹名刮削。
自动删除：自动删除已完成任务（不删本地文件）；建议开启「等待做种完毕」再删除，否则可能被 PeerBanHelper 标记为吸血。与「备用 RSS」联动时，会自动删除被洗版替换的旧视频。
失败重试次数：添加到下载器失败时的重试次数。
同时下载限制：推荐 3-5，防止任务过多导致 qBittorrent 卡死。
延迟下载：种子发布时间 + 延迟时间 = 实际下载时间，主要用于配合网盘秒传场景（一般 30 分钟后即可秒传）。

qBittorrent 侧配套设置（来自官方 FAQ）：

勾选「为不完整的文件添加扩展名 .!qB」；
设置「保存未完成的 torrent 到」；
做种限制建议设为「停止任务」，切勿设置「做种后删除任务」，否则 qBittorrent 可能在 ani-rss 处理完成前抢先删任务，引发各种异常；
若出现下载权限错误，可将容器 PUID/PGID 设为 0，或执行 chmod -R 777 /Media。

3.3 添加订阅

点击「添加订阅」，各字段说明如下：

字段	说明
标题	订阅标识名
TMDB	从 TMDB 获取的番剧名称，支持剧集组（集标题将按剧集组信息获取，与 tvshow.nfo 联动）
BgmUrl	Bangumi 番剧链接
主 RSS	订阅链接地址（如蜜柑计划的番剧 RSS）
备用 RSS	可设置多个备用源，需先在设置中开启「备用 RSS」功能
日期 / 季	番剧首播日期与季度
集数偏移	修正字幕组编号与实际集数的差异
总集数	通过 Bangumi 获取，用于自动禁用订阅
匹配 / 排除	支持正则表达式过滤种子标题
全局排除	套用全局排除规则
剧场版	剧场版保存位置为空时使用「保存位置」
自定义集数规则	默认规则无法识别集数时，可自定义正则（不会写正则可以借助 AI 生成）
自定义下载	针对该订阅单独设置下载参数
遗漏检测	检测最小与最大集数之间是否有遗漏并通知（缺集超过 10 个视为误判不通知）
只下载最新集	仅下载最新一集，不补旧集
启用	是否开启该订阅

「添加订阅配置」中还有几个全局开关值得关注：只下载最新集、标题添加年份（数据源可选 Bangumi 或 TMDB）、自动剧集偏移（如《无职转生》第二季从第 0 集开始自动识别偏移 +1）、自动刮削、全局排除等。

新手建议：第一次不要批量导入订阅，先用一部测试番剧验证「拉取 → 识别 → 推送下载器 → 下载 → 重命名」全链路，确认无误后再批量添加。

3.4 RSS 设置

RSS 开关：轮询任务总开关，关闭后不再检查更新，但配置与历史保留；
RSS 间隔：轮询间隔（分钟），订阅多时不宜设置得过小；
自动跳过：自动检测季度文件夹下是否已有该集，必须开启自动重命名且保证挂载路径一致；
自动禁用订阅：依据 Bangumi 总集数，全部下载完成后自动停用订阅（每 12 小时同步一次总集数）；
自动跳过 X.5 集：是否把 12.5 这类总集篇/特别篇纳入跳过判断；
摸鱼检测：主 RSS 超过设定天数未更新时发通知，适合发现字幕组断更、源站失效等问题；
备用 RSS（洗版核心）：主 RSS 未更新时先下载备用 RSS，主 RSS 更新后自动覆盖替换。
- 洗版推荐配置：使用默认重命名模板、关闭「多字幕组共存模式」、开启「自动删除」、关闭「自动跳过」；
- 若希望主备源同时保留（如双字幕组收藏），可开启「多字幕组共存模式」，但重命名模板中必须包含 [${subgroup}]。

3.5 重命名设置

自动重命名：下载完成后按模板重命名视频与字幕文件，不影响 BT 做种；
重命名间隔：重命名任务执行周期（分钟）；
最大文件名长度：超长自动截断（不含扩展名）；
重命名模板：默认 [${subgroup}] ${title} S${seasonFormat}E${episodeFormat}，效果如 Wonderful 光之美少女！ S01E31.mkv；
- ⚠️ 模板中至少需保留 S${seasonFormat}E${episodeFormat} 或 S${season}E${episode}，否则无法重命名；
- 可用变量还包括 ${episodeTitle}（TMDB 集标题）、${bgmEpisodeTitle}、${bgmJpEpisodeTitle}、${resolution}、${itemTitle} 等；
剔除年份 / 剔除 TMDB ID：自动去除文件名中的 (2024)、[tmdbid=242143] 等标识。

3.6 通知设置

通知事件类型包括：开始下载、下载完成、缺少集数、发生错误、OpenList 上传通知、订阅完结、摸鱼检测（其中「下载完成」暂不支持 Aria2；「订阅完结」需开启「自动禁用订阅」）。

通知模板支持 ${emoji}、${action}、${title}、${score}、${subgroup}、${currentEpisodeNumber}/${totalEpisodeNumber}、${downloadPath} 等丰富变量。

支持的通知方式：

Telegram：通过 @BotFather 创建 Bot 获取 Token；
邮箱：以 QQ 邮箱为例——SMTP 地址 smtp.qq.com、端口 465、开启 SSL、关闭 STARTTLS，密码需使用邮箱「设置 - 账号」中开启服务后生成的授权码；
Server酱：填写 SendKey 即可推送到微信；
Emby 媒体库刷新：填写 EmbyHost、API 密钥、媒体库与延迟时间，下载完成后自动刷新媒体库；
文件移动（仅下载完成通知）：自动把完成的视频移动到挂载目录，配合 CD2 网盘挂载实现上传，使用 qBittorrent 时需勾选 .!qB 扩展名选项；
OpenList 上传（仅下载完成通知）：将完成文件上传至 OpenList，令牌在 OpenList「设置 - 其他 - 令牌」获取。

3.7 代理设置

代理用于访问 Mikan、Bangumi、TMDB、Telegram，仅支持 HTTP 代理。当出现 RSS 获取超时、SSL 握手异常、DNS 解析失败等问题时，优先检查或启用代理（通常比单纯更换 DNS 更稳定）。

3.8 日常使用与运维

推荐上手路线：Docker 部署 → 配置下载设置 → 修改登录密码 → 添加一个测试订阅 → 确认链路正常 → 再逐步开启重命名、通知、备用 RSS 洗版等进阶功能。一次只调整一两项，便于定位问题。
订阅管理：番剧完结后，「自动禁用订阅」会自动停止轮询；也可手动启用/停用单条订阅。
预览与缓存：删除本地视频后若预览仍显示存在，需在预览界面删除对应种子缓存。
忘记密码：参考文档「忘记密码」章节重置。
常见排错：
- 自动跳过/洗版不生效 → 检查 ani-rss 与下载器挂载路径是否一致；
- 集数识别错误 → 开启自定义集数规则；
- 自动重命名不生效 → qBittorrent 需 ≥ 4.6.11，模板须包含 S..E.. 段；
- 网络超时/SSL 异常 → 配置代理，避免使用运营商默认 DNS；
- Windows 端口被占用 → 可能是 Hyper-V 随机占用，可调整动态端口范围或改用 --server.port 指定其他端口；
- 部分 NSFW 番剧无法解析 → 在设置中完善 BgmToken。

四、总结

ANI-RSS 把追番流程中最繁琐的「盯更新、找种子、下文件、改名字、刮元数据、换版本」六个环节全部自动化：一次配置下载器与订阅，之后每一季新番都会安静地出现在你的媒体库里。配合 qBittorrent + Emby/Jellyfin 的经典组合，它几乎是目前个人番剧媒体库自动化的最优解之一。

参考链接

官方文档：https://docs.wushuo.top
GitHub 仓库：https://github.com/wushuo894/ani-rss

ANI-RSS：基于 RSS 的自动追番、订阅、下载、刮削与洗版

一、软件简介

1.1 ANI-RSS 是什么

1.2 核心功能

1.3 主要特点

1.4 适用场景

二、Docker Compose 部署教程

2.1 环境要求

2.2 镜像版本选择

2.3 编写 docker-compose.yml

2.4 启动容器

2.5 常见配置参数说明

2.6 与下载器配套的参数

三、使用教程

3.1 首次登录与安全设置

3.2 配置下载器（关键步骤）

3.3 添加订阅

3.4 RSS 设置

3.5 重命名设置

3.6 通知设置

3.7 代理设置

3.8 日常使用与运维

四、总结

ANI-RSS：基于 RSS 的自动追番、订阅、下载、刮削与洗版

屋檐下的猫🐱

文章目录