liufumingren 11ebb33966 feat(extension): 插件配置集中管理 + 桌面端策略安装 + 跨网下载修复
- 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension;
  插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效)
- 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成)
- 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布
- 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证);
  跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe
- 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包),
  nginx 对 /download/extension/updates.xml 关缓存

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:26 +08:00

37 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# extension/keys —— 扩展签名私钥(**已入库**)
| 文件 | 说明 |
| --- | --- |
| `key.pem` | Chrome 扩展签名私钥。**决定扩展 ID**,`npm run extension:publish` 用它对 `.crx` 签名 |
**当前扩展 ID**:`lkeibbccgdddjamahnkibopcpidhgggk`
(= 公钥 SHA256 前 16 字节按 `a~p` 映射;可用 `extension/out/extension-id.txt` 核对)
## 为什么入库
桌面端「工具 → 安装谷歌插件」会在客户机写一条企业策略:
```
HKLM\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist
1 = lkeibbccgdddjamahnkibopcpidhgggk;https://<域名>/download/extension/updates.xml
```
策略里写死了**扩展 ID**,而 ID 由这把私钥唯一决定:
- 私钥在 → 每次发布都是同一个 ID,客户机策略长期有效;
- 私钥丢 → 重新生成 → **ID 变了** → 已下发到所有客户机的策略全部失效(要重新点一次安装)。
所以按「宁可入库也别丢」处理。⚠️ 代价是:**仓库必须保持私有**,能读这个仓库的人等于能签发
一个"官方更新"推给所有客户机(Chrome 信任这个私钥签的包)。
## 绝对不能随安装包发给客户
`desktop/YuncangTrace.LocalService.csproj` 已经把 `extension/keys/**` 和 `extension/out/**`
从输出/发布/安装包里排除了;改那个 `Content Include` 的 `Exclude` 时**别把这两条删掉**。
## 换机器 / 重建
- 正常:`git clone` 下来就有 `key.pem`,直接 `npm run extension:publish` 即可;
- 想换一把新的(**会让扩展 ID 变化**):删掉 `key.pem` 再发布,脚本会自动生成;
之后客户机需要重新执行一次「工具 → 安装谷歌插件」(旧的 forcelist 值会被同名校验覆盖)。