Transmission 删除任务但保留文件:Remove、RPC 与 Docker 安全操作
简答:Transmission 只删除任务记录而保留下载文件,应选择普通 Remove/移除;命令行使用 --remove,RPC 根据版本使用 torrent-remove 或 torrent_remove,并把删除本地数据的参数设为 false。
定义:Transmission 删除任务但保留文件,是指移除客户端中的任务记录、状态和恢复信息,但不删除下载目录中的实际数据。
30 秒速查:先选对操作
如果你的目标只是清理 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 项安全检查
点击移除前,建议先暂停任务并完成下面四项检查。尤其是未完成任务和正在做种的任务,不要只看任务名称就直接操作。
- 确认下载目录。记录任务详情中显示的下载位置,并在文件管理器、NAS 或服务器上确认目标文件夹仍存在。
- 确认任务 ID 和名称。命令行操作先执行列表命令,核对任务 ID、名称和完成状态,避免移除相邻任务。
- 暂停正在写入或做种的任务。暂停可以减少文件仍在写入、校验或被其他进程占用时产生的混淆。
- 保留恢复材料。如果以后还要继续做种,保存原始
.torrent文件或磁力链接;只保留下载文件,不能自动恢复任务记录。
Transmission 的配置目录、.torrent 文件、.resume 文件和下载数据不是同一个对象。官方配置说明指出,torrents/ 保存已添加的种子文件,resume/ 保存下载分块、数据路径等恢复信息。Transmission 配置文件说明
图形界面:普通 Remove 才是保留文件的选择
- 暂停目标任务,并记录任务名称、下载目录和完成状态。
- 右键任务或打开任务操作菜单,寻找普通的 Remove、移除或不含“删除本地文件”含义的选项。
- 看到确认框后,检查是否出现 Delete Files、Remove and Delete、删除文件等字样。
- 如果确认框要求删除本地数据,取消操作,返回菜单重新选择普通移除。
- 任务从列表消失后,到原下载目录检查文件夹和文件是否仍在。
| 界面 | 可确认的判断方式 | 按钮名称 |
|---|---|---|
| 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 规范
移除后想继续做种:重新添加、定位并校验
- 重新添加原来的
.torrent文件或磁力链接,并在需要时先暂停自动启动。 - 确认任务类型和顶层内容名称。
- 设置本地位置:如果多文件任务的顶层目录名是
movie-a,实际目录为/downloads/movie-a/,位置应填写其父目录/downloads;不要填写子目录/downloads/movie-a。如果是单文件任务,位置填写该文件所在目录。 - 文件已经在目标位置时,选择不移动数据、只搜索现有文件的方式。
- 执行 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 配置文件说明
如果任务已经消失:按顺序检查文件和恢复材料
- 暂停相关任务或停止自动操作。避免重新添加后立即下载、移动或覆盖现有文件。
- 检查原下载目录。确认文件夹、文件大小和修改时间,不要只根据任务是否消失判断数据是否被删除。
- 检查挂载状态和权限。外置硬盘、NAS 共享或 Docker volume 暂时不可用时,文件可能只是当前环境不可见。
- 查找原始种子或磁力链接。没有任务记录时,需要用这些材料重新添加任务。
- 重新设置位置并执行本地数据校验。按照上一节的父目录规则填写路径,确认校验结果后再启动。
需要注意,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 和权限。
相关阅读
- Transmission 更改下载目录不重新下载:已有任务迁移与校验步骤
- Transmission 中文界面怎么设置:下载、导入与排障指南
- Transmission 下载目录权限错误怎么办?按系统与 Docker 排查