群晖qbittorrent下载自动分类

简介

这套做法围绕群晖 NAS 上的 qBittorrent，把「新任务从哪来、文件落到哪」两件事自动化：用监听目录接收拖入的种子，用 RSS 订阅按规则自动建任务，再按来源把保存路径拆到不同目录，避免所有文件堆在一个文件夹里。它适合在群晖上跑 Docker 下载、追番、做 BT/PT 管理的用户，部署过程有图形界面教程可逐步跟做，常见镜像可选 linuxserver/qbittorrent，容器还能用你自己的账户权限运行，避免下载完的文件在群晖文件面板里改不动。

核心功能

• 监听目录自动建任务：把种子文件放进指定目录即自动开始下载，目录通过卷挂载暴露给容器，宿主机和容器内路径需要对应。
• RSS 订阅自动下载：添加订阅源后按规则匹配新条目自动建任务，常用于自动追番并连带下载字幕。
• 保存路径按来源拆分：不同来源指向不同目录，例如把下载文件夹直接设置到外接硬盘，或按电影、剧集、订阅分开落盘。
• Docker 图形化部署：在群晖 Container Manager 的注册表页签搜索 qBittorrent，选中 linuxserver/qbittorrent，标签选 latest 后下载。
• 容器参数可配：创建容器时配置卷挂载、环境变量与端口，再用 Web Station 建门户从浏览器进入管理界面。
• WebUI 可替换：支持更换 Web UI，社区有 iOS 风格的 iQbit 主题，可在群晖上用 Docker 部署。
• Tracker 与版本可控：Docker 方式版本可控，新版本在 Tracker 处理、RSS 解析、内存占用上有优化，也有 tracker 自动更新的做法可参考。

使用场景

• 追番与字幕：用 RSS 订阅匹配更新条目自动下载，配合按番剧拆分的保存目录，新集出现后无需手动建任务。
• 大批量种子归档：拖入监听目录即开始下载，按来源分别落到外接硬盘或不同共享文件夹，避免事后手动搬运。
• 远程离线下载：把 qBittorrent 部署在群晖上，出门时用浏览器打开 Web Station 门户提交磁力或种子，回家直接取文件。
• 多任务并行与限速管理：利用磁力链接、种子下载、多任务并行、限速设置、队列管理，在带宽有限时安排下载节奏。
• 反吸血与镜像定制：有静态编译 qbittorrentee 的增强版镜像，支持 x86-64、arm64、armhf 全平台架构，参考 https://blog.gy63.com/index.php?c=show&id=477。
• 界面改造：替换 WebUI 换成 iOS 风格主题，或继续用原生界面，按自己习惯选择。

安装与获取步骤

1. 打开群晖 Container Manager，切到注册表页签，在搜索框输入 qBittorrent 回车，从结果中选中 linuxserver/qbittorrent，标签选 latest 后点击下载或双击。
2. 创建容器时完成三项配置：卷挂载（下载目录、监听目录、配置目录）、环境变量、端口映射；若镜像仓库搜索不到结果，先按教程配置轩辕镜像仓库再重试。
3. 浏览器打开 WebUI，做一遍常用设置：限速、队列、默认保存路径；把保存路径指向已挂载的共享文件夹或外接硬盘。
4. 指定监听目录：确认该目录已挂载进容器，之后把种子文件放入宿主机对应目录，观察任务是否自动出现并开始下载。
5. 配置 RSS 订阅：添加订阅源并设定匹配规则，用于自动追番与字幕下载，规则改动后留意 RSS 解析是否正常。
6. 可选优化：替换 WebUI 主题、更新 tracker、参考 https://blog.csdn.net/LawssssCat/article/details/103626875 的 docker 使用笔记做进一步调整。

与同类方案的区别

• 套件中心方式：版本往往滞后，而 qBittorrent 版本更新较频繁，新版本在 Tracker 处理、RSS 解析、内存占用上有优化，Docker 方式版本可控。
• 非 Docker 套件方式：走套件安装配置、替换 WebUI 的路线，路径更短，但镜像与架构选择受限，具体差异以官方页面为准。
• 与 Download Station、Transmission 并列对比时，qBittorrent 的优势在于开源、Web 界面远程管理，以及监听目录与 RSS 这两条自动化入口。

注意事项

• 权限：镜像做了 usermapping，用你自己的账户权限运行，这点在群晖上尤其重要；权限不匹配会导致容器写不进下载目录。
• 路径：容器内路径与宿主机路径不是同一个，监听目录和保存目录都要先挂载再填写，否则种子放进去不会被识别。
• 速度：有用户反馈下载速度只有可用带宽的一半，需依次检查是否设了限速、目录是否在外接硬盘、tracker 是否失效。
• 架构：镜像分 x86-64、arm64、armhf，选错架构的容器起不来，先确认群晖机型对应的架构。
• 版本与参数：镜像标签、端口、目录位置以官方页面与所选镜像说明为准，不要照抄他人配置。