AdBlock-Acceleration

使用方法 · 公告历史 · English

为常见去广告工具（AdGuard、uBlock Origin、AdGuard Home 等）提供“国际/中国网络可用”的规则加速订阅：

• 零代理即可快速更新：通过多镜像分发，显著降低更新失败率与等待时间。
• 多镜像冗余：① GHUCS、② jsDelivr（有缓存，速度快）；③ cosr、④ gitmirror（无缓存，强一致）。
• 一键复制与搜索：内置 Web 索引页支持镜像选择、即时搜索、单条/批量复制。

• 2025年01月21日，对仓库.git进行缩减大小。

更多历史请见 公告历史。

过滤工具：

• 🌍 浏览器插件
  • AdGuard
  • uBlock Origin
  • AdBlock Plus
  • Adblock
• 📺 路由器端
  • AdGuard Home
  • KoolProxyR
  • Adbyby
  • 阿呆喵
• 📱 移动端
  • AdGuard for Android
  • AdGuard for iOS
• 💻 桌面端（全局去广告）
  • AdGuard for Windows
  • AdGuard for macOS

🙅‍♂️但是这类工具都存在一个痛点，因为规则基本都托管在境外服务器，导致更新极其缓慢，甚至无法成功更新。

😫 一个非常常见的场景：你为家中长辈、老人配置了去广告工具来避免他们在浏览网页时被钓鱼、欺诈或感染病毒。但是事实往往是，精心选择了很多规则，但实际上大部分规则都处于更新失败的状态，然后弹出提示框，长辈乱点，之后不一定怎样了……可能说电脑坏了，更新失败了……

💥 这个项目就是为了解决这一难题，无需通过任何代理即可光速更新规则。

项目使用了 GitHub Actions 在每天 UTC 时间每隔6小时更新下载一次最新规则，然后推送到 GitHub Repo。
配合使用多个网站提供的全球加速 CDN 来分发规则：

①GHUCS （具有缓存）
②jsDelivr （具有缓存）
③cosr （无缓存）
④gitmirror （无缓存）

从而在数秒内完成所有规则更新。

正常网络环境下（无任何代理，在中国大陆网络环境下）

• 使用加速链接前：更新 13 个规则最长可能需要 5 分钟 12 秒，而且有 4 个更新失败。
• 使用加速链接后：所有规则在 15秒内全部更新完成。

⚠️ 注意： 该规则不是针对网络代理工具的，不要给 Surge、ShadowRocket、Quantumult(X)、Clash(X/A) 等类似工具使用！ 直接拷贝下方表格中，对应规则的加速地址，作为去广告工具的订阅规则链接即可。

1. 打开 Web 规则索引页（见下文“Web 规则索引页”）。
2. 选择镜像（默认推荐 ① 或 ②），搜索并点击对应规则右侧“复制”。
3. 在你的去广告工具中粘贴为“自定义订阅/自定义过滤器/阻止列表 URL”。

• AdGuard（Android/iOS/macOS/Windows）
  • 路径：设置 → 过滤器 → 自定义过滤器 → 添加 → 粘贴加速地址 → 保存
• uBlock Origin（浏览器扩展）
  • 路径：Dashboard（仪表盘）→ Filter lists → Custom → Import/添加自定义 → 粘贴加速地址 → Apply changes
• AdGuard Home（路由器/家庭网关）
  • 路径：Filters → DNS blocklists → Add blocklist → 粘贴加速地址 → Save & Update

小贴士：同一规则可同时添加多条镜像链接作“冗余”，或保留 1 条主镜像 + 1 条备用镜像，降低单点故障影响。

• 在 Web 索引页使用“复制当前可见规则链接”即可一键复制表格中所有可见规则。
• 深链快捷：index.html?mirror=ghucs&copy=EasyPrivacy.txt（示例）——进入即选定镜像并复制该文件最终链接。

• 追求速度：优先 ① GHUCS、② jsDelivr（有缓存、命中率高）。
• 强制最新：使用 ③ cosr、④ gitmirror（无缓存，一般更”新”）。
• 若某镜像在你所在网络环境不可用，换另一个镜像即可；国内网络建议同时保留一个无缓存镜像作备用。

• 在线镜像：https://raw.cosr.eu.org
• 功能：
  • 镜像选择：GHUCS / jsDelivr / cosr / gitmirror
  • 单条一键复制；按“复制当前可见规则链接”批量复制
  • 即时搜索（按规则名或文件名）
  • 大小/更新时间来自根目录 manifest.json
  • 主题：浅色（默认）/ 深色 / 跟随系统
• 深链（复制直达）：index.html?mirror=ghucs&copy=EasyPrivacy.txt
  • 进入即按镜像复制最终链接到剪贴板

• 订阅更新失败或很慢？
  • 先切换镜像（①/② ↔ ③/④），或在工具中手动”立即更新”。必要时保留一个无缓存镜像作备用。
• 为什么”屏蔽网站的 Cookies 警告”不提供加速？
  • 其再分发许可存在限制，已在 CI 暂停同步，仅保留原始地址，使用者请按其许可自取。
• 更新频率？
  • CI 每 6 小时拉取上游并推送，通常 15 秒内即可通过镜像完成更新分发（命中缓存时更快）。
• 规则不生效？
  • 确认已点击”Update now”或”Save & Update”强制刷新；检查规则是否与内置规则冲突；清除扩展缓存后重新订阅。
• 哪个镜像速度最快？
  • 因地区而异。国内用户优先尝试 cosr、gitmirror；jsDelivr 全球覆盖好但国内偶有波动；GHUCS 为 GitHub 官方 CDN 稳定性最高。最佳方案：同时添加 2–3 个镜像。

除标准 EasyList / EasyPrivacy 外，建议中国用户额外订阅以下规则以获得更好的中文网站过滤效果：

各规则与广告拦截工具的兼容性：

说明： hosts 格式文件仅支持 DNS 级过滤工具（AdGuard Home / AdGuard APP），不支持浏览器扩展。

• 规则数量影响加载速度： 浏览器扩展加载过多规则会占用内存并降低页面加载速度。建议采用”内置规则 + 2–4 条补充”的策略。
• 推荐组合：
  • 基础：EasyList + EasyPrivacy + AdGuard Base Filter（多数工具已内置，无需重复添加）
  • 中国用户加：EasyList China + AdGuard Chinese Filter
  • 可选补充：乘风规则 或 Fanboy's Annoyances（二选一即可）
  • DNS 用户：StevenBlack 或 Hblock（AdGuard Home 专用）
• 多镜像冗余： 为同一规则添加 2–3 个镜像 URL，当某个源失效时工具会自动尝试备用源，确保订阅持续可用。

• 校验和：见 checksums.txt（由 CI 生成）。本地校验示例：

sha256sum -c checksums.txt

• 清单：见 manifest.json，包含文件大小、哈希与时间戳，便于程序化消费。

希望大家可以提交 Issue 或者 Request 来帮助我完善规则

提交认为你们需要更新加速的规则。下面几点需要注意：

1. 规则需要在境外服务器，难以成功更新或更新缓慢的。
2. 注明规则的名称、来源、作用
3. 如果你需要加速的规则是 GitHub 的项目中的文件，请直接使用 jsDelivr 的语法加速项目文件即可，无需提交请求。 https://cdn.jsdelivr.net/gh/用户名/项目名@版本/加速文件

• 提交 Issue 时请尽量附上：
  • 所在地区与运营商、使用的镜像、工具类型与版本
  • 失败截图或报错信息、可复现步骤
  • 涉及的规则名称与链接

• @Hackl0us

• 本项目的所有代码除另有说明外,均按照 GPL-3.0 license 发布。
• 本项目的 README.md、wiki 等资源基于 CC BY-NC-SA 4.0 这意味着你可以拷贝、并再发行本项目的内容，
  但是你将必须同样提供原作者信息以及协议声明。同时你也不能将本项目用于商业用途，按照我们狭义的理解
  (增加附属条款)，凡是任何盈利的活动皆属于商业用途。
• 请在遵守当地相关法律法规的前提下使用本项目。

本项目遵循 Contributor Covenant 行为准则。