rsync
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 | deploy: |
执行 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 | rsync: connection unexpectedly closed (0 bytes received so far) |
本地和远端 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 | $env:Path = "$PSScriptRoot\bin;$env:Path" |
这样,终端和其他程序仍可使用 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 | Host 152.53.166.31 |
若代理入口是 SOCKS5,则将 --proxy-type http 改为 --proxy-type socks5。配置后宜先用 ssh -v -p 3377 root@152.53.166.31 查看连接过程,再执行 rsync dry-run。
note: >代理只可能改善本地到服务器之间的路由、丢包或连接稳定性,不能提升服务器自身的出口带宽。代理会看到目标地址、连接时间和流量大小,但 SSH 内的认证与文件内容仍为端到端加密。
排查顺序
- 使用
where.exe rsync和where.exe ssh确认实际命令来源。 - 单独运行
ssh -p <port> user@host,确认认证、主机指纹和.ssh权限正常。 - 使用
rsync -n预演,确认源目录、目标目录和删除列表。 - 若 SSH 正常而 rsync 立即断开,检查 rsync 是否调用了同一 cwRsync 包中的 SSH。
- 检查远端是否安装 rsync、目标目录是否存在,以及登录用户是否有写入和删除权限。
- 网络不稳定时增加 SSH keepalive;确认是路由问题后再考虑代理。






