静态博客一键发布到服务器：WinSCP + SFTP 实战指南

1
<#
2
.SYNOPSIS
3
  静态博客 dist 一键同步到服务器
4
.DESCRIPTION
5
  WinSCP SFTP 增量同步：上传新增/修改文件 + 删除服务器多余文件
6
#>
7

8
# ========== 配置区（改成你自己的信息） ==========
9
$winscpPath = Join-Path $PSScriptRoot "WinSCP.com"
10
$localDir   = "D:\your-blog\dist\"            # 改：本地 dist 路径
11
$remoteDir  = "/www/wwwroot/blog"              # 改：服务器站点目录
12
$sshHost    = "你的服务器IP"                    # 改：例如 123.45.67.89
13
$port       = 22                                # SSH 端口，一般默认 22
14
$user       = "root"                            # 改：SSH 用户名
15
$pass       = "你的SSH密码"                      # 改：SSH 密码
16
$logFile    = Join-Path $PSScriptRoot "sync-log.txt"
17

18
# ========== 前置检查 ==========
19
if (-not (Test-Path $winscpPath)) {
20
    Write-Host "[错误] 未找到 WinSCP.com，请放在 tools\ 目录下。" -ForegroundColor Red
21
    pause
22
    exit 1
23
}
24

25
# ========== 核心同步命令 ==========
26
# 参数说明：
27
#   -hostkey=*                 跳过主机指纹确认（首次连接不卡手动确认）
28
#   synchronize remote         本地 -> 服务器
29
#   -delete                    删除服务器多余文件（镜像模式）
30
#   -criteria=checksum         用哈希判断文件是否变化（比时间戳准）
31
#   -filemask="|.user.ini;**/.user.ini"   排除所有目录下的 .user.ini
32
#       |.user.ini = 排除根目录 .user.ini
33
#       **/.user.ini = 排除所有子目录 .user.ini（宝塔面板会生成）
34

35
$scriptText = @"
36
open sftp://$($user):$($pass)@$($sshHost):$port -hostkey=*
37
synchronize remote "$localDir" "$remoteDir" -delete -criteria=checksum -filemask="|.user.ini;**/.user.ini"
38
exit
39
"@
40

41
$tmpScript = Join-Path $PSScriptRoot "winscp_tmp.txt"
42
[System.IO.File]::WriteAllText($tmpScript, $scriptText, [System.Text.Encoding]::ASCII)
43

44
Write-Host "[信息] 开始同步..." -ForegroundColor Cyan
45
& $winscpPath /script="$tmpScript" /log="$logFile"
46

47
Remove-Item $tmpScript -ErrorAction SilentlyContinue
48

49
Write-Host ""
50
Write-Host "[完成] 同步完毕，日志：$logFile" -ForegroundColor Green
51
pause

1
<#
2
.SYNOPSIS
3
  一键：pnpm build -> WinSCP SFTP 同步
4
  构建失败则不会执行同步，避免把空 dist 推到服务器
5
#>
6

7
# ========== 路径 ==========
8
$projectRoot = Split-Path $PSScriptRoot -Parent   # 项目根目录（tools 上一级）
9
$distDir     = Join-Path $projectRoot "dist"
10
$winscpPath  = Join-Path $PSScriptRoot "WinSCP.com"
11
$logFile     = Join-Path $PSScriptRoot "sync-log.txt"
12

13
# ========== 服务器连接配置（改成你自己的） ==========
14
$sshHost    = "你的服务器IP"
15
$port       = 22
16
$user       = "root"
17
$pass       = "你的SSH密码"
18
$remoteDir  = "/www/wwwroot/blog"
19

20
# ========== 环境检查 ==========
21
try {
22
    $pnpmVer = & pnpm --version 2>$null
23
    if (-not $pnpmVer) { throw "pnpm not found" }
24
    Write-Host "[OK] pnpm v$pnpmVer" -ForegroundColor Gray
25
} catch {
26
    Write-Host "[错误] 未检测到 pnpm，请先安装：npm install -g pnpm" -ForegroundColor Red
27
    pause
28
    exit 1
29
}
30

31
# ========== Step 1：构建 ==========
32
Write-Host ""
33
Write-Host "[1/2] 开始构建：pnpm build" -ForegroundColor Cyan
34
$buildTimer = [System.Diagnostics.Stopwatch]::StartNew()
35

36
Push-Location $projectRoot
37
try {
38
    & pnpm build
39
    $buildExitCode = $LASTEXITCODE
40
} finally {
41
    Pop-Location
42
}
43

44
$buildTimer.Stop()
45

46
if ($buildExitCode -ne 0) {
47
    Write-Host ""
48
    Write-Host "[错误] 构建失败（退出码 $buildExitCode），已中止同步。" -ForegroundColor Red
49
    pause
50
    exit 1
51
}
52
Write-Host "[OK] 构建成功，耗时 $($buildTimer.Elapsed.ToString('mm\分ss\秒'))" -ForegroundColor Green
53

54
# ========== Step 2：同步 ==========
55
Write-Host ""
56
Write-Host "[2/2] 开始同步 dist -> 服务器 $remoteDir" -ForegroundColor Cyan
57
$syncTimer = [System.Diagnostics.Stopwatch]::StartNew()
58

59
$winscpCmd = @"
60
open sftp://$($user):$($pass)@$($sshHost):$port -hostkey=*
61
synchronize remote "$distDir\" "$remoteDir" -delete -criteria=checksum -filemask="|.user.ini;**/.user.ini"
62
exit
63
"@
64

65
$tmp = Join-Path $PSScriptRoot "winscp_tmp.txt"
66
[System.IO.File]::WriteAllText($tmp, $winscpCmd, [System.Text.Encoding]::ASCII)
67

68
& $winscpPath /script="$tmp" /log="$logFile"
69
$syncExitCode = $LASTEXITCODE
70

71
Remove-Item $tmp -ErrorAction SilentlyContinue
72
$syncTimer.Stop()
73

74
# ========== 汇总报告 ==========
75
Write-Host ""
76
Write-Host "=============== 发布结果 ===============" -ForegroundColor Magenta
77
Write-Host "  构建 ：$(if ($buildExitCode -eq 0) { '成功' } else { '失败' })  耗时 $($buildTimer.Elapsed.ToString('mm\分ss\秒'))" -ForegroundColor Magenta
78
Write-Host "  同步 ：$(if ($syncExitCode -eq 0) { '成功' } else { "失败($syncExitCode)" })  耗时 $($syncTimer.Elapsed.ToString('mm\分ss\秒'))" -ForegroundColor Magenta
79
Write-Host "========================================" -ForegroundColor Magenta
80

81
if ($syncExitCode -ne 0) {
82
    Write-Host "[警告] 同步有问题，日志：$logFile" -ForegroundColor Yellow
83
}
84

85
Write-Host ""
86
pause