<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/9565/f9be27527e40a78f4f25d3a7763a377ffb492bc1891f8645f0214792a89cf548.png" alt="wBlock 标志" width="112" />
# wBlock
### 终结 Safari 广告拦截的糟心事
一款免费、开源的广告拦截器,适用于 Mac、iPhone、iPad 和 Apple Vision Pro 上的 Safari。
<a href="https://apps.apple.com/us/app/wblock/id6746388723?itscg=30200&itsct=apps_box_badge&mttnsubad=6746388723">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/white/en-us?releaseDate=1760313600" width="220" />
<source media="(prefers-color-scheme: light)" srcset="https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/black/en-us?releaseDate=1760313600" width="220" />
<img src="https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/black/en-us?releaseDate=1760313600" alt="在 App Store 下载" width="220" />
</picture>
</a>
<br>
<br>
[](https://github.com/0xCUB3/wBlock/releases/latest)


[](https://discord.gg/Y3yTFPpbXr)
[](https://fmhy.net/beginners-guide#browsers)
[](https://github.com/dkhamsing/open-source-ios-apps)
<br>
<img src="https://assets.kitploit.com/production/public/readmes/9565/52c7b447f669b7e207d2b83aabc2802c556edd9516e579c47f9895920637f641/42582adf96376cd477fc79cc9aa542c878daae0b1f25ca4f5e3880a4a7d198e5-display-v1.webp" alt="wBlock 在 macOS 上的浅色与深色模式" width="900" />
<br>
<br>
[功能](#features) · [截图](#screenshots) · [安装](#install) · [工作原理](#how-it-works) · [常见问题](#faq) · [支持](#support)
</div>
## 功能
### 拦截
跨五个内容拦截器最多支持 750,000 条 Safari 规则,提供推荐列表、为你精选的区域列表,以及可选的烦扰元素和 Cookie 横幅过滤器。
<details>
<summary>关于拦截的更多信息</summary>
<br>
- 兼容 AdGuard 的过滤列表会被编译为 Safari 原生规则,并分散到五个内容拦截器中,每个上限为 150,000 条规则。Safari 在应用进程之外应用这些规则。
- 提供推荐的默认列表、自动区域过滤器选择,以及可选的烦扰元素和 Cookie 横幅过滤器。可通过 URL、粘贴文本或导入文件添加自定义列表。
- 支持从每小时到每周的定时更新,对支持增量下载的列表进行增量下载。在 macOS 上,启动代理会在应用关闭时检查更新。
- 移除跟踪参数(包括 `utm_*`)并解析短链接。两者默认开启。
- 提供容量指示器和规则查看器,可显示已编译规则、不支持的条目、重复规则、由脚本扩展处理的规则,以及最新更新带来的变更。
</details>
### 用户脚本
兼容 Greasemonkey 的引擎、UserCSS 主题,以及内置目录,包含 Tube Cleaner、DeArrow、Dark Reader 等。
<details>
<summary>关于用户脚本的更多信息</summary>
<br>
- 独立的脚本扩展支持 scriptlet、外观过滤、用户脚本、用户样式和元素隐藏。
- 兼容 Greasemonkey 的引擎,支持 `GM_*` 和 `GM.*` API。`GM_xmlhttpRequest` 仅限于脚本 `@connect` 元数据中声明的主机。
- 支持 UserCSS 主题(`.user.css`),兼容 Less 和 Stylus。参见 [docs/USERSTYLES.md](https://github.com/0xcub3/wblock/blob/main/docs/USERSTYLES.md)。
- 内置目录包含 Tube Cleaner、Player Cleaner、DeArrow、Dark Reader、Return YouTube Dislike、Bypass Paywalls Clean、AdGuard Extra、AdGuard Popup Blocker 和 TwitchAdSolutions。目录中的脚本默认关闭,但 tinyShield 除外,它负责处理反广告拦截检查。
</details>
### 原生视频
Tube Cleaner 和 Player Cleaner 为视频提供 Safari 自带的控件,包括画中画、后台音频和 SponsorBlock。
<details>
<summary>关于原生视频的更多信息</summary>
<br>
Tube Cleaner 和 Player Cleaner 会在页面渲染之前为现有视频元素启用 Safari 的原生控件,包括画中画、后台音频、全屏播放和“正在播放”。
Tube Cleaner 适用于 YouTube,并保留其原始视频流。它将章节和字幕放入 Safari 的原生菜单,并通过 SponsorBlock 跳过赞助片段,可按类别进行设置。DeArrow 可单独使用,以提供替代标题和缩略图。
Player Cleaner 支持 video.js、JW Player、Plyr、Flowplayer、MediaElement、Clappr、Media Chrome,以及 Archive.org 等使用 shadow-root 的播放器。它会按站点保存播放速度、音量、字幕和播放位置。
两个脚本均独立于应用版本,从 [wBlock-userscripts](https://github.com/0xCUB3/wBlock-userscripts) 更新。广告拦截仍由过滤列表负责。
</details>
### 按站点控制与同步
Safari 弹窗可为每个站点开启或关闭过滤、用户脚本和自动播放,Element Zapper 则可隐藏其他任何内容。列表、脚本和设置通过 iCloud 同步。
<details>
<summary>关于按站点控制与同步的更多信息</summary>
<br>
Safari 工具栏弹窗为过滤、用户脚本和自动播放提供独立的开关,此外还有 Element Zapper。过滤列表和用户脚本可以限制为仅对选定站点生效,或从特定域名中排除。Zapper 规则可在“设置”中编辑。在 iPhone 和 iPad 上,Element Zapper 也位于分享表单中,因此来自其他应用内置浏览器的页面也可以被清除。这些规则会在 wBlock 下次执行“应用”后同步到其他应用。
wBlock 可在 macOS、iOS、iPadOS 和 visionOS 上运行。iCloud 同步涵盖过滤列表、自定义过滤器、用户脚本、允许列表和设置。此外还提供本地备份导出功能。
</details>
### 隐私优先的设计
wBlock 不收集任何数据。Safari 在应用之外应用这些规则,空闲内存占用约为 40 MB。
> [!TIP]
> [对比指南](https://github.com/0xcub3/wblock/blob/main/Adblock_Comparison.md)涵盖了 wBlock、uBlock Origin Lite、Wipr 和 AdGuard。
## 截图
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/filters_macos_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/82e5de58ecd0e34c8b3e11869d2b944ac5ef54c0391a6e1027ff483a0a4c9601/51024bdb66ef35314102814037052822f648b087c62ef8428745a48560c4deab-display-v1.webp" alt="macOS 上的过滤器" width="760" />
</picture>
<br><sub>macOS 上的过滤器</sub>
</p>
<br>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/scripts_popup_ios_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/976e753bbfe670701961a4c7c9f1b93233eef1ca9983f1adf27758905bb96973/1b19d722633b19330382d5281738f539a403c96c26fc1eceb81f8945483ada3b-display-v1.webp" alt="iPhone 上的 Safari 弹窗" height="560" />
</picture>
<img src="https://assets.kitploit.com/production/public/readmes/9565/630d6f33e78c95d190de68c7d897865802df77edf39cee596e94fdaa3e583f84/ba00ede1e1b803daf3a6225cb2629bde1b228c928a39c85491e5f87d96492775-display-v1.webp" alt="Tube Cleaner 中的 SponsorBlock 设置" height="560" />
<br><br><sub>iPhone 上的 Safari 弹窗,以及 Tube Cleaner 中的 SponsorBlock</sub>
</p>
<br>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/userscripts_macos_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/0a43bfebcee0c1168a4d27d03874a69ff837c625d6a3ec37b9834126f1760d3f.png" alt="macOS 上的用户脚本" width="760" />
</picture>
<br><sub>macOS 上的用户脚本</sub>
</p>
<br>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/img/settings_macos_dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/9565/34551e39e45c30e4a70cbd7600583229103edb5608582a2f01e68b99493a69cf.png" alt="macOS 上的设置" width="760" />
</picture>
<br><sub>macOS 上的设置</sub>
</p>
## 安装
[App Store](https://apps.apple.com/us/app/wblock/id6746388723) 版本是安装 wBlock 的推荐方式。它会自动更新,并由 Apple 签名和审核。在 iPhone、iPad 和 Apple Vision Pro 上,App Store 是获取它的唯一途径。
在 Mac 上,你也可以从[最新版本](https://github.com/0xCUB3/wBlock/releases/latest)下载 DMG,或使用 Homebrew:
```sh
brew install --cask wblock
```
Homebrew 从 [homebrew/cask](https://github.com/Homebrew/homebrew-cask/blob/main/Casks/w/wblock.rb) 安装;无需额外的 tap。如果你使用过旧的 tap,请遵循[迁移说明](https://github.com/0xcub3/wblock/blob/main/docs/HOMEBREW.md#move-from-the-old-tap)。
首次启动时,wBlock 会引导你在 Safari 中开启其扩展。
## 工作原理
该应用下载过滤列表,并使用 [SafariConverterLib](https://github.com/AdguardTeam/SafariConverterLib) 4.3.0 进行转换。规则分布在五个内容拦截器中:Ads、Privacy、Security、Foreign 和 Custom。Safari 独立于应用编译并应用这些规则。wBlock Scripts 扩展负责处理静态规则无法表达的内容。
过滤数据以 Protocol Buffers 格式存储并采用 LZ4 压缩,流式写入可在编译期间保持较低的内存峰值。更改列表时仅重建受影响的内容拦截器。更改生效前,Safari 必须重新加载更新后的规则集。
[对比指南](https://github.com/0xcub3/wblock/blob/main/Adblock_Comparison.md#how-wblock-works-around-static-rules)包含了用于关闭特定网站过滤的规则。
## 常见问题
<details>
<summary>wBlock 是否应与其他广告拦截器一起使用?</summary>
<br>
否。一次只使用一个通用内容拦截器。
多个拦截器可能会对同一页面或请求做出相互冲突的更改。Mozilla 的 [webRequest 文档](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/webRequest/onHeadersReceived)描述了相互冲突的响应修改可能只允许一个扩展的更改成功。[uBlock Origin 文档](https://github.com/gorhill/ublock#all-programs)建议不要与其一起使用其他内容拦截器。[AdGuard 的指南](https://adguard.com/en/adguard-browser-extension/opera/overview.html)指出加载变慢、网站损坏和视频播放问题可能是其后果。
在报告 wBlock 问题之前,请禁用其他广告拦截器。这样可以隔离拦截失败或网站兼容性问题的原因。
<img width="1560" height="176" alt="Skill Issue" src="https://assets.kitploit.com/production/public/readmes/9565/a6de7686522f14ac83be4be091c405aef8881625609202420c0bbd5bf4086cd2/7329a16d44d089a6c58e51bd5ac843782b725f112f06eeac58c6fd12ec171850-display-v1.webp" />
</details>
<details>
<summary>是否应启用额外的过滤列表?</summary>
<br>
推荐的默认设置覆盖了大多数广告和跟踪器。额外的通用列表通常会重复现有规则、消耗 Safari 的规则容量,并增加网站兼容性问题的风险。烦扰列表为 Cookie 横幅、弹窗和社交小部件提供覆盖。区域列表为非英语网站提供额外覆盖。
</details>
<details>
<summary>为什么 wBlock 不提供 HaGeZi 的拦截列表?</summary>
<br>
HaGeZi 的列表是优质的列表,主要面向 DNS 拦截。在 Safari 中,它们占用的规则空间可由面向浏览器的列表更好地利用。HaGeZi 建议移动广告拦截器使用内容过滤列表,而在 DNS 层面使用 DNS 列表,wBlock 遵循同样的划分。wBlock 不再提供 HaGeZi Multi Pro Mini,更新会将其从曾启用它的设备上移除。
完整说明及来源见 [docs/HAGEZI.md](https://github.com/0xcub3/wblock/blob/main/docs/HAGEZI.md)。
</details>
<details>
<summary>wBlock 会拖慢 Safari 吗?</summary>
<br>
正常使用下不会。Safari 在 wBlock 应用进程之外应用编译后的规则,因此页面加载不会等待该应用。空闲内存占用约为 40 MB。
</details>
<details>
<summary>如何拦截 Twitch 广告?</summary>
<br>
在 Userscripts 标签页中启用 TwitchAdSolutions (vaft) 或 AdGuard Extra,然后重新加载 Twitch。TwitchAdSolutions 是专用选项。一次只使用其中一个脚本。Twitch 经常更改其广告投放方式,因此在脚本更新之前,拦截可能会暂时受到影响。
</details>
<details>
<summary>为什么 Cookie 横幅过滤器或脚本在无痕浏览中不起作用?</summary>
<br>
Safari 要求扩展在无痕浏览中运行时必须获得明确授权。大多数 Cookie 横幅过滤器依赖 wBlock Scripts 提供的脚本片段。在 Safari → 设置 → 扩展中,为 wBlock Scripts 和全部五个内容拦截器启用“在无痕浏览中允许”,然后重新加载无痕窗口。
已存储的同意 Cookie 可能解释了为什么在普通窗口中看不到横幅。在比较普通浏览与无痕浏览行为之前,请先清除该网站的 Cookie。
</details>
<details>
<summary>用户脚本的网络请求是如何处理的?</summary>
<br>
`GM_xmlhttpRequest` 需要 `@grant GM_xmlhttpRequest` 或 `@grant GM.xmlHttpRequest`。请求仅限于脚本 `@connect` 元数据中声明的主机。仅写主机名即允许该主机及其子域;`localhost`、`self` 和 `*` 也受支持。若没有 `@connect`,请求仅限于当前主机。目前尚不支持按域名的权限提示。
仅支持 HTTP 和 HTTPS。在请求跟随重定向之前,会先检查重定向目标。如果 Safari 未向扩展暴露重定向目标,请求将失败,而不会绕过主机限制。请求不包含浏览器 Cookie 或已保存的凭据。标记为 `anonymous` 的请求还会排除脚本提供的 Cookie。
</details>
<details>
<summary>Tube Cleaner 和 Player Cleaner 位于何处?</summary>
<br>
这两个脚本列在“用户脚本”标签页“通用”部分的顶部,默认处于禁用状态。启用脚本后,章节、字幕和 SponsorBlock 等各项功能可以单独配置。如果出现兼容性问题,可以通过 Safari 工具栏弹出菜单针对特定网站禁用 Player Cleaner。
</details>
<details>
<summary>过滤器多久更新一次,wBlock 必须保持打开吗?</summary>
<br>
更新可以安排为每小时到每周一次,也可以手动执行。应用无需保持打开。在 macOS 上,启动代理会在应用关闭时检查更新;此行为可以在设置中禁用。
在 iOS 和 iPadOS 上,后台更新由操作系统调度。禁用“后台 App 刷新”或从应用切换器中强制退出 wBlock,可能会降低更新频率或将更新推迟到应用打开时。
</details>
## 支持
<div align="center">
wBlock 是免费且开源的。如果它对你有帮助,你可以在 Open Collective 上支持开发。
<br>
<a href="https://opencollective.com/skula/projects/wblock">
<img src="https://assets.kitploit.com/production/public/readmes/9565/888185d078b1763d0469847749dec546281355c97b40f1aeea46a80665c78d92.png" alt="Donate on Open Collective" width="220" />
</a>
<br>
<br>
[报告缺陷或请求新功能](https://github.com/0xCUB3/wBlock/issues) · [加入 Discord](https://discord.gg/Y3yTFPpbXr) · [隐私政策](https://github.com/0xcub3/wblock/blob/main/PRIVACY_POLICY.md)
</div>
## 致谢
<div align="center">
<sub>贡献者包括 [@arjpar](https://github.com/arjpar)、[@ameshkov](https://github.com/ameshkov) 和 [@shindgew](https://github.com/shindgew)。规则转换和脚本片段来自 [AdGuard](https://github.com/AdguardTeam)。SponsorBlock 和 DeArrow 数据来自 [Ajay Ramachandran](https://sponsor.ajay.app/) 的项目,采用 CC BY-NC-SA 4.0 许可。</sub>
<br>
<br>
</div>
<div align="center">
<a href="https://www.star-history.com/?repos=0xCUB3%2FwBlock&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=0xCUB3/wBlock&type=date&theme=dark&legend=top-left&sealed_token=FHF3tvPu6mhBn3K4_1fpH1nj2W36bTa6aW6_u-990mCb5zN_PRort245hoHzQEhFBRJo38qUYoOzU1huHG4_mHDsYpO7YxzKOIJEUaQI4NQNRDSdt9aZ_T1PVVSIaXqpdYnrBTTIlKhCEkYdneNsXEnpXhiUB3GW2F-tnsMNC4DPQJUKAmJK90omDnb2" />
<img alt="Star history" src="https://api.star-history.com/chart?repos=0xCUB3/wBlock&type=date&legend=top-left&sealed_token=FHF3tvPu6mhBn3K4_1fpH1nj2W36bTa6aW6_u-990mCb5zN_PRort245hoHzQEhFBRJo38qUYoOzU1huHG4_mHDsYpO7YxzKOIJEUaQI4NQNRDSdt9aZ_T1PVVSIaXqpdYnrBTTIlKhCEkYdneNsXEnpXhiUB3GW2F-tnsMNC4DPQJUKAmJK90omDnb2" />
</picture>
</a>
</div>