
Бесплатный блокировщик рекламы с открытым исходным кодом для Safari на macOS, iOS, iPadOS и visionOS. До 750 000 правил, пользовательские списки фильтров, userscripts и userstyles. Без подписки.
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/9565/f9be27527e40a78f4f25d3a7763a377ffb492bc1891f8645f0214792a89cf548.png" alt="Логотип wBlock" width="112" />
# wBlock
### Конец бардаку с блокировкой рекламы в Safari.
Бесплатный блокировщик рекламы с открытым исходным кодом для Safari на Mac, iPhone, iPad и Apple Vision Pro.
<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](#faq) · [Поддержка](#support)
</div>
## Возможности
### Блокировка
До 750 000 правил Safari в пяти контент-блокировщиках, с рекомендуемыми списками, региональными списками, подобранными для вас, и опциональными фильтрами раздражителей и баннеров cookie.
<details>
<summary>Подробнее о блокировке</summary>
<br>
- Совместимые с AdGuard списки фильтров, скомпилированные в нативные правила Safari и распределённые по пяти контент-блокировщикам с лимитом в 150 000 правил каждый. Safari применяет правила вне процесса приложения.
- Рекомендуемые списки по умолчанию, автоматический выбор региональных фильтров и опциональные фильтры раздражителей и баннеров cookie. Добавляйте собственные списки по URL, вставленным текстом или импортом файла.
- Обновления по расписанию — от ежечасных до еженедельных, с инкрементальной загрузкой для списков, которые её поддерживают. На macOS launch agent проверяет обновления, пока приложение закрыто.
- Удаление трекинговых параметров, включая `utm_*`, и разворачивание сокращённых ссылок. Обе функции включены по умолчанию.
- Индикатор ёмкости и просмотрщик правил, который показывает скомпилированные правила, неподдерживаемые записи, дубликаты правил, правила, обрабатываемые расширением скриптов, и изменения из последнего обновления.
</details>
### Пользовательские скрипты
Совместимый с Greasemonkey движок, темы UserCSS и встроенный каталог с Tube Cleaner, DeArrow, Dark Reader и другими.
<details>
<summary>Подробнее о пользовательских скриптах</summary>
<br>
- Отдельное расширение скриптов поддерживает скриптлеты, косметическую фильтрацию, пользовательские скрипты, пользовательские стили и скрытие элементов.
- Совместимый с Greasemonkey движок с поддержкой API `GM_*` и `GM.*`. `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 и плееры в shadow-root, такие как у Archive.org. Он сохраняет скорость воспроизведения, громкость, субтитры и позицию для каждого сайта.
Оба скрипта обновляются из [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 МБ.
> [!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="Filters on 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="The Safari popup on iPhone" height="560" />
</picture>
<img src="https://assets.kitploit.com/production/public/readmes/9565/630d6f33e78c95d190de68c7d897865802df77edf39cee596e94fdaa3e583f84/ba00ede1e1b803daf3a6225cb2629bde1b228c928a39c85491e5f87d96492775-display-v1.webp" alt="SponsorBlock settings in Tube Cleaner" height="560" />
<br><br><sub>Всплывающее окно Safari на iPhone и SponsorBlock в Tube Cleaner</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="Userscripts on 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="Settings on 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 вы также можете скачать DMG из [последнего релиза](https://github.com/0xCUB3/wBlock/releases/latest) или использовать 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) включает правило, используемое для отключения фильтрации для конкретного сайта.
## FAQ
<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 МБ.
</details>
<details>
<summary>Как заблокировать рекламу на Twitch?</summary>
<br>
Включите TwitchAdSolutions (vaft) или AdGuard Extra на вкладке Userscripts, затем перезагрузите 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, можно настроить отдельно. Player Cleaner можно отключить для конкретного сайта через всплывающее окно на панели инструментов Safari, если возникают проблемы совместимости.
</details>
<details>
<summary>Как часто обновляются фильтры и должен ли wBlock оставаться открытым?</summary>
<br>
Обновления можно запланировать от ежечасных до еженедельных или выполнять вручную. Приложение не обязано оставаться открытым. В macOS агент запуска проверяет обновления, пока приложение закрыто; это поведение можно отключить в настройках.
В iOS и iPadOS фоновые обновления планируются операционной системой. Отключение «Обновления контента» или принудительное закрытие 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>