ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

uBlock Origin 浏览器适配实战:MV2 与 MV3 如何选?

uBlock Origin 浏览器适配实战:MV2 与 MV3 如何选? uBlock Origin 浏览器适配实战MV2 与 MV3 如何选【免费下载链接】uBlockuBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.项目地址: https://gitcode.com/GitHub_Trending/ub/uBlock打开一个新闻站点uBlock Origin 图标上的拦截数却纹丝不动停在0点开面板动态过滤一栏灰着不亮——这是 MV3 环境下最高频的兼容性翻车现场。uBlock Origin 是一款面向 Chromium 与 Firefox 的广谱内容拦截器拦截广告、追踪器、挖矿脚本与弹窗。装哪个构建版本直接决定动态过滤、脚本注入这些核心能力是否还能用。环境摸底——你的配置能不能跑起来不同构建版本对浏览器内核能力要求差异很大装之前先对下表运行项最低要求依据FirefoxMV2 完整版Firefox 115.0官方 manifest 的strict_min_versionChromium / Edge / OperaMV2Chrome 93.0manifest 的minimum_chrome_version版本号为 1.15.11.0ChromiumMV3 / uBO LiteChrome 122.0依赖declarativeNetRequestAPINode.js源码构建≥ 22lint/构建MV3 构建 ≥ 17.5根目录package.json的engines声明npm≥ 11同上 快速验证只需两条路径Firefox 地址栏输入about:version核对版本号Chromium 系进入chrome://extensions/查看扩展卡片上的版本与加载状态。想从源码出包执行git clone https://gitcode.com/GitHub_Trending/ub/uBlock cd uBlock git submodule update make chromium⚠️ 常见环境陷阱现象图标常驻0 拦截。→原因装的是 MV3 Lite它靠预编译静态规则集工作动态加载的追踪域名管不到。→修复换回 MV2 版本或把高频域名改写成##js脚本规则。现象make firefox构建直接失败。→原因子模块第三方依赖库没拉取或缺 Node 22。→修复先跑git submodule init git submodule update再确认node -v版本达标。按角色拆解——你的使用场景对应哪套配置个人轻量用户核心诉求装完就忘不想管规则列表。推荐配置Chrome 122 装 uBO LiteMV3manifest 版本 1.0或 Firefox 115 装 MV2 完整版1.9.15.101。收益常驻内存低、随商店自动更新代价Lite 版放弃动态过滤。快速验证安装后打开任一广告密集新闻站图标拦截数应为正数。高级规则用户核心诉求点选式动态防火墙 自定义 scriptlet 调试。推荐配置Firefox 115 的 MV2 版本1.9.15.101开启 logger 侧边栏。收益##js全量 scriptlet、按站点动态规则、侧边栏日志一应俱全代价需自行维护列表规则多时内存占用更高。快速验证右键图标打开日志面板确认请求逐条列出、可点击跳转规则。企业部署用户核心诉求批量下发规则、统一权限管控。推荐配置Chromium 93 的 MV2 版本1.15.11.0 组策略模板仓库内managed_storage.json即策略模式配置。收益策略统一生效、便于审计代价Chrome 商店 2026-08-31 移除 MV2 后无法再自动更新需提前缓存安装包。快速验证chrome://policy/中能看到生效的策略条目。如果你更在意自动更新与轻量选 MV3如果更在意动态防火墙和完整调试能力就锁定 Firefox MV2。能力边界——哪些功能在你当前的环境下受限功能Firefox MV2Chromium MV2Chromium MV3Lite动态过滤按站点防火墙✅ 完整✅ 完整❌ 不支持脚本注入##jsscriptlet✅ 完整✅ 完整⚠️ 部分受限日志面板 / 侧边栏✅ 侧边栏⚠️ 仅弹窗❌ 无网络请求拦截方式webRequestBlockingwebRequestBlocking⚠️ 仅 DNR 静态规则矩阵中受限项的具体含义动态过滤MV3 禁止在页面脚本中长期驻留并拦截请求边看边点的按站点防火墙在 Lite 中不存在。部分 scriptletMV3 的服务工作者service worker生命周期短依赖长驻注入的脚本类型无法照搬仓库中platform/mv3/scriptlets/只保留了可改造的模板。日志侧边栏Firefox 的sidebar_action是 Gecko 独有能力Chromium 系任何版本都没有。变通技巧把常用动态规则固化成静态规则放入自定义列表配合##js脚本规则按模块管理如视频站-防弹窗、媒体站-反追踪各建一个列表再每周手动更新一次内置列表MV3 下也能覆盖绝大多数场景。故障速查——遇到这些现象怎么救现象拦截数恒为 0广告照常加载。定位打开仪表板看各规则列表状态红字表示该列表加载失败。处理仪表板 → 过滤器列表 → 点更新强制拉取列表确认没有与另一个拦截扩展共存官方明确警告共存会导致隐私与反封锁功能失效重启浏览器后复测。现象个别网站白屏或无法登录拦截过度。定位打开日志面板查看关键请求命中的规则 ID。处理进入宽松拦截模式工具栏图标下拉菜单确认是否过度拦截所致用动态过滤给该站点放行对应域名的 XHR若反复出现把该站点加入按站点规则白名单。现象Chrome 上 MV3 装不上或商店页面提示即将下架 MV2。定位chrome://extensions/核对版本与报错文案。处理确认 Chrome ≥ 122手动下载离线安装包以加载已解压的扩展方式部署排期在 2026-08-31 前完成 MV2 到 Lite 的迁移演练。现象本地make mv3-chromium构建失败提示缺少 assets。定位检查dist/build/下是否有mv3-data缓存与日志。处理补拉子模块后重跑 make确认 Node ≥ 17.5建议直接用 22阅读包内log.txt定位具体失败步骤。如果以上都没解决先检查浏览器版本是否低于 93/115/122 这条基线以及是否还装着其他内容拦截器。性能与资源——把开销压下去关掉不用的地区/语言规则列表 → 默认 5 个列表EasyList、EasyPrivacy、Peter Lowe、恶意 URL 列表、uBO 官方列表合计约 10 万条规则按需裁剪可减少约 30% 的规则匹配开销。高频站点关闭外观cosmetic过滤 → 省去 CSS 注入与 DOM 改写单页内存占用可降 15% 左右。自动更新从每天改为每周 → 背景任务的网络请求与解析耗时按比例下降规则时效性几乎无感。⚠️ 不建议做的操作在 uBlock Origin 之外再叠加一个拦截类扩展。官方立场是不要与任何其他拦截器混用——另一个拦截器会破坏 uBO 的反封锁与隐私特性多花的内存换不来叠加的拦截率。回到开篇那个0 拦截的新闻站先核对版本基线再核对列表加载状态绝大多数适配问题到此为止。如果你还在 Chromium 系且 MV2 即将离店现在就可以用独立用户资料装一份 Lite逐条核对缺失的动态规则为迁移留出余量。【免费下载链接】uBlockuBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.项目地址: https://gitcode.com/GitHub_Trending/ub/uBlock创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表