rsync 基础教程

331

uvim管理员
2026-08-20
你好！我是你的资深软件工程师。很高兴能为你讲解 rsync。
在日常开发和运维中，rsync（Remote Sync） 是我个人最喜欢的工具之一。它不仅仅是一个简单的文件复制命令，更是一个高效的增量备份和文件传输利器。
下面我将从核心概念、常用场景、基础语法、实战演练以及高级技巧五个方面，为你带来一份实用的 rsync 基础教程。
一、什么是 rsync？它的核心优势是什么？
rsync 是一个开源的、快速的、多功能的命令行工具，用于在本地和远程机之间同步文件和目录。
为什么不用 cp 或 scp？
* 增量传输（Delta Transfer Algorithm）： 这是 rsync 的灵魂。它不会每次都复制所有文件，而是只同步发生改变的文件，甚至是文件的修改部分。这极大地节省了带宽和时间。
* 保持属性： 它可以完美保持文件的权限、时间戳、软硬链接、属主和属组等。
* 压缩传输： 在传输过程中可以进行实时压缩，适合弱网环境。
二、基础语法结构
rsync 的语法非常灵活，既可以在本地使用，也可以通过 SSH 在远程使用。
```
# 本地模式
rsync [选项] 源路径 目标路径

# 远程模式（通过 SSH）
rsync [选项] 源路径 用户名@远程IP:目标路径
```
💡 核心选项（Options）速查表：
- -v (verbose)：显示详细的传输信息。
- -r (recursive)：递归处理，复制目录及子目录。
- -a (archive)：归档模式，包含 -r、 -l（保留软链接）、-p（保留权限）、-t（保留时间戳）、-g（保留组）、-o（保留属主）、-D（保留设备文件）。在实际开发中，备份几乎总是用这个参数。
- -z (compress)：传输时进行压缩。
- -P (progress + partial)：显示进度条，并支持断点续传。
- --delete：危险但强大！删除目标路径中源路径没有的文件（保持两边完全一致）。
- -e ssh：指定使用 SSH 协议传输（默认通常也是）。
三、实战演练：常见开发场景
场景 1：本地目录备份
将本地的 /data/project 备份到 /backup/project，并保持原有属性。
```
rsync -avz /data/project /backup/project
```
*注意：如果源路径以 / 结尾（如 /data/project/），表示复制目录里面的内容；如果不以 / 结尾（如 /data/project），则表示将目录本身复制过去。*
场景 2：上传代码到远程服务器（替代 SCP）
将本地代码同步到远程测试服务器的 /var/www/html 目录下。
```
rsync -avz -e ssh /path/to/local/code/ [email protected]:/var/www/html/
```
场景 3：从远程服务器下载日志
将生产环境的日志下载到本地分析。
```
rsync -avzP [email protected]:/var/log/app.log ~/downloads/
```
(这里用了 -P 参数，可以看到下载进度，网络中断时还可以续传)
四、进阶技巧：过滤与排除（Excluding）
在实际项目中，我们经常需要排除一些不需要同步的文件（比如 node_modules、.git、日志文件等）。
使用 --exclude 参数：
```
rsync -avz --exclude 'node_modules' --exclude '.git' --exclude '*.log' /project/ user@remote:/project/
```
如果需要排除的内容很多，可以写到一个排除文件里（exclude-list.txt）：
```
node_modules
.git
*.log
build/
```
然后使用 --exclude-from 调用：
```
rsync -avz --exclude-from='exclude-list.txt' /project/ user@remote:/project/
```
五、工程师视角：rsync 的底层逻辑（增量同步原理）
作为一个软件工程师，了解它的工作原理有助于我们更好地使用它：
1. rsync 在传输前，不会简单地对比文件大小和修改时间（虽然默认也对比）。
2. 它会将大文件切分成若干个小块（Block），并对每个块计算 MD5 校验和 以及一个弱校验和。
3. 客户端将这些校验和发送给服务端。
4. 服务端用自己的文件块与这些校验和进行比对，找出哪些块变了，然后只把变了的块发送给客户端。
5. 客户端将收到的新块组装到原文件中。
正因为这个算法，即使一个 10GB 的大文件只修改了 1KB，rsync 也可能只需要传输几 KB 的网络流量。
总结
rsync 是运维和开发工具箱中的瑞士军刀。对于新手，建议先记住这套“黄金组合拳”：
```
rsync -avzP [源] [目标]
```
在熟悉了基础操作后，配合 --delete 和 --exclude 可以实现非常强大的自动化备份脚本。
你在实际工作中遇到了什么关于 rsync 的具体场景或报错吗？我们可以一起探讨。
uvim管理员
#1
2026-08-20
作为一名资深软件工程师，在实际生产环境中，我们用 rsync 绝不仅仅是敲一行简单的命令。我们需要考虑安全性（免密/防火墙）、性能（大文件/多线程）、自动化（脚本/定时任务）以及灾难恢复（防误删）。
下面我为你整理一份 Rsync 生产环境进阶教程，涵盖高级参数、性能调优、安全配置和常见避坑指南。
一、核心进阶参数（提升效率与安全性）
除了大家熟知的 -avz，这些高级参数在特定场景下能救命：
1. --delete（镜像同步/强力删除）
* 作用： 保持目标目录和源目录绝对一致。如果源目录删除了某个文件，目标目录的对应文件也会被删除。
* 场景： 网站发布、CDN分发。
* ⚠️ 警告： 慎用！如果源路径写错了（比如写成空目录），加上 --delete 会把目标服务器清空！
2. -H (保持硬链接) / -A (保持 ACL 权限) / -X (保持扩展属性)
* 场景： 迁移整台服务器或备份复杂系统文件时使用，确保 Linux 文件的特殊属性不丢失。
3. --bwlimit=KB/s (限速)
* 作用： 限制带宽占用，防止把网络跑满影响线上业务。
* 示例： --bwlimit=1024（限制最大速度为 1MB/s）。
4. --exclude 与 --include (排除与包含)
* 作用： 排除不需要同步的临时文件（如日志、缓存、Git 目录）。
* 示例：
```
     rsync -avz --exclude '*.log' --exclude 'node_modules/' /src/ user@dest:/dest/
```
5. --partial 与 --append-verify (断点续传)
* 作用： 传输大文件时，如果网络中断，下次传输可以接着上次的传，而不是从头开始。
二、生产环境实战：全量与增量备份脚本
在真实项目中，我们通常会写成 Shell 脚本配合 crontab 定时执行。
生产级 Shell 脚本示例 (sync_backup.sh)
```
#!/bin/bash

# 配置变量
SRC="/data/webapp/"
DEST_USER="deploy"
DEST_HOST="192.168.1.200"
DEST_PATH="/data/backup/webapp/"
LOG_FILE="/var/log/rsync_backup.log"

# 记录开始时间
echo "=== 备份开始: $(date '+%Y-%m-%d %H:%M:%S') ===" >> "$LOG_FILE"

# 执行 rsync
# 使用 -e 指定 SSH 端口（假设是 22），--delete 实现完全镜像
rsync -avz --delete \
  -e "ssh -p 22 -o StrictHostKeyChecking=no" \
  --exclude "logs/" \
  --exclude "*.tmp" \
  "$SRC" "$DEST_USER@$DEST_HOST:$DEST_PATH" >> "$LOG_FILE" 2>&1

# 检查执行结果
if [ $? -eq 0 ]; then
    echo "=== 备份成功: $(date '+%Y-%m-%d %H:%M:%S') ===" >> "$LOG_FILE"
else
    echo "=== ⚠️ 备份失败: $(date '+%Y-%m-%d %H:%M:%S') ===" >> "$LOG_FILE"
fi
```
三、进阶网络拓扑：通过堡垒机/跳板机同步
在企业内网中，目标服务器往往不能直接连接，必须通过跳板机（Bastion/Jump Host）。Rsync 支持通过 SSH 代理传输。
利用 SSH 的 ProxyJump (-J) 参数，可以一行命令搞定：
```
rsync -avz -e "ssh -J user@jump_host:22 user@target_host:22" /local/path/ user@target_host:/remote/path/
```
(逻辑：先连跳板机，再由跳板机转发到目标服务器，rsync 在这个透明的通道里传输数据。)
四、性能调优：如何用 rsync 传输海量小文件？
Rsync 最大的痛点之一：当有几百万个小文件（几 KB 大小）时，rsync 在传输前的“file list building”（文件列表构建）阶段会非常慢，甚至卡死、吃满 CPU。
解决方案：
1. 分批/分目录同步： 不要一次性同步整个根目录，拆分成子目录并行同步。
2. 结合 tar 管道传输（极致性能）：
如果文件真的多到爆，有时候绕过 rsync 的文件比对，用 tar 压缩后通过 SSH 管道流过去，速度反而更快：
```
   tar czf - /source_dir | ssh user@dest "tar xzf - -C /target_dir"
```
(注：这种方式失去了 rsync 的增量对比能力，每次是全量流式传输，但省去了昂贵的元数据比对时间。)
五、安全加固：Rsync Daemon 模式（非 SSH 方式）
除了基于 SSH 传输，Rsync 还支持以独立服务（Daemon 模式）运行在 873 端口。
- 场景： 不需要 Linux 系统账号，通过专属的 rsync 虚拟用户进行权限控制。
- 配置步骤简述：
1. 在目标服务器配置 /etc/rsyncd.conf。
2. 启动守护进程：rsync --daemon。
3. 客户端直接通过 rsync 协议连接：
```
     rsync -avz /src/ rsync://username@dest_host/module_name/
```
* 注意： 现代企业为了安全，通常直接封禁 873 端口，全面转向更安全的 SSH 隧道传输。
六、资深工程师的“避坑指南”
1. 斜杠 / 的血泪教训：
* rsync -avz /data/foo /dest/ -> 会在目标目录创建 foo 目录（结果：/dest/foo）。
* rsync -avz /data/foo/ /dest/ -> 会把 foo 目录下的内容直接倒进目标目录（结果：/dest/文件...）。
* 建议： 动手前先加 -n 或 --dry-run（演练模式），它只打印会做什么，不真正执行，能帮你救命。
```
     rsync -avun /src/ /dest/
```
2. 权限问题 (Permission Denied)：
* 如果源文件属于 root，而你用普通用户去拉取，会报错。
* 需要在 SSH 侧配置 sudo 免密，或者确保同步账号对目标路径有完全的 w/r/x 权限。
掌握了这些，你不仅能用 rsync 搬运文件，还能在生产环境中设计出高可用、高安全的自动化同步架构。如果在实际落地中遇到具体的报错，随时发出来我们一起 debug！

发表回复

登录后回复

rsync 基础教程

一、 什么是 rsync？它的核心优势是什么？

二、 基础语法结构

💡 核心选项（Options）速查表：

三、 实战演练：常见开发场景

场景 1：本地目录备份

场景 2：上传代码到远程服务器（替代 SCP）

场景 3：从远程服务器下载日志

四、 进阶技巧：过滤与排除（Excluding）

五、 工程师视角：rsync 的底层逻辑（增量同步原理）

总结

一、 核心进阶参数（提升效率与安全性）

二、 生产环境实战：全量与增量备份脚本

生产级 Shell 脚本示例 (sync_backup.sh)

三、 进阶网络拓扑：通过堡垒机/跳板机同步

四、 性能调优：如何用 rsync 传输海量小文件？

五、 安全加固：Rsync Daemon 模式（非 SSH 方式）

六、 资深工程师的“避坑指南”

发表回复

一、什么是 rsync？它的核心优势是什么？

二、基础语法结构

三、实战演练：常见开发场景

四、进阶技巧：过滤与排除（Excluding）

五、工程师视角：rsync 的底层逻辑（增量同步原理）

一、核心进阶参数（提升效率与安全性）

二、生产环境实战：全量与增量备份脚本

生产级 Shell 脚本示例 (`sync_backup.sh`)

三、进阶网络拓扑：通过堡垒机/跳板机同步

四、性能调优：如何用 rsync 传输海量小文件？

五、安全加固：Rsync Daemon 模式（非 SSH 方式）

六、资深工程师的“避坑指南”