explaingit

johnshall/shadowrocket-adblock-rules-forever

📈 Trending25,709Audience · vibe coderComplexity · 2/5ActiveSetup · 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

Things people build with this

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.

Tech stack

PythonShadowrocketGFWListEasyList

Getting 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.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.