AyuCLouD-Services返回首页

Transmission 下载文件总混在一起?未完成目录这样设置

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

简答: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 官方中文翻译文件。

  1. 打开 Transmission,进入“编辑→偏好设置”或 macOS 菜单栏中的“Transmission→偏好设置”。
  2. 切换到 Downloading、下载或名称相近的页面。
  3. 找到 Save to Location,它对应任务完成后的最终下载目录。
  4. 勾选 Keep incomplete files in,再选择单独的未完成目录。
  5. 如只想区分文件名,可单独启用 Append “.part” to incomplete files’ names;它只改变未完成文件名,不会改变文件所在目录。
  6. 保存设置后,用一个新建的小任务验证。已有任务不一定会因为全局默认目录变化而自动迁移。

不同版本可能把英文标签翻译成“保存到位置”“保留未完成文件到”或相近文字。不要只按中文菜单猜测,重点确认两个含义:一个是最终保存位置,另一个是未完成文件位置。

settings.json 的键名:4.x 旧写法与新写法怎么选

本项目检索到的 Transmission 官方文档说明:Transmission 4.1.0 开始逐步把配置字符串转换为下划线命名;Transmission 4 系列默认仍使用连字符命名,并计划在 Transmission 5 中将下划线命名作为默认格式。当前最稳妥的做法不是凭版本号猜,而是打开本机现有 settings.json,沿用文件中已经存在的键名。参考 官方 Editing Configuration Files 文档。

作用Transmission 4 默认或旧式键名新式下划线键名
最终下载目录download-dirdownload_dir
未完成目录incomplete-dirincomplete_dir
启用未完成目录incomplete-dir-enabledincomplete_dir_enabled
未完成文件加 .partrename-partial-filesrename_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 后缀。若配置文件中已有连字符键名,就优先继续使用连字符写法。

修改配置前后的正确操作顺序

  1. 暂停任务并完全退出 Transmission。官方文档提醒,客户端运行时直接修改配置,退出时可能把旧值重新写回。
  2. 备份实际配置目录中的 settings.json,同时保留 resume 和 torrents 目录。
  3. 创建最终目录和未完成目录,例如 /downloads/complete 与 /downloads/incomplete。
  4. 打开当前真正生效的 settings.json,只修改与本机已有格式一致的四个键。
  5. 重新启动 Transmission,添加一个体积较小且来源合法的测试任务。
  6. 任务下载过程中,确认数据先出现在未完成目录;任务完整后,再确认整个任务目录移动到最终目录。
  7. 如果运行的是 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 denieddaemon 用户、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,再分别检查未完成目录和最终目录是否可写、可删除和可移动,同时确认磁盘已挂载且不是只读。

相关阅读

参考资料

  1. Transmission 官方配置字段与修改说明
  2. Transmission 官方配置文件位置说明
  3. Transmission 官方中文界面翻译文件
  4. Transmission 官方 transmission-remote 参数源码
  5. Transmission 官方 RPC 配置字段说明
  6. Transmission Docker 部署与网络排查指南
  7. Transmission 下载目录权限错误排查
  8. Transmission 已有任务迁移与校验步骤