Transmission 更改下载目录不重新下载:已有任务迁移与校验
简答:可以。先暂停任务并备份配置,再把已有数据放到目标目录,用 Set Location 重新关联;多文件任务填顶层文件夹的父目录,单文件任务填文件所在目录,随后执行 Verify Local Data,确认进度恢复后再继续下载或做种。
定义:Transmission 更改下载目录不重新下载,指保留原有任务记录和已完成分块,只重新指定数据位置并校验本地文件,而不是删除任务后重新添加。
先看正确路径:Set Location 不是把任务顶层文件夹再填一遍
本文是站外操作指南,先给结论:如果文件已经移动,选择 Set Location,并把 Local data is already there 作为“数据已在新位置”的选项;不要选择会从旧位置搬移数据的选项。Transmission 的 RPC 规范把这两种行为区分为 move=false(在新位置查找已有文件)和 move=true(从旧位置移动文件)。Transmission RPC 规范
| 任务类型 | 实际数据结构 | Set Location 应填写 | 容易填错的路径 |
|---|---|---|---|
| 多文件任务 | /downloads/movie-a/,里面有多个文件 | /downloads | /downloads/movie-a,可能导致再次拼接一层 movie-a |
| 单文件任务 | /downloads/movie.iso | /downloads | /downloads/movie.iso,这里需要的是文件所在目录 |
| Docker/NAS | 宿主机为 /volume1/downloads,容器内为 /downloads | 填写 Transmission 容器内能看到的路径:/downloads | 直接填宿主机路径,容器内通常无法访问 |
Transmission 的配置和 resume 文件会记录任务数据路径及已下载分块,因此不要只修改全局默认下载目录后就期待旧任务自动迁移;已有任务仍应单独重新关联。Transmission 配置文件说明
按这个顺序操作:备份、暂停、重新定位、校验
- 备份配置。需要停止 daemon 或客户端时,先停止并复制配置目录;备份完成后立即重新启动 Transmission,后面的暂停和设置位置必须在客户端或 Web UI 可用时操作。配置目录中通常包含
settings.json、torrents/和resume/,其中 resume 文件保存任务路径及进度信息。配置目录与 resume 文件说明 - 暂停任务。选中已经移动数据的任务,先执行 Pause,等待磁盘读写停止。不要在任务仍下载或做种时直接搬移同一批文件。
- 确认新目录结构。先在文件管理器或终端确认多文件任务的顶层目录存在;例如数据在
/downloads/movie-a/,Set Location 填/downloads,不是/downloads/movie-a。 - 设置位置。在任务菜单中寻找
Set Location或Set Torrent Location。如果界面询问是否移动数据,选择表示本地数据已经在目标位置的选项,英文原文通常是Local data is already there,中文译名以实际客户端显示为准。GTK 和 Qt 的源码翻译中都能查到这些入口文字。Transmission Qt 界面文字来源 - 执行校验。对任务执行
Verify Local Data;部分客户端会显示为验证本地数据或重新校验。等待校验结束,再查看完成比例、剩余大小和任务状态。 - 恢复任务并验收。已完成任务应回到做种状态,未完成任务应保留原有完成比例;随后重启一次 Transmission,确认路径和状态仍然正确。
如果任务提示找不到数据,Transmission 的提示文本本身建议先使用 Set Location,再使用 Verify Local Data。Transmission 错误提示源码
Windows、macOS、Linux 和 Web UI 怎么找入口
| 场景 | 重新定位入口 | 校验入口 | 注意事项 |
|---|---|---|---|
| Windows Qt | 选中任务后打开任务菜单,查找 Set Location 或同义中文项 | 任务菜单中的 Verify Local Data 或同义中文项 | 配置目录通常位于 %LOCALAPPDATA%/transmission;实际菜单文字以当前客户端为准 |
| Linux GTK/Qt | 选中任务后查找 Set Torrent Location | 查找 Verify Local Data | GTK/Qt 配置目录通常位于 $HOME/.config/transmission,daemon 可能使用独立配置目录 |
| macOS | 在任务菜单或信息面板中查找移动/设置任务位置的等效入口 | 查找验证本地数据的等效入口 | macOS 界面菜单名和当前客户端版本有关;配置位置通常与 $HOME/Library/Application Support/Transmission 相关 |
| Web UI/远程 daemon | 任务菜单中的 Set Location | 任务菜单中的 Verify Local Data | 路径必须是 daemon 所在主机或容器内部路径,不是浏览器所在电脑的路径 |
Windows、Linux 和 macOS 的配置目录存在差异;如果你连接的是远程 daemon,客户端显示的路径也应以 daemon 能访问的文件系统为准。Transmission 各平台配置目录
Docker、NAS 或 Jail:先解决路径映射,再做 Set Location
容器场景最常见的错误是把宿主机路径直接填入 Transmission。假设 Compose 将宿主机 /volume1/downloads 挂载到容器内 /downloads,文件实际位于宿主机 /volume1/downloads/movie-a,那么 Transmission 内部应使用 /downloads,而不是 /volume1/downloads。
- 宿主机检查:确认
/volume1/downloads/movie-a存在。 - 容器内检查:确认 Transmission 进程能看到
/downloads/movie-a。 - 任务定位:多文件任务填
/downloads;单文件任务也填其所在目录。 - 权限检查:运行 Transmission 的账户需要读取已有文件,并能写入未完成任务需要继续写入的目录。
- 校验验收:Set Location 后执行 Verify Local Data,不要用删除任务再重新添加代替迁移。
Transmission 的底层接口也明确区分“移动文件”和“在新位置查找已有文件”,因此容器内路径正确时应使用只定位的方式。Transmission 路径定位接口说明
大量任务迁移:用 RPC 批量设置位置后再逐个校验
如果需要迁移很多任务,可以调用 RPC 的 torrent_set_location,通过任务 ID 数组批量指定新位置;关键是把 move 设为 false,让 Transmission 在新目录寻找已经存在的数据。下面是按当前 RPC 字段写出的请求结构,认证、RPC 地址和任务 ID 需要按你的环境填写:
{"method":"torrent_set_location","arguments":{"ids":[12,15],"location":"/downloads","move":false}}
批量定位后仍建议执行校验并逐项验收。RPC 规范明确规定了 ids、location 和 move 字段;不同版本的旧式连字符字段与新式下划线字段存在兼容差异,脚本应先读取会话返回的 RPC 版本,再按对应协议发送请求。Transmission RPC 方法与版本说明
校验为 0% 或任务仍提示找不到数据怎么办
- 先检查是否多了一层目录。如果真实路径是
/downloads/movie-a/file.mkv,而任务元数据期望的顶层目录是movie-a,位置通常应填/downloads,不是/downloads/movie-a。 - 确认任务类型。单文件任务要让 Transmission 在目标目录找到文件名本身;不要把文件路径误当成目录路径。
- 确认 daemon 视角。Docker、NAS 或远程 Web UI 中,浏览器能看到的宿主机路径不代表 daemon 能看到。
- 重新执行 Set Location,再执行 Verify Local Data。只修改默认下载目录、只重启客户端或只刷新界面,不能替代已有任务的重新定位。
- 检查权限和挂载是否持久化。如果重启后路径又失效,检查容器挂载、服务账户权限以及配置目录是否被正确保存。
- 最后再考虑重新下载。只有在本地文件确实缺失或已损坏时,校验结果才可能显示缺失分块;不要因为路径填错就删除任务。
Transmission 的配置文档说明 resume 文件记录任务数据保存路径和已下载部分,因此迁移时保留配置并正确重新定位,比删除任务后重新添加更适合保留已有进度。Transmission resume 数据说明
常见问题
修改 Transmission 的默认下载目录,会自动影响已有任务吗?
不要把默认目录修改当作已有任务迁移。已有任务的路径和进度保存在任务及 resume 信息中,文件已经移动时,应对任务单独使用 Set Location,再执行 Verify Local Data。
多文件任务为什么不能把 Set Location 填到 movie-a 文件夹?
因为多文件任务通常把 movie-a 视为任务顶层目录。数据在 /downloads/movie-a 时,位置应填 /downloads;填到 /downloads/movie-a 可能让 Transmission 继续寻找 /downloads/movie-a/movie-a。
Local data is already there 和移动数据有什么区别?
前者表示文件已经在新位置,Transmission 只需重新查找和关联;移动数据表示让 Transmission 从旧位置搬到新位置。手动搬完文件后,应选择前者或等效的“不移动、数据已存在”选项。
校验完成后仍然是 0%,应该先重下吗?
先不要重下。依次检查多文件任务是否多填了一层目录、单文件任务是否填了文件所在目录、Docker 是否使用了容器内路径,以及 daemon 是否有读权限;修正后重新 Set Location 和 Verify Local Data。
Transmission Docker 里能直接填 NAS 宿主机路径吗?
通常不能。Set Location 应填写 Transmission 进程所在容器能访问的路径;例如宿主机 /volume1/downloads 映射为容器 /downloads,就填写 /downloads。
相关阅读
- Transmission 下载目录权限错误排查
- Transmission 下载目录与安装设置
- Transmission Docker 路径映射与网络排查
- Transmission Docker 权限和持久化配置