AyuCLouD-Services返回首页

Transmission 删除任务但保留文件:Remove、RPC 与 Docker 安全操作

更新于 2026-11-19 · ayu-ssr.buzz

简答:Transmission 只删除任务记录而保留下载文件,应选择普通 Remove/移除;命令行使用 --remove,RPC 根据版本使用 torrent-remove 或 torrent_remove,并把删除本地数据的参数设为 false。

定义:Transmission 删除任务但保留文件,是指移除客户端中的任务记录、状态和恢复信息,但不删除下载目录中的实际数据。

30 秒速查:先选对操作

如果你的目标只是清理 Transmission 任务列表,先按下面三种情况选择操作。最需要避开的,是明确包含删除本地数据含义的选项。

Transmission 删除任务但保留文件速查
使用场景保留文件的写法不要使用预期结果
图形界面选择普通 Remove、移除或同义操作Delete Files and Remove、删除文件并移除任务从列表消失,下载目录应保留
transmission-remote--remove--remove-and-delete移除任务,不请求删除本地数据
旧版 RPC 格式torrent-remove 加 delete-local-data:false将该参数设为 true返回 result:success 时任务被移除
Transmission 4.1.0 及其新 RPC 格式torrent_remove 加 delete_local_data:false将该参数设为 true按 JSON-RPC 2.0 返回结果

官方命令行选项明确区分 remove 与 remove-and-delete;官方 RPC 规范则说明删除本地数据的默认值为 false。实际脚本仍建议显式写出保留文件的参数。Transmission transmission-remote 选项 Transmission RPC 规范

删除前先做 4 项安全检查

点击移除前,建议先暂停任务并完成下面四项检查。尤其是未完成任务和正在做种的任务,不要只看任务名称就直接操作。

  1. 确认下载目录。记录任务详情中显示的下载位置,并在文件管理器、NAS 或服务器上确认目标文件夹仍存在。
  2. 确认任务 ID 和名称。命令行操作先执行列表命令,核对任务 ID、名称和完成状态,避免移除相邻任务。
  3. 暂停正在写入或做种的任务。暂停可以减少文件仍在写入、校验或被其他进程占用时产生的混淆。
  4. 保留恢复材料。如果以后还要继续做种,保存原始 .torrent 文件或磁力链接;只保留下载文件,不能自动恢复任务记录。

Transmission 的配置目录、.torrent 文件、.resume 文件和下载数据不是同一个对象。官方配置说明指出,torrents/ 保存已添加的种子文件,resume/ 保存下载分块、数据路径等恢复信息。Transmission 配置文件说明

图形界面:普通 Remove 才是保留文件的选择

  1. 暂停目标任务,并记录任务名称、下载目录和完成状态。
  2. 右键任务或打开任务操作菜单,寻找普通的 Remove、移除或不含“删除本地文件”含义的选项。
  3. 看到确认框后,检查是否出现 Delete Files、Remove and Delete、删除文件等字样。
  4. 如果确认框要求删除本地数据,取消操作,返回菜单重新选择普通移除。
  5. 任务从列表消失后,到原下载目录检查文件夹和文件是否仍在。
不同界面的移除入口速查
界面可确认的判断方式按钮名称
Transmission Qt按确认框是否包含删除本地数据判断具体菜单名需以安装版本实际界面为准
Transmission GTK按普通移除与删除数据是否分开判断具体菜单名需核实
macOS 界面按操作确认框是否要求删除文件判断具体菜单名需核实
Web UI按网页操作菜单和确认框的完整文字判断具体菜单名需核实
第三方远程客户端先查看其是否把“移除任务”和“删除数据”分成两个动作需核实,不要仅凭“删除”二字操作

不同客户端的菜单文字不能仅凭名称推断。没有看到明确的普通移除选项时,先不要点击带有“删除文件”含义的按钮。

transmission-remote:本机、远程 daemon 和 Docker 都要确认连接目标

官方无头使用示例使用 transmission-remote --torrent 2 --remove,执行后返回 success,再用列表命令确认任务已从列表移除。Transmission Headless Usage

第 1 步:查看任务列表。

transmission-remote --list

预期输出:显示任务 ID、完成度、状态和名称。先确认目标任务的纯数字 ID。

第 2 步:只移除任务记录。

transmission-remote --torrent <任务ID> --remove

预期输出:返回成功提示;任务从列表中消失。随后检查原下载目录,确认文件仍在。

第 3 步:远程 daemon 指定地址和认证。

transmission-remote --host <服务器地址> --port <RPC端口> --auth <用户名:密码> --torrent <任务ID> --remove

预期输出:客户端连接指定的 daemon 并返回成功;如果提示认证失败、连接失败或地址不可达,先核对 RPC 地址、端口和认证设置。官方命令行选项提供主机、端口和认证参数。Transmission transmission-remote 选项

不要执行下面的命令来保留文件:

transmission-remote --torrent <任务ID> --remove-and-delete

预期结果:该选项会同时移除任务并删除本地数据,因此不适合“删除任务但保留文件”。

macOS 和 Linux 可在 shell 中使用上述写法。Windows PowerShell 中,<任务ID>应替换为纯数字;PowerShell 5.1 与 7.3 及更高版本调用原生程序时的参数解析行为存在差异,复杂引号参数应先用单个任务测试。微软文档明确说明,PowerShell 7.3 改变了原生命令参数解析方式,并可能影响依赖旧行为的脚本。Microsoft Learn:about_Parsing

RPC:按 Transmission 版本选择旧格式或新格式

RPC 是最容易因版本格式不匹配而失败的部分。Transmission 官方规范说明,4.1.0 引入 JSON-RPC 2.0,并把 RPC 字符串改为下划线写法;旧的专用协议和旧的连字符、驼峰混合写法在 Transmission 4 中仍受支持,但已被标记为弃用。Transmission 当前 RPC 规范

Transmission 4.0.6 文档所示的旧格式

{"method":"torrent-remove","arguments":{"ids":[<任务ID>],"delete-local-data":false},"tag":1}

预期输出:成功时返回包含 result 且值为 success 的响应。该写法使用 method、arguments 和 tag,对应 Transmission 4.0.6 的旧 RPC 规范。Transmission 4.0.6 RPC 规范

Transmission 4.1.0 及新 RPC 规范写法

{"jsonrpc":"2.0","method":"torrent_remove","params":{"ids":[<任务ID>],"delete_local_data":false},"id":1}

预期输出:返回 JSON-RPC 2.0 响应,成功结果位于 result 对象中;本地下载数据不应因该请求被删除。新规范要求参数使用对象形式,不支持按位置传参。Transmission 当前 RPC 规范

如果不确定 daemon 使用哪种格式,先确认 Transmission 版本;不要把旧格式的 torrent-remove、delete-local-data 与新格式的 torrent_remove、delete_local_data混用。通过 HTTP 直接调用 RPC 时,还要处理 X-Transmission-Session-Id;旧规范说明,首次请求或会话标识失效时可能返回 HTTP 409,并在响应头中提供新的会话标识,客户端需要带新标识重发请求。Transmission 4.0.6 RPC 规范

移除后想继续做种:重新添加、定位并校验

  1. 重新添加原来的 .torrent 文件或磁力链接,并在需要时先暂停自动启动。
  2. 确认任务类型和顶层内容名称。
  3. 设置本地位置:如果多文件任务的顶层目录名是 movie-a,实际目录为 /downloads/movie-a/,位置应填写其父目录 /downloads;不要填写子目录 /downloads/movie-a。如果是单文件任务,位置填写该文件所在目录。
  4. 文件已经在目标位置时,选择不移动数据、只搜索现有文件的方式。
  5. 执行 Verify Local Data或对应的本地数据校验,等待校验结束后再启动任务。

官方 RPC 规范中,torrent_set_location的move参数设为true表示从旧位置移动文件,设为false表示在新位置搜索已有文件,默认值为false。Transmission 当前 RPC 规范

重新关联时的路径判断
文件结构正确位置错误位置
多文件任务:/downloads/movie-a//downloads/downloads/movie-a
单文件任务:/downloads/movie-a.iso/downloads把文件名当作目录
Docker 挂载:宿主机/volume1/downloads映射为容器/downloads/downloads直接填写宿主机路径

校验完成后,如果进度仍不完整,先检查文件是否缺失、路径是否指向 Transmission daemon 实际可见的位置,以及 Docker 或 NAS 挂载是否正常。

Docker、NAS 和远程 daemon:不要混用宿主机路径

Transmission 运行在 Docker、NAS 或远程服务器时,任务位置应以 daemon 进程实际看到的路径为准。宿主机路径只有在容器内以相同路径挂载时才可直接使用。

  • Docker:先查看容器的 volume 映射,再使用容器内路径,例如宿主机目录映射到容器的 /downloads,任务位置就应使用 /downloads。
  • NAS:确认共享目录已经挂载,并检查 Transmission 运行账户是否能读取和写入该目录。
  • 远程 daemon:在运行 Transmission 的设备上核对路径,不要填写当前电脑上的同名目录。
  • 恢复前:先确认文件夹实际存在,再执行 Set Location 或等效定位操作;不要在路径未确认时使用删除本地数据的动作。

路径和恢复信息由 Transmission 的配置与 resume 数据记录,配置目录位置会因 macOS、Linux、Windows、daemon 或客户端类型而不同,具体位置应以实际安装环境为准。Transmission 配置文件说明

如果任务已经消失:按顺序检查文件和恢复材料

  1. 暂停相关任务或停止自动操作。避免重新添加后立即下载、移动或覆盖现有文件。
  2. 检查原下载目录。确认文件夹、文件大小和修改时间,不要只根据任务是否消失判断数据是否被删除。
  3. 检查挂载状态和权限。外置硬盘、NAS 共享或 Docker volume 暂时不可用时,文件可能只是当前环境不可见。
  4. 查找原始种子或磁力链接。没有任务记录时,需要用这些材料重新添加任务。
  5. 重新设置位置并执行本地数据校验。按照上一节的父目录规则填写路径,确认校验结果后再启动。

需要注意,trash-original-torrent-files这类配置针对的是添加后的原始 .torrent 文件,不应被理解为下载数据回收站设置。下载数据是否进入系统回收站、是否可恢复,取决于实际客户端、操作系统和存储环境,本文不对未核实的平台行为作确定判断。Transmission RPC 规范

本文为独立整理,非 Transmission 官方文档,引用页面仅作参考。

常见问题

Transmission 删除任务会删除文件吗?

不一定。普通 Remove/移除与 Delete Files and Remove 是不同操作;只想保留文件时,应选择不包含删除本地数据含义的普通移除。

Transmission 删除任务但保留文件应该点哪个按钮?

选择 Remove、移除或类似的普通移除按钮;如果确认框出现 Delete Files、删除文件或 Remove and Delete,应取消操作。

transmission-remote 怎么删除任务但不删文件?

先执行 transmission-remote --list 查看任务 ID,再执行 transmission-remote --torrent <任务ID> --remove,不要使用 --remove-and-delete。

Transmission 4.0.6 和 4.1.0 的 RPC 写法为什么不同?

4.0.6 文档使用 torrent-remove、arguments 和 delete-local-data;4.1.0 新 RPC 规范使用 JSON-RPC 2.0、torrent_remove、params 和 delete_local_data。不要混用两套字段。

RPC 如何删除任务但保留下载数据?

旧格式把 delete-local-data 设为 false,新格式把 delete_local_data 设为 false。直接 HTTP 调用时还要处理 X-Transmission-Session-Id。

任务移除后还能继续做种吗?

可以重新添加原来的种子或磁力链接,把位置指向包含任务顶层内容的父目录,再执行 Verify Local Data。校验完成后才能判断文件是否可继续使用。

Docker 中重新添加任务为什么找不到原文件?

常见排查方向是路径视角不一致:Transmission 应使用容器内部挂载路径,而不是未经映射的宿主机路径;同时检查 volume 和权限。

相关阅读

参考资料

  1. Transmission transmission-remote command options
  2. Transmission Headless Usage
  3. Transmission current RPC specification
  4. Transmission 4.0.6 RPC specification
  5. Transmission Configuration Files
  6. Microsoft Learn about_Parsing