Transmission 下载文件总混在一起?未完成目录这样设置
简答:Transmission 未完成目录主要设置两处:最终目录由 download-dir 或 download_dir 指定,未完成目录由 incomplete-dir 或 incomplete_dir 指定,并启用对应的 incomplete-dir-enabled 或 incomplete_dir_enabled。桌面版通常从“编辑→偏好设置→Downloading/下载”进入,勾选“Keep incomplete files in”后选择临时目录;修改 settings.json 前必须停止客户端,并以本机现有键名为准。
定义:Transmission 未完成目录,是任务完成前暂存数据的位置;启用后,新任务先写入该目录,任务完成后再移动到最终下载目录。
先看速查卡:界面、配置文件和 Docker 分别改哪里
如果你的目标只是把未完成文件与已完成文件分开,优先使用桌面客户端界面设置;只有在 daemon、Docker 或 Web UI 不方便操作时,才编辑 settings.json。Transmission 官方说明显示,未完成目录开关只影响新添加的任务,任务完成后会移动到最终下载目录;官方配置字段说明对此有明确解释。
| 运行方式 | 改哪里 | 路径应该填什么 | 设置后怎么验证 |
|---|---|---|---|
| Windows、macOS、Linux 桌面版 | 偏好设置中的 Downloading/下载页 | 最终目录和未完成目录都选择本机真实存在的文件夹 | 新建小任务,观察是否先进入未完成目录 |
| Linux 或 macOS daemon | 实际生效的 settings.json | 填写 daemon 进程能看到的路径 | 停止服务、修改、重启,再检查新任务 |
| Docker | 容器内的 settings.json 或 RPC 设置 | 填写容器路径,不是宿主机源路径 | 检查挂载、容器内目录和宿主机目录是否对应 |
| Web UI | 通常可修改常用会话设置,但具体入口随客户端而变 | 以远程 Transmission 服务端看到的路径为准 | 重新连接或重启服务后,用新任务验证 |
例如 Docker 把宿主机的 /srv/transmission/downloads 映射到容器内的 /downloads,配置应填写 /downloads/incomplete,不能填写宿主机的 /srv/transmission/downloads/incomplete。宿主机路径只用于核对挂载。
桌面版界面怎么开启未完成目录
Transmission Qt、GTK 以及 macOS 客户端的菜单名称可能因版本和语言不同而变化,但入口通常都在偏好设置的下载选项中。官方 Qt 中文翻译文件可以核对“偏好设置”“正在下载”“选项”等界面词;相关文字见 Transmission 官方中文翻译文件。
- 打开 Transmission,进入“编辑→偏好设置”或 macOS 菜单栏中的“Transmission→偏好设置”。
- 切换到 Downloading、下载或名称相近的页面。
- 找到 Save to Location,它对应任务完成后的最终下载目录。
- 勾选 Keep incomplete files in,再选择单独的未完成目录。
- 如只想区分文件名,可单独启用 Append “.part” to incomplete files’ names;它只改变未完成文件名,不会改变文件所在目录。
- 保存设置后,用一个新建的小任务验证。已有任务不一定会因为全局默认目录变化而自动迁移。
不同版本可能把英文标签翻译成“保存到位置”“保留未完成文件到”或相近文字。不要只按中文菜单猜测,重点确认两个含义:一个是最终保存位置,另一个是未完成文件位置。
settings.json 的键名:4.x 旧写法与新写法怎么选
本项目检索到的 Transmission 官方文档说明:Transmission 4.1.0 开始逐步把配置字符串转换为下划线命名;Transmission 4 系列默认仍使用连字符命名,并计划在 Transmission 5 中将下划线命名作为默认格式。当前最稳妥的做法不是凭版本号猜,而是打开本机现有 settings.json,沿用文件中已经存在的键名。参考 官方 Editing Configuration Files 文档。
| 作用 | Transmission 4 默认或旧式键名 | 新式下划线键名 |
|---|---|---|
| 最终下载目录 | download-dir | download_dir |
| 未完成目录 | incomplete-dir | incomplete_dir |
| 启用未完成目录 | incomplete-dir-enabled | incomplete_dir_enabled |
| 未完成文件加 .part | rename-partial-files | rename_partial_files |
下面两个示例只能选择与本机现有配置一致的一组,不要把连字符和下划线混在同一份配置中:
{
"download-dir": "/downloads/complete",
"incomplete-dir": "/downloads/incomplete",
"incomplete-dir-enabled": true,
"rename-partial-files": true
}{
"download_dir": "/downloads/complete",
"incomplete_dir": "/downloads/incomplete",
"incomplete_dir_enabled": true,
"rename_partial_files": true
}官方文档列出的下划线字段含义是:启用后,新任务写入 incomplete_dir,完成后移动到 download_dir;rename_partial_files 只是给未完成文件添加 .part 后缀。若配置文件中已有连字符键名,就优先继续使用连字符写法。
修改配置前后的正确操作顺序
- 暂停任务并完全退出 Transmission。官方文档提醒,客户端运行时直接修改配置,退出时可能把旧值重新写回。
- 备份实际配置目录中的
settings.json,同时保留resume和torrents目录。 - 创建最终目录和未完成目录,例如
/downloads/complete与/downloads/incomplete。 - 打开当前真正生效的
settings.json,只修改与本机已有格式一致的四个键。 - 重新启动 Transmission,添加一个体积较小且来源合法的测试任务。
- 任务下载过程中,确认数据先出现在未完成目录;任务完整后,再确认整个任务目录移动到最终目录。
- 如果运行的是 daemon,也可以发送
SIGHUP重新加载配置,但首次修改更建议停止服务后再启动。官方文档给出的命令包括:
killall -HUP transmission-daemon如果你修改的是已有任务,不能只依赖全局目录设置。已有任务可能仍保留原来的路径信息,应暂停任务,使用“设置位置”或类似功能重新指定目录,再执行“验证本地数据”。
Web UI、transmission-remote 和 Docker 怎么处理
Web UI 是否提供完整的未完成目录开关,取决于连接的客户端和服务端版本;官方配置文档明确指出,并非所有配置都能从 GUI 设置,daemon 或 Web UI 可能需要编辑配置文件。不要把 Web UI 当前显示的表单当成完整字段列表。
transmission-remote 当前源码提供了 -c、--incomplete-dir 参数,用于指定新任务在完成前保存到哪里;同时提供 -C、--no-incomplete-dir 用于取消单独的未完成目录。参数定义可参考 Transmission 官方 transmission-remote 源码。使用远程服务时,必须带上认证参数,例如:
transmission-remote HOST:PORT \
-n 'USER:PASSWORD' \
-c /downloads/incomplete这里的 HOST:PORT、用户名、密码和路径都要替换为实际值。此命令针对会话设置,是否写回持久化配置仍应通过重启服务和新任务测试确认;不能只看命令执行成功就认为配置已经永久保存。
Docker 场景中,先检查容器内路径,再检查宿主机挂载。若容器内使用 /downloads/incomplete,宿主机应能通过对应的 Source 目录看到文件;如果文件只出现在容器可写层,说明挂载或配置路径有误。本站已有 Transmission Docker 部署与网络排查指南,可继续核对挂载和服务日志。
设置后不生效、完成后不移动:按现象排查
| 现象 | 优先判断 | 处理步骤 |
|---|---|---|
| 新任务仍直接写入最终目录 | 开关未启用、键名格式不匹配或改错配置文件 | 停止 Transmission,沿用本机原有键名,确认对应 enabled 值为 true,再用新任务测试 |
| 配置重启后恢复旧值 | 客户端运行时修改,退出时覆盖了文件 | 完全退出客户端或停止 daemon 后再编辑,并保留备份 |
| 完成后无法移动 | 最终目录不可写、空间不足或挂载为只读 | 分别测试两个目录的创建、写入、删除权限 |
| 提示 Permission denied | daemon 用户、Docker UID/GID 或父目录权限不正确 | 先确认运行身份,再检查父目录逐层权限,不要直接长期设置为 777 |
| Docker 宿主机找不到文件 | 填写了宿主机路径或没有正确挂载 | 用容器内路径配置,并检查 Source、Destination 和读写状态 |
| 已有任务没有移动 | 任务保存了自己的旧路径 | 暂停任务,重新设置位置,再执行本地数据验证 |
如果遇到下载目录权限错误,可继续查看本站的 Transmission 下载目录权限错误排查。核心顺序是确认运行身份、确认路径存在、检查逐层权限、执行最小写入测试。
跨磁盘或跨文件系统并非一定不能使用,但完成阶段可能涉及复制、删除或较长时间的移动操作。为了减少变量,首次配置建议把两个目录放在同一个可写挂载中;确认流程正常后,再测试跨磁盘规划。
本文结论与自查清单
最容易出错的地方有三个:键名格式、运行环境路径和修改时机。键名必须沿用本机 settings.json 的现有风格;Docker 必须填写容器路径;编辑配置前必须停止客户端或服务。
- 最终目录:由
download-dir或download_dir控制。 - 未完成目录:由
incomplete-dir或incomplete_dir控制。 - 启用开关:对应的
incomplete-dir-enabled或incomplete_dir_enabled必须为true。 - .part 后缀:只影响文件名,不等于未完成目录。
- 验证方式:用新任务观察“未完成目录→最终目录”的完整过程。
- 已有任务:需要单独重新设置位置并验证,不能只改全局默认值。
如排查后确认是线路或连接问题,可了解边界云加速官网的相关服务。
本文为独立整理,非 Transmission 官方,引用页面仅作参考,与本站无合作关系。
资料核验日期:2026-11-18。
常见问题
Transmission 未完成目录怎么在界面里设置?
打开 Transmission 的偏好设置,进入 Downloading 或下载页面,先确认 Save to Location 为最终目录,再勾选 Keep incomplete files in 并选择临时目录。不同版本的中文翻译可能不同,重点是确认“最终保存位置”和“未完成文件位置”两个选项。
settings.json 应该使用下划线还是连字符?
以本机现有 settings.json 中的键名为准。Transmission 官方文档说明,4.1.0 开始逐步转换为下划线命名,但 Transmission 4 默认仍使用连字符命名;不要混用两种格式。
为什么修改 settings.json 后目录仍然不变?
常见原因是 Transmission 没有完全退出、改错了配置文件、键名格式与本机不一致,或测试的是已有任务。先停止客户端并备份,确认实际配置目录,再用一个新任务测试。
Web UI 可以修改未完成目录吗?
是否能完整修改取决于 Web UI 和服务端版本。官方文档明确说明并非所有配置都能从 GUI 设置;如果界面没有对应开关,应停止服务后编辑实际 settings.json,或使用 transmission-remote 的 incomplete-dir 参数,再通过重启和新任务确认是否持久化。
Docker 中填写宿主机路径还是容器路径?
填写 Transmission 容器内的路径。宿主机目录映射到容器的 /downloads 后,配置应使用 /downloads/incomplete;宿主机路径只用于检查挂载是否正确。
启用未完成目录后还要开启 .part 吗?
不需要。未完成目录负责改变文件存放位置,.part 选项负责改变未完成文件名。需要同时实现目录隔离和文件名标识时,才分别开启两项。
完成后没有移动并提示 Permission denied,先查什么?
先确认 Transmission 的运行账户或 Docker UID/GID,再分别检查未完成目录和最终目录是否可写、可删除和可移动,同时确认磁盘已挂载且不是只读。