Usage · Announcement History · 中文
International/China accelerated ad filtering rule subscriptions for popular tools (AdGuard, uBlock Origin, AdGuard Home, etc.):
- Zero-proxy fast updates: distributed via multiple mirrors to significantly reduce failures and waiting time.
- Multi-mirror redundancy: ① GHUCS, ② jsDelivr (cached, usually faster); ③ Render, ④ 7ed (no cache, stronger freshness).
- One-click copy & search: a web index provides mirror selector, instant search, and single/bulk copy.
- January 21, 2025, the warehouse.git was reduced in size .
More history: see Announcement History.
Filtering tools：
- 🌍 browser plug-in
- 📺 router terminal
- 📱 mobile
- 💻 Desktop (global de-advertising)）
🙅♂️However, there is a pain point with all of these tools, as the rules are largely hosted on offshore servers, making updates extremely slow or even impossible to successfully update.
😫 A very common scenario: you've configured de-advertising tools for the elders and elderly in your family to prevent them from being phished, scammed or infected with viruses while browsing the web. But the fact is that often, many rules are carefully chosen, but in fact most of them are in the state of failure to update, and then a pop-up box appears, and the elder clicks randomly, but not necessarily what happens after ...... may say that the computer is broken, the update failed....
💥 This project is designed to solve this problem by updating the rules at light speed without going through any agents.
The project uses GitHub Actions to download the latest rules every 6 hours every day at UTC time, and then pushes them to GitHub Repo.
The rules are distributed in conjunction with a globally accelerated CDN provided by multiple sites:
①GHUCS (With cache)
②JsDelivr (With cache)
③Render (No cache)
④7ed (No cache)
The result is a second-by-second update of all de-advertising rules.
Under normal network environment (without any proxies, in mainland China network environment)
- Before using accelerated links: It can take up to 5 minutes and 12 seconds to update up to 13 rules, and 4 updates have failed.
- When accelerated links are used: all rules are updated within 15 seconds.
- Open the Web index page (see “Web index page” below).
- Pick a mirror (① or ② recommended by default), search your rule, and click “copy”.
- Paste it as a custom subscription/filter/blocklist URL in your ad-blocking tool.
- AdGuard (Android/iOS/macOS/Windows)
- Path: Settings → Filters → Custom filters → Add → paste the accelerated URL → Save
- uBlock Origin (browser extension)
- Path: Dashboard → Filter lists → Custom → Import/Add → paste the accelerated URL → Apply changes
- AdGuard Home (router/home gateway)
- Path: Filters → DNS blocklists → Add blocklist → paste the accelerated URL → Save & Update
Tip: You can keep multiple mirror URLs for the same rule as redundancy, or one primary + one backup mirror to avoid single-point failures.
- On the web index page, use “copy all visible links” to copy all rules in view.
- Deep-link shortcut:
index.html?mirror=ghucs©=EasyPrivacy.txt(example) — it pre-selects the mirror and copies the final URL on entry.
- For speed: prefer ① GHUCS, ② jsDelivr (cached, high hit rate).
- For freshness: prefer ③ Render, ④ 7ed (no cache, usually more up-to-date).
- If a mirror is blocked or slow in your network, switch to another. In mainland China, consider also keeping one no-cache mirror as a backup.
-
Online mirror: https://raw.cosr.eu.org
-
Features:
- Mirror selector: GHUCS / jsDelivr / cosr / gitmirror
- One-click copy per rule; copy-all for current visible rows
- Instant search (by rule name or filename)
- Size/Updated time sourced from
manifest.json - Theme: light (default) / dark / follow system
-
Deep link (copy shortcut):
index.html?mirror=ghucs©=EasyPrivacy.txt- It selects the mirror and copies the final URL to clipboard
-
gzip copies: each file also has a
.gzcompanion (e.g.EasyPrivacy.txt.gz). Most tools can ingest gzip directly or after a quickgunzip -c file.txt.gz > file.txt.
- Updates fail or are slow?
- Switch mirrors (①/② ↔ ③/④) or trigger a manual update in your tool. Keeping one no-cache mirror as backup often helps.
- Why no acceleration for “I Don't Care About Cookies”?
- Redistribution license restrictions. CI sync is paused; only the original address is listed.
- Update frequency?
- CI fetches upstream every 6 hours and pushes to the repo. With mirrors, updates usually propagate within seconds (even faster on cache hits).
- checksums: see
checksums.txt(generated by CI). Verify locally:
sha256sum -c checksums.txt- manifest: see
manifest.jsonfor a machine-readable index with file sizes, hashes and timestamps.
I'd like you to submit an Issue or Request to help me improve the rules.
Submit the rules that you think you need to update for acceleration. The following points should be noted.
- the rules need to be on an offshore server, difficult to successfully update or slow to update.
- indicate the name, source, and function of the rule.
- If the rule you want to speed up is a file in a GitHub project, just use the jsDelivr syntax to speed up the project file without submitting a request.
https://cdn.jsdelivr.net/gh/username/project name@version/accelerate files.
- When filing an Issue, please include:
- Region/ISP, chosen mirror(s), tool type & version
- Error messages or screenshots, reproduction steps
- The rule name and link involved
- All code in this project is released under the GPL-3.0 license unless otherwise specified.
- The README.MD and wiki resources of this project are based on CC BY-NC-SA 4.0. This means you can copy and redistribute the content of this project, but you must provide appropriate credit and a link to the license. At the same time, you may not use this project for commercial purposes, according to our narrow understanding (with supplementary terms), any profit-making activity is considered a commercial purpose.
- Please use this project in compliance with local laws and regulations.
