rsync

名称、版本与用途

  • 名称:rsync
  • 当前版本:3.2.7
  • 路径:/usr/bin/rsync
  • 用途:本地或 SSH 远程增量同步文件,保留元数据并减少重复传输。

基本语法(Synopsis)

rsync [OPTION]... SRC... DEST

[] 表示可选项,... 表示可重复;大写名称表示需要替换的参数。

当前安装与更新

由 Ubuntu APT 管理:

sudo apt update
sudo apt install --only-upgrade rsync

基本功能与推荐用法

rsync -avh src/ dest/                    # 同步目录内容
rsync -avh --progress file host:/path/
rsync -avh --exclude '.git/' src/ dest/
rsync -avhn src/ dest/                   # dry-run
rsync -avh --itemize-changes src/ dest/
rsync -avh --partial --append-verify big.iso host:/path/
rsync -a --delete --dry-run src/ dest/   # 先预览镜像删除

源路径末尾 / 很重要:

  • src/ 表示同步目录内容。
  • src 表示把目录本身放入目标。

--delete 会删除目标端多余文件。必须先加 --dry-run 并检查源、目标和末尾斜杠。

示例中的选项、参数与子命令

本表解释本页示例实际出现的选项、参数、子命令及必要的辅助命令语法。

语法元素含义
-a, --archive归档模式,递归并尽量保留元数据。
-v, --verbose显示详细过程。
-h, --human-readable使用可读的数字单位。
--progress显示每个文件的传输进度。
--exclude=PATTERN排除匹配的路径。
-n, --dry-run预演操作,不实际复制或删除。
--itemize-changes逐项显示将发生的变化。
--partial保留未完成的部分文件。
--append-verify续传时追加数据并校验完整文件。
--delete删除目标端源目录中不存在的文件。
SRC/ 与 SRC源目录末尾斜杠表示复制目录内容;无斜杠表示复制目录本身。
apt --only-upgrade只升级已安装的软件包。

官方资料