在搭建静态博客（如 Hexo、Hugo、Jekyll）后，我们常需要将本地生成的静态文件同步到 Linux 服务器的网站目录，实现博客在线访问。本文将详细讲解 Windows（cwRsync）+ Linux（rsync） 的完整同步方案，包括 rsync 安装配置、核心参数解析、两种认证方式（密码/SSH 密钥）配置、同步时 chown 所有者问题解决，以及常见故障排查，全程实操可复现，新手也能轻松上手。

一、环境说明与准备工作

1.1 环境概述

本地客户端：Windows 系统 + cwRsync（Windows 版 rsync，集成了 cygwin，支持 rsync 协议和 SSH 协议）
服务器端：Linux 系统（本文以 CentOS 7/Ubuntu 22.04 为例）+ rsync（服务器端核心同步工具）
同步目标：将 Windows 本地静态博客目录（如 Hexo 生成的 public 目录）同步至 Linux 服务器的网站根目录（如 /var/www/blog）

1.2 软件下载

Windows 客户端：cwRsync（推荐 cwRsync 6.2.4 稳定版），下载地址：rsync.net 官方 binaries（选择 Windows 版本）
Linux 服务器端：rsync（系统自带或通过包管理器安装，无需额外下载第三方版本）

二、Linux 服务器端 rsync 安装与配置

rsync 是 Linux 系统常用的文件同步工具，支持本地同步和跨机同步，服务器端需先安装并配置 rsync 服务，用于接收客户端的同步请求。

2.1 安装 rsync

根据 Linux 发行版选择对应命令，大部分系统默认已安装，可先执行 rsync --version 检查是否安装。


# CentOS / RHEL 系列
yum install rsync -y

# Ubuntu / Debian 系列
apt update && apt install rsync -y

2.2 配置 rsync 服务（rsyncd.conf）

rsync 服务的核心配置文件为 /etc/rsyncd.conf，若文件不存在则手动创建，配置内容如下（带详细参数说明）：


# /etc/rsyncd.conf 配置文件
uid = root          #  rsync 服务运行的用户（建议 root，避免权限不足，后续可通过 --chown 调整文件所有者）
gid = root          #  rsync 服务运行的用户组
pid file = /var/run/rsyncd.pid  # 进程 PID 文件路径
log file = /var/log/rsyncd.log  # 日志文件路径，便于排查同步故障
lock file = /var/run/rsync.lock # 锁文件路径，防止多个同步进程冲突

# 定义同步模块（核心，客户端将通过模块名访问服务器目录）
[blog_sync]          # 模块名，自定义（如 blog_sync），客户端同步时需指定
comment = Sync static blog from Windows to Linux  # 模块注释，可选
path = /var/www/blog # 服务器上的目标目录（静态博客存放路径），需提前创建
read only = no       # 禁止只读，允许客户端写入（同步文件到服务器，需设为 no）
write only = no      # 禁止只写，允许客户端读取（可选，默认 no）
auth users = rsync_user  # 允许访问该模块的用户（自定义，如 rsync_user），需与密码文件中的用户名一致
secrets file = /etc/rsyncd.secrets  # 密码文件路径，存储 auth users 的用户名和密码
hosts allow = 192.168.1.0/24  # 允许访问的客户端 IP 段（如本地局域网 IP 段），提高安全性
hosts deny = *       # 拒绝所有其他 IP 访问

2.3 核心参数意义补充

除上述配置参数外，同步命令中常用的 rsync 核心参数（后续客户端同步会用到）说明：

-a：归档模式，等同于 -rlptgoD，递归同步目录、保留文件属性（权限、时间戳等），是同步时最常用的参数，适合静态博客同步（博客文件无需特殊权限调整，保留原始属性即可）。
-v：详细模式，输出同步过程中的详细信息（如同步了哪些文件、是否成功），便于排查故障（调试时常用，正常同步可省略）。
-z：压缩传输，同步时压缩文件数据，减少网络带宽占用，适合跨网络同步（如本地与远程服务器不在同一局域网）。
--delete：删除目标目录中客户端不存在的文件，保持客户端和服务器目录完全一致（静态博客同步推荐开启，避免服务器残留旧版博客文件）。
--chown=用户:组：同步时修改文件的所有者和所属组（解决 Windows 同步到 Linux 后文件所有者为 root 的问题，核心参数）。
-e "ssh -p 端口"：指定通过 SSH 协议同步，用于 SSH 密钥认证（默认端口 22，若服务器 SSH 端口修改，需指定端口）。

2.4 启动 rsync 服务并设置开机自启


# 启动 rsync 服务
systemctl start rsyncd

# 设置开机自启（避免服务器重启后 rsync 服务失效）
systemctl enable rsyncd

# 检查服务状态（确保服务正常运行）
systemctl status rsyncd

若服务启动失败，可查看日志 cat /var/log/rsyncd.log 排查故障（常见原因：配置文件语法错误、密码文件权限异常）。

三、Windows 客户端 cwRsync 安装与配置

cwRsync 是 Windows 平台的 rsync 客户端，集成了 cygwin 环境，可直接使用 rsync 命令与 Linux 服务器同步文件，安装配置步骤如下：

3.1 安装 cwRsync

双击下载的 cwRsync 安装包（如 cwRsync_6.2.4_x64_free.exe），选择安装路径（建议安装在无空格、无中文的路径，如 D:\cwRsync，避免后续命令执行报错）。
安装过程中会提示设置 “Rsync Server” 和 “Rsync Client”，此处我们仅需客户端功能，选择 “Rsync Client” 即可（取消勾选 Rsync Server）。
安装完成后，配置环境变量：右键 “此电脑” → 属性 → 高级系统设置 → 环境变量 → 系统变量 → 找到 Path → 编辑 → 新增 D:\cwRsync\bin（对应你的安装路径），点击确定保存。

3.2 验证 cwRsync 安装成功

按下 Win+R，输入 cmd 打开命令提示符，执行 rsync --version，若输出 rsync 版本信息（如 rsync version 3.2.7），则说明安装配置成功。

四、两种认证方式配置（密码认证 + SSH 密钥认证）

rsync 支持两种同步认证方式：密码认证（简单易配置，适合测试或内网环境）和 SSH 密钥认证（无需输入密码，更安全，适合生产环境），以下分别讲解配置步骤。

4.1 密码认证配置（简单版）

密码认证需在 Linux 服务器端创建密码文件，客户端同步时指定密码文件，无需手动输入密码。

4.1.1 Linux 服务器端配置密码文件


# 1. 创建密码文件（路径与 rsyncd.conf 中 secrets file 一致）
touch /etc/rsyncd.secrets

# 2. 写入用户名和密码（格式：用户名:密码，用户名需与 rsyncd.conf 中 auth users 一致）
echo "rsync_user:123456" >> /etc/rsyncd.secrets  # 示例：用户 rsync_user，密码 123456（自定义）

# 3. 设置密码文件权限（关键！rsync 要求密码文件权限必须为 600，否则服务无法读取）
chmod 600 /etc/rsyncd.secrets

# 4. 重启 rsync 服务，使密码文件生效
systemctl restart rsyncd

4.1.2 Windows 客户端密码认证同步命令

打开 Windows 命令提示符（cmd），切换到静态博客的生成目录（如 Hexo 的 public 目录，路径如 D:\blog\public），执行以下同步命令：


# 同步命令格式：rsync -avz --delete 本地目录 用户名@服务器IP::模块名 --password-file=客户端密码文件路径
rsync -avz --delete D:\blog\public\ rsync_user@192.168.1.100::blog_sync --password-file=D:\cwRsync\rsync.pass

# 命令说明：
# D:\blog\public\：Windows 本地静态博客目录（末尾加 / 表示同步目录内的所有文件，不加则同步目录本身）
# rsync_user：服务器端配置的 auth users 用户名
# 192.168.1.100：Linux 服务器 IP 地址
# blog_sync：服务器端 rsyncd.conf 中定义的模块名
# --password-file=D:\cwRsync\rsync.pass：客户端密码文件路径（需手动创建，仅写入密码，无需用户名）

客户端密码文件创建：在 cwRsync 安装目录（如 D:\cwRsync）下，创建 rsync.pass 文件，仅写入服务器端密码（如 123456），保存即可（无需任何多余字符，否则会认证失败）。

4.2 SSH 密钥认证配置（安全版）

密码认证存在密码泄露风险，SSH 密钥认证通过公私钥配对实现认证，无需输入密码，更适合生产环境。配置核心：Windows 客户端生成公私钥，将公钥上传至 Linux 服务器，客户端同步时使用私钥认证。

4.2.1 Windows 客户端生成 SSH 密钥

打开 cwRsync 的终端（开始菜单搜索 “cwRsync”，打开 “cwRsync Terminal”，本质是 cygwin 终端）。
执行以下命令生成公私钥（无需输入密码，直接回车即可，生成的密钥默认存放在 /cygdrive/c/Users/你的用户名/.ssh/ 目录下，对应 Windows 路径 C:\Users\你的用户名\.ssh\）： ssh-keygen -t rsa -b 4096 -C "rsync_sync_blog" # -t 指定密钥类型，-b 指定密钥长度，-C 备注（可选）
生成后，在 C:\Users\你的用户名\.ssh\ 目录下会出现两个文件：
- id_rsa：私钥，存放在 Windows 客户端，切勿泄露给他人。
- id_rsa.pub：公钥，需要上传至 Linux 服务器。

4.2.2 Linux 服务器端配置 SSH 密钥


# 1. 切换到 root 用户（或服务器 SSH 登录用户，建议 root，避免权限不足）
su - root

# 2. 确保 ~/.ssh 目录存在（若不存在则创建）
mkdir -p ~/.ssh && chmod 700 ~/.ssh

# 3. 上传 Windows 客户端的公钥（id_rsa.pub）到服务器 ~/.ssh 目录
# 方法1：使用 scp 命令（Windows 终端执行，需服务器开启 SSH 服务）
# 在 Windows cwRsync Terminal 中执行：
scp /cygdrive/c/Users/你的用户名/.ssh/id_rsa.pub root@192.168.1.100:~/.ssh/

# 方法2：手动复制公钥内容，在 Linux 服务器执行（适合无法使用 scp 的情况）
vim ~/.ssh/authorized_keys  # 创建 authorized_keys 文件（存储客户端公钥）
# 粘贴 Windows 客户端 id_rsa.pub 文件的全部内容，保存退出（:wq）

# 4. 设置 authorized_keys 文件权限（关键！权限错误会导致密钥认证失败）
chmod 600 ~/.ssh/authorized_keys

# 5. （可选）若服务器 SSH 端口不是默认 22，需修改 SSH 配置文件（/etc/ssh/sshd_config）
vim /etc/ssh/sshd_config
# 找到 Port 22，修改为你的 SSH 端口（如 Port 2222），保存退出
# 重启 SSH 服务生效：systemctl restart sshd

4.2.3 Windows 客户端 SSH 密钥认证同步命令

SSH 密钥认证无需密码文件，直接通过私钥认证，同步命令如下（Windows cmd 或 cwRsync Terminal 执行）：


# 同步命令格式：rsync -avz --delete -e "ssh -i 私钥路径 -p SSH端口" 本地目录 服务器用户@服务器IP:服务器目录
# 示例1：SSH 默认端口 22
rsync -avz --delete -e "ssh -i /cygdrive/c/Users/你的用户名/.ssh/id_rsa" D:\blog\public\ root@192.168.1.100:/var/www/blog

# 示例2：SSH 非默认端口（如 2222）
rsync -avz --delete -e "ssh -i /cygdrive/c/Users/你的用户名/.ssh/id_rsa -p 2222" D:\blog\public\ root@192.168.1.100:/var/www/blog

# 命令说明：
# -e "ssh -i 私钥路径"：指定通过 SSH 协议同步，且使用指定的私钥认证
# /cygdrive/c/Users/你的用户名/.ssh/id_rsa：Windows 私钥的 cygwin 路径（cwRsync 需使用 cygwin 路径，不能直接用 Windows 路径 D:\...）
# root@192.168.1.100:/var/www/blog：服务器用户@服务器IP:服务器目标目录（无需指定 rsync 模块，直接指定目录路径）

注意：cygwin 路径规则：Windows 的 C 盘对应 /cygdrive/c/，D 盘对应 /cygdrive/d/，以此类推，路径中的反斜杠 \ 改为正斜杠 /。

五、解决 Windows 同步到 Linux 的 chown 所有者问题

5.1 问题现象

Windows 客户端同步文件到 Linux 服务器后，查看服务器目标目录（如 /var/www/blog）的文件所有者，会发现所有文件的所有者和所属组都是 root（或 rsync 服务运行的用户），而网站服务（如 Nginx、Apache）通常使用 www 用户运行，会导致网站无法访问（权限不足，无法读取静态文件）。

原因：Windows 系统没有 Linux 的用户/组概念，同步时会默认使用 rsync 服务运行的用户（root）作为文件所有者，导致文件权限不匹配。

5.2 解决方法：使用 —chown 参数

rsync 的 --chown=用户:组 参数可以在同步文件时，直接修改文件的所有者和所属组，无需同步后手动执行 chown 命令，一步解决问题。

5.2.1 密码认证同步（加入 —chown 参数）


# 假设网站服务使用 www 用户和 www 组，同步时指定 --chown=www:www
rsync -avz --delete --chown=www:www D:\blog\public\ rsync_user@192.168.1.100::blog_sync --password-file=D:\cwRsync\rsync.pass

5.2.2 SSH 密钥认证同步（加入 —chown 参数）


# SSH 默认端口，加入 --chown=www:www
rsync -avz --delete --chown=www:www -e "ssh -i /cygdrive/c/Users/你的用户名/.ssh/id_rsa" D:\blog\public\ root@192.168.1.100:/var/www/blog

5.3 验证解决效果

同步完成后，在 Linux 服务器执行以下命令，查看文件所有者：


ls -l /var/www/blog

若输出结果中，所有文件的所有者和所属组都是 www（如 -rw-r--r-- 1 www www 1234 Jan 24 10:00 index.html），则说明问题已解决，网站可正常访问。

六、常见问题与解决方法

在同步过程中，可能会遇到各种故障，以下整理了最常见的 5 个问题及详细解决方法，覆盖配置、认证、权限等场景。

问题 1：rsync 服务启动失败，日志提示 “secrets file has wrong permissions”

原因：Linux 服务器端的 rsync 密码文件（/etc/rsyncd.secrets）权限不是 600，rsync 服务要求密码文件必须为 600 权限（仅 root 可读写）。

解决方法：执行以下命令修改权限，重启 rsync 服务： chmod 600 /etc/rsyncd.secrets systemctl restart rsyncd

问题 2：Windows 同步时提示 “Permission denied (publickey,password)”

原因：认证失败，分两种情况：

密码认证：客户端密码文件内容错误（密码与服务器端不一致），或密码文件路径指定错误。
SSH 密钥认证：私钥路径错误、服务器端 authorized_keys 文件权限错误（不是 600）、公钥内容粘贴错误。

解决方法：密码认证：检查客户端 rsync.pass 文件，确保仅写入正确密码；检查同步命令中的 —password-file 路径是否正确。SSH 密钥认证： `# 1. 检查私钥路径是否正确（使用 cygwin 路径）

2. 检查服务器端 authorized_keys 权限

chmod 600 ~/.ssh/authorized_keys

3. 重新上传公钥，确保公钥内容完整无多余字符`

问题 3：同步成功，但网站无法访问，提示 “403 Forbidden”

原因：文件所有者错误（未使用 —chown 参数），或服务器目标目录（/var/www/blog）权限不足，网站服务用户（www）无法读取文件。

解决方法：方法 1：重新同步，加入 —chown=www:www 参数（推荐）。方法 2：手动修改服务器目标目录权限（同步后执行）： chown -R www:www /var/www/blog chmod -R 755 /var/www/blog # 目录权限 755，文件权限 644，确保 www 用户可读取

问题 4：Windows 同步时提示 “rsync: failed to set permissions on…”

原因：Windows 系统没有 Linux 的权限概念，同步时无法保留 Linux 的文件权限，导致权限设置失败（不影响文件同步，仅提示警告）。

解决方法：无需特殊处理，若想消除警告，可在同步命令中加入--no-perms 参数（禁止保留文件权限），同时配合 —chown 参数指定正确的所有者： rsync -avz --delete --no-perms --chown=www:www -e "ssh -i 私钥路径" 本地目录服务器目录

问题 5：同步时提示 “connection refused”（连接被拒绝）

原因： Linux 服务器端 rsync 服务未启动。服务器防火墙阻挡了 rsync 端口（默认 873 端口）或 SSH 端口（默认 22 端口）。服务器 IP 地址错误，或客户端与服务器无法互通（ping 不通）。

解决方法： `# 1. 检查 rsync 服务是否启动 systemctl status rsyncd

2. 开放防火墙端口（rsync 端口 873，SSH 端口 22）

CentOS / RHEL 系列

firewall-cmd —add-port=873/tcp —permanent firewall-cmd —add-port=22/tcp —permanent firewall-cmd —reload

Ubuntu / Debian 系列

ufw allow 873/tcp ufw allow 22/tcp ufw reload

3. 检查客户端与服务器是否互通（Windows cmd 执行）

ping 192.168.1.100（服务器 IP）`

七、总结

本文详细讲解了 Windows+cwRsync 同步静态博客至 Linux+rsync 服务器的完整流程，从软件安装、服务配置，到两种认证方式（密码认证适合测试、SSH 密钥认证适合生产），再到核心的 chown 所有者问题解决，以及常见故障排查，覆盖了同步过程中的所有关键环节。

核心要点回顾：服务器端 rsync 配置核心：rsyncd.conf 模块配置、密码文件权限 600。客户端同步核心参数：-a（归档）、—delete（同步一致性）、—chown（解决所有者问题）。认证方式推荐：生产环境优先使用 SSH 密钥认证，安全无密码。常见故障排查：重点关注权限（文件权限、目录权限）、认证（密码、密钥）、服务状态（rsync、SSH）。

按照本文步骤操作，即可实现本地静态博客的一键同步，后续可将同步命令写成批处理文件（.bat），双击即可完成同步，提升效率。若遇到其他未提及的问题，可在评论区留言，或查看 rsync 日志（服务器端 /var/log/rsyncd.log）排查故障。

Windows同步静态博客Linux服务器完整教程