全部教程
本页目录
很多人卡在这一步:买好服务器,发现是「不含图形化桌面」的版本,远程连上去只有一个黑窗口,无从下手。
这篇把我自己这套站(静态 HTML + 每天自动更新)的部署过程完整写下来。全程不需要图形界面,不需要在服务器上装任何客户端。
零、这套方案长什么样#
本机(写作 + 构建) 阿里云
┌──────────────────┐ ┌─────────────────┐
│ 写完文章 → 构建 │ ① 打成 zip │ OSS 桶(中转) │
│ dist/ 静态文件 │ ───────────────▶ │ _deploy/site.zip│
└──────────────────┘ └─────────────────┘
│ ③ 用 API 下发命令 ▲ ② 签名 URL 临时可读
▼ │
┌──────────────────────────────────────────────┴──┐
│ ECS(Windows Server,无桌面) │
│ 云助手执行 PowerShell:下载 zip → 解压 wwwroot │
│ IIS 提供 HTTP 服务 │
└───────────────────────────────────────────────────┘关键点:你不需要登录服务器也能部署。阿里云「云助手」本身就是一条远程执行通道,用 API 调它就行。
一、先确认三件事#
- 服务器能上网(公网 IP + 按固定带宽或按流量)
- 有一个对象存储桶(我用的是私有桶,只当文件中转,不对外)
- 有一个 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 |
放行之后从本机验一次:
Test-NetConnection -ComputerName <你的公网IP> -Port 80 -InformationLevel Quiet返回 True 才继续。返回 False 别怀疑 IIS,先怀疑安全组。
三、调用云助手(这一步是核心)#
阿里云 RPC 接口的签名不复杂,但细节容易错。下面是能直接跑的 Node 版本,只要三个值:AccessKeyId、AccessKeySecret、实例 ID。
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
}四个坑,按踩到的顺序记:
- 时间戳:必须是 UTC 的 ISO8601,去掉毫秒,
2026-11-01T12:00:00Z这种 - 编码:标准 urlencode 之后还要把
+→%20、*→%2A、%7E→~,少一步签名就对不上 - SignatureNonce:每次要换,重复用会报签名重复
- RegionId 放哪:放在公共参数里,同时又属于某些 Action 的参数,两处都要有
四、装 IIS 并放站点#
一条命令下发整段 PowerShell。云助手要求 Base64 编码的 CommandContent:
await call('RunCommand', {
'InstanceId.1': '<实例ID>',
Type: 'RunPowerShellScript',
Name: 'deploy-site',
ContentEncoding: 'Base64',
CommandContent: Buffer.from(script, 'utf8').toString('base64'),
Timeout: '900',
})script 里做四件事:
# 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,要拿它轮询:
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:
{
"deployCmd": "\"C:\\Program Files\\nodejs\\node.exe\" \"D:\\你的路径\\deploy-ecs.mjs\""
}脚本的职责固定成五段,任何一段失败就返回非 0,让上层判定「今天没部署成功」:
- 打包
dist/→site.zip - 上传到对象存储(带
Cache-Control: no-store,避免 CDN 缓存旧包) - 生成 2 小时有效的签名 URL
- 云助手下载 + 解压 + 起服务
- 校验服务状态和文件数,回执写进日志
实测一轮 40–130 秒,主要变量是服务器到存储的网络。
七、排错对照表#
| 现象 | 多半是 | 怎么确认 |
|---|---|---|
| 装完访问超时 | 安全组没放行 80 | Test-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这类文件被覆盖过一次就知道疼了,改之前先复制一份 - 日志留小一点:跑久了日志会涨,定期归档,别把系统盘塞满
- 夜里的窗口:定时任务放在早上跑,出问题你白天还能看见;别放在凌晨
九、还有问题?#
文里的命令都是我自己跑通的,照着做卡在哪一步,直接贴报错原文——截图往往看不清,一行文本就够定位。