讲师中心 微信公众号
AI工具推荐 视频效率加速

scp 传输中断后如何用 rsync --partial-dir 实现续传

夜涛君_2923

夜涛君_2923

发布时间:2026-01-26 20:05:02

|

733人浏览过

|

来源于php中文网

原创

rsync 支持断点续传,需同时使用 --partial 和 --partial-dir(如 .rsync-partial/),并注意源文件未修改、权限及路径配置;仅 --partial-dir 无效。

scp 传输中断后如何用 rsync --partial-dir 实现续传

scp 中断后不能直接续传,必须换 rsync

scp 本身不支持断点续传,传输中断就只能重来。rsync 的 --partial 和 --partial-dir 才是真正解决这个问题的组合。但注意:--partial-dir 不是“自动续传开关”,它只是把未完成的临时文件存到指定目录,避免污染目标路径——真正起续传作用的是 --partial + --append(大文件)或默认的增量比对逻辑。

rsync --partial-dir 的正确用法和必要参数

只加 --partial-dir 不够,常见错误是漏掉 --partial 或忽略权限/时间戳干扰。实际命令要这样组织:

rsync -av --partial --partial-dir=.rsync-partial/ \
  --rsh="ssh -p 2222" \
  /local/file.zip user@host:/remote/path/
  • --partial:保留传输中断时的不完整文件(否则 rsync 默认删掉)
  • --partial-dir=.rsync-partial/:把所有未完成的临时文件放进这个子目录,不影响目标目录的干净性
  • -a 保持属性,但若源文件被修改过,可能触发全量重传;如只关心内容一致,可改用 -r --checksum
  • --rsh 显式指定 ssh 参数(比如非标端口),否则容易因连接配置缺失导致失败

中断后重试时 rsync 怎么识别并续传

rsync 不会“扫描 .rsync-partial/ 然后接上”,它的续传逻辑依赖两点:源文件没变 + 目标端已有同名不完整文件。所以:

  • 如果目标路径下已存在 file.zip(完整),rsync 会跳过 —— 它不校验是否真和源一致,只看大小和修改时间
  • 如果中断后目标端只有 .rsync-partial/file.zip.12345(临时名),rsync 会把它重命名为 file.zip 并继续写入(前提是加了 --partial)
  • 若源文件在中断后被修改过,rsync 会当作新文件处理,丢弃旧临时文件,从头传 —— 这是设计使然,不是 bug
  • 对超大单文件,可加 --append 强制追加模式(要求文件末尾没变化),比默认行为更可靠

容易被忽略的权限与路径陷阱

--partial-dir 路径是相对于目标目录的,且 rsync 必须有写入该目录的权限。常见翻车点:

  • 目标路径是 /var/www/,--partial-dir=.rsync-partial 实际创建在 /var/www/.rsync-partial/,如果 ssh 用户对 /var/www/ 只有写文件权限、没有建目录权限,就会报错 mkdir failed: Permission denied (13)
  • 使用绝对路径如 --partial-dir=/tmp/rsync-partial 可绕过,但需确保远程用户对那个路径有读写权,且注意磁盘空间归属
  • 如果目标是 root 目录,又没用 sudo 或对应权限,--partial-dir 创建失败会导致整个传输终止,不会退化为无目录模式
  • 某些老版本 rsync(--partial-dir,执行时报错 unrecognized option,得先查 rsync --version

真正麻烦的不是语法,而是中断后你得确认源文件没动、目标端临时文件还在、权限够写、rsync 版本支持——四个条件缺一不可。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

更多
append用法
append用法

append是一个常用的命令行工具,用于将一个文件的内容追加到另一个文件的末尾。想了解更多append用法相关内容,可以阅读本专题下面的文章。

578

2023.10.25

python中append的用法
python中append的用法

在Python中,append()是列表对象的一个方法,用于向列表末尾添加一个元素。想了解更多append的更多内容,可以阅读本专题下面的文章。

1476

2023.11.14

python中append的含义
python中append的含义

本专题整合了python中append的相关内容,阅读专题下面的文章了解更多详细内容。

2024

2025.09.12

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

20

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

20

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

20

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

20

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

20

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn