1. 项目概述：为什么选择 rsync 进行跨机文件夹同步
在多个设备间保持文件一致，是很多朋友都会遇到的场景。无论是把树莓派上拍的照片自动备份到主力电脑，还是在开发时让本地代码和服务器上的测试环境同步，核心需求就一个：高效、可靠、不折腾。我试过不少方案，从图形化的同步软件到各种云盘，最后发现，在命令行里一个叫rsync的工具，才是解决这类问题的“瑞士军刀”。它轻量、灵活，而且几乎无处不在——从 Linux、macOS 到通过 WSL 运行的 Windows，都能找到它的身影。
简单来说，rsync是一个远程（或本地）数据同步工具。它的核心价值在于“增量同步”和“快速传输”。不像简单的cp或scp命令每次都会复制所有文件，rsync会聪明地比较源文件夹和目标文件夹的差异，只传输那些被修改过或新增的文件。对于动辄几个G的照片库或者代码项目，这能节省大量的时间和网络带宽。更棒的是，它通过 SSH 进行加密传输，安全性和使用普通的 SSH 登录完全一样，你不需要额外配置复杂的服务。今天，我就以最典型的“从树莓派同步照片到个人电脑”为例，带你从头到尾走一遍配置流程，并分享一些我踩过坑才总结出来的实战技巧。
2. 核心原理与方案选型：rsync 为何是更优解
在动手之前，我们有必要花几分钟了解一下rsync的工作原理，这能帮助你在后面理解每条命令参数的意义，甚至在出问题时自己进行排查。
2.1 rsync 的增量同步算法
rsync的核心算法非常巧妙。它并非简单地比较文件修改时间，而是采用了一种“校验和对比”的方式。当你运行一条rsync命令时，它会执行以下步骤：
- 文件列表扫描：首先，
rsync会递归地扫描源目录和目标目录，生成两个文件列表。 - 快速检查：对于每个文件，它会先比较文件大小和最后修改时间。如果两者都完全一致，
rsync会认为文件没有变化，直接跳过。这是第一层优化。 - 校验和计算：如果快速检查无法确认（比如修改时间被意外更改了），
rsync会进入更精确的模式。它将文件分割成固定大小的数据块，并为源文件的每个数据块计算一个滚动校验和（一种高效的哈希值），然后将这些校验和列表发送给接收方。 - 差异比对与传输：接收方拿着这个校验和列表，与自己本地文件的对应数据块进行比对。它会告诉发送方：“我缺了第2、5、7块的数据，其他块我都有了。” 发送方于是只传输这些缺失或不同的数据块，而不是整个文件。
- 文件重组：接收方用传输过来的新数据块，替换掉旧文件中对应的部分，从而在本地重组出一个与源端一模一样的新文件。
这个过程就是“增量同步”的精髓。对于一个大文件，哪怕你只修改了几个字节，rsync也大概率只传输被修改的那个数据块，效率极高。
2.2 为什么不用其他工具？
你可能会问，图形化的同步软件或者云盘不香吗？这里我基于实际经验做个对比：
| 工具/方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 图形化同步软件 (如 FreeFileSync) | 操作直观，有可视化对比界面。 | 1. 通常需要两端都安装客户端。 2. 配置复杂任务（如定时、过滤）可能不够灵活。 3. 跨平台一致性有时不佳。 | 本地文件夹之间的定期手动同步。 |
| 云盘 (如 Dropbox, OneDrive) | 设置简单，有版本历史，多设备自动同步。 | 1. 依赖互联网，内网大文件同步慢。 2. 有存储空间限制和费用问题。 3. 数据隐私性存疑，同步规则不可定制。 | 个人文档、小型工作文件的跨互联网同步。 |
scp或sftp命令 | 简单直接，系统原生支持。 | 每次都是全量拷贝，无法识别差异，同步大量文件时效率极低。 | 一次性传输少量新文件。 |
rsync | 1.增量同步，效率极高。 2. 基于 SSH，安全且无需额外配置。 3. 功能强大（保留权限、软链接、排除文件等）。 4. 可通过 cron实现全自动定时同步。 | 需要学习命令行参数，有一定学习成本。 | 跨计算机的定期、自动、高效文件夹同步，尤其是开发环境、媒体备份、服务器文件分发。 |
注意：对于树莓派这类资源有限的设备，
rsync的轻量级（它只是一个命令行工具）和低开销（传输时CPU占用远低于一些图形化工具）是巨大优势。
所以，当你需要在两台都能运行命令行的计算机（比如你的个人电脑和树莓派）之间，建立一个可靠、高效、自动化的同步通道时，rsync几乎是目前最优的解决方案。
3. 环境准备与信息确认
在敲下第一条rsync命令前，我们需要把“原材料”准备好。这个过程就像出门前检查钥匙、手机、钱包一样，虽然琐碎，但能避免后续操作卡壳。
3.1 获取树莓派的连接信息
你需要明确以下四个信息，我习惯把它们记在一个临时文本文件里：
<pi_ip_address>：树莓派的本地 IP 地址这是你电脑在局域网内找到树莓派的“门牌号”。获取方法很简单，在树莓派的终端里输入hostname -I。你会看到类似192.168.1.100的输出，这就是它的 IP。请确保你的电脑和树莓派连接在同一个局域网（比如同一个Wi-Fi）下。<pi_username>：树莓派的登录用户名默认通常是pi。如果你创建过新用户，就用那个用户名。<pi_folder_name>：树莓派上需要被同步的源文件夹路径比如你的照片可能放在/home/pi/Pictures/，或者你项目的代码在/home/pi/my_project/。务必使用绝对路径。<pc_folder_name>：个人电脑上用于接收同步文件的目标文件夹路径你需要在电脑上预先想好一个位置，比如/Users/YourName/Backups/PiPhotos/（Mac/Linux）或C:\Users\YourName\PiBackup\（Windows，但需在WSL或Git Bash环境下使用）。这个文件夹可以不存在，rsync会创建它。
3.2 确保 SSH 免密登录（关键步骤）
这是实现自动化同步的基石。默认情况下，rsync通过 SSH 连接，每次都会提示你输入树莓派的密码。这对于手动操作还行，但对于想用定时任务自动运行来说是不可接受的。我们需要配置 SSH 密钥对，让电脑能“无密码”安全地登录树莓派。
在个人电脑上操作：
生成密钥对（如果已有
~/.ssh/id_rsa.pub可跳过）：ssh-keygen -t rsa -b 4096连续按回车，接受默认存储位置和不设置密码（为求自动化），即可生成私钥（
id_rsa）和公钥（id_rsa.pub）。将公钥上传到树莓派：
ssh-copy-id <pi_username>@<pi_ip_address>例如：
ssh-copy-id pi@192.168.1.100。这条命令会自动将你的公钥追加到树莓派对应用户的~/.ssh/authorized_keys文件中。测试免密登录：
ssh <pi_username>@<pi_ip_address>如果不需要输入密码就直接进入了树莓派的命令行，恭喜你，配置成功。如果失败，请检查树莓派的 SSH 服务是否开启（
sudo systemctl status ssh），以及.ssh目录和authorized_keys文件的权限（应为 700 和 600）。
实操心得：很多同步失败的问题都卡在 SSH 连接上。务必先单独用
ssh命令测试连通性和免密登录，确保这一步畅通无阻，再进行rsync操作。
4. 首次同步与命令参数深度解析
信息齐备，SSH 通道也已打通，现在可以执行第一次同步了。我们逐行拆解命令，让你明白每个参数的作用。
4.1 创建本地目标文件夹
虽然rsync的-a参数可以自动创建不存在的目录，但显式地先创建目标文件夹是个好习惯，可以避免因路径权限问题导致的同步失败。
mkdir -p /path/to/your/<pc_folder_name>-p参数确保如果路径中的父目录不存在，也会一并创建。
4.2 执行 rsync 同步命令
核心命令来了：
rsync -avz -e ssh <pi_username>@<pi_ip_address>:<pi_folder_name>/ <pc_folder_name>/让我们像拆解机器一样看看每个部分：
rsync：调用同步工具本身。-a(archive)：这是最重要的参数，代表“归档模式”。它是一个复合参数，相当于-rlptgoD，意思是：-r: 递归同步子目录。-l: 同步符号链接（软链接）本身。-p: 保留文件权限。-t: 保留文件修改时间。-g: 保留文件所属组。-o: 保留文件所有者。-D: 保留设备文件和特殊文件。 简单说，-a让你在同步后，目标文件夹里的文件和源文件夹在元数据上尽可能一模一样。
-v(verbose)：输出详细过程，让你看到正在同步哪些文件。首次同步时建议加上，便于观察进度和排查问题。-z(compress)：在传输过程中压缩数据。这对于通过互联网或较慢的网络同步文本、代码等可压缩率高的文件效果显著，能大幅提升速度。但对于已经高度压缩的文件（如.jpg, .mp4），效果不大，甚至可能因压缩计算而稍慢。在千兆局域网内同步照片、视频时，可以尝试不加-z对比一下速度。-e ssh：指定使用ssh作为远程 shell。这是默认选项，所以有时可以省略。但显式写出是好习惯，特别是如果你需要指定特殊SSH端口时（如-e 'ssh -p 2222'）。<pi_username>@<pi_ip_address>:<pi_folder_name>/：这是源地址。注意末尾的/斜杠，它有关键含义！- 有斜杠(
path/to/source/): 表示同步该目录下的内容。结果会是<dest>/file1, <dest>/file2。 - 无斜杠(
path/to/source): 表示同步该目录本身。结果会是<dest>/source/file1, <dest>/source/file2。 根据你想在目标端得到怎样的目录结构，决定是否加这个斜杠。例子中加斜杠，意味着直接把源文件夹里的文件同步到目标文件夹根目录。
- 有斜杠(
<pc_folder_name>/：这是目标地址。
执行示例： 假设树莓派IP是192.168.1.100，用户名pi，照片在/home/pi/Pictures/，我想同步到电脑的~/PiBackup/。
rsync -avz -e ssh pi@192.168.1.100:/home/pi/Pictures/ ~/PiBackup/敲下回车，你会看到文件列表开始滚动，第一次同步完成。
4.3 验证首次同步结果
同步完成后，别急着关掉终端。做两件事：
- 快速浏览目标文件夹：用
ls -la ~/PiBackup/看看文件数量和大致内容是否相符。 - 使用
rsync的“模拟运行”模式：这是rsync一个极其有用的安全特性。
注意多出的rsync -avzn --delete pi@192.168.1.100:/home/pi/Pictures/ ~/PiBackup/-n(dry-run) 参数。它会模拟同步过程，告诉你将会发生什么变化，但绝不真正执行任何文件操作。如果输出显示“sending incremental file list”下面没有任何文件列表，那就说明两边已经完全一致，首次同步成功。
5. 进阶配置与自动化实战
一次成功的手动同步只是开始。我们的目标是建立一个“静默的守护者”，让它能自动、可靠地工作。下面进入进阶环节。
5.1 使用--exclude过滤不需要的文件
你肯定不想同步临时文件、缓存或者某些特定类型的文件。rsync的--exclude参数就是为此而生。
rsync -avz -e ssh \ --exclude='*.tmp' \ --exclude='.DS_Store' \ --exclude='Thumbs.db' \ --exclude='.git/' \ pi@192.168.1.100:/home/pi/Pictures/ ~/PiBackup/- 你可以使用通配符
*。 - 要排除整个目录，需要在模式后加
/，如.git/。 - 如果排除规则很多，可以写在一个文件里，比如
exclude-list.txt，然后使用--exclude-from='exclude-list.txt'。
5.2 启用--delete确保严格同步（谨慎！）
默认情况下，rsync只做“增量添加”，如果源端删除了一个文件，目标端不会自动删除。这有时是保护机制，但如果你希望两端完全一致（镜像），就需要--delete参数。
rsync -avz -e ssh --delete pi@192.168.1.100:/home/pi/Pictures/ ~/PiBackup/警告：使用--delete前，务必先用-n(dry-run) 参数模拟运行，确认删除列表是你预期的。误操作可能导致目标端重要数据被删。
5.3 通过cron实现定时自动同步
这是实现完全自动化的最后一步。我们将上面的rsync命令写成一个脚本，然后让系统的定时任务工具cron来定期执行它。
创建同步脚本： 在电脑上找个合适位置，比如
~/scripts/sync_pi_photos.sh，用文本编辑器创建：#!/bin/bash # 同步树莓派照片脚本 # 定义变量，方便修改 PI_USER="pi" PI_IP="192.168.1.100" SOURCE_DIR="/home/pi/Pictures/" DEST_DIR="$HOME/PiBackup/" LOG_FILE="$HOME/rsync.log" # 执行同步，并记录日志 echo "===== 同步开始 @ $(date) =====" >> "$LOG_FILE" rsync -avz -e ssh --delete "$PI_USER@$PI_IP:$SOURCE_DIR" "$DEST_DIR" >> "$LOG_FILE" 2>&1 echo "===== 同步结束 @ $(date) =====" >> "$LOG_FILE" echo "" >> "$LOG_FILE"给脚本添加执行权限：
chmod +x ~/scripts/sync_pi_photos.sh手动测试脚本：
~/scripts/sync_pi_photos.sh然后查看日志文件
cat ~/rsync.log，确认运行正常。配置 cron 定时任务： 打开当前用户的 cron 配置：
crontab -e。 在末尾添加一行，例如，规定每天凌晨3点同步一次：0 3 * * * /home/yourusername/scripts/sync_pi_photos.shcron 时间格式是“分 时 日 月 周 命令”。
0 3 * * *表示每天3:00 AM。 保存并退出。cron 会立即生效。
实操心得：定时任务不执行？90%的问题出在环境变量上。在脚本中，对所有命令使用绝对路径（如
/usr/bin/rsync），或者脚本开头显式设置PATH变量（如PATH=/usr/local/bin:/usr/bin:/bin）。另外，将输出重定向到日志文件（如上面脚本中的>> "$LOG_FILE" 2>&1）对于后期排查至关重要。
6. 常见问题排查与性能优化技巧
即使按照步骤操作，你也可能会遇到一些问题。这里我整理了一份“急救手册”，涵盖了最常见的情况。
6.1 连接与权限问题
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
ssh: connect to host 192.168.1.100 port 22: Connection refused | 1. 树莓派IP地址变了。 2. 树莓派SSH服务未开启。 3. 防火墙阻止了22端口。 | 1. 在树莓派上重新用hostname -I查IP。2. 在树莓派上运行 sudo systemctl start ssh并sudo systemctl enable ssh。3. 检查路由器或电脑防火墙设置。 |
Permission denied (publickey,password). | SSH免密登录配置失败。 | 1. 确认执行了ssh-copy-id。2. 检查树莓派 ~/.ssh/authorized_keys文件权限是否为600，上级目录.ssh权限是否为700。3. 暂时用 ssh -v pi@IP查看详细连接过程找线索。 |
rsync: [receiver] mkdir failed: Permission denied (13) | 目标文件夹没有写入权限。 | 1. 检查目标文件夹权限：ls -ld ~/PiBackup。2. 尝试用 sudo创建文件夹或更改其所有者：sudo chown -R $USER:$USER ~/PiBackup。 |
6.2 同步内容相关问题
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 同步后，目标端多了源端没有的文件夹。 | 可能之前同步时源端目录名后没加/，导致创建了同名目录。或者使用了不正确的相对路径。 | 1. 检查命令中源路径末尾是否有/。2. 使用 -n模拟运行，观察同步路径。3. 清理目标端，使用正确的命令重新同步。 |
| 部分文件始终被重复同步。 | 1. 文件时间戳被意外更改。 2. 文件权限不同，而 rsync被配置为保持权限。 | 1. 使用rsync -c（基于校验和）而不是默认的快速检查，但这会慢很多。2. 检查并统一文件权限。 |
| 同步速度非常慢。 | 1. 网络问题。 2. 同步了大量小文件（元数据开销大）。 3. 对已压缩文件使用了 -z。 | 1. 测试网络带宽。 2. 考虑将小文件打包（如.tar）再同步。 3. 对图片/视频同步，尝试去掉 -z参数。 |
6.3 高级技巧与性能调优
使用
--partial和--progress：--partial：保留部分传输的文件。如果网络中断，下次同步时会从断点续传，而不是重新开始整个文件。--progress：显示每个文件的传输进度百分比。对于大文件同步时，能让你心里有底。
rsync -avzP -e ssh source/ dest/ # `-P` 是 `--partial --progress` 的简写限制带宽占用： 如果你不希望
rsync占满所有带宽，影响其他网络活动，可以使用--bwlimit。rsync -avz --bwlimit=1000 -e ssh source/ dest/ # 限制速度约为 1000 KB/s同步大量文件时优化： 同步数十万个文件时，扫描阶段可能很慢。可以尝试：
- 使用
--no-detach运行rsync守护进程模式（适用于固定服务器间同步）。 - 考虑使用
rsync的--fuzzy参数进行更智能的模糊匹配（适用于文件有重命名的情况）。
- 使用
编写更健壮的脚本： 在生产环境中，脚本应该包含错误处理。
#!/bin/bash ... # 变量定义 MAX_RETRIES=3 RETRY_COUNT=0 while [ $RETRY_COUNT -lt $MAX_RETRIES ]; do rsync -avz -e ssh --delete "$SOURCE" "$DEST" if [ $? -eq 0 ]; then echo "同步成功 @ $(date)" >> "$LOG_FILE" break else ((RETRY_COUNT++)) echo "同步失败，第 $RETRY_COUNT 次重试 @ $(date)" >> "$LOG_FILE" sleep 60 fi done if [ $RETRY_COUNT -eq $MAX_RETRIES ]; then echo "错误：同步失败，已达最大重试次数。" >> "$LOG_FILE" # 可以在这里添加发送邮件或系统通知的代码 fi
7. 扩展应用场景与思路
掌握了树莓派到电脑的同步，rsync的舞台远不止于此。它的模式是通用的，你可以举一反三，应用到各种场景：
- 反向同步（电脑 -> 树莓派）：只需调换源和目标的位置。例如，将你电脑上的开发代码推送到树莓派进行测试：
rsync -avz ~/projects/my_app/ pi@192.168.1.100:~/test_deploy/。 - 本地备份：
rsync同样适用于本地磁盘或移动硬盘的备份。rsync -a --delete /important/data/ /Volumes/BackupDisk/backup/。结合cron，就是一套简单的本地定时备份方案。 - 多服务器间同步：如果你管理多台服务器，可以用一台作为“同步中心”，通过
rsync分发配置文件或代码更新。 - 与
inotifywait结合实现实时同步：cron是定时轮询，而inotifywait可以监听文件系统事件（如创建、修改、删除）。两者结合，可以实现“文件一变，立即同步”的准实时效果。不过这套方案配置更复杂，适合有进阶需求的场景。
我个人在多年使用中最大的体会是，rsync的可靠性来自于它的“简单”和“专注”。它不依赖复杂的客户端-服务器架构，不引入额外的数据库，就是基于 SSH 和文件系统的差异计算。这种设计使得它极其稳定，一旦配置好，就可以数年如一日地默默工作。最后一个小技巧是，对于非常重要的同步任务，在正式加入cron前，不妨先让脚本以较短的间隔（比如每小时一次）跑上一两天，观察日志，确认其行为完全符合预期，再调整为最终的定时周期。这能帮你避免一些因配置疏忽导致的意外数据覆盖或删除。