explaingit

orz-3/quantumultx

4,509JavaScriptAudience · ops devopsComplexity · 2/5Setup · moderate

TLDR

A ready-made configuration for the Quantumult X iOS proxy app that routes streaming, domestic, and foreign internet traffic through appropriate regional proxy servers automatically.

Mindmap

mindmap
  root((quantumultx))
    What it does
      Proxy routing
      Ad blocking
      Traffic rules
    Policy groups
      Regional nodes
      Streaming services
      Direct connections
    Tech stack
      JavaScript
      iOS
      Quantumult X
    Use cases
      Stream access
      Ad blocking
      Region routing
    Setup
      Import config
      Add proxy nodes
      Trust certificate
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

Set up Quantumult X to automatically route YouTube, Netflix, and streaming services through the best regional proxy node.

USE CASE 2

Configure iOS traffic so domestic Chinese websites connect directly while foreign services go through a proxy.

USE CASE 3

Block ads by default across all iOS apps using the built-in rejection rules in the configuration.

Tech stack

JavaScriptiOSQuantumult X

Getting it running

Difficulty · moderate Time to first run · 30min

Requires an existing Quantumult X app on iOS and your own proxy server subscription to connect through.

In plain English

This repository is a custom configuration preset for Quantumult X, a proxy and network rules app for iOS. Quantumult X lets users route their internet traffic through remote servers and apply filtering rules to decide which connections go through a proxy and which connect directly. This project provides a pre-built configuration file and a collection of JavaScript scripts that work inside that app. The configuration sets up ten routing policy groups, five of which are region-based filters that automatically select proxy nodes located in Hong Kong, Taiwan, Singapore, the United States, or Japan. The remaining five policy groups build on those regional selections to route specific types of traffic to appropriate regions. For example, Apple services and the App Store are sent through one group, international streaming services like YouTube, Netflix, and Amazon Prime Video are directed through relevant regional nodes, and domestic Chinese websites connect directly without going through any proxy. Advertisements are rejected by default. The README, which is written in Chinese, provides step-by-step setup instructions. The process involves copying the raw URL of the main configuration file, pasting it into the Quantumult X app's download dialog, generating a certificate for the app's traffic inspection feature (called MiTM), trusting that certificate in iOS system settings, and then adding your own proxy server nodes or subscription URLs through the app's node management interface. The project also integrates with BoxJS, a companion tool for managing script settings, and includes scripts that can capture cookies from certain services for use with scheduled task scripts. A TikTok region-unlock script is included as well, defaulting to the Japanese region with instructions for changing it to another. The repository credits multiple community contributors whose parsers and scripts were incorporated or adapted into this configuration.

Copy-paste prompts

Prompt 1
I have Quantumult X installed on iPhone. How do I import the orz-3 configuration and add my own proxy server subscription to it?
Prompt 2
Using the orz-3 Quantumult X config, how do I change which proxy region my Netflix and YouTube traffic is routed through?
Prompt 3
How do I set up the MiTM certificate in Quantumult X with the orz-3 configuration to enable script-based features?
Open on GitHub → Explain another repo

← orz-3 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.