-
Notifications
You must be signed in to change notification settings - Fork 3.3k
Dashboard: Settings
If checked, this gives permission for uBlock Origin (uBO) to add items in the browser's context menu which are meant to improve convenience.
Currently mostly useful for users who checked "I am an advanced user" (see below).
See Cloud storage documentation.
If you check this, this will enable uBO's dynamic filtering, and the dynamic filtering pane will become available from uBO's popup UI.
Unchecking this disables dynamic filtering. And the dynamic filtering pane in the popup UI will no longer be available.
Advanced user mode also gives access to the advanced settings (normally hidden), and enables the ability to filter behind-the-scene network requests.
You should avoid playing with advanced features and settings unless you understand fully what you are doing.
Checking this will disable prefetching in your browser. When prefetching is enabled, the browser can still establish connections to remote servers even if the resources from these remote servers are meant to be blocked by uBO.
This prevents the browser from bypassing uBO's filtering engine before establishing connections to remote servers.
Mozilla's "Link prefetching FAQ":
Privacy implications Along with the referral and URL-following implications already mentioned above, prefetching will generally cause the cookies of the prefetched site to be accessed.
Google's "Make webpages load faster":
If you turn this setting on in Chrome, websites (and any of their embedded resources) that are prerendered or prefetched may set and read their own cookies as if you had visited them before -- even if you don’t visit the prerendered or prefetched pages after all.
On Chromium 51 and above (including browsers based on Chromium 51 and above), this setting is completely unreliable, as it does not cause DNS lookups, preconnections and prefetches to be reliably blocked, because Chromium allows web pages to override that user setting. For details, see:
- https://github.com/gorhill/uBlock/issues/3219
- https://bugs.chromium.org/p/chromium/issues/detail?id=785125
- Example of different behavior with Firefox: https://github.com/uBlockOrigin/uBlock-issues/issues/435
Checking this will prevent hyperlink auditing. Hyperlink auditing is best summarized as a "phone home" feature (or more accurately "phone anywhere") meant to inform one or more servers of which links you click on (and when). The details are well explained here and the case of why such feature is harmful to users is well-argued here.
Option removed from desktop browsers in uBO v1.38.
Browsers now obfuscate LAN addresses by mDNS:
- Firefox: "Enable mDNS hostname obfuscation"
- Chromium: "mDNS service for IP handling in WebRTC"
The option is still available in Android Firefox because obfuscation is still not implemented there: "Support mDNS hostname obfuscation on Android"
Details
Background info: STUN IP Address requests for WebRTC
Test case: Prevent WebRTC from leaking local IP address
Keep in mind that this feature is to prevent leakage of your non-internet-facing IP address. The purpose of this feature is not to hide your current internet-facing IP address -- so be cautious to not misinterpret the results of the tests above. For example, if you use a VPN, your internet-facing IP address is that of the VPN, so your ISP-provided IP address should not be visible to the outside world with this setting checked. However, if you are not behind any VPN or proxy, your ISP-provided IP address will be visible regardless of this setting.
Caveats:
Enabled by default in Firefox in 1.31.3rc1 to mitigate fingerprinting attempts described in LiCybora/NanoDefenderFirefox#196.
You can block network requests made as a result of your browser reporting Content Security Policy violations ("CSP reports") to a remote server (which can be 3rd-party to the site where the violation occurred).
Important: disabling CSP reporting is not something that will break web pages, the purpose of CSP reporting is strictly a development tool for web sites.
Consider this excerpt from Reporting API / Privacy Considerations (my emphasis):
9.4. Disabling Reporting
[...]
That said, it can’t be the case that this general benefit be allowed to take priority over the ability of a user to individually opt-out of such a system. Sending reports costs bandwidth, and potentially could reveal some small amount of additional information above and beyond what a website can obtain in-band ([NETWORK-ERROR-LOGGING], for instance). User agents MUST allow users to disable reporting with some reasonable amount of granularity in order to maintain the priority of constituencies espoused in [HTML-DESIGN-PRINCIPLES].
There is currently no way to easily toggle CSP reporting in either Chromium or Firefox. This per-site switch is to address this shortcoming.
Note that as opposed to all other network requests, behind-the-scene network requests which are actual CSP reports will also be filtered out according to this setting. So if you globally disable CSP reporting in uBO, this will also apply to behind-the-scene network requests.
Note that the blocking of CSP reports is implemented as a per-site switch internally in uBO, so this means that an advanced user could create rules in the My rules pane in the dashboard to allow more granular control of the blocking of CSP reports. For example:
no-csp-reports: example.com false
The above rule means CSP reports would not be blocked on example.com
when CSP reports are blocked globally. The reverse will also work:
no-csp-reports: example.com true
The above rule means CSP reports would be blocked on example.com
when CSP reports are not blocked globally.
From uBO 1.34.0 and above. Before 1.34.0, this was an advanced setting since 1.25.0.
Enable/disable the uncloaking of canonical names -- enabled by default.
For background information see "What's CNAME of your game? This DNS-based tracking defies your browser privacy defenses".
The setting will be disabled on platforms not supporting this feature. It's currently supported only on Firefox.
In some edge cases, it might be necessary to disable this setting to prevent network-related issues. For example, "Pages load slowly when uBlock Origin is installed", which occurred when funneling network requests through a proxy.
Important note when using extension-based proxy service: Extension-based proxy services are often done on the fly through a browser API, and in such case uBO's own DNS queries to uncloak canonical names will NOT be caught and proxied by an extension-based proxy service. So you may want to disable this setting when using an extension-based proxy service.
Please see: "Per site switches"
The bottom-most section is for you to easily backup/restore/reset all settings in uBO.
It's done by saving a text file to the location specified by your browser.
It is suggested you backup all your settings regularly.
uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.
- Wiki home
- About the Wiki documentation
- Permissions
- Privacy policy
- Info:
- The toolbar icon
- The popup user interface
- The context menu
-
Dashboard
- Settings pane
- Filter lists pane
- My filters pane
- My rules pane
- Trusted sites pane
- Keyboard shortcuts
- The logger
- Element picker
- Element zapper
-
Blocking mode
- Very easy mode
- Easy mode (default)
- Medium mode (optimal for advanced users)
- Hard mode
- Nightmare mode
- Strict blocking
- Few words about re-design of uBO's user interface
- Reference answers to various topics seen in the wild
- Overview of uBlock's network filtering engine
- uBlock's blocking and protection effectiveness:
- uBlock's resource usage and efficiency:
- Memory footprint: what happens inside uBlock after installation
- uBlock vs. ABP: efficiency compared
- Counterpoint: Who cares about efficiency, I have 8 GB RAM and|or a quad core CPU
- Debunking "uBlock Origin is less efficient than Adguard" claims
- Myth: uBlock consumes over 80MB
- Myth: uBlock is just slightly less resource intensive than Adblock Plus
- Myth: uBlock consumes several or several dozen GB of RAM
- Various videos showing side by side comparison of the load speed of complex sites
- Own memory usage: benchmarks over time
- Contributed memory usage: benchmarks over time
- Can uBO crash a browser?
- Tools, tests
- Deploying uBlock Origin
- Proposal for integration/unit testing
- uBlock Origin Core (Node.js):
- Troubleshooting:
- Good external guides:
- Scientific papers