uBlock Origin 回来了！第三方开发者将其完整功能移植到 Manifest V3

uBlock Origin 回来了！

在 Chrome/Edge 相继淘汰了 Manifest V2 标准的老旧插件之后，首当其冲就是强大的广告过滤插件 uBlock Origin 被淘汰。原作者也不太愿意折腾，但终于有人出手了！@Appinn

一位名叫 r58Playz 的开发者，在原 uBlock Origin 的基础之上，利用 Chrome 给企业管理的扩展留了一个口子，做出了一个支持 Manifest V3 的非官方移植版本，保留了原版的完整功能。

唯一的代价是…启动略麻烦。

感谢 @风舞淼痕 同学的提醒，青小蛙开始还没看懂，没想到啊没想到。

如何安装 uBlock Origin MV3

• 官网地址 / GitHub

首先需要 Chrome 138 或更高版本。

uBlock Origin MV3 有两种安装方式：

1. 通过企业 Policy 强制安装，功能最完整，但 Windows/macOS 普通电脑配置起来非常麻烦，可参考官网地址
2. 手动安装 CRX + Chrome 启动参数，普通用户推荐这种。

下面主要介绍第二种。

第一步：下载 uBlock Origin MV3

首先下载开发者提供的 CRX 文件：

• https://ublock.r58playz.dev/uBlock0_1.74.0.crx

目前提供的是基于 uBlock Origin 1.74.0 制作的版本。

它的扩展 ID 为：

blockddmmcjpfkbhanlgegpmjpfpfjka

后面会用到。

第二步：把扩展加入 Chrome 白名单

如果使用的是正式版 Google Chrome，还需要先通过 Chrome Policy 将这个扩展加入允许安装列表，否则手动安装后 Chrome 可能会再次将它禁用。

Windows

按 Win + R，输入：

regedit

打开注册表编辑器，进入：

HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome

在这里创建：

ExtensionInstallAllowlist

最终路径为：

HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\ExtensionInstallAllowlist

然后在里面新建一个「字符串值」：

名称：1
数据：blockddmmcjpfkbhanlgegpmjpfpfjka

如果已经存在 1，就依次使用 2、3……

修改完成后彻底退出 Chrome，包括仍然驻留在后台的 Chrome 进程，然后重新启动。

打开：

chrome://policy

确认 ExtensionInstallAllowlist 已经生效。

macOS

macOS 同样需要设置 Chrome 的：

ExtensionInstallAllowlist

对应的配置位于：

/Library/Managed Preferences/com.google.Chrome.plist

其中需要加入：

ExtensionInstallAllowlist
    blockddmmcjpfkbhanlgegpmjpfpfjka

注意，这里设置的是 Allowlist，并不是 ExtensionInstallForcelist。

普通、未受企业管理的 Mac 无法简单通过 plist 强制安装这个扩展，因此我们仍然需要使用下面的启动参数。

第三步：添加 Chrome 启动参数

这是整个安装过程最关键的一步。

需要让 Chrome 每次启动时都携带：

--allowlisted-extension-id=blockddmmcjpfkbhanlgegpmjpfpfjka

这个参数会让 Chromium 向这个 MV3 扩展开放 webRequestBlocking 权限。

Windows

找到平时使用的 Chrome 快捷方式，右键 →「属性」。

在「目标」最后面加一个空格，然后加入：

--allowlisted-extension-id=blockddmmcjpfkbhanlgegpmjpfpfjka

例如原来是：

"C:\Program Files\Google\Chrome\Application\chrome.exe"

修改为：

"C:\Program Files\Google\Chrome\Application\chrome.exe" --allowlisted-extension-id=blockddmmcjpfkbhanlgegpmjpfpfjka

以后需要通过这个快捷方式启动 Chrome。

Chrome 启动后会提示正在使用不受支持的命令行参数，这是正常现象。

不要为了隐藏警告加入 --test-type，因为这个参数还会改变 Chrome 的其他行为。

macOS

先彻底退出 Chrome，然后可以通过终端测试：

open -a "Google Chrome" --args --allowlisted-extension-id=blockddmmcjpfkbhanlgegpmjpfpfjka

需要注意：

以后每次启动 Chrome，都必须带着这个参数。

所以实际长期使用时，可以制作一个带有该参数的启动脚本、快捷指令或其他启动器。

第四步：安装 CRX

现在打开：

chrome://extensions

打开右上角的：

开发者模式（Developer mode）

然后把第一步下载的：

uBlock0_1.74.0.crx

直接拖进这个页面。

Chrome 会询问是否安装扩展，确认即可。

第五步：打开 Allow User Scripts

安装完成后，进入 uBlock Origin 的扩展详情页面。

找到：

Allow User Scripts

将其打开。

这是因为这个 MV3 移植版本使用了 Chrome 的 chrome.userScripts API 来重新实现原版 uBlock Origin 的部分脚本注入功能。

第六步：等待 uBlock Origin 启动完成

刚刚启动时，uBlock Origin 图标可能会显示一个：

!

等待这个 ! 消失即可。

如果一直没有消失，可以进入：

chrome://extensions

手动重新加载一次 uBlock Origin。

至此，Manifest V3 版 uBlock Origin 就安装完成了。

为什么安装这么麻烦？

因为这个版本并没有把 uBlock Origin 改造成适用于 Manifest V3 的广告拦截器。

原版 uBlock Origin 最重要的能力之一，是通过：

webRequestBlocking

实时检查浏览器的网络请求，然后由自己的过滤引擎决定：

请求
 ↓
uBlock Origin
 ↓
过滤规则
 ↓
允许 / 拦截

但 Manifest V3 对普通扩展限制了这项权限，Chrome 更希望广告拦截器使用 declarativeNetRequest，也就是提前把过滤规则交给浏览器，由 Chrome 自己负责拦截。

这也是 uBlock Origin Lite 采用的方案。

然而 Chrome 给企业管理的扩展留了一个口子：通过 Policy 安装的 MV3 扩展仍然可以获得 webRequestBlocking。

@r58Playz 利用了这个机制，把原来的 uBlock Origin 过滤引擎放进 Manifest V3 Service Worker 中继续运行。

而：

--allowlisted-extension-id

这个启动参数，可以绕过 Chromium 对 webRequestBlocking 的权限检查。

所以整个方案可以简单理解成：

Manifest V3
       ↓
利用 Chrome 保留的 webRequestBlocking 通道
       ↓
运行原版 uBlock Origin 过滤引擎
       ↓
保留完整的 uBlock Origin 功能

这也是为什么它安装起来比 uBlock Origin Lite 麻烦得多。

还有一个小区别

上面介绍的「CRX + 启动参数」方案虽然可以正常获得 webRequestBlocking，但和真正通过企业 Policy 安装仍然存在一点区别。

真正的 Policy 安装允许 webRequestBlocking 在 uBO 刚启动时返回 Promise，因此可以暂时把网络请求“扣住”，等过滤引擎准备完成后再处理。

普通用户使用启动参数安装时做不到这一点。

所以在 uBO 刚刚启动的短暂时间里，这个移植版会临时取消部分子资源请求，等过滤引擎启动完成以后，再重新加载受到影响的标签页。

过滤引擎启动完成后，正常的网页过滤仍然是同步进行的。

对于日常使用来说，主要区别基本集中在 Chrome 和 uBO 刚启动的这段时间。

uBlock 不同版本间主要区别

如果，你现在使用 uBlock Origin Lite 时感觉到足够了，就别折腾了，青小蛙觉得太麻烦了。

原文：https://www.appinn.com/ublock-origin-mv3/