feat(desktop): 下线 Edge 企业策略安装(扩展已上架商店)
- 工具菜单去掉「安装浏览器插件(企业策略:Chrome / Edge)」「卸载浏览器插件(企业策略)」, 删除 Services/ExtensionInstaller.cs(.reg 生成 + 提权导入 + 注册表校验) - 只保留「安装浏览器插件(Edge 应用商店)」与「复制插件路径(Chrome / 开发者模式)」; 商店弹窗去掉「审核中会 404」的说法,Chrome 用户直接引导到开发者模式 - 文档同步(桌面 README / 后端 README / extension README / STORE-SUBMISSION / keys README): 写清老机器上残留的 HKLM 策略怎么手工清理,避免和商店版同时注入 - extension:publish(.crx + updates.xml)保留,仅给内网/离线分发用 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
1dc3404eae
commit
6f52613e5e
@ -294,7 +294,8 @@ npm run db:deploy:prod # 基线表 + 全部未执行迁移(幂等,可反
|
||||
发布说明:
|
||||
|
||||
> ⚠️ `npm run deploy` **只发后端 + 前端 + nginx**:桌面端安装包(`npm run desktop:publish`)和
|
||||
> Chrome 插件(`npm run extension:publish`)是**两条独立命令**,不会跟着 deploy 走。
|
||||
> Chrome 插件(`npm run extension:publish`)是**两条独立命令**,不会跟着 deploy 走(Edge 扩展已上架商店,
|
||||
> 这条 `.crx` + `updates.xml` 链路现在只给内网/离线分发用)。
|
||||
> 三者的远端目录互不重叠(`/download/desktop/`、`/download/extension/`),可以各自单独发布。
|
||||
|
||||
- 前端构建产物单独上传到 `deployRoot/frontend`,由 **nginx 直接托管**(SPA 回退到 `index.html`);上一版保留在 `frontend.prev`,`npm run rollback` 会连前端一起切回。
|
||||
@ -332,8 +333,8 @@ npm run desktop:publish -- --target=Msi # 只出 MSI(不发 EXE)
|
||||
(路径不能改:老客户端写死 `/download/version.json`;先传安装包,再原子替换 `version.json`);
|
||||
- nginx 的 `/download/` 静态托管该目录:`version.json` 不缓存,安装包长缓存;
|
||||
- `desktop/installer/package.config.json` 的 Production `serverBaseUrl` 必须是 `https://`,安装包内嵌的接口 / 下载地址会跟着变;
|
||||
- **谷歌插件一起打进包**:`extension/` 发布到 `<安装目录>\extension`;正式分发走企业策略
|
||||
(`npm run extension:publish` + 菜单「工具 → 安装谷歌插件」,见下节);
|
||||
- **浏览器插件一起打进包**:`extension/` 发布到 `<安装目录>\extension`(开发者模式加载用);
|
||||
正式分发:Edge 走加载项商店、Chrome 走开发者模式,客户端**不再写企业策略**(见下节);
|
||||
- 不会重启 Egg、不会重新发布后端、不会跑数据库迁移;
|
||||
|
||||
### Chrome 插件正式包(.crx + updates.xml)
|
||||
@ -355,10 +356,11 @@ npm run extension:publish -- --version=1.2.0 --skip-nginx
|
||||
- 产物:`YuncangTraceExtension-<version>.crx`、`updates.xml`、`extension-id.txt`;
|
||||
- 上传到 `deployRoot/download/extension/`;nginx 对 **`updates.xml` 关缓存**(浏览器靠它自动升级),
|
||||
`.crx` 文件名带版本号、走长缓存;
|
||||
- 扩展 ID 由 `extension/keys/key.pem` 决定(首次运行自动生成,**必须备份**,换了 ID 就变,
|
||||
已下发到客户机的策略全部失效);
|
||||
- 客户机侧:桌面端「工具 → 安装谷歌插件」写 `ExtensionInstallForcelist` + `ExtensionInstallSources`
|
||||
(Chrome 与 Edge 各一份,HKLM),重启浏览器即自动安装;
|
||||
- 扩展 ID 由 `extension/keys/key.pem` 决定(首次运行自动生成,**必须备份**,换了 ID 就变);
|
||||
- ⚠️ 客户端**已不再**用企业策略装自建 CRX:Edge 扩展上架商店后该功能已下线,桌面端没有
|
||||
「一键写策略」的入口。这条 `updates.xml` + `.crx` 链路保留给**内网/离线分发**;
|
||||
- 正式分发:Edge 用桌面端「工具 → 安装浏览器插件(Edge 应用商店)」点「获取」;
|
||||
Chrome 用「工具 → 复制插件路径(Chrome / 开发者模式)」到 `chrome://extensions` 加载已解压的扩展程序;
|
||||
- 前置:.NET 8 SDK、WiX 5.0.2(`dotnet tool install --global wix --version 5.0.2`)、Inno Setup 6(`winget install --id JRSoftware.InnoSetup`,出 EXE 用)、`desktop/native/ffmpeg/ffmpeg.exe`。
|
||||
|
||||
下载地址:`<desktopBaseUrl>/download/desktop/YuncangTraceSetup-<版本>.exe`(新客户端优先)
|
||||
|
||||
@ -3,13 +3,15 @@
|
||||
/**
|
||||
* Chrome 插件正式包:打包 .crx + 生成 updates.xml,并发布到 nginx 静态目录
|
||||
*
|
||||
* 为什么需要它:
|
||||
* - 浏览器只认**已签名**的扩展包,`chrome://extensions` 里「加载已解压」没法被策略/安装包注入;
|
||||
* - 企业策略 `ExtensionInstallForcelist` 只接受 `<扩展ID>;<update_url>`,update_url 必须是一个
|
||||
* 可访问的 XML(不是本地目录);
|
||||
* 为什么还需要它:
|
||||
* - 浏览器只认**已签名**的扩展包,需要给内网/离线机器一个可双击安装或自行加载的 `.crx`;
|
||||
* - `updates.xml` 让这些机器能按 `<扩展ID>;<update_url>` 自动升级(
|
||||
* 企业策略 `ExtensionInstallForcelist` 用的就是这个组合,客户端已不再写策略,改由 IT 自行下发);
|
||||
* - 所以这里把仓库里的 `extension/` 打成 `.crx`,连同 `updates.xml` 一起放到
|
||||
* `deployRoot/download/extension/`(nginx 对 updates.xml 关缓存,.crx 长缓存)。
|
||||
*
|
||||
* ⚠️ 正式分发早已改成:Edge 走加载项商店(已上架)、Chrome 走开发者模式加载安装目录里的 `extension/`。
|
||||
*
|
||||
* 产物(extension/out/):
|
||||
* - `YuncangTraceExtension-<version>.crx` 扩展包(文件名带版本号,可以长缓存)
|
||||
* - `updates.xml` 更新清单(`<app appid>` 就是扩展 ID)
|
||||
@ -287,9 +289,10 @@ async function main() {
|
||||
if (!options.skipNginx) refreshNginx(config);
|
||||
|
||||
console.log('');
|
||||
console.log('发布完成。客户机「工具 → 安装谷歌插件」会写入策略:');
|
||||
console.log(` ExtensionInstallForcelist = ${id};${updateUrl}`);
|
||||
console.log(` ExtensionInstallSources = ${baseUrl}/download/extension/*`);
|
||||
console.log('发布完成(内网/离线分发用,客户端已不再写企业策略):');
|
||||
console.log(` 扩展 ID = ${id}`);
|
||||
console.log(` 更新地址 = ${updateUrl}`);
|
||||
console.log(` .crx = ${baseUrl}/download/extension/`);
|
||||
} finally {
|
||||
fs.rmSync(workDir, { recursive: true, force: true });
|
||||
}
|
||||
|
||||
@ -26,9 +26,7 @@
|
||||
<MenuItem Header="清理日志" Click="ClearLogs_Click" />
|
||||
<Separator />
|
||||
<MenuItem Header="安装浏览器插件(Edge 应用商店)" Click="OpenExtensionStore_Click" />
|
||||
<MenuItem Header="安装浏览器插件(企业策略:Chrome / Edge)" Click="InstallExtension_Click" />
|
||||
<MenuItem Header="复制插件路径(开发者模式)" Click="CopyExtensionPath_Click" />
|
||||
<MenuItem Header="卸载浏览器插件(企业策略)" Click="UninstallExtension_Click" />
|
||||
<MenuItem Header="复制插件路径(Chrome / 开发者模式)" Click="CopyExtensionPath_Click" />
|
||||
<Separator />
|
||||
<MenuItem Header="清理更新缓存" Click="ClearUpdateCache_Click" />
|
||||
<Separator />
|
||||
|
||||
@ -793,19 +793,15 @@ public partial class MainWindow : Window
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 「工具 → 安装浏览器插件(企业策略)」:写 Chrome/Edge 企业策略(UAC 一次),重启浏览器后自动安装
|
||||
///
|
||||
/// 扩展 ID 从后端 `/download/extension/updates.xml` 读(由打包私钥决定),
|
||||
/// 这里不写死 —— 换私钥/换域名都不用改客户端。
|
||||
/// </summary>
|
||||
/// <summary>Edge 加载项商店的安装页(审核通过后可用;审核/未上线时打开会是 404,属正常)</summary>
|
||||
/// <summary>Edge 加载项商店的安装页(已上架,点「获取」即可)</summary>
|
||||
private const string ExtensionStoreUrl =
|
||||
"https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj";
|
||||
|
||||
/// <summary>
|
||||
/// 「工具 → 安装浏览器插件(Edge 应用商店)」:
|
||||
/// 非受管 / 没有管理员权限的电脑上,企业策略会被浏览器拒绝,商店是唯一能一键装的路。
|
||||
/// 「工具 → 安装浏览器插件(Edge 应用商店)」:用 msedge.exe 打开商店安装页。
|
||||
///
|
||||
/// Edge 扩展已上架商店,装了 Edge 就点「获取」,不需要开发者模式、不需要管理员权限,
|
||||
/// 也不需要企业策略;Chrome 装不了 Edge 商店的扩展,走「复制插件路径(Chrome / 开发者模式)」。
|
||||
/// </summary>
|
||||
private void OpenExtensionStore_Click(object sender, RoutedEventArgs e)
|
||||
{
|
||||
@ -829,7 +825,8 @@ public partial class MainWindow : Window
|
||||
"已打开「云仓视频溯源 · 单号注入」的 Edge 加载项页面。\n\n"
|
||||
+ "· 点「获取」→「添加扩展」,几秒就装好,不需要开发者模式,也不需要管理员权限;\n"
|
||||
+ "· 这个页面只对 Microsoft Edge 有效(Chrome 装不了 Edge 商店的扩展);\n"
|
||||
+ "· 如果页面显示 404,说明商店还在审核中——先用企业策略或开发者模式。",
|
||||
+ "· 用 Chrome 的话:菜单「复制插件路径(Chrome / 开发者模式)」,"
|
||||
+ "再到 chrome://extensions 打开开发者模式、加载已解压的扩展程序。",
|
||||
"安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information);
|
||||
}
|
||||
catch (Exception ex)
|
||||
@ -859,75 +856,6 @@ public partial class MainWindow : Window
|
||||
return null;
|
||||
}
|
||||
|
||||
private async void InstallExtension_Click(object sender, RoutedEventArgs e)
|
||||
{
|
||||
var confirm = MessageBox.Show(this,
|
||||
"将为 Chrome 和 Edge 写入企业策略,重启浏览器后自动安装「云仓视频溯源 · 单号注入」插件。\n\n"
|
||||
+ "· 需要允许一次管理员权限(UAC);\n"
|
||||
+ "· 电脑必须已纳管(加域 / Intune 等),否则浏览器会拒绝非商店来源的扩展;\n"
|
||||
+ "· 装好后插件由浏览器自己更新,不用再手动「加载已解压」;\n"
|
||||
+ "· 想撤销:同一菜单「卸载浏览器插件(企业策略)」。\n\n继续吗?",
|
||||
"安装浏览器插件", MessageBoxButton.OKCancel, MessageBoxImage.Question);
|
||||
if (confirm != MessageBoxResult.OK) return;
|
||||
|
||||
try
|
||||
{
|
||||
var result = await ExtensionInstaller.InstallAsync(_settings.ServerBaseUrl).ConfigureAwait(true);
|
||||
AppLog.Write($"[extension] 插件策略已写入:{string.Join("、", result.Targets)}(id={result.Id})");
|
||||
|
||||
MessageBox.Show(this,
|
||||
$"已为 {string.Join("、", result.Targets)} 写入策略。\n\n"
|
||||
+ $"扩展 ID:{result.Id}\n更新地址:{result.UpdateUrl}\n\n"
|
||||
+ "请完全退出并重新打开浏览器;在 chrome://extensions 里应能看到该插件,并显示「由你的组织管理」。",
|
||||
"安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information);
|
||||
}
|
||||
catch (OperationCanceledException)
|
||||
{
|
||||
MessageBox.Show(this, "已取消管理员授权,浏览器策略没有改动。",
|
||||
"安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information);
|
||||
}
|
||||
catch (Exception ex)
|
||||
{
|
||||
AppLog.Write($"[extension] 安装插件失败:{ex.Message}");
|
||||
MessageBox.Show(this,
|
||||
$"安装失败:{ex.Message}\n\n"
|
||||
+ "没有管理员权限、或电脑没纳管时,浏览器会拒绝企业策略。改用这两条路:\n"
|
||||
+ "· 用 Edge:菜单「安装浏览器插件(Edge 应用商店)」→ 点「获取」;\n"
|
||||
+ "· 用 Chrome:菜单「复制插件路径(开发者模式)」→ chrome://extensions 加载已解压的扩展程序。",
|
||||
"安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Warning);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>「工具 → 卸载浏览器插件(企业策略)」:删掉我们写的那几条策略(UAC 一次)</summary>
|
||||
private async void UninstallExtension_Click(object sender, RoutedEventArgs e)
|
||||
{
|
||||
var confirm = MessageBox.Show(this,
|
||||
"将移除 Chrome / Edge 里由本软件写入的插件策略,重启浏览器后插件会被卸载。\n\n继续吗?",
|
||||
"卸载浏览器插件", MessageBoxButton.OKCancel, MessageBoxImage.Question);
|
||||
if (confirm != MessageBoxResult.OK) return;
|
||||
|
||||
try
|
||||
{
|
||||
var result = await ExtensionInstaller.UninstallAsync(_settings.ServerBaseUrl).ConfigureAwait(true);
|
||||
AppLog.Write($"[extension] 插件策略已移除:{(result.Targets.Count == 0 ? "没有找到" : string.Join("、", result.Targets))}");
|
||||
|
||||
MessageBox.Show(this,
|
||||
result.Targets.Count == 0
|
||||
? "没有找到本软件写入的插件策略(可能本来就没装)。"
|
||||
: "已移除插件策略,重启浏览器后插件会被卸载。",
|
||||
"卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information);
|
||||
}
|
||||
catch (OperationCanceledException)
|
||||
{
|
||||
MessageBox.Show(this, "已取消管理员授权,浏览器策略没有改动。",
|
||||
"卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information);
|
||||
}
|
||||
catch (Exception ex)
|
||||
{
|
||||
AppLog.Write($"[extension] 卸载插件失败:{ex.Message}");
|
||||
MessageBox.Show(this, $"卸载失败:{ex.Message}", "卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Warning);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 「工具 → 复制插件路径(开发者模式)」:插件随安装包释放到 <安装目录>\extension,
|
||||
|
||||
@ -243,45 +243,36 @@ cd desktop\installer
|
||||
> 安装包与版本信息都归到后端 `desktop` 子目录:下载地址 `<域名>/download/desktop/YuncangTraceSetup-x.y.z.exe`(新客户端)
|
||||
> 和 `.msi`(老客户端),版本信息仍是 `<域名>/download/version.json`(老客户端写死了这个地址,不能改)。
|
||||
|
||||
### 谷歌浏览器插件
|
||||
### 浏览器插件
|
||||
|
||||
仓库根目录的 `extension/dist`(压缩产物)会一起打进 MSI / EXE,安装后固定在 **`<安装目录>\extension`**
|
||||
(perUser 安装即 `%LOCALAPPDATA%\Programs\YuncangTrace\extension`)。
|
||||
|
||||
**首选:Edge 加载项商店(非受管电脑也能装)** ——
|
||||
**Edge:加载项商店(已上架)** ——
|
||||
|
||||
- 菜单「工具 → **安装浏览器插件(Edge 应用商店)**」:装了 Edge 就用 `msedge.exe` 打开
|
||||
`https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj`,
|
||||
用户点「获取」即可;**不需要开发者模式,也不需要管理员权限**;
|
||||
- 这个链接**审核通过后**才有效(审核中打开是 404);商店版扩展 ID 是 `mgdonmkicojkabgalgekobaoohaohfcj`;
|
||||
- 只对 Edge 有效:Chrome 装不了 Edge 商店的扩展,请走下面的企业策略或开发者模式。
|
||||
`https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj`,点「获取」即可;
|
||||
**不需要开发者模式、不需要管理员权限,也不写任何策略**;
|
||||
- 商店版扩展 ID:`mgdonmkicojkabgalgekobaoohaohfcj`;装好后由 Edge 商店自己更新;
|
||||
- 只对 Edge 有效:Chrome 装不了 Edge 商店的扩展,用下面的开发者模式。
|
||||
|
||||
**受管设备:企业策略安装(零开发者模式)** —— `Services/ExtensionInstaller.cs`:
|
||||
**Chrome:开发者模式** ——
|
||||
|
||||
- 菜单「工具 → **安装浏览器插件(企业策略:Chrome / Edge)**」:先拉后端 `/download/extension/updates.xml`
|
||||
读出扩展 ID,再生成 `.reg` 文件、**runas 执行 `reg import`** 写 HKLM 策略(Chrome + Edge),
|
||||
最后**读注册表**确认结果(不依赖子进程回传,早期用「提权起自己 + 临时文件回传」现场踩过
|
||||
「退出码 0 但结果文件没写」的坑):
|
||||
- `ExtensionInstallForcelist = <ID>;https://<域名>/download/extension/updates.xml`
|
||||
- `ExtensionInstallSources = https://<域名>/download/extension/*`
|
||||
- 重启浏览器后自动装好,之后由 `updates.xml` 自己升级;`chrome://extensions` 里显示「由你的组织管理」;
|
||||
- 菜单「工具 → **卸载浏览器插件(企业策略)**」:只删值里带 `/download/extension/` 的那几条,不影响别人写的策略;
|
||||
- 前提:发布端已执行过 `cd backend && npm run extension:publish`(产出 `.crx` + `updates.xml`);
|
||||
扩展 ID 由 `extension/keys/key.pem` 决定,**换私钥 = 换 ID = 已下发策略失效**,私钥务必备份;
|
||||
- 提权失败 / 设备未纳管时,弹窗会直接引导到「Edge 商店」或「开发者模式」两条路。
|
||||
|
||||
> ⚠️ 商店版(`mgdon…`)与自建 CRX(`lkei…`)是**两个不同 ID 的扩展**:同一浏览器都装会同时注入、
|
||||
> 页面被标记两遍。从自建 CRX 切到商店版前,先点「卸载浏览器插件(企业策略)」。
|
||||
|
||||
**兜底:开发者模式** ——
|
||||
|
||||
- 菜单「工具 → 复制插件路径(开发者模式)」直接把该目录的 **Windows 路径**(如 `C:\Users\xxx\AppData\Local\Programs\YuncangTrace\extension`)复制到剪贴板;
|
||||
- 菜单「工具 → 复制插件路径(Chrome / 开发者模式)」直接把该目录的 **Windows 路径**(如 `C:\Users\xxx\AppData\Local\Programs\YuncangTrace\extension`)复制到剪贴板;
|
||||
写剪贴板全程在后台 STA 线程、带截止时间退避重试(WPF → WinForms → 补 `OleFlushClipboard`),
|
||||
被远程桌面(实测 BilldDesk)/ 输入法 / 剪贴板工具占用时不会卡住界面、也不会误报;
|
||||
**复制前先核对内容**:剪贴板里已经是这个路径就直接算成功;确实写不进去才提示,并告知是哪个进程占着,可选「打开记事本」手动抄写;
|
||||
- 用户打开 `chrome://extensions` → 打开「开发者模式」→「加载已解压的扩展程序」→ 粘贴路径即可;
|
||||
- 卸载时该目录随安装包一起删除;
|
||||
|
||||
> ⚠️ **企业策略安装已下线**(`ExtensionInstallForcelist`,菜单里的「安装/卸载浏览器插件(企业策略)」
|
||||
> 和 `Services/ExtensionInstaller.cs` 一起删掉了):Edge 上架商店后不再需要它。
|
||||
> 老版本写在客户机 HKLM 里的策略**不会自己消失** —— 那些机器的 `chrome://extensions` 里会留一个
|
||||
> 「由你的组织管理」的旧同名插件(自建 CRX,ID `lkei…`),和商店版同时装会注入两遍。手动清理:
|
||||
> 删掉 `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist` 与
|
||||
> `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallForcelist` 下值里带
|
||||
> `/download/extension/` 的项,以及同级的 `ExtensionInstallSources`,然后重启浏览器。
|
||||
|
||||
### 自动更新怎么工作
|
||||
|
||||
```
|
||||
|
||||
@ -1,393 +0,0 @@
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.ComponentModel;
|
||||
using System.Diagnostics;
|
||||
using System.IO;
|
||||
using System.Linq;
|
||||
using System.Net.Http;
|
||||
using System.Text;
|
||||
using System.Threading;
|
||||
using System.Threading.Tasks;
|
||||
using System.Xml.Linq;
|
||||
using Microsoft.Win32;
|
||||
|
||||
namespace YuncangTrace.LocalService.Services;
|
||||
|
||||
/// <summary>
|
||||
/// 「工具 → 安装谷歌插件」:用**企业策略**把 Chrome / Edge 的扩展装上
|
||||
///
|
||||
/// 为什么不能像以前那样「复制解压目录 + 加载已解压」:
|
||||
/// - 那只在开发者模式生效,每台机器要人手动点,Chrome 每次启动还会提示「请停用以开发者模式运行的扩展程序」;
|
||||
/// - 策略安装(<c>ExtensionInstallForcelist</c>)只认 `<扩展ID>;<update_url>`,update_url 必须是
|
||||
/// 一个可访问的 XML(我们自己的 `/download/extension/updates.xml`),**不认本地目录**。
|
||||
///
|
||||
/// 实现方式(**不依赖进程间回传结果**):
|
||||
/// 1. 去后端拉 `updates.xml` 读出扩展 ID;
|
||||
/// 2. 生成一个 `.reg` 文件(写 HKLM 策略);
|
||||
/// 3. runas 执行 `reg.exe import`(一次 UAC);
|
||||
/// 4. **直接读注册表**确认写没写进去 —— 成功与否以注册表为准,不看子进程输出。
|
||||
///
|
||||
/// ⚠️ 早期版本用「runas 起自己 + 临时文件回传结果」,现场出现过
|
||||
/// 「提权进程退出码 0 但结果文件没写」→ 装不上。reg import 只有一步动作、没有 IPC,稳得多。
|
||||
/// </summary>
|
||||
public static class ExtensionInstaller
|
||||
{
|
||||
/// <summary>更新清单路径(相对后端地址)</summary>
|
||||
private const string UpdatePath = "/download/extension/updates.xml";
|
||||
|
||||
/// <summary>允许安装来源的匹配串(非商店 CRX 必须放行,否则 Chrome 直接拒绝)</summary>
|
||||
private const string SourcesSuffix = "/download/extension/*";
|
||||
|
||||
/// <summary>我们写的策略以后都带这个特征,卸载时按它精确匹配,不误删别人的策略</summary>
|
||||
private const string OurMarker = "/download/extension/";
|
||||
|
||||
/// <summary>Chrome / Edge 的策略根(都支持 ExtensionInstallForcelist + ExtensionInstallSources)</summary>
|
||||
private static readonly string[] BrowserPolicyRoots =
|
||||
{
|
||||
@"SOFTWARE\Policies\Google\Chrome",
|
||||
@"SOFTWARE\Policies\Microsoft\Edge",
|
||||
};
|
||||
|
||||
/// <summary>用户点了 UAC 的「否」</summary>
|
||||
private const int ErrorCancelled = 1223;
|
||||
|
||||
public sealed class HelperResult
|
||||
{
|
||||
public bool Ok { get; set; }
|
||||
public string? Error { get; set; }
|
||||
public string? Id { get; set; }
|
||||
public string? UpdateUrl { get; set; }
|
||||
public List<string> Targets { get; set; } = new();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 装插件(**会弹一次 UAC**)
|
||||
/// </summary>
|
||||
/// <exception cref="OperationCanceledException">用户取消了 UAC 授权</exception>
|
||||
/// <exception cref="InvalidOperationException">拉不到更新清单 / 策略没写进去</exception>
|
||||
public static async Task<HelperResult> InstallAsync(string serverBaseUrl, CancellationToken ct = default)
|
||||
{
|
||||
var baseUrl = NormalizeBase(serverBaseUrl);
|
||||
var id = await FetchExtensionIdAsync(baseUrl, ct).ConfigureAwait(false);
|
||||
return await ApplyAsync(baseUrl, id, install: true, ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
/// <summary>卸插件(**会弹一次 UAC**):只删带我们 URL 特征的那几条策略</summary>
|
||||
public static Task<HelperResult> UninstallAsync(string serverBaseUrl, CancellationToken ct = default)
|
||||
=> ApplyAsync(NormalizeBase(serverBaseUrl), string.Empty, install: false, ct);
|
||||
|
||||
/// <summary>更新清单地址(失败提示里要给用户看)</summary>
|
||||
public static string UpdateUrlOf(string serverBaseUrl) => NormalizeBase(serverBaseUrl) + UpdatePath;
|
||||
|
||||
private static string NormalizeBase(string serverBaseUrl)
|
||||
{
|
||||
var value = (serverBaseUrl ?? string.Empty).Trim().TrimEnd('/');
|
||||
if (value.Length == 0) throw new InvalidOperationException("后端地址为空,无法安装插件");
|
||||
return value;
|
||||
}
|
||||
|
||||
/// <summary>拉 updates.xml,读 `<app appid="...">`</summary>
|
||||
private static async Task<string> FetchExtensionIdAsync(string baseUrl, CancellationToken ct)
|
||||
{
|
||||
var url = baseUrl + UpdatePath;
|
||||
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(10) };
|
||||
|
||||
string xml;
|
||||
try
|
||||
{
|
||||
xml = await http.GetStringAsync(url, ct).ConfigureAwait(false);
|
||||
}
|
||||
catch (HttpRequestException ex)
|
||||
{
|
||||
throw new InvalidOperationException(
|
||||
$"拿不到插件更新清单({url}):{ex.Message}\n\n"
|
||||
+ "服务端还没发布过插件包?先执行 backend 的 npm run extension:publish。", ex);
|
||||
}
|
||||
|
||||
try
|
||||
{
|
||||
var id = XDocument.Parse(xml)
|
||||
.Descendants()
|
||||
.FirstOrDefault(element => element.Name.LocalName == "app")
|
||||
?.Attribute("appid")?.Value?.Trim();
|
||||
|
||||
if (string.IsNullOrEmpty(id) || id.Length != 32)
|
||||
{
|
||||
throw new InvalidOperationException($"更新清单里没有有效的 appid({url})");
|
||||
}
|
||||
return id;
|
||||
}
|
||||
catch (Exception ex) when (ex is not InvalidOperationException)
|
||||
{
|
||||
throw new InvalidOperationException($"解析插件更新清单失败({url}):{ex.Message}", ex);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>生成 .reg → runas 执行 reg import → 读注册表确认</summary>
|
||||
private static async Task<HelperResult> ApplyAsync(string baseUrl, string id, bool install, CancellationToken ct)
|
||||
{
|
||||
var regFile = Path.Combine(Path.GetTempPath(), $"yuncang_ext_{Guid.NewGuid():N}.reg");
|
||||
var regText = BuildReg(baseUrl, id, install);
|
||||
|
||||
if (regText.Length == 0)
|
||||
{
|
||||
// 卸载时没有任何我们写的值:直接算成功
|
||||
AppLog.Write("[extension] 没有找到本软件写入的策略,无需提权");
|
||||
return new HelperResult { Ok = true, Id = id, UpdateUrl = baseUrl + UpdatePath };
|
||||
}
|
||||
|
||||
File.WriteAllText(regFile, regText, Encoding.Unicode);
|
||||
|
||||
var regExe = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "reg.exe");
|
||||
var psi = new ProcessStartInfo(regExe, $"import \"{regFile}\"")
|
||||
{
|
||||
UseShellExecute = true, // runas 只能走 ShellExecute
|
||||
Verb = "runas",
|
||||
WindowStyle = ProcessWindowStyle.Hidden,
|
||||
CreateNoWindow = true,
|
||||
};
|
||||
|
||||
AppLog.Write($"[extension] 提权导入策略({(install ? "安装" : "卸载")}):{psi.FileName} {psi.Arguments}");
|
||||
|
||||
try
|
||||
{
|
||||
using var process = await Task.Run(() => Process.Start(psi), ct).ConfigureAwait(false)
|
||||
?? throw new InvalidOperationException("提权进程启动失败");
|
||||
|
||||
await process.WaitForExitAsync(ct).ConfigureAwait(false);
|
||||
|
||||
// 以注册表实际状态为准(reg 的退出码在不同系统上不完全可靠)
|
||||
var ok = install ? HasExactPolicy(id, baseUrl) : !HasAnyOfOurPolicy();
|
||||
if (!ok)
|
||||
{
|
||||
AppLog.Write($"[extension] reg import 退出码 {process.ExitCode},但注册表未生效({regText})");
|
||||
throw new InvalidOperationException(
|
||||
$"策略没有写进注册表(reg import 退出码 {process.ExitCode})。\n\n"
|
||||
+ "可能被安全软件拦截了注册表写入;也可以手动导入下面这个文件后重试:\n"
|
||||
+ regFile);
|
||||
}
|
||||
|
||||
return new HelperResult
|
||||
{
|
||||
Ok = true,
|
||||
Id = id,
|
||||
UpdateUrl = baseUrl + UpdatePath,
|
||||
Targets = BrowserPolicyRoots.Select(root => root.EndsWith("Chrome", StringComparison.OrdinalIgnoreCase) ? "Chrome" : "Edge").ToList(),
|
||||
};
|
||||
}
|
||||
catch (Win32Exception ex) when (ex.NativeErrorCode == ErrorCancelled)
|
||||
{
|
||||
throw new OperationCanceledException("已取消管理员授权,浏览器策略没有改动");
|
||||
}
|
||||
finally
|
||||
{
|
||||
TryDelete(regFile);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>拼 .reg 文本(空文本 = 没有要改的东西)</summary>
|
||||
private static string BuildReg(string baseUrl, string id, bool install)
|
||||
{
|
||||
var updateUrl = baseUrl + UpdatePath;
|
||||
var sources = baseUrl + SourcesSuffix;
|
||||
|
||||
var builder = new StringBuilder();
|
||||
var hasContent = false;
|
||||
|
||||
foreach (var root in BrowserPolicyRoots)
|
||||
{
|
||||
var forcelistPath = root + @"\ExtensionInstallForcelist";
|
||||
var sourcesPath = root + @"\ExtensionInstallSources";
|
||||
|
||||
var forcelistLines = BuildValueLines(forcelistPath, $"{id};{updateUrl}", install);
|
||||
var sourcesLines = BuildValueLines(sourcesPath, sources, install);
|
||||
|
||||
if (forcelistLines.Count == 0 && sourcesLines.Count == 0) continue;
|
||||
|
||||
if (!hasContent)
|
||||
{
|
||||
builder.AppendLine("Windows Registry Editor Version 5.00");
|
||||
hasContent = true;
|
||||
}
|
||||
|
||||
if (forcelistLines.Count > 0)
|
||||
{
|
||||
builder.AppendLine();
|
||||
builder.AppendLine($"[HKEY_LOCAL_MACHINE\\{forcelistPath}]");
|
||||
foreach (var line in forcelistLines) builder.AppendLine(line);
|
||||
}
|
||||
|
||||
if (sourcesLines.Count > 0)
|
||||
{
|
||||
builder.AppendLine();
|
||||
builder.AppendLine($"[HKEY_LOCAL_MACHINE\\{sourcesPath}]");
|
||||
foreach (var line in sourcesLines) builder.AppendLine(line);
|
||||
}
|
||||
}
|
||||
|
||||
return hasContent ? builder.ToString() : string.Empty;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 生成某个策略键要写的行(安装 = 写入/复用值名;卸载 = 删除我们写的值)
|
||||
///
|
||||
/// 安装时**复用已有的值名**(值就是我们想要的,或值是旧的我们 URL),
|
||||
/// 顺手把重复的历史值删掉 —— 否则每点一次「安装」都会多出一条一样的策略。
|
||||
/// </summary>
|
||||
private static List<string> BuildValueLines(string policyPath, string desiredValue, bool install)
|
||||
{
|
||||
var existing = PolicyValues(policyPath);
|
||||
|
||||
if (!install)
|
||||
{
|
||||
return existing
|
||||
.Where(item => item.Value.Contains(OurMarker, StringComparison.OrdinalIgnoreCase))
|
||||
.Select(item => $"\"{item.Key}\"=-")
|
||||
.ToList();
|
||||
}
|
||||
|
||||
var lines = new List<string>();
|
||||
|
||||
// ① 已经是目标值 → 直接用这个值名
|
||||
var target = existing
|
||||
.FirstOrDefault(item => string.Equals(item.Value.Trim(), desiredValue, StringComparison.OrdinalIgnoreCase))
|
||||
.Key;
|
||||
|
||||
// ② 否则复用「我们写的旧值」那个名字(比如域名换过)
|
||||
if (target is null)
|
||||
{
|
||||
target = existing
|
||||
.FirstOrDefault(item => item.Value.Contains(OurMarker, StringComparison.OrdinalIgnoreCase))
|
||||
.Key;
|
||||
}
|
||||
|
||||
// ③ 都没有才找一个空号(默认 "1",被别人占了就顺延)
|
||||
target ??= PickFreeValueName(existing.Keys);
|
||||
|
||||
lines.Add($"\"{target}\"=\"{Escape(desiredValue)}\"");
|
||||
|
||||
// 清掉重复的历史条目(同一个扩展我们可能写过多条)
|
||||
foreach (var item in existing)
|
||||
{
|
||||
if (string.Equals(item.Key, target, StringComparison.OrdinalIgnoreCase)) continue;
|
||||
if (!item.Value.Contains(OurMarker, StringComparison.OrdinalIgnoreCase)) continue;
|
||||
lines.Add($"\"{item.Key}\"=-");
|
||||
}
|
||||
|
||||
return lines;
|
||||
}
|
||||
|
||||
/// <summary>该策略键下的「值名 → 值」(读不到返回空字典)</summary>
|
||||
private static Dictionary<string, string> PolicyValues(string policyPath)
|
||||
{
|
||||
var result = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
|
||||
try
|
||||
{
|
||||
using var baseKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry64);
|
||||
using var key = baseKey.OpenSubKey(policyPath);
|
||||
if (key is null) return result;
|
||||
|
||||
foreach (var name in key.GetValueNames())
|
||||
{
|
||||
if (key.GetValue(name) is string text) result[name] = text;
|
||||
}
|
||||
}
|
||||
catch
|
||||
{
|
||||
// 读不到就当没有
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/// <summary>找一个没被占用的值名</summary>
|
||||
private static string PickFreeValueName(IEnumerable<string> used)
|
||||
{
|
||||
var taken = new HashSet<string>(used, StringComparer.OrdinalIgnoreCase);
|
||||
for (var i = 1; i < 100; i++)
|
||||
{
|
||||
if (!taken.Contains(i.ToString())) return i.ToString();
|
||||
}
|
||||
return Guid.NewGuid().ToString("N");
|
||||
}
|
||||
|
||||
/// <summary>装成功后该有的那条 forcelist 值在不在(读 HKLM 不需要管理员)</summary>
|
||||
private static bool HasExactPolicy(string id, string baseUrl)
|
||||
{
|
||||
if (id.Length == 0) return false;
|
||||
var expected = $"{id};{baseUrl}{UpdatePath}";
|
||||
|
||||
foreach (var root in BrowserPolicyRoots)
|
||||
{
|
||||
foreach (var view in new[] { RegistryView.Registry64, RegistryView.Registry32 })
|
||||
{
|
||||
try
|
||||
{
|
||||
using var baseKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, view);
|
||||
using var key = baseKey.OpenSubKey(root + @"\ExtensionInstallForcelist");
|
||||
if (key is null) continue;
|
||||
|
||||
foreach (var name in key.GetValueNames())
|
||||
{
|
||||
if (key.GetValue(name) is string text
|
||||
&& string.Equals(text.Trim(), expected, StringComparison.OrdinalIgnoreCase))
|
||||
{
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
catch
|
||||
{
|
||||
// 读不到就当没有
|
||||
}
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/// <summary>还有没有我们写的策略(卸载后应为 false)</summary>
|
||||
private static bool HasAnyOfOurPolicy()
|
||||
{
|
||||
foreach (var root in BrowserPolicyRoots)
|
||||
{
|
||||
foreach (var view in new[] { RegistryView.Registry64, RegistryView.Registry32 })
|
||||
{
|
||||
try
|
||||
{
|
||||
using var baseKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, view);
|
||||
using var key = baseKey.OpenSubKey(root + @"\ExtensionInstallForcelist");
|
||||
if (key is null) continue;
|
||||
|
||||
foreach (var name in key.GetValueNames())
|
||||
{
|
||||
if (key.GetValue(name) is string text
|
||||
&& text.Contains(OurMarker, StringComparison.OrdinalIgnoreCase))
|
||||
{
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
catch
|
||||
{
|
||||
// 读不到就当没有
|
||||
}
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/// <summary>.reg 字符串里的转义(反斜杠、引号)</summary>
|
||||
private static string Escape(string value)
|
||||
=> value.Replace("\\", "\\\\").Replace("\"", "\\\"");
|
||||
|
||||
private static void TryDelete(string path)
|
||||
{
|
||||
try
|
||||
{
|
||||
if (File.Exists(path)) File.Delete(path);
|
||||
}
|
||||
catch
|
||||
{
|
||||
// 临时文件删不掉不影响业务
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -35,7 +35,7 @@ Chrome / Edge 扩展(**Manifest V3 + 原生 JS,零构建**)。
|
||||
|
||||
---
|
||||
|
||||
## 0.1 打包与分发(企业策略安装)
|
||||
## 0.1 打包与分发
|
||||
|
||||
浏览器**不认「加载已解压」之外的本地目录**,所以正式分发必须打包成签名好的 `.crx`:
|
||||
|
||||
@ -55,19 +55,22 @@ npm run extension:zip # 压缩 + 出商店上传包(extension/out/*.zip
|
||||
而且 Chrome/Edge 商店要求提交的代码可读;压缩后已经去掉全部注释、缩短了标识符,
|
||||
真正需要保密的东西也不在插件里(前缀/正则/站点全部由服务端下发,私钥从不进包)。
|
||||
|
||||
- 私钥 `extension/keys/key.pem`(首次运行自动生成,**务必单独备份**):它决定**扩展 ID**,
|
||||
换了私钥 = 换了 ID = 已经下发到客户机的策略全部失效;
|
||||
- 服务器上:`/download/extension/updates.xml`(**不缓存**,浏览器靠它自动升级)、
|
||||
`/download/extension/YuncangTraceExtension-<version>.crx`(文件名带版本号,长缓存);
|
||||
- 客户机:桌面端「工具 → **安装谷歌插件**」→ 允许一次 UAC → 写 HKLM 策略:
|
||||
```
|
||||
Chrome/Edge ExtensionInstallForcelist = <扩展ID>;https://<域名>/download/extension/updates.xml
|
||||
Chrome/Edge ExtensionInstallSources = https://<域名>/download/extension/*
|
||||
```
|
||||
重启浏览器即自动装好(`chrome://extensions` 里显示「由你的组织管理」)。
|
||||
「工具 → 卸载谷歌插件」只会删掉值里带 `/download/extension/` 的那几条,不动别的策略。
|
||||
- 私钥 `extension/keys/key.pem`(首次运行自动生成,**务必单独备份**):它决定**扩展 ID**;
|
||||
- 服务器上:`/download/extension/updates.xml`(**不缓存**)、
|
||||
`/download/extension/YuncangTraceExtension-<version>.crx`(文件名带版本号,长缓存)——
|
||||
这条链路现在只用于**内网/离线分发**,客户端不再写企业策略;
|
||||
- 正式分发:
|
||||
- **Edge**:加载项商店(已上架)<https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj>,
|
||||
桌面端「工具 → 安装浏览器插件(Edge 应用商店)」直接打开,点「获取」即可;
|
||||
- **Chrome**:桌面端「工具 → 复制插件路径(Chrome / 开发者模式)」,到 `chrome://extensions`
|
||||
开开发者模式、加载已解压的扩展程序。
|
||||
|
||||
没有管理员权限的机器仍可用「工具 → 复制插件路径(开发者模式)」手动加载(拿到的是安装目录里的压缩版)。
|
||||
> ⚠️ 早期版本用 `ExtensionInstallForcelist` 写 HKLM 策略装自建 CRX(ID `lkei…`),**该功能已下线**。
|
||||
> 用过旧版本的机器策略仍在,会和商店版同时注入 —— 手动删掉 `...\Policies\Google\Chrome\ExtensionInstallForcelist`
|
||||
> 与 `...\Policies\Microsoft\Edge\ExtensionInstallForcelist` 里值带 `/download/extension/` 的项
|
||||
> 及同级 `ExtensionInstallSources`,重启浏览器即可。
|
||||
|
||||
没有管理员权限的机器仍可用「工具 → 复制插件路径(Chrome / 开发者模式)」手动加载(拿到的是安装目录里的压缩版)。
|
||||
|
||||
> 国内环境下 **Chrome 应用商店连不上**(实测 `chromewebstore.google.com`、`clients2.google.com` 均超时),
|
||||
> 官方分发走 **Edge 加载项商店**(可达、免费)。上架文案、权限说明、截图清单、审核应对
|
||||
|
||||
@ -10,12 +10,14 @@
|
||||
|
||||
| 路线 | 覆盖谁 | 国内可用 | 现状 |
|
||||
|---|---|---|---|
|
||||
| **Edge 加载项商店** | 所有 Edge 用户,**非受管/非开发者模式也能一键装** | ✅ | 待上架(免费) |
|
||||
| 企业策略 + 自建 CRX | 仅**受管设备**(加域 / Intune / 组策略) | ✅ | 已实现:菜单「安装谷歌插件」 |
|
||||
| 开发者模式手动加载 | 任何 Chromium 内核浏览器 | ✅ | 已实现:菜单「复制插件路径(开发者模式)」 |
|
||||
| **Edge 加载项商店** | 所有 Edge 用户,**非受管/非开发者模式也能一键装** | ✅ | **已上架**(免费) |
|
||||
| 开发者模式手动加载 | 任何 Chromium 内核浏览器 | ✅ | 已实现:菜单「复制插件路径(Chrome / 开发者模式)」 |
|
||||
|
||||
非受管电脑上 `ExtensionInstallForcelist` 会被 Chrome/Edge 拒绝(`[BLOCKED]`,提示"此设备并非由你的组织管理"),
|
||||
所以**普通员工电脑只有商店这条路**。
|
||||
所以**普通员工电脑只有商店这条路**;受管设备同样直接装商店版(IT 也能统一下发商店扩展)。
|
||||
|
||||
> 企业策略 + 自建 CRX 这条路线已下线:桌面端的「安装/卸载浏览器插件(企业策略)」菜单
|
||||
> 和 `Services/ExtensionInstaller.cs` 都已移除。
|
||||
|
||||
## 1. 上架前检查清单
|
||||
|
||||
@ -145,19 +147,20 @@ Policy: https://pack.wms.gztbyc.com/extension-privacy.html
|
||||
|
||||
1. **扩展 ID 会变**:商店用微软的密钥签名,ID 不再是 `lkeibbccgdddjamahnkibopcpidhgggk`(那是 `extension/keys/key.pem` 算出来的自建 ID)。
|
||||
- 商店版:用户在 Edge 加载项页面点「获取」即可,**不需要**写策略;
|
||||
- 自建 CRX(受管设备):继续用现有 ID 与 `updates.xml`,两条线互不影响。
|
||||
- 自建 CRX:只保留给内网/离线分发(`updates.xml` 仍会发布),客户端不再提供一键安装入口。
|
||||
2. **升级流程**:改代码 → 改 `manifest.json` 的 `version` → `cd backend && npm run extension:zip` →
|
||||
在 Partner Center 上传新 zip → 审核通过后用户自动升级(Edge 端的自建 CRX 仍走 `npm run extension:publish`)。
|
||||
在 Partner Center 上传新 zip → 审核通过后用户自动升级。
|
||||
3. 商店版和自建 CRX 版是**两个不同 ID 的扩展**,同一浏览器都装会同时注入、页面被标记两遍——
|
||||
过渡期务必先「工具 → 卸载谷歌插件」清掉旧策略,再装商店版。详见第 9 节。
|
||||
用过旧版企业策略的机器要先手工清掉 HKLM 里那几条 `ExtensionInstallForcelist` /
|
||||
`ExtensionInstallSources`(见 `desktop/README.md` 的「浏览器插件」一节),再装商店版。
|
||||
|
||||
## 7. 现场操作对照
|
||||
|
||||
| 场景 | 操作 |
|
||||
|---|---|
|
||||
| 员工电脑(非受管)、用 Edge | 打开加载项商店页面 → 「获取」 |
|
||||
| 员工电脑(加域 / 受管) | 桌面端「工具 → 安装谷歌插件」(写 HKLM 策略 + 自建 CRX) |
|
||||
| 临时/无管理员权限 | 桌面端「工具 → 复制插件路径(开发者模式)」→ `edge://extensions` 加载已解压 |
|
||||
| 员工电脑(加域 / 受管) | 同上,直接装商店版(也可由 IT 统一下发商店扩展) |
|
||||
| 临时/无管理员权限 | 桌面端「工具 → 复制插件路径(Chrome / 开发者模式)」→ `chrome://extensions` 加载已解压 |
|
||||
| 国产 Chromium 浏览器(360/QQ/搜狗) | 多数支持"加载已解压的扩展程序",用同一条路径 |
|
||||
|
||||
## 8. 提交时逐字段对照表(Package 上传之后)
|
||||
@ -218,16 +221,17 @@ PwIDAQAB
|
||||
|
||||
| 版本 | 扩展 ID | 由谁签名 | 装法 |
|
||||
|---|---|---|---|
|
||||
| 自建 CRX(企业策略) | `lkeibbccgdddjamahnkibopcpidhgggk` | 我们的 `extension/keys/key.pem` | 桌面端「工具 → 安装谷歌插件」写 HKLM 策略 |
|
||||
| 自建 CRX(内网/离线) | `lkeibbccgdddjamahnkibopcpidhgggk` | 我们的 `extension/keys/key.pem` | 客户端不再提供入口(企业策略已下线) |
|
||||
| Edge 商店版 | `mgdonmkicojkabgalgekobaoohaohfcj` | 微软密钥(上表公钥) | 用户在加载项商店点「获取」 |
|
||||
|
||||
- 用上面那把公钥实测推导,得到的正是 `mgdon…`,确认它就是商店的签名公钥;
|
||||
- **CRX 的 ID 由签名密钥决定**,别试图用 manifest 的 `key` 字段把两个 ID 统一(会与签名密钥冲突);
|
||||
- 两个 ID = 两个独立扩展(配置、注入各自一套)。过渡期先「卸载谷歌插件」再装商店版;
|
||||
- 目前自建 ID `lkei…` 只在开发机上装过(非受管电脑的策略安装本来就被浏览器拒绝),所以切到商店版几乎零成本。
|
||||
- 两个 ID = 两个独立扩展(配置、注入各自一套)。老机器如果被旧版策略装过自建 CRX,
|
||||
先按桌面端 README 的说明清掉 HKLM 策略再装商店版;
|
||||
- 目前自建 ID `lkei…` 只在开发机上装过(非受管电脑的策略安装本来就被浏览器拒绝),所以切到商店版几乎零成本;
|
||||
|
||||
### 发布后的接入动作(TODO)
|
||||
|
||||
1. 把安装页 URL 填进桌面端「工具」菜单:新增「安装浏览器插件(商店)」→ 用默认浏览器打开该链接;
|
||||
2. 链接可用性自查:`curl -I https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj` 返回 200 即上线;
|
||||
3. 现场分发话术:非受管电脑 → 商店安装;受管电脑 → 企业策略自建 CRX(或让 IT 下发商店版)。
|
||||
3. 现场分发话术:统一走 Edge 商店(点「获取」);Chrome 用户走开发者模式。
|
||||
@ -9,20 +9,17 @@
|
||||
|
||||
## 为什么入库
|
||||
|
||||
桌面端「工具 → 安装谷歌插件」会在客户机写一条企业策略:
|
||||
私钥决定**扩展 ID**(自建 CRX 分发与内网安装时用;Edge 商店版是另一个 ID,走商店审核
|
||||
`mgdonmkicojkabgalgekobaoohaohfcj`):
|
||||
|
||||
```
|
||||
HKLM\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist
|
||||
1 = lkeibbccgdddjamahnkibopcpidhgggk;https://<域名>/download/extension/updates.xml
|
||||
```
|
||||
|
||||
策略里写死了**扩展 ID**,而 ID 由这把私钥唯一决定:
|
||||
|
||||
- 私钥在 → 每次发布都是同一个 ID,客户机策略长期有效;
|
||||
- 私钥丢 → 重新生成 → **ID 变了** → 已下发到所有客户机的策略全部失效(要重新点一次安装)。
|
||||
- 私钥在 → 每次 `npm run extension:publish` 都是同一个 ID,内网分发的 `updates.xml` 长期有效;
|
||||
- 私钥丢 → 重新生成 → **ID 变了** → 已分发的 CRX 与 `updates.xml` 全部对不上,要重新发。
|
||||
|
||||
所以按「宁可入库也别丢」处理。⚠️ 代价是:**仓库必须保持私有**,能读这个仓库的人等于能签发
|
||||
一个"官方更新"推给所有客户机(Chrome 信任这个私钥签的包)。
|
||||
一个"官方更新"推给所有装了自建 CRX 的机器(浏览器信任这个私钥签的包)。
|
||||
|
||||
> 客户端**已不再**用它写企业策略(`ExtensionInstallForcelist` 功能已下线,Edge 上架商店后不需要),
|
||||
> 现在正式分发走商店 / 开发者模式。
|
||||
|
||||
## 绝对不能随安装包发给客户
|
||||
|
||||
@ -33,4 +30,4 @@ HKLM\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist
|
||||
|
||||
- 正常:`git clone` 下来就有 `key.pem`,直接 `npm run extension:publish` 即可;
|
||||
- 想换一把新的(**会让扩展 ID 变化**):删掉 `key.pem` 再发布,脚本会自动生成;
|
||||
之后客户机需要重新执行一次「工具 → 安装谷歌插件」(旧的 forcelist 值会被同名校验覆盖)。
|
||||
之后已分发的内网 `updates.xml` 要对新的 CRX 重新生成(商店版不受影响,它用商店自己的签名)。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user