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)已于 2026 年 8 月 31 日从 Chrome Web Store 下架,因此 Chromium 用户现在需要手动安装,也无法自动更新。
它实际支持哪些浏览器?它可用于 Firefox 桌面版和安卓版(支持最好的平台)、任何基于 Chromium 的浏览器、Microsoft Edge、Opera 和 Thunderbird(在 Thunderbird 中它只过滤订阅源,不过滤邮件)。
默认会拦截什么?我能修改吗?默认情况下,它使用 EasyList、EasyPrivacy、Peter Lowe's Blocklist、Online Malicious URL Blocklist 以及 uBO 自带的过滤列表,并支持 hosts 文件。如果你觉得拦截得太多,可以取消勾选其中任何一个列表。
它真的免费吗?有没有什么套路?是的,它完全免费且开源,采用 GPLv3 许可证,项目明确表示不接受捐赠。
基础模式和高级模式有什么区别?基础模式安装后即可放心使用,默认已是最佳配置;高级模式则额外提供一个可按网站点选设置的防火墙。
我能同时运行 uBO 和另一个广告拦截器吗?不建议。项目明确反对这样做:其他拦截器可能会干扰 uBO 的隐私保护和反反拦截功能,尽管 uBO 单独使用时的表现就已与大多数热门拦截器相当,甚至更好。
uBO 会影响我的 Thunderbird 邮件吗?不会。在 Thunderbird 中,uBlock Origin 只过滤 RSS/Atom 订阅源,不会处理邮件。
作者是否认为广告拦截属于盗窃?不认为。README 明确拒绝这种说法,认为拦截是为了捍卫不可剥夺的隐私权,抵御侵犯隐私的追踪手段,而不是盗窃。
Creator
gorhill
Size
156.3 MB
Stars
68.7K
Age
11y
Commits · 90 Days