rsync断点续传需显式启用--partial并配合--partial-dir指定临时目录，传输中断后可基于已有内容续传；推荐--append-verify校验已传部分，避免数据不一致。
rsync 本身不依赖 scp，但很多人误以为 rsync 是基于 scp 的传输方式。实际上，rsync 默认使用自己的协议（通过 rsh 或 ssh 作为传输通道），而 --partial-dir 是 rsync 专为断点续传设计的核心选项之一——它能安全保存传输中未完成的临时文件，避免重复传输已传部分。
理解 --partial-dir 的作用机制
--partial-dir 指定一个临时目录，rsync 在传输大文件时，会先把未完成的部分写入该目录下的同名文件中；传输成功后，再原子性地将该文件移入目标位置。如果中断，下次运行时 rsync 能识别该临时文件，并基于其已有内容继续上传（需配合 --partial 和 --append 或 --append-verify）。
- 必须显式启用
--partial（否则中断时临时文件会被删除） - 对大文件续传，推荐用
--append-verify（校验已传部分，更安全）而非仅--append - 临时目录路径建议用绝对路径，且确保有写权限；rsync 不会自动创建父目录
典型断点续传命令示例
假设通过 SSH 向远程服务器传输大文件，希望支持中断恢复：
rsync -av --partial --partial-dir=/tmp/rsync-partial \ --append-verify \ /local/bigfile.dat user@host:/remote/
-
/tmp/rsync-partial是本地临时目录（若同步到远程，该目录也需在远程存在且可写） - 若同步方向是远程→本地，
--partial-dir指的是本地路径；若本地→远程，则指远程路径 - 首次运行后中断，再次执行相同命令即可续传，无需额外参数
注意事项与常见问题
rsync 的断点续传不是“自动感知上次中断位置”，而是依赖文件大小、修改时间、校验和等综合判断。以下情况会影响续传效果：
- 源文件在传输中断后被修改：rsync 可能重传整个文件（除非加
--ignore-times强制跳过时间检查） - 未指定
--partial-dir但用了--partial：临时文件直接放在目标目录，文件名带 .~tmp~ 后缀，易混淆且不安全 - 远程端磁盘满或权限不足：可能导致
--partial-dir创建失败，rsync 报错退出，需提前检查 - 不要混用
--compress和断点续传：压缩会改变数据流，导致--append-verify失效
替代方案：用 --inplace + --partial 更轻量？
如果不想管理独立临时目录，可用 --inplace --partial 直接在目标位置更新文件（适合单文件、空间受限场景）：
rsync -av --partial --inplace --append-verify /local/file user@host:/remote/
- 优点：无需额外目录，适合嵌入式或权限受限环境
- 风险：传输中目标文件始终存在且内容不完整，可能被其他进程误读
- 不适用于硬链接、ACL、xattr 等元数据敏感场景（
--inplace会绕过部分安全检查）
