Windows Hexo 使用 Rsync 发布踩坑指南

问题与解决方案

在使用 Hexo 生成静态博客并发布到远程服务器时，rsync 是一个非常高效的工具。然而，在 Windows 环境下使用 rsync 可能会遇到一些问题。

错误：'rsync' �����ڲ����ⲿ���Ҳ���ǿ����еij���

这个错误通常是因为系统找不到 rsync 可执行文件。解决方法如下：

1. 检查环境变量
   确保 rsync 的路径已经添加到系统的 PATH 环境变量中。

2. 使用绝对路径
   如果你使用的是 cwRsync，可以在 Hexo 的 _config.yml 中使用绝对路径来指定 rsync 的位置。例如：

   1 2 3 4 5 6 7 8 9

   deploy: type: rsync rsync: "C:/Program Files/cwRsync/bin/rsync.exe" host: your.server.com user: your_username root: /path/to/your/blog port: 22 delete: true verbose: true

1. 安装 Rsync

在 Windows 上，rsync 并不是原生支持的，因此我们需要借助第三方工具来实现。使用 cwRsync。

使用 cwRsync

1. 下载 cwRsync
   访问 cwRsync 官网，下载并安装适合你系统的版本。

2. 配置环境变量
   安装完成后，将 cwRsync 的安装路径（例如 C:\Program Files\cwRsync\bin）添加到系统的环境变量 PATH 中。

3. 验证安装
   打开命令提示符（CMD），输入 rsync --version，如果能看到版本信息，说明安装成功。

2. 配置 Hexo 使用 Rsync

在 Hexo 的配置文件 _config.yml 中，找到 deploy 部分，添加或修改如下配置：

1
2
3
4
5
6
7
8

deploy:
  type: rsync
  host: your.server.com
  user: your_username
  root: /path/to/your/blog
  port: 22
  delete: true
  verbose: true

• host: 你的服务器地址。
• user: 登录服务器的用户名。
• root: 服务器上存放博客的路径。
• port: SSH 端口，默认为 22。
• delete: 是否删除服务器上多余的文件，建议设置为 true。
• verbose: 是否显示详细日志，建议设置为 true 以便调试。

4. 测试发布

完成配置后，运行以下命令来发布你的博客：

1

hexo clean && hexo deploy --generate

如果一切顺利，你应该能够看到 rsync 开始同步文件，并且博客成功发布到远程服务器。

如果你还有其他问题，欢迎在评论区留言讨论