- 后端: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>
37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
# 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 值会被同名校验覆盖)。
|