explaingit

johnshall/shadowrocket-adblock-rules-forever

Analysis updated 2026-05-18

25,278Audience · vibe coderComplexity · 2/5Setup · easy

TLDR

Daily-updated routing rules for Shadowrocket iOS app that intelligently decide which websites go through a proxy and which connect directly, with optional ad-blocking.

Mindmap

mindmap
  root((repo))
    What it does
      Routing rules for iOS
      Proxy vs direct logic
      Auto-updated daily
    Rule sources
      GFWList blocked domains
      Greatfire Analyzer data
      Ad-blocking lists
    Rule variants
      Direct by default
      Proxy by default
      Domestic vs foreign
    Features
      Web ad blocking
      In-app ad blocking
      Video ad blocking
    Use cases
      Regional access
      Traffic optimization
      Ad filtering
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

What do people build with it?

USE CASE 1

Set up intelligent proxy routing on iOS to access region-blocked websites without proxying all traffic.

USE CASE 2

Block ads across web, apps, and videos on iOS using automatically maintained filter lists.

USE CASE 3

Choose between proxy-first, direct-first, or geography-based routing rules based on your network needs.

What is it built with?

PythonShadowrocketGFWListEasyList

How does it compare?

johnshall/shadowrocket-adblock-rules-forevergocolly/collyjavascript-tutorial/en.javascript.info
Stars25,27825,27525,275
LanguageGoHTML
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencevibe coderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
License could not be detected automatically. Check the repository's LICENSE file before use.

In plain English

This project provides a collection of routing rules for Shadowrocket, an iOS proxy app. The problem it solves is that iOS users who want to access websites not available in their region need to decide which sites should go through a proxy and which can connect directly. Without good rules, they either route everything through a proxy (slow, expensive) or nothing (can't access blocked sites). The rules are plain text configuration files that tell Shadowrocket which websites to proxy and which to connect to directly. They are automatically rebuilt every day using Python scripts that pull from several sources: GFWList (a community list of blocked domains), Greatfire Analyzer data, and popular ad-blocking lists like EasyList. The project offers multiple rule variants so users can choose their preferred behavior, such as defaulting to direct connection for unknown sites, defaulting to proxy, or routing based on whether a site is domestic or foreign. Ad-blocking rules covering web ads, in-app ads, and video ads are optionally included. You would use this if you have the Shadowrocket iOS app and want a well-maintained, automatically updated set of rules to intelligently route your internet traffic without manually maintaining a list yourself.

Copy-paste prompts

Prompt 1
How do I import these Shadowrocket rules into my iOS device and choose between the different routing variants?
Prompt 2
What sources does this project use to build its GFWList and ad-blocking rules, and how often are they updated?
Prompt 3
Can I customize these rules to add my own domains or create a hybrid routing strategy combining multiple rule files?
Prompt 4
Show me how to set up the direct-by-default variant so only specific sites route through my proxy.

Frequently asked questions

What is shadowrocket-adblock-rules-forever?

Daily-updated routing rules for Shadowrocket iOS app that intelligently decide which websites go through a proxy and which connect directly, with optional ad-blocking.

What license does shadowrocket-adblock-rules-forever use?

License could not be detected automatically. Check the repository's LICENSE file before use.

How hard is shadowrocket-adblock-rules-forever to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is shadowrocket-adblock-rules-forever for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub johnshall on gitmyhub

Verify against the repo before relying on details.