explaingit

sve1r/rules-for-quantumult-x

3,759JavaScriptAudience · generalComplexity · 2/5Setup · easy

TLDR

A ready-made collection of routing rules for the Quantumult X iOS proxy app that automatically sends international sites through a proxy and blocks ads, tracking, and fraudulent websites.

Mindmap

mindmap
  root((rules-for-quantumult-x))
    What it does
      Route traffic smartly
      Block ads and tracking
      Block fraud sites
    Rule Categories
      Global proxy rules
      China direct rules
      Streaming services
      Ad blocking
    Special Cases
      BackCN for overseas
      Carrier hijack block
      Captive portal fix
    Setup
      Add raw link in app
      Follow load order
      CDN mirror available
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

Add these rules to Quantumult X on iOS to automatically route international websites through a proxy while keeping Chinese sites on a direct connection.

USE CASE 2

Block in-app advertising across apps by loading the ad-blocking rule list into Quantumult X's split-routing section.

USE CASE 3

Access Chinese streaming services from outside China by enabling the BackCN rule set.

USE CASE 4

Protect against known scam and fraud websites by including the fraud-blocking rule list.

Tech stack

JavaScript

Getting it running

Difficulty · easy Time to first run · 5min

Rules are added by pasting raw file URLs into Quantumult X, load order matters, put ad-blocking and hijack rules before general routing rules.

License terms are not stated in the explanation.

In plain English

This repository is a curated collection of routing rules for Quantumult X, a network proxy application popular among iOS users in China. Quantumult X lets you control how your device's internet traffic is routed: certain websites or apps go directly, others go through a proxy server. This repository provides a ready-made set of rules that handle common scenarios so you do not have to write them yourself. The rules are organized into several categories. There are rules to route international websites through a proxy while keeping Chinese websites on a direct connection. Separate rule lists cover specific streaming services, social networks, Apple services, and games. There are also rules for blocking in-app advertising, blocking carrier traffic hijacking, and blocking known fraud and scam websites. A BackCN section handles the reverse case: accessing Chinese media services from outside China. The README is written primarily in Chinese and includes detailed setup instructions: you add the rules to the Quantumult X split-routing section using the raw file link from GitHub, or through a CDN mirror the author provides. There is a recommended load order for the rule files (advertising and hijacking rules first, then media, then general global and China rules) to ensure they interact correctly. The FAQ section addresses common issues, such as captive portal login pages not loading over the proxy, certain Alibaba apps rejecting proxy connections, and how ad blocking interacts with caching. Contributions are accepted via pull request. The project credits several other open-source rule lists that were used as sources.

Copy-paste prompts

Prompt 1
I'm setting up Quantumult X on iOS and want to use the sve1r rules. What is the correct order to add the rule files so they work together properly?
Prompt 2
How do I add the ad-blocking rule list from rules-for-quantumult-x to Quantumult X using its raw GitHub link?
Prompt 3
I'm outside China and want to watch Chinese streaming services. Which rule file from rules-for-quantumult-x do I enable for BackCN support?
Prompt 4
After adding rules-for-quantumult-x, my captive portal login page stopped working. How do I fix this in Quantumult X?
Open on GitHub → Explain another repo

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

Verify against the repo before relying on details.