很多人卡在这一步:买好服务器,发现是「不含图形化桌面」的版本,远程连上去只有一个黑窗口,无从下手。

这篇把我自己这套站(静态 HTML + 每天自动更新)的部署过程完整写下来。全程不需要图形界面,不需要在服务器上装任何客户端。

零、这套方案长什么样#

text
本机(写作 + 构建)                      阿里云
┌──────────────────┐                  ┌─────────────────┐
│ 写完文章 → 构建   │  ① 打成 zip      │  OSS 桶(中转) │
│ dist/ 静态文件    │ ───────────────▶ │  _deploy/site.zip│
└──────────────────┘                  └─────────────────┘
         │ ③ 用 API 下发命令                  ▲ ② 签名 URL 临时可读
         ▼                                    │
┌──────────────────────────────────────────────┴──┐
│ ECS(Windows Server,无桌面)                     │
│ 云助手执行 PowerShell:下载 zip → 解压 wwwroot    │
│ IIS 提供 HTTP 服务                                │
└───────────────────────────────────────────────────┘

关键点:你不需要登录服务器也能部署。阿里云「云助手」本身就是一条远程执行通道,用 API 调它就行。

一、先确认三件事#

  1. 服务器能上网(公网 IP + 按固定带宽或按流量)
  2. 有一个对象存储桶(我用的是私有桶,只当文件中转,不对外)
  3. 有一个 RAM 子账号的 AccessKey(不要用主账号的)

AccessKey 的权限给到最小就够了:能调用 ECS 的 RunCommand / DescribeInvocationResults / AuthorizeSecurityGroup,以及 OSS 的读写。给完把 Secret 存在本机配置文件里,别写进代码仓库。

二、放行 80 端口(不然你装完也打不开)#

安全组默认只开了 3389(远程桌面)。放行 HTTP 有两条路:

方式做法
控制台实例 → 安全组 → 入方向 → 手动添加 TCP 80,授权对象 0.0.0.0/0
API调用 AuthorizeSecurityGroup,PortRange=80/80、IpProtocol=tcp、SourceCidrIp=0.0.0.0/0

放行之后从本机验一次:

powershell
Test-NetConnection -ComputerName <你的公网IP> -Port 80 -InformationLevel Quiet

返回 True 才继续。返回 False 别怀疑 IIS,先怀疑安全组。

三、调用云助手(这一步是核心)#

阿里云 RPC 接口的签名不复杂,但细节容易错。下面是能直接跑的 Node 版本,只要三个值:AccessKeyId、AccessKeySecret、实例 ID。

js
import { createHmac, randomUUID } from 'node:crypto'

const ak = { id: process.env.ALI_KEY_ID, secret: process.env.ALI_KEY_SECRET }
const pe = (s) => encodeURIComponent(s).replace(/\+/g, '%20').replace(/\*/g, '%2A').replace(/%7E/g, '~')

async function call(action, params) {
  const p = {
    Format: 'JSON', Version: '2014-05-26',
    AccessKeyId: ak.id, SignatureMethod: 'HMAC-SHA1', SignatureVersion: '1.0',
    SignatureNonce: randomUUID(),
    Timestamp: new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),
    Action: action, RegionId: 'cn-shanghai', ...params,
  }
  const canonical = Object.keys(p).sort().map((k) => `${pe(k)}=${pe(String(p[k]))}`).join('&')
  const sig = createHmac('sha1', ak.secret + '&').update(`GET&${pe('/')}&${pe(canonical)}`).digest('base64')
  const res = await fetch(`https://ecs.cn-shanghai.aliyuncs.com/?${canonical}&Signature=${pe(sig)}`)
  const json = await res.json()
  if (json.Code) throw new Error(`${action}: ${json.Code} ${json.Message}`)
  return json
}

四个坑,按踩到的顺序记:

  1. 时间戳:必须是 UTC 的 ISO8601,去掉毫秒,2026-11-01T12:00:00Z 这种
  2. 编码:标准 urlencode 之后还要把 +→%20、*→%2A、%7E→~,少一步签名就对不上
  3. SignatureNonce:每次要换,重复用会报签名重复
  4. RegionId 放哪:放在公共参数里,同时又属于某些 Action 的参数,两处都要有

四、装 IIS 并放站点#

一条命令下发整段 PowerShell。云助手要求 Base64 编码的 CommandContent:

js
await call('RunCommand', {
  'InstanceId.1': '<实例ID>',
  Type: 'RunPowerShellScript',
  Name: 'deploy-site',
  ContentEncoding: 'Base64',
  CommandContent: Buffer.from(script, 'utf8').toString('base64'),
  Timeout: '900',
})

script 里做四件事:

powershell
# 1. 装 IIS(Server Core 版没有桌面,只能用 ServerManager 模块)
Install-WindowsFeature -Name Web-Server -IncludeManagementTools

# 2. 拉压缩包(签名 URL 有时效,别提前太久生成)
Invoke-WebRequest -Uri $signedUrl -OutFile 'C:\site.zip' -UseBasicParsing -TimeoutSec 300

# 3. 清空并解压到站点目录
Get-ChildItem 'C:\inetpub\wwwroot' -Force | Remove-Item -Recurse -Force
Expand-Archive -Path 'C:\site.zip' -DestinationPath 'C:\inetpub\wwwroot' -Force

# 4. 设开机自启并启动
Set-Service -Name W3SVC -StartupType Automatic
Start-Service -Name W3SVC

实测耗时:装 IIS 约 3 分 35 秒,下载 1 MB 站点包约 8–20 秒,解压 3 秒。整轮 40 秒到 2 分钟,取决于带宽。

五、拿回执,别只看「命令已发送」#

RunCommand 返回一个 InvokeId,要拿它轮询:

js
const r = await call('DescribeInvocationResults', { InvokeId, 'InstanceId.1': instanceId })
const res = r.Invocation?.InvocationResults?.InvocationResult?.[0]
// res.InvocationStatus:Pending / Running / Success / Failed
// res.Output 默认是 Base64,要解一次

输出是 Base64 的,第一次看到一串乱码别慌,Buffer.from(out, 'base64').toString('utf8') 就还原了。

六、做成每天自动部署#

把上面五步封成一个脚本,接进自动运营的 deployCmd:

json
{
  "deployCmd": "\"C:\\Program Files\\nodejs\\node.exe\" \"D:\\你的路径\\deploy-ecs.mjs\""
}

脚本的职责固定成五段,任何一段失败就返回非 0,让上层判定「今天没部署成功」:

  1. 打包 dist/ → site.zip
  2. 上传到对象存储(带 Cache-Control: no-store,避免 CDN 缓存旧包)
  3. 生成 2 小时有效的签名 URL
  4. 云助手下载 + 解压 + 起服务
  5. 校验服务状态和文件数,回执写进日志

实测一轮 40–130 秒,主要变量是服务器到存储的网络。

七、排错对照表#

现象多半是怎么确认
装完访问超时安全组没放行 80Test-NetConnection -Port 80
403.14站点目录没有默认文档看 C:\inetpub\wwwroot 有没有 index.html
500应用池权限 / 目录被清空服务器上 Test-Path 查文件
中文乱码响应头没带 charset页面里加 <meta charset="utf-8">
图片 404用了相对路径 /assets/ 前少了斜杠打开 F12 看请求 URL
首屏慢带宽小(3 Mbps 很常见)换 CDN,或压缩图片
域名打不开大陆服务器绑域名需要备案先只用 IP 访问

八、几条老实建议#

  • 带宽别省:3 Mbps 拉 1 MB 站点,首屏四秒起步。图片能压就压,一张 960 KB 的 PNG 换 JPG 能省三分之二
  • 能上 CDN 就上:静态站接 CDN 之后,源站只承担回源流量,体验完全不一样
  • 备份配置:config.json 这类文件被覆盖过一次就知道疼了,改之前先复制一份
  • 日志留小一点:跑久了日志会涨,定期归档,别把系统盘塞满
  • 夜里的窗口:定时任务放在早上跑,出问题你白天还能看见;别放在凌晨

九、还有问题?#

文里的命令都是我自己跑通的,照着做卡在哪一步,直接贴报错原文——截图往往看不清,一行文本就够定位。

站内相关的两篇:DSH 怎么配置、诸葛智算接入。