uBlock README

The project's README from github.com/gorhill/uBlock. As one markdown file: README.md.

Badge Commits Badge Issues Badge Localization Badge License Badge NPM Badge Mozilla Badge Chrome Badge Edge


uBlock Origin (uBO)

Browser Install from ... Status
Get uBlock Origin for Firefox Firefox Add-ons uBO works best on Firefox
Get uBlock Origin for Microsoft Edge Edge Add-ons "Moving the Microsoft Edge extensions ecosystem forward with Manifest Version 3": "Beginning in August 2026, Microsoft Edge will start the consumer transition away from Manifest Version 2 (MV2) extensions and toward MV3. Our goal is to complete the consumer transition by the end of 2026, with enterprise deprecation following in early 2027."
Get uBlock Origin for Opera Opera Add-ons
Get uBlock Origin for Chromium Removed "Manifest V2 support timeline": "Aug 31st 2026: All remaining Manifest V2 extensions removed from the Chrome Web Store"
About Google Chrome's "This extension may soon no longer be supported"
Get uBlock Origin for Thunderbird Thunderbird Add-ons No longer updated and stuck at 1.49.2. Later versions require "GitHub - Releases".
Get uBlock Origin through GitHub GitHub - Releases Stable and development versions on Firefox, Chromium MV2, and Thunderbird. Must be placed manually into web browsers; the Chromium and Thunderbird versions usually won't auto-update.

Related: uBlock Origin Lite


uBlock Origin (uBO) is a CPU and memory-efficient wide-spectrum content blocker for Chromium and Firefox. It blocks ads, trackers, coin miners, popups, annoying anti-blockers, malware sites, etc., by default using EasyList, EasyPrivacy, Peter Lowe's Blocklist, Online Malicious URL Blocklist, and uBO filter lists. There are many other lists available to block even more. Hosts files are also supported. uBO uses the EasyList filter syntax and extends the syntax to work with custom rules and filters.

You may easily unselect any preselected filter lists if you think uBO blocks too much. For reference, Adblock Plus installs with only EasyList, ABP filters, and Acceptable Ads enabled by default.

It is important to note that using a blocker is NOT theft. Do not fall for this creepy idea. The ultimate logical consequence of blocking = theft is the criminalization of the inalienable right to privacy.

Ads, "unintrusive" or not, are just the visible portion of the privacy-invading means entering your browser when you visit most sites. uBO's primary goal is to help users neutralize these privacy-invading methods in a way that welcomes those users who do not wish to use more technical means.


Documentation

Basic Mode Advanced Mode
The simple popup user interface for an install-it-and-forget-it type of installation that is configured optimally by default. The advanced popup user interface includes a point-and-click firewall that is configurable on a per-site basis.

Visit the Wiki for documentation.

For support, questions, or help, visit /r/uBlockOrigin.

Installation

Required Permissions

Firefox

Firefox Add-ons

Development Builds

uBO works best on Firefox and is available for desktop and Android versions.

Chromium

Chrome Web Store: Removed on 2026-08-31

Microsoft Edge Add-ons (Published by Nicole Rolls until version 1.62. Ownership transfer at version 1.64.)

Opera Add-ons

uBO should be compatible with any Chromium-based browser.

Thunderbird

Thunderbird Add-ons

In Thunderbird, uBlock Origin does not affect emails, just feeds.

All Programs

Do NOT use uBO with any other content blocker. uBO performs as well as or better than most popular blockers. Other blockers can prevent uBO's privacy or anti-blocker-defusing features from working correctly.

Manual Installation

Enterprise Deployment

Deploying uBO

Release History

Releases Page

Translations

Help translate uBO via Crowdin.

About

Manifesto

Privacy Policy

GPLv3 License

Free. Open-source. For users by users. No donations sought.

If you ever want to contribute something, think about the people working hard to maintain the filter lists you are using, which are available to use by all for free.

uBlock (gorhill/uBlock)

Searching Database…

68.7K ·GitHub
Что это такое?uBlock Origin (uBO) — бесплатное расширение браузера с открытым исходным кодом, которое блокирует рекламу, трекеры, майнеры криптовалют, всплывающие окна, скрипты, борющиеся с блокировщиками, и сайты с вредоносным ПО в браузерах на основе Chromium и в Firefox.
Это одно расширение или разные сборки для каждого браузера?Это одно и то же расширение, которое распространяется отдельно через магазин каждого браузера (Firefox, Edge, Opera), а также в ручных сборках для других браузеров на основе Chromium и для Thunderbird.
Оно всё ещё есть в Chrome Web Store?Нет. Все оставшиеся расширения на Manifest V2, включая uBO, были удалены из Chrome Web Store 31 августа 2026 года, поэтому пользователям Chromium теперь нужно устанавливать расширение вручную, и автоматические обновления они получать не будут.
Какие браузеры оно на самом деле поддерживает?Оно работает в Firefox на компьютере и на Android (это лучше всего поддерживаемая платформа), в любом браузере на основе Chromium, в Microsoft Edge, Opera и Thunderbird (где оно фильтрует только ленты новостей, но не письма).
Что блокируется по умолчанию и можно ли это изменить?По умолчанию используются списки EasyList, EasyPrivacy, Peter Lowe's Blocklist, Online Malicious URL Blocklist и собственные списки фильтров uBO, а также поддержка файла hosts; любой из этих списков можно отключить, если кажется, что блокируется слишком много.
Оно и правда бесплатное, без подвоха?Да, оно полностью бесплатное и с открытым исходным кодом по лицензии GPLv3; проект прямо заявляет, что пожертвований не просит.
В чём разница между базовым и расширенным режимом?Базовый режим — это установил и забыл: по умолчанию он уже оптимально настроен, а расширенный режим добавляет файрвол, который настраивается для каждого сайта мышью.
Можно ли использовать uBO вместе с другим блокировщиком рекламы?Нет, разработчики проекта советуют этого не делать: другие блокировщики могут мешать функциям защиты приватности и обезвреживания скриптов против блокировщиков, хотя сам uBO работает так же хорошо или лучше, чем большинство популярных блокировщиков.
Влияет ли uBO на мои письма в Thunderbird?Нет, в Thunderbird uBlock Origin фильтрует только ленты RSS/Atom и не трогает письма.
Считает ли автор блокировку рекламы кражей?Нет, в README это прямо отвергается: по мнению автора, блокировка — это защита неотъемлемого права на приватность от методов слежки, а не кража.
Creator
gorhill
Size
156.3 MB
Stars
68.7K
Age
11y
Commits · 90 Days