qBittorrent可通过四种方式自动删除已完成任务:一、启用内置做种限制删种;二、配置完成时运行脚本调用API删种;三、使用qBit Manage按多维条件批量删种;四、通过Cleanuparr联动媒体服务器协同清理。

如果您在qBittorrent中完成下载后仍保留大量已完成任务,不仅占用界面空间,还可能干扰种子健康度判断与磁盘管理。以下是实现自动删除已完成任务的多种可行方法:
一、启用内置“自动删种”功能(基于做种限制)
qBittorrent原生支持根据共享率、做种时间等条件自动移除满足规则的已完成任务,无需第三方工具即可触发清理。
1、打开qBittorrent,点击顶部菜单栏的“工具” → “选项”。
2、在左侧导航栏选择“BitTorrent”项。
3、向下滚动至“Seeding Limits”(做种限制)区域。
4、勾选“Enable automatic torrent management”(启用自动种子管理)。
5、勾选“Remove torrent when seeding time limit is reached”(达到做种时间限制时删除种子)或“Remove torrent when ratio limit is reached”(达到分享率限制时删除种子)。
6、分别设置具体阈值,例如:做种时间设为3600秒(1小时),分享率设为1.0。
7、点击“确定”保存,此后所有新添加的种子将按此策略执行自动删种。
二、配置“完成时运行外部程序”调用脚本删种
该方法通过qBittorrent的事件钩子机制,在每个任务完成瞬间执行自定义命令,可精准控制删种逻辑,支持条件判断与日志记录。
1、准备一个Shell脚本(如/opt/qbit/clean_done.sh),内容包含qBittorrent Web API调用逻辑,用于查询并删除状态为“上传完成”的任务。
2、确保脚本具有可执行权限:chmod +x /opt/qbit/clean_done.sh。
3、进入qBittorrent“选项”→“下载”选项卡。
4、在“Run external program on torrent completion”输入框中填入完整路径与参数,例如:/opt/qbit/clean_done.sh "%I" "%N"。
5、其中"%I"为哈希值,"%N"为任务名称,供脚本识别目标任务。
6、确认qBittorrent Web UI已启用且用户名密码正确,脚本中需使用curl携带认证信息访问http://localhost:8080/api/v2/torrents/delete接口。
三、使用qBit Manage执行批量条件删种
qBit Manage作为专用自动化工具,提供可视化规则引擎,可按标签、分类、完成时间、文件存在性等多维条件筛选并清理已完成任务,避免误删活跃种子。
1、部署qBit Manage服务(Docker或源码方式),确保其能通过API连接到qBittorrent实例。
2、登录qBit Manage Web界面,进入“Rules” → “Create New Rule”。
3、设置触发条件为“State is Completed”,并添加附加约束,例如:“Tags contains auto_clean”或“Added date is older than 1 day”。
4、在动作部分选择“Delete torrent and data”或“Delete torrent only”,根据需要勾选“Also delete .torrent file”。
5、启用规则并设置执行频率为“On every scan”或“Every 5 minutes”。
6、启动扫描后,qBit Manage将自动匹配并执行删种操作,所有动作均记录于/var/log/qbitmanage/execution.log。
四、通过Cleanuparr集成实现跨应用协同清理
Cleanuparr专为媒体下载栈设计,可联动Sonarr/Radarr与qBittorrent,识别“下载完成但未被媒体服务器成功导入”的孤立任务,并执行安全删种。
1、在Cleanuparr中完成qBittorrent客户端配置,确保主机、端口、凭据全部验证通过。
2、进入“Settings” → “Actions”,新建一条Action规则。
3、设定“Client”为已配置的qBittorrent实例,“Status”为Completed,“Category”可限定为tv/movies等指定分类。
4、启用“Delete torrent only”并勾选“Also delete data files”仅当确认文件未被任何媒体应用引用时才执行。
5、在“Filters”中添加排除项,例如排除标签为keep_forever或名称含[backup]的任务。
6、保存后手动触发一次“Run Cleanup”或等待定时任务自动轮询。

















