Windows安装rsync命令一键脚本

请注意： 执行这个脚本意味着您同意cwRsync的相关协议。

如何执行脚本？

1. 通过以下命令启动PowerShell窗口：

powershell.exe

2. 在PowerShell窗口中，运行以下命令以执行远程脚本：

Invoke-Expression -Command ([System.Text.Encoding]::UTF8.GetString((Invoke-WebRequest -Uri "https://util.apio.xyz/public/InstallRsync.ps1" -UseBasicParsing).Content))

这个命令会下载并运行位于 https://util.apio.xyz/public/InstallRsync.ps1的脚本。

脚本内容

# 检查是否具有管理员权限
function Test-IsAdmin {
    $identity = [Security.Principal.WindowsIdentity]::GetCurrent()
    $principal = New-Object Security.Principal.WindowsPrincipal($identity)
    return $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
}

# 以管理员身份运行当前脚本
if (-not (Test-IsAdmin)) {
    $arguments = "-NoProfile -ExecutionPolicy Bypass -Command & { $($ExecutionContext.InvokeCommand.ExpandString($MyInvocation.MyCommand.Definition)) }"
    Start-Process powershell -Verb runAs -ArgumentList $arguments
    exit
}

# 下载最新版 cwRsync 6.4.8 x64 免费包
# 该 WAPT 包内含 cwrsync_6.4.8_x64_free.zip，并提供可核验的 SHA-256 清单
$Url = "https://wapt.tranquil.it/store/en/wapt/tis-cwrsync_6.4.8-23_x64_windows_PROD.wapt"
$PackageFile = "$env:TEMP\cwrsync_6.4.8.wapt.zip"
$PackageFolder = "$env:TEMP\cwrsync_6.4.8_package"
$ZipFile = "$PackageFolder\cwrsync_6.4.8_x64_free.zip"
$RsyncFolder = "C:\Program Files\rsync"
$ExpectedHash = "8798363513b05c355ad87f8f3efbb15b7b6433996b652efec712efd52d7c8336"

# 下载 WAPT 包并提取其中的 cwRsync 压缩包
try {
    Invoke-WebRequest $Url -OutFile $PackageFile -ErrorAction Stop
    Remove-Item $PackageFolder -Recurse -Force -ErrorAction SilentlyContinue
    Expand-Archive -Path $PackageFile -DestinationPath $PackageFolder -Force
} catch {
    Write-Host "Error downloading or extracting package: $($_.Exception.Message)"
    exit
}

# 确认文件存在并校验哈希
if (-Not (Test-Path $ZipFile)) {
    Write-Host "Download failed or cwRsync archive was not found in the package."
    exit
}

$ActualHash = (Get-FileHash -Path $ZipFile -Algorithm SHA256).Hash.ToLower()
if ($ActualHash -ne $ExpectedHash) {
    Write-Host "cwRsync archive checksum verification failed."
    exit
}

# 解压缩文件， 使用 -Force 参数以覆盖现有文件
Expand-Archive -Path $ZipFile -DestinationPath $RsyncFolder -Force

# 赋予Users用户组写入权限
$Acl = Get-Acl -Path $RsyncFolder
$Users = New-Object System.Security.Principal.SecurityIdentifier (New-Object System.Security.Principal.NTAccount("Users")).Translate([System.Security.Principal.SecurityIdentifier])
$AccessRule = New-Object System.Security.AccessControl.FileSystemAccessRule($Users, "Modify", "Allow")
$Acl.SetAccessRule($AccessRule)
Set-Acl -Path $RsyncFolder -ACLObject $Acl

# 在 C:\Windows\System32 下创建 rsync.bat 文件
$RsyncBatFile = "C:\Windows\System32\rsync.bat"
$RsyncBatContent = @"
@echo off
SETLOCAL
SET CWRSYNCHOME="C:\Program Files\rsync"
SET HOME=%USERPROFILE%
SET CWOLDPATH=%PATH%
SET PATH=%CWRSYNCHOME%\bin;%PATH%
SET KNOWN_HOSTS_PATH=%USERPROFILE%\.ssh\known_hosts

%CWRSYNCHOME%\bin\rsync.exe -e "\"C:\Program Files\rsync\bin\ssh.exe\" -o Compression=yes -o UserKnownHostsFile=%KNOWN_HOSTS_PATH%" %*
"@

# 检查文件是否已存在，如果不存在则创建
if (-not (Test-Path $RsyncBatFile)) {
    Set-Content -Path $RsyncBatFile -Value $RsyncBatContent
}

# 添加到系统环境变量 Path
# $systemPathKey = [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine)
# if (-not ($systemPathKey.Contains("$RsyncFolder\bin"))) {
#     $newSystemPathKey = $systemPathKey + ";$RsyncFolder\bin"
#     [Environment]::SetEnvironmentVariable("Path", $newSystemPathKey, [EnvironmentVariableTarget]::Machine)
# }

# 更新当前 PowerShell 会话的环境变量
# $env:Path += ";$RsyncFolder\bin"

# 验证安装成功
$rsyncVersion = & rsync --version
if ($LASTEXITCODE -eq 0) {
    Write-Host "Rsync installation successful!"
    # Write-Host $rsyncVersion
} else {
    Write-Host "Rsync installation failed."
}

# 暂停等待按键
Write-Host "Press any key to exit..."
$host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown") | Out-Null

脚本做了什么事情？

这个脚本执行了以下操作：

1. 检查管理员权限，如果没有，则以管理员身份重新启动。
2. 下载并解压cwRsync到"C:\Program Files\rsync"。
3. 将cwRsync的可执行文件添加到系统环境变量Path，以便在命令提示符或PowerShell中直接使用。 使用bat脚本封装rsync命令，避免安装git命令时同步安装的ssh与之冲突。
4. 验证安装成功，并显示rsync版本信息。

完成这些操作后，您可以在Windows上直接使用rsync命令。

2023年6月11日更新： 添加rsync.bat脚本，避免操作系统中存在多个ssh.exe导致rsync报错：rsync: connection unexpectedly closed (0 bytes received so far) [Receiver]。

修复的主要报错信息类似：

rsync: connection unexpectedly closed (0 bytes received so far) [Receiver]
rsync error: error in rsync protocol data stream (code 12) at io.c(228) [Receiver=3.2.7]
rsync: connection unexpectedly closed (0 bytes received so far) [sender]
rsync error: error in rsync protocol data stream (code 12) at io.c(228) [sender=3.2.7]

rsync error: error in IPC code (code 14) at pipe.c(85) [sender=3.2.7]
rsync: connection unexpectedly closed (0 bytes received so far) [sender]
rsync error: error in rsync protocol data stream (code 12) at io.c(231) [sender=3.2.7]

Error syncing files: exit status 12

2023年6月13日更新：

注释了无需用到的设置环境变量代码，赋予Users用户组写入rsync文件夹权限，避免Failed to add the host to the list of known hosts (/known_hosts).错误。

2024年8月15日更新：

与ssh共用known_hosts文件，同时升级最新版本的cwrsync，修改脚本地址。支持覆盖升级（重新执行一次命令即可）。

2026年7月12日更新：

升级到当前最新版 cwRsync client 6.4.8。由于原缓存地址和 GitHub latest 接口当前均不可用，脚本改用已验证可访问的 WAPT 6.4.8-23 下载地址，从包内提取 cwrsync_6.4.8_x64_free.zip，并按发布清单校验 SHA-256 后再安装。