rsync 是用于本地或远程文件同步的开源工具。它会比较源端和目标端,只传输有变化的数据;通过 SSH 连接时,认证和传输内容由 SSH 加密。

常用命令

1
rsync -avz -e 'ssh -p 3377' --delete public/ root@152.53.166.31:/var/www/hexo/
  • -a:归档模式,递归同步并尽量保留文件属性。
  • -v:显示详细过程。
  • -z:传输时压缩数据。
  • -e:指定远程 shell,此处为使用 3377 端口的 SSH。
  • --delete:删除目标端存在、源端不存在的文件,使两端保持镜像一致。
  • 源目录末尾的 / 表示同步目录中的内容,而不是再创建一层 public 目录。

warning: 先预演删除
使用 --delete 前宜增加 -n 或 --dry-run。预演会列出待上传和待删除的文件,但不会修改远端。

1
rsync -avzn -e 'ssh -p 3377' --delete public/ root@152.53.166.31:/var/www/hexo/

Hexo 部署

安装 hexo-deployer-rsync 后,可在 Hexo _config.yml 的多部署器列表中加入:

1
2
3
4
5
6
7
8
9
deploy:
- type: rsync
host: 152.53.166.31
user: root
root: /var/www/hexo/
port: 3377
delete: true
verbose: true
ignore_errors: false

执行 hexo deploy 时,Hexo 会按照配置中的顺序运行全部部署器,而不只是 rsync。可先运行 hexo clean 和 hexo generate,确保 public/ 是本次生成的完整站点。

Windows 与 cwRsync

cwRsync 是 rsync、Cygwin 运行库和 OpenSSH 的 Windows 打包。应从 Itefix cwRsync 下载,并核对官网给出的 SHA-256;发布包中的可执行文件还带有 Itefix 数字签名。

cwRsync 的 rsync.exe 应与同一发行包中的 ssh.exe 配套使用。若它调用了 Windows 自带的 C:\Windows\System32\OpenSSH\ssh.exe,可能在 SSH 已连接后出现:

1
2
rsync: connection unexpectedly closed (0 bytes received so far)
rsync error: error in rsync protocol data stream (code 12)

本地和远端 rsync 的小版本不同通常不是该错误的原因。例如本地 3.4.1 与远端 3.2.7 可以协商并正常同步。

Scoop 包装脚本

只用 env_add_path 将 cwRsync 的 bin 加入用户 PATH,不能保证它排在系统级 OpenSSH 前面;已经启动的终端也不会自动读取后续写入的持久化 PATH。

更稳妥的做法是在 Scoop manifest 的安装阶段创建一个 rsync 包装脚本。每次调用 rsync 时,脚本只在该子进程中将 cwRsync 的 bin 临时放到 PATH 最前,然后启动真正的 rsync.exe:

1
2
3
$env:Path = "$PSScriptRoot\bin;$env:Path"
& "$PSScriptRoot\bin\rsync.exe" @args
exit $LASTEXITCODE

这样,终端和其他程序仍可使用 Windows OpenSSH,而手动调用 rsync 或执行 hexo deploy 时会稳定使用 cwRsync 自带的 SSH。相关 manifest 写法见 Scoop 软件仓库 自建 Scoop 软件仓库。

SSH 文件权限

Cygwin OpenSSH 会检查 .ssh/config 和私钥的所有者与 ACL。配置文件归 BUILTIN\Administrators 所有、启用继承或允许其他主体写入时,可能出现:

1
Bad owner or permissions on /cygdrive/c/Users/Administrator/.ssh/config

处理时应将文件所有者设置为当前用户,授予当前用户所需权限,并移除不必要的继承权限。具体命令见 ACL 文件所有者与 ACL。

首次连接新的 主机:端口 组合时,SSH 会要求确认主机指纹。确认前应与服务器端记录核对;接受后,指纹会写入 known_hosts。主机密钥发生变化时不应直接忽略警告,应先排除服务器重装、地址复用或中间人攻击。

代理

当前写法属于 rsync over SSH,代理需要配置在 SSH 层。RSYNC_PROXY 只适用于 rsync://host/module 或 host::module 的 rsync daemon 连接。

本地 HTTP 代理可借助 Ncat 配置:

1
2
3
4
Host 152.53.166.31
ProxyCommand ncat.exe --proxy 127.0.0.1:7890 --proxy-type http %h %p
ServerAliveInterval 30
ServerAliveCountMax 6

若代理入口是 SOCKS5,则将 --proxy-type http 改为 --proxy-type socks5。配置后宜先用 ssh -v -p 3377 root@152.53.166.31 查看连接过程,再执行 rsync dry-run。

note: >代理只可能改善本地到服务器之间的路由、丢包或连接稳定性,不能提升服务器自身的出口带宽。代理会看到目标地址、连接时间和流量大小,但 SSH 内的认证与文件内容仍为端到端加密。

排查顺序

  1. 使用 where.exe rsync 和 where.exe ssh 确认实际命令来源。
  2. 单独运行 ssh -p <port> user@host,确认认证、主机指纹和 .ssh 权限正常。
  3. 使用 rsync -n 预演,确认源目录、目标目录和删除列表。
  4. 若 SSH 正常而 rsync 立即断开,检查 rsync 是否调用了同一 cwRsync 包中的 SSH。
  5. 检查远端是否安装 rsync、目标目录是否存在,以及登录用户是否有写入和删除权限。
  6. 网络不稳定时增加 SSH keepalive;确认是路由问题后再考虑代理。