fix(update): 换发清单签名密钥,补齐 1.0.9 已签名清单 #8

Merged
Morris merged 1 commits from feat/manifest-signing into main 2026-11-18 18:41:21 +08:00
Owner

问题

仓库里硬编码的公钥 gc-2026-11 没有对应的私钥 —— .signing/ 在 .gitignore 里,私钥从来没进过库,也找不回来。结果是 build.sh 每次签名都失败:

==> 签名 version.json(gc-2026-11)
已签名: version.json(Invalid)
!! 签名失败,version.json 保持未签名状态

而客户端默认 RequireSignedManifest=true,未签名清单一律拒绝更新。也就是说自动更新链路目前是完全不通的,用户只能手动下载。

做法

文件 改动
GC/src/Security/SignatureKeyring.cs 新增 gc-2026-12(指纹 ee6083be47a87907),旧 gc-2026-11 保留并标注「私钥遗失、已停用」
GC-SAVEDOG/Program.cs DefaultKeyId → gc-2026-12
buildsh/lib/build_funcs.sh GC_SIGNING_KEY_ID 默认值 → gc-2026-12
GC.Tests/Program.cs 构造可信清单时的 keyId 同步改掉
README.md 补密钥轮换步骤与实际代价
Directory.Build.props 1.0.7 → 1.0.9
version.json / model/version.json 1.0.9 且带签名,两份字节一致

私钥 .signing/gc-signing.pem 仍然只在本地,没进这次提交。

一个必须知道的代价

公钥是编译进客户端的。1.0.8 及更早的版本只认识 gc-2026-11,这份用新钥匙签出的清单在它们眼里是「签名无效」—— 和之前的「未签名」等价,都不会更新。要让自动更新真正生效,得把带新公钥的 1.0.9 发出去,之后 1.0.9 → 1.0.10 才能全自动。

验证

GC.Tests --update-test        → 清单验签通过(gc-2026-12),篡改清单被判 Invalid 并拒绝
GC-SAVEDOG verify             → 信任状态: Verified / 密钥: gc-2026-12
build.sh build -version=1.0.9 → 三平台出包并自动签名成功
平台 产物
win-amd64 109 MB
win-arm64 105 MB
mac-arm64 57 MB

osx-x64 / linux-x64 在清单里没有 sha256(本机没出这两个平台的包),下载端会跳过,不影响其他平台。

合并后我这边再发 1.0.9 正式版;私钥需要你自己备份 —— 丢了就只能再换一次钥匙,中间老客户端又会断一次更新。

## 问题 仓库里硬编码的公钥 `gc-2026-11` 没有对应的私钥 —— `.signing/` 在 `.gitignore` 里,私钥从来没进过库,也找不回来。结果是 `build.sh` 每次签名都失败: ``` ==> 签名 version.json(gc-2026-11) 已签名: version.json(Invalid) !! 签名失败,version.json 保持未签名状态 ``` 而客户端默认 `RequireSignedManifest=true`,未签名清单一律拒绝更新。也就是说**自动更新链路目前是完全不通的**,用户只能手动下载。 ## 做法 | 文件 | 改动 | |---|---| | `GC/src/Security/SignatureKeyring.cs` | 新增 `gc-2026-12`(指纹 `ee6083be47a87907`),旧 `gc-2026-11` 保留并标注「私钥遗失、已停用」 | | `GC-SAVEDOG/Program.cs` | `DefaultKeyId` → `gc-2026-12` | | `buildsh/lib/build_funcs.sh` | `GC_SIGNING_KEY_ID` 默认值 → `gc-2026-12` | | `GC.Tests/Program.cs` | 构造可信清单时的 keyId 同步改掉 | | `README.md` | 补密钥轮换步骤与实际代价 | | `Directory.Build.props` | 1.0.7 → 1.0.9 | | `version.json` / `model/version.json` | 1.0.9 且带签名,两份字节一致 | 私钥 `.signing/gc-signing.pem` 仍然只在本地,没进这次提交。 ## 一个必须知道的代价 公钥是编译进客户端的。1.0.8 及更早的版本只认识 `gc-2026-11`,这份用新钥匙签出的清单在它们眼里是「签名无效」—— 和之前的「未签名」等价,都不会更新。**要让自动更新真正生效,得把带新公钥的 1.0.9 发出去**,之后 1.0.9 → 1.0.10 才能全自动。 ## 验证 ``` GC.Tests --update-test → 清单验签通过(gc-2026-12),篡改清单被判 Invalid 并拒绝 GC-SAVEDOG verify → 信任状态: Verified / 密钥: gc-2026-12 build.sh build -version=1.0.9 → 三平台出包并自动签名成功 ``` | 平台 | 产物 | |---|---| | win-amd64 | 109 MB | | win-arm64 | 105 MB | | mac-arm64 | 57 MB | > `osx-x64` / `linux-x64` 在清单里没有 sha256(本机没出这两个平台的包),下载端会跳过,不影响其他平台。 合并后我这边再发 1.0.9 正式版;私钥需要你自己备份 —— 丢了就只能再换一次钥匙,中间老客户端又会断一次更新。
Morris added 1 commit 2026-11-18 18:20:42 +08:00
fix(update): 换发清单签名密钥,补齐 1.0.9 已签名清单
PR 审核 / 后端编译 (pull_request) Canceled after 0s
PR 审核 / 后端自检 (pull_request) Canceled after 0s
PR 审核 / 前端检查(Flutter) (pull_request) Canceled after 0s
PR 审核 / 安全扫描 (pull_request) Canceled after 0s
PR 审核 / 审核汇总 (pull_request) Canceled after 0s
e327a56421
仓库里硬编码的公钥 gc-2026-11 没有对应的私钥(.signing/ 在 .gitignore 里,
私钥从来没入过库,也无法找回),导致 build.sh 每次签名都失败,version.json
始终是「未签名」。而客户端默认 RequireSignedManifest=true,未签名清单一律
拒绝更新 —— 自动更新实际上完全不可用。

改动:
- keygen 生成新密钥 gc-2026-12(指纹 ee6083be47a87907),公钥写进
  SignatureKeyring;旧 gc-2026-11 保留一个版本周期,标注为「私钥遗失、已停用」
- GC-SAVEDOG 的 DefaultKeyId 与 build_funcs.sh 的 GC_SIGNING_KEY_ID 默认值
  同步改为 gc-2026-12,避免 keyId 与私钥不匹配又签出 Invalid
- GC.Tests 构造可信清单时用的 keyId 改为 gc-2026-12(原来硬编码旧 keyId,
  换钥匙后会判成 Invalid)
- README 补上密钥轮换的实际步骤与「换钥匙老客户端就更新不了」的代价
- Directory.Build.props 版本 1.0.7 → 1.0.9(此前只靠 -version 传参,
  仓库里一直停在 1.0.7,与实际发布脱节)
- version.json / model/version.json 换成 1.0.9 且带 gc-2026-12 签名,
  两份字节一致

验证:
- GC.Tests --update-test 全通过,日志里是「清单验签通过(gc-2026-12)」,
  篡改清单被判 Invalid 并拒绝更新
- GC-SAVEDOG verify --manifest version.json → Verified
- 三平台重新出包:win-amd64 109 MB、win-arm64 105 MB、mac-arm64 57 MB

注意:1.0.8 及更早的客户端只认识旧公钥,这份清单在它们眼里是「签名无效」,
与之前的「未签名」等价 —— 都不会自动更新。要让自动更新真正生效,需要把
带新公钥的 1.0.9 发出去。
Morris merged commit 7e34cb0467 into main 2026-11-18 18:41:21 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#8