SpoolDatTorrent

下载几千个文件、数TB体量的巨型种子，却只想要其中一小部分内容，手动勾选文件不仅耗时，很多客户端面对上万文件列表甚至会直接卡顿崩溃。开源工具 SpoolDatTorrent（SDT） 给出了一套全新方案：基于DAT清单动态控制qBittorrent，只下载清单指定文件，还支持磁盘分批下载，完美解决小硬盘缓存、超大资源集下载的痛点。

传统工作流程往往是先完整下载全部文件，再依靠Retool这类工具，使用DAT清单筛选保留目标内容，多余文件直接删除。这样带宽、硬盘空间被大量无效占用。而SDT直接在下载源头进行过滤，不在清单内的文件从一开始就不会下载，省下带宽、存储空间与大量等待时间。

两大核心能力

1、DAT精准过滤下载

接入DAT清单，SDT实时管控种子下载列表。仅勾选清单内的文件下发给qBittorrent，其余文件直接跳过，不再下载无关资源。非常适合ROM合集、大型素材库、多文件归档资源的精简获取。

2、Spool‑Cap 分批下载机制

即便过滤完成后，剩余文件总大小依旧超出本地缓存硬盘容量，SDT可以设置单批次下载上限。
举个例子：筛选后资源合计2.5TB，而临时下载盘仅有2TB空间。你就可以设置批次上限1TB。工具自动下发第一批1TB任务，下载结束后，将文件迁移到大容量存储池；随后清空本地缓存，继续调度下一批任务，循环往复直至清单全部下载完毕。
迁移策略可选：MoveFiles 文件移动、Pause暂停任务、RateLimit限速三种模式。

开发者提示：下载完成后请记得做种，维持PT/BT生态活力。

两种使用前端

1. Web UI可视化面板：Docker部署，浏览器访问管理任务，适合图形化操作。
2. CLI命令行终端：Windows、Linux原生运行，适配无头服务器、脚本自动化调度场景。

运行前置条件

• qBittorrent 5.0及以上版本，开启Web API服务，获取访问地址、账号密码或者API密钥。当前仅支持qBittorrent客户端。
• WebUI部署依赖Docker；CLI客户端无需容器环境，可以直接本地运行。

CLI快速上手

可执行文件启动后不带参数查看完整帮助文档，核心命令包含添加下载流、暂停、重试、取消任务、管理服务器配置等。
添加下载任务最基础示例：

#配置qBittorrent服务器
SpoolDatTorrent add-server
#打开配置文件填写qb访问信息、批次容量
SpoolDatTorrent config
#添加种子，绑定DAT清单开始下载
SpoolDatTorrent add -t "种子文件路径/磁力链接/哈希值" -d "xxx.dat"

配置文件 config.json 内可以定义默认下载服务器、单批次GB上限、文件移动等待静置时间、重试次数、磁盘预留安全余量等参数。

Docker‑WebUI部署要点

使用docker‑compose拉起镜像后，浏览器访问 http://主机IP:6502，输入管理员密码登录后台。

最关键的挂载规则：SDT容器必须和qBittorrent容器共享相同的已完成、未完成下载文件夹，并且容器内路径保持完全一致。否则工具无法定位已经下载完成的文件，移动任务就会失败。

/staging‑dir 为默认中转目录，下载完毕的文件将会迁移至此；/library‑dir属于可选的第二目标存储位置。容器右侧挂载路径名称不可修改，冒号前面的主机本地路径则可自由调整。

适用人群

ROM收藏爱好者、影音资料库整理人员、需要处理数千文件大型种子的自动化玩家。如果你经常需要从巨型合集当中，只挑选一小部分文件，这款工具可以彻底告别全量下载‑筛选‑删除的低效流程。