feat: the one-line installer verifies the CI-signed release manifest and pulls the image by digest [CI]

This commit is contained in:
justme committed 2026-10-07 23:01:45 +08:00
1 parent a19e6548d3
commit 310b2b5b19
8 files changed
+227 -8

No files matched your search

+56
View File
@@ -1,13 +1,41 @@
# MoShiro 节点一键安装(Windows,Agent 和 Probe 共用同一份)。面板在 /install.ps1?code=… 生成这份脚本,把下面四个值填好:
# irm 'https://panel/install.ps1?code=jt_…' | iex
# 镜像:向面板取 CI 签名的发布清单,用内置的发布公钥验签,再按清单里的 digest 拉取。面板还没有签名的清单时,设 $env:MOSHIRO_ALLOW_UNVERIFIED='1' 才会按标签安装。
# 做的事:用 Docker Desktop 起一个容器,身份和配置存在命名卷里(重启、换新镜像重建都不用再给参数),节点名字默认取计算机名。
# 可选环境变量:MOSHIRO_NAME=节点名字(名字被占用时用)。
function Test-MoShiroSignature([byte[]]$data, [byte[]]$derSignature, [string]$pem) {
# 发布公钥是 PEM 的 SPKI(P-256):最后 64 字节是 X、Y;签名是 DER,.NET 要 r||s
$b64 = ($pem -split "`n" | Where-Object { $_ -notmatch '^-----' }) -join ''
$spki = [Convert]::FromBase64String($b64.Trim())
$xy = $spki[($spki.Length - 64)..($spki.Length - 1)]
$blob = [byte[]]@(0x45, 0x43, 0x53, 0x31, 0x20, 0, 0, 0) + $xy
$i = 2
if ($derSignature[1] -band 0x80) { $i = 2 + ($derSignature[1] -band 0x7f) }
$parts = @()
for ($n = 0; $n -lt 2; $n++) {
$len = $derSignature[$i + 1]
$part = [byte[]]$derSignature[($i + 2)..($i + 1 + $len)]
while ($part.Length -gt 32 -and $part[0] -eq 0) { $part = [byte[]]$part[1..($part.Length - 1)] }
if ($part.Length -gt 32) { return $false }
$parts += , ([byte[]](New-Object byte[] (32 - $part.Length)) + $part)
$i += 2 + $len
}
$key = [Security.Cryptography.CngKey]::Import($blob, [Security.Cryptography.CngKeyBlobFormat]::EccPublicBlob)
try {
$ecdsa = New-Object Security.Cryptography.ECDsaCng($key)
return $ecdsa.VerifyData($data, [byte[]]($parts[0] + $parts[1]), [Security.Cryptography.HashAlgorithmName]::SHA256)
} finally { $key.Dispose() }
}
function Install-MoShiro {
$ErrorActionPreference = 'Stop'
$role = '@@ROLE@@'
$server = '@@SERVER@@'
$code = '@@CODE@@'
$image = '@@IMAGE@@'
$releaseKey = @'
@@RELEASE_KEY@@
'@
$name = if ($env:MOSHIRO_NAME) { $env:MOSHIRO_NAME } else { $env:COMPUTERNAME }
$name = $name -replace '[^A-Za-z0-9._-]', '-'
@@ -34,6 +62,34 @@ function Install-MoShiro {
return
}
# 验发布清单:签名对不上、组件不对、digest 格式不对都直接拒绝,不装
$client = New-Object System.Net.WebClient
$manifest = $null
try {
$manifest = $client.DownloadData("$server/install/manifest?code=$code")
$signature = [Convert]::FromBase64String(($client.DownloadString("$server/install/manifest.sig?code=$code")).Trim())
} catch {
$manifest = $null
}
if ($null -eq $manifest) {
if ($env:MOSHIRO_ALLOW_UNVERIFIED -ne '1') {
Write-Error "the panel has no signed release for $role yet, so the image cannot be verified. Run again with `$env:MOSHIRO_ALLOW_UNVERIFIED='1' to install $image without verification"
return
}
Write-Host "warning: installing $image without signature verification"
} else {
if (-not (Test-MoShiroSignature $manifest $signature $releaseKey)) {
Write-Error 'the release signature does not verify against the built-in release key; refusing to install'
return
}
$release = [Text.Encoding]::UTF8.GetString($manifest) | ConvertFrom-Json
if ($release.component -ne $role) { Write-Error "the signed release is for '$($release.component)', not '$role'"; return }
if ($release.digest -notmatch '^sha256:[0-9a-f]{64}$') { Write-Error 'the signed release has a malformed digest'; return }
if ($release.image -notmatch '^[A-Za-z0-9._/:-]+$') { Write-Error 'the signed release has a malformed image name'; return }
$image = "$($release.image)@$($release.digest)"
Write-Host "verified release $($release.version) ($($release.tag)): $image"
}
Write-Host "pulling $image"
docker pull $image | Out-Null
if ($LASTEXITCODE -ne 0) {