feat(更新链路): web_config 加 sha256(V142),/api/version/latest 回带包摘要
客户端自更新过去只验 zip 结构:桶里的包被换掉时,结构完整的恶意 zip 会直接交给 update.exe 解压执行。摘要必须由服务端给出才与下载来源无关——能替换对象的人替换不了这个接口。 - V142 加 sha256 列(可空、不回填历史行,列缺失时客户端行为不变); - /latest、公开列表、后台上传响应都回带摘要;multipart 上传按真正落盘的字节算; - 直传确认路径不重算摘要(那要把 100MB 对象拉回来),这类行留空由发布脚本回填。 盘点文档同步:V1..V142、141 个文件、后续从 V143 取号。
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
-- V142: web_config(桌面客户端升级包版本表)增加 sha256 —— 更新包的完整性锚点
|
||||
--
|
||||
-- 背景(2026-10-03 实证):4.0.43 包内 .env 的 oss_access_key_id / oss_access_key_secret 与主机 A
|
||||
-- minio 容器 env 的 MINIO_ROOT_* 同指纹(口令 len=16 sha8=a84c33f1),也就是对象存储的管理员身份
|
||||
-- 随公开包分发给了每个下载者。拿到它的人可以覆盖任意 client/nanri-image/versions/<版本>.zip,
|
||||
-- 而客户端下载后只验 zip 结构(tool/resumable_download.verify_zip_archive),不比对服务端摘要
|
||||
-- ⇒ 结构完整的恶意包会被 update.exe 解压并执行。
|
||||
-- 轮换凭据只能管"以后";本表有摘要才能让客户端对每一次下载做与来源无关的校验:
|
||||
-- 能替换桶里对象的人,替换不了本接口的返回值。
|
||||
--
|
||||
-- 存量:列可空。历史行没有摘要,客户端在「服务端未登记摘要」时沿用旧行为(告警后继续),
|
||||
-- 因此本迁移不回填、也不改变 /api/version/latest 对现有客户端的可观察行为(多一个字段,
|
||||
-- 老客户端按 key 取值,忽略未知键)。当前最新版(4.0.43)的摘要由发布脚本回填。
|
||||
--
|
||||
-- 不加索引:本表 62 行量级,读取走 is_latest 那条路径,摘要只是随行返回的一列。
|
||||
-- 风险:单表 ADD COLUMN,秒级完成;不改任何历史迁移文件。
|
||||
-- 上线窗口:无锁窗口顾虑,随双节点滚动发布正常执行;本地/CI 无库不跑 migrate,
|
||||
-- 首次执行发生在生产启动期,建议先发一台、确认下方验证 SQL 通过后再发第二台。
|
||||
-- 回滚:ALTER TABLE `web_config` DROP COLUMN `sha256`;
|
||||
-- (回滚后客户端不受影响:/latest 不返回 sha256 ⇒ 走"未登记摘要"的旧路径)
|
||||
--
|
||||
-- 验证 SQL(迁移后执行):
|
||||
-- SHOW COLUMNS FROM `web_config` LIKE 'sha256';
|
||||
-- -> 期望 1 行,Type=varchar(64),Null=YES
|
||||
-- SELECT COUNT(*) AS with_digest FROM `web_config` WHERE `sha256` IS NOT NULL;
|
||||
-- -> 期望 0(迁移不回填);此后每发布一个版本 +1
|
||||
|
||||
SET @db_name = DATABASE();
|
||||
|
||||
SET @col_exists := (
|
||||
SELECT COUNT(*) FROM information_schema.COLUMNS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'web_config' AND COLUMN_NAME = 'sha256'
|
||||
);
|
||||
SET @sql := IF(@col_exists = 0,
|
||||
'ALTER TABLE `web_config` ADD COLUMN `sha256` VARCHAR(64) NULL COMMENT ''更新包sha256(hex小写);NULL=迁移前历史行,客户端不做摘要校验'' AFTER `file_url`',
|
||||
'SELECT 1'
|
||||
);
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
Reference in New Issue
Block a user