gmoogway/shadowrocket-rules — explained in plain English
Analysis updated 2026-06-26
Block ads and tracking domains on your iPhone using Shadowrocket without changing your existing proxy setup.
Route blocked services like Telegram, Gmail, and WhatsApp through a proxy while keeping Chinese sites on a direct connection.
Switch between whitelist and blacklist proxy modes depending on which sites you visit most.
Keep your routing rules automatically up to date without manually maintaining rule lists yourself.
| gmoogway/shadowrocket-rules | fody/fody | tokio-rs/console | |
|---|---|---|---|
| Stars | 4,517 | 4,517 | 4,517 |
| Language | — | C# | Rust |
| Setup difficulty | easy | moderate | moderate |
| Complexity | 2/5 | 3/5 | 3/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Add the .module files directly inside Shadowrocket on iOS. No computer or coding required. Requires Shadowrocket app (paid, App Store).
This repository provides routing rules for Shadowrocket, an iOS proxy client app commonly used to manage network traffic. The rules tell Shadowrocket what to do with each network request: connect directly without a proxy (DIRECT), route through a proxy server (PROXY), or block the request entirely (REJECT). The README is written in Chinese. The rule sets are large. As of the last update, the collection includes around 113,000 DIRECT rules, 26,500 PROXY rules, and 173,000 REJECT rules. The REJECT rules cover advertising and tracking domains drawn from multiple public sources including EasyList, AdGuard DNS filters, and others. The PROXY rules include addresses for services like Telegram, Gmail, WhatsApp, and Google Voice that are commonly blocked. The DIRECT rules cover Chinese domestic sites and services that should not be routed through a proxy. The rules are packaged as Shadowrocket module files (.module), which you add to the app rather than replacing the whole configuration. This keeps your own settings intact and makes it easy to enable or disable rule sets independently. Three modules are provided: one for direct connections, one for proxied connections, and one for ad blocking. The repository explains two usage modes: a whitelist mode where known sites go through the proxy and everything else connects directly, and a blacklist mode where known Chinese sites connect directly and everything else goes through the proxy. The rule files are built automatically each day from their source lists, so they stay current. The README notes that ad blocking is not guaranteed to catch all ads, particularly video ads from apps that change their ad server URLs frequently.
A daily-updated collection of 300,000+ routing rules for the Shadowrocket iOS proxy app, covering ad blocking, direct Chinese site access, and proxy routing for blocked services like Telegram and Google.
No license is mentioned in the explanation.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.