explaingit

gmoogway/shadowrocket-rules

4,517Audience · generalComplexity · 2/5Setup · easy

TLDR

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.

Mindmap

mindmap
  root((Shadowrocket Rules))
    DIRECT Rules
      Chinese domestic sites
      113000 entries
    PROXY Rules
      Telegram Gmail WhatsApp
      26500 entries
    REJECT Rules
      Ad and tracker domains
      173000 entries
    Usage Modes
      Whitelist mode
      Blacklist mode
    Sources
      EasyList
      AdGuard DNS
    Modules
      Easy install
      Modular toggle
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Block ads and tracking domains on your iPhone using Shadowrocket without changing your existing proxy setup.

USE CASE 2

Route blocked services like Telegram, Gmail, and WhatsApp through a proxy while keeping Chinese sites on a direct connection.

USE CASE 3

Switch between whitelist and blacklist proxy modes depending on which sites you visit most.

USE CASE 4

Keep your routing rules automatically up to date without manually maintaining rule lists yourself.

Tech stack

Shadowrocket.module filesiOS

Getting it running

Difficulty · easy Time to first run · 5min

Add the .module files directly inside Shadowrocket on iOS. No computer or coding required. Requires Shadowrocket app (paid, App Store).

No license is mentioned in the explanation.

In plain English

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.

Copy-paste prompts

Prompt 1
I'm using Shadowrocket on iOS with the gmoogway/shadowrocket-rules modules installed. Explain the difference between whitelist mode and blacklist mode and help me decide which one to use based on my browsing habits.
Prompt 2
I installed the ad-blocking module from gmoogway/shadowrocket-rules but some video ads in apps are still getting through. Why might that happen and what can I do about it?
Prompt 3
Walk me through how to add the three .module files from gmoogway/shadowrocket-rules to Shadowrocket on my iPhone without losing my existing proxy configuration.
Prompt 4
The README for gmoogway/shadowrocket-rules is in Chinese. Summarize the key setup steps and explain what each of the three modules does in plain English.
Open on GitHub → Explain another repo

← gmoogway on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.