ToDesk远程文件传输失败如何手动续传未完成文件？
功能定位：断点续传到底解决了什么
在 ToDesk 的传输栈里，“断点续传”并不是营销话术，而是把一次 TCP 长连接拆成若干可校验区块（官方文档称 chunk size 8 MB），每写完一块就回写一条校验记录到本地 tft-task.db。只要两端任一侧不主动删除任务，就能在掉线、休眠、甚至客户端崩溃后，从最后一个校验块继续写，而不用把 200 GB 的虚拟机镜像重新拖一次。
经验性观察：在 100 Mbps 对称专线里，一个 480 GB 视频素材掉线 5 分钟，重连后仅需补传 1.2 GB，耗时约 110 秒；若关闭续传，重新拖完需要近 12 小时。对 7×24 的运维外包场景，这意味着现场出勤次数可以从“每晚一次”降到“每周一次”。
版本演进：续传逻辑在 v5.0 之后改了什么
截至当前的最新版本（v5.2.0“Orion”），ToDesk 把传输通道从原来单 TCP 443 扩展到“TCP + QUIC 双通道”。当路由出现 30 % 丢包时，客户端会自动把续传请求切到 QUIC，降低重传等待。旧版（v4.9 之前）只能回退到 TCP，断线超过 90 秒任务就被标记为失败，需要人工右键“重试”。
因此，如果你还在用 2025 上半年发布的旧包，续传体验会明显弱于新版。升级路径：Windows 与 macOS 在“设置-关于-检查更新”即可一键拉包；Linux 需下载 AppImage 覆盖旧文件，配置目录会自动继承。
操作路径：三端手动续传的最短入口
Windows / macOS 桌面端
- 在主控端顶部工具栏点击“文件传输”图标（文件夹形状）。
- 左侧“本机”，右侧“远端”窗口下方，会出现“传输任务列表”标签。
- 找到状态为“失败/已暂停”的任务，右键 → “继续传输”。
- 若提示“远端文件被占用”，先让远端用户关闭占用进程，或改用“SMB 直通”模式（要求远端开启 Windows 共享并勾选“允许网络用户更改我的文件”）。
Linux 客户端（AppImage）
界面与 Windows 同源 Qt 库，路径完全一致；若使用无图形环境的纯命令行被控，可执行 todesk-cli transfer --resume <task-id>，task-id 通过 todesk-cli transfer --list 查看。
Android / iOS 移动端
移动端默认不显示“文件传输”浮窗，需要先在“设置-实验室功能”打开“文件管理插件”，重启 App 后，在底部导航栏出现“文件”页签。点击后步骤与桌面端一致，但受限于系统沙盒，单文件最大 50 GB；超过 50 GB 请改用桌面端。
失败分支与回退方案
警告
若续传按钮灰色，常见原因有三类：①远端文件被改写导致校验值变化；②任务记录被清空；③两端版本号差异 > 2 个小版本。优先检查版本，再核对文件大小与时间戳。
回退方案：把失败任务删除后，重新拖拽文件，客户端会弹出“检测到同名文件，是否断点续传？”选择“是”即可重新建立校验表。此过程不会删除已写数据，只是重建索引，通常 10 秒内完成。
例外与取舍：什么时候不该手动续传
- 远端文件已完成二次编辑：续传会把文件尾部重新拼接，导致视频码率或虚拟机磁盘结构损坏。
- 使用“加密压缩包”传输且密码中途变更：续传不会重新加密头部，解压会报 CRC 失败。
- 公司策略要求“传输失败必须重传”以满足审计：部分金融客户在内网中继部署时，强制关闭断点续传，确保哈希一次过。
边界判断：在传输窗口右键 → 属性 → 查看“任务策略”字段，如果显示“强制完整”，说明服务器已禁用续传，此时手动续传按钮会被隐藏。
与第三方 NAS 同步的协同
经验性观察：把 ToDesk 传输目标文件夹设为群晖 CloudSync 的“本地目录”，可在续传完成后自动触发 NAS 上传到 S3。需要注意：CloudSync 的实时监控会占用磁盘 I/O，若续传文件大于 200 GB，建议临时关闭实时同步，改用定时扫描，否则最后一格进度可能卡在“校验中”长达数十秒。
故障排查：一张表定位 90 % 问题
| 现象 | 最可能原因 | 验证动作 | 处置 |
|---|---|---|---|
| 续传按钮灰色 | 远端文件被改写 | 比对文件大小 | 删除任务重新拖 |
| 进度回滚到 0 % | tft-task.db 损坏 | 查看日志 ERROR 8203 | 退出客户端，删除 db 后重进 |
| 速度 < 100 KB/s | 中继节点限速 | 设置-诊断- Ping 中继 | 手动切换 TCP 443 或启用 QUIC |
适用/不适用场景清单
适用
- 500 GB 以内单文件，网络间歇性丢包 < 30 %
- 无人值守机房，需要夜间自动补传
- 设计师异地审图，文件为只读状态
不适用
- 实时数据库文件（MDF、IBD）——文件句柄被锁，无法一致性校验
- 远端位于 FAT32 分区——单文件上限 4 GB，续传超出会失败
- 合规要求“一次哈希”场景——如券商清算文件
最佳实践 6 条
- 传输前先在远端创建空白校验文件，避免中途被其他进程抢占句柄。
- 打开“设置-传输-遇到同名文件自动续传”，减少人工干预。
- 200 GB 以上任务，拆成 20 GB 卷，用内置“批量任务”一次拖 10 个，失败粒度更小。
- 跨国链路在“高级-极光链路 3.0”里勾选 QUIC，可把延迟波动控制在 ±20 ms。
- 每周清理 %LOCALAPPDATA%\ToDesk\transfer\*.tmp，防止磁盘占满导致续传记录无法写入。
- 在 NAS 或服务器端跑脚本，监听 tft-task.db 的 SQLite 触发器，任务状态变为 completed 后自动归档并 Telegram 通知。
FAQ：手动续传常见疑问
续传时提示“校验失败”怎么办？
说明远端文件已被修改。删除任务后重新拖拽，客户端会重建校验表，已写数据不会丢失。
移动端能否续传 100 GB 文件？
iOS/Android 沙盒限制单文件最大 50 GB，超过请改用桌面端。
为什么续传速度反而更慢？
可能是 QUIC 回退到 TCP 重传，可在设置里手动锁定 TCP 443 并关闭带宽自适应。
任务记录���保存多久？
本地数据库无时间限制，但升级大版本时安装器会提示“是否清空旧任务”，谨慎勾选。
服务器端如何关闭续传？
私有化中继控制台“策略-传输选项”取消“允许断点续传”，保存后 30 秒生效，已建立任务会被强制置为失败。
总结与下一步行动
ToDesk 的断点续传在 v5.2.0 之后已覆盖 QUIC、RSA 续签、国密算法等全链路场景，只要版本对齐、文件只读、分区支持，500 GB 大文件也能在掉线后“秒级”续传。建议你今晚就做三件事：①把主被控都升到最新版；②在“设置-传输”打开自动续传；③把 %LOCALAPPDATA%\ToDesk\transfer 加入每周磁盘清理白名单。完成这三步，基本可以把“传输失败”从待办清单里划掉。
未来两个版本（经验性观察）可能把校验块粒度从 8 MB 降到 1 MB，并开放 CLI 的断点续传 API，方便脚本直接把 ToDesk 当“高容错通道”嵌入 CI/CD。保持更新，你会第一时间收到这些能力。