VPN07

Quantumult X Complete Tutorial 2026: Rules, Scripts & VPN Import

March 3, 2026 18 min read Quantumult X iOS Guide Advanced Tutorial

Quick Summary: Quantumult X (圈X) is the most feature-rich proxy client for iOS and macOS, trusted by advanced users for its powerful rule system, JavaScript scripting engine, and flexible policy groups. This guide covers everything from basic setup to advanced script automation with VPN07.

What Is Quantumult X? The Power User's iOS Proxy

Quantumult X, commonly abbreviated as "圈X" (Quān X) in Chinese communities, is a sophisticated iOS and macOS proxy application developed by Cross Utopia. Since its release, it has become the preferred tool for power users who require more than what simpler proxy clients offer. While apps like Shadowrocket are excellent for straightforward use, Quantumult X caters to users who want scriptable automation, granular traffic control, and deep protocol flexibility.

What truly sets Quantumult X apart is its JavaScript-based scripting engine. Unlike other proxy apps that are limited to simple rule matching, Quantumult X can execute custom JavaScript to modify HTTP requests and responses on the fly, rewrite API calls, remove advertisements from app network traffic, and automate authentication. This capability has spawned a thriving community of script developers who share ready-to-use scripts for popular apps.

Quantumult X Key Features

  • JavaScript scripting engine for traffic rewriting
  • Multiple server policy groups with failover
  • Filter rules from remote URLs (auto-updating)
  • Per-app traffic routing control
  • MitM with certificate for HTTPS inspection
  • Network activity log with full request details

Supported Protocols

  • Shadowsocks (most ciphers supported)
  • VMess (WebSocket, gRPC transports)
  • VLESS (WebSocket, TCP+TLS)
  • Trojan (over TLS)
  • HTTP/HTTPS proxy
  • SOCKS5 with authentication

App Store Availability

Quantumult X is available on the iOS App Store and Mac App Store, but is not listed in the China mainland App Store. You need a non-China Apple ID (US, Hong Kong, Taiwan, etc.) to purchase and download it. It costs $7.99 as a one-time purchase with no subscription fees.

Step 1: Install Quantumult X and First Launch

After purchasing Quantumult X from the App Store with a non-China Apple ID, launch it for the first time. The app will request permission to add a VPN configuration — this is required for proxy operation on iOS and is completely normal. Tap "Allow" when prompted.

1

Grant VPN Permission

On first launch, Quantumult X will ask to add VPN configurations. Tap "Allow" to proceed. Enter your iPhone passcode or use Face ID when prompted by iOS to approve the VPN profile installation.

2

Familiarize With the Interface

Quantumult X's home screen has a large toggle button in the center and five tabs at the bottom: Dashboard, Server, Filter, Rewrite, and Settings (⚙). Each tab serves a distinct function in the proxy workflow.

3

Check the Configuration Editor

Unlike Shadowrocket's GUI-only approach, Quantumult X uses a text-based configuration format similar to Surge. You can access the raw config by tapping the top-right icon (three horizontal lines) → Edit. This is where advanced customization happens.

Step 2: Import VPN07 Subscription into Quantumult X

Quantumult X supports subscription URLs in multiple formats including Clash YAML, Quantumult X native format, and SIP008. VPN07 provides subscription URLs compatible with Quantumult X, making server import a one-step process.

Importing VPN07 Subscription — Step by Step

  1. 1. Log into your VPN07 account at vpn07.com and navigate to "My Subscription"
  2. 2. Find the "Quantumult X" or "Universal" subscription URL and copy it
  3. 3. Open Quantumult X → tap the Server tab (second from left)
  4. 4. Tap the subscription button (cloud icon with arrow) in the top-right
  5. 5. Paste your VPN07 subscription URL and set the auto-update interval (6 or 12 hours)
  6. 6. Tap OK — all VPN07 nodes will appear organized by region
  7. 7. Tap the latency test icon (⚡) to ping all nodes and find the fastest one
70+
VPN07 Countries
1000Mbps
Max Bandwidth
$1.5
Per Month
Auto
Node Updates

Alternative: Manual Config File Import

If you prefer file-based configuration, you can paste a complete Quantumult X config directly into the editor. Go to the top-right menu → Edit → paste the configuration. VPN07's dashboard provides a ready-made Quantumult X config template you can download and paste.

Step 3: Configure Filter Rules for Smart Traffic Routing

The Filter tab is where Quantumult X truly shines over simpler proxy apps. Filter rules determine whether each connection goes through your VPN07 proxy or connects directly. Well-configured filters mean domestic apps remain fast while internationally blocked services automatically use VPN07.

Rule Type Example Action
DOMAIN-SUFFIX google.com PROXY
DOMAIN-KEYWORD youtube PROXY
IP-CIDR 192.168.0.0/16 DIRECT
GEOIP CN DIRECT
FINAL Catch-all rule PROXY or DIRECT

Use Remote Filter Rule Sets (Recommended)

Instead of adding rules manually, Quantumult X supports remote filter lists that update automatically. In the Filter tab, tap the cloud icon and add a remote ruleset URL. Popular community-maintained rule sets include:

  • • Loyalsoldier/surge-rules: Comprehensive CN/non-CN domain lists
  • • blackmatrix7/ios_rule_script: App-specific rule sets for 400+ services
  • • GeQ1an/QuantumultX: Quantumult X-optimized filter collections

Set update interval to 24 hours so your rules stay current without manual maintenance.

Step 4: Policy Groups — Organizing Your VPN07 Nodes

Policy groups are one of Quantumult X's most powerful features. Rather than manually selecting a single server, you create groups that contain multiple servers and define how the group selects which server to use for each connection. This enables automatic failover, geographic load balancing, and latency optimization.

STATIC

Static Policy Group

Manually select which server in the group is active. Simple but requires manual switching when a node goes down. Good for users who prefer to always use a specific region (e.g., always Japan).

URL-TEST

URL-Test Policy Group (Recommended)

Automatically tests all servers in the group by fetching a URL (usually google.com) and selects the lowest-latency server. Reruns the test every set interval (e.g., 300 seconds). This is the best option for most VPN07 users — always connected to the fastest available node.

AVAILABLE

Available Policy Group

Uses the first reachable server in the list, falling back to the next if the first fails. Best for reliability when you have a preferred primary node and want automatic fallback to backups.

ROUND-ROBIN

Round-Robin Policy Group

Rotates through servers sequentially. Useful for distributing load across multiple nodes, particularly useful for high-volume usage across multiple VPN07 nodes in the same region.

# Example policy group config in Quantumult X format

[policy]
url-test=Auto-Speed, server-tag-regex=(?i)(JP|HK|SG), url=http://www.google.com/generate_204, interval=300, tolerance=50
static=StreamingUS, US-New-York, US-Los-Angeles, US-Chicago
available=Failover, HK-01, JP-01, SG-01

Step 5: Using Scripts in Quantumult X

The Rewrite & Script features are what make Quantumult X unique among iOS proxy clients. The scripting engine runs JavaScript that can intercept and modify network requests before they reach your apps. This powers features like in-app ad removal, price comparison across regions, and automatic cookie management.

Ad-Blocking Scripts

Scripts that intercept API responses and remove advertisement data before it reaches the app. Unlike browser ad blockers, these work inside any iOS app including streaming services and news apps.

Common target: Spotify, Bilibili, YouTube (for skipping behavior)

URL Rewrite Rules

Redirect specific URLs to alternative endpoints. For example, redirect tracking URLs to harmless alternatives, or redirect region-locked API endpoints to accessible ones.

Example: Redirect ads.example.com → localhost

Scheduled Tasks

Run scripts on a schedule — for example, automatically check your VPN07 account status, send ping notifications, or run subscription refresh checks at specified intervals.

Uses iOS background refresh capabilities

Notification Scripts

Scripts that trigger local iOS notifications based on network events — such as alerting you when a preferred VPN07 node becomes available again after downtime.

Useful for monitoring node availability

# Example: URL Rewrite rule to block ads in Quantumult X [rewrite_local]

^https?://(www\.)?googleads\.g\.doubleclick\.net reject
^https?://pagead2\.googlesyndication\.com reject
^https?://ad\.doubleclick\.net reject

Proxy Modes in Quantumult X

Quantumult X offers several proxy modes accessible from the main dashboard. Choosing the right mode for your situation makes a significant difference in performance and privacy:

FILTER

Filter Mode — Daily Use (Recommended)

Uses your configured filter rules to decide each connection's path. Chinese apps connect directly, blocked international services use VPN07. Best balance of speed and accessibility for everyday use.

GLOBAL

Global Mode — All Traffic Through VPN07

Every connection on the device goes through VPN07, bypassing all filter rules. Useful on untrusted networks (hotel WiFi, airport WiFi) where you want maximum protection. Slightly slower than Filter mode due to full proxy routing.

DIRECT

Direct Mode — Proxy Temporarily Paused

All traffic bypasses the proxy and connects directly. Quantumult X remains loaded with the VPN profile active, but effectively passes all traffic through without any proxy routing.

Quantumult X FAQ: Common Questions Answered

What is the difference between Quantumult X and Shadowrocket?

Shadowrocket is simpler, cheaper ($2.99 vs $7.99), and easier to configure. Quantumult X has a steeper learning curve but provides JavaScript scripting, more flexible policy groups, and deeper traffic analysis. If you need advanced automation and granular control, choose Quantumult X. For straightforward proxy use, Shadowrocket is sufficient.

Does Quantumult X support VPN07 subscription URLs?

Yes. VPN07 provides subscription URLs compatible with Quantumult X format. Log into your VPN07 dashboard, find the subscription section, and copy the Quantumult X URL. Import it via the Server tab's subscription import feature — all nodes will automatically populate.

Can I run Quantumult X alongside other VPN apps?

No. iOS only allows one VPN profile to be active at a time. If you have another VPN app (like a corporate VPN) that needs to be active, you must disable Quantumult X first. For most users, Quantumult X with VPN07 provides everything needed without a separate VPN app.

Why is Quantumult X connected but some apps still can't load?

This usually means your filter rules are incorrectly routing the affected app's traffic. Check the Activity log (Dashboard tab → tap an entry) to see which rule is being applied. You may need to add a specific domain to your proxy rule set, or add the app to per-app routing settings.

Is Quantumult X available on macOS?

Yes. Quantumult X is available on both iOS and macOS (Mac App Store). The macOS version works identically to iOS but runs as a native Mac app with a menu bar interface. If you purchase on iOS, you can download on macOS using the same Apple ID under "My Purchases."

Advanced Tips for Quantumult X Users

Once your basic Quantumult X setup is working with VPN07, these advanced configurations can significantly improve your experience:

Network Extensions Background Mode

Go to iOS Settings → General → VPN & Device Management → VPN → Quantumult X. Enable "Connect On Demand" to automatically activate the proxy whenever your iPhone connects to WiFi or cellular data. This ensures you're always protected without manually toggling the app.

Fallback DNS Configuration

In Quantumult X settings, configure a fallback DNS server (e.g., Cloudflare 1.1.1.1) for domains that don't match your filter rules. This prevents DNS resolution failures when your rules don't have a specific match, ensuring browsing continues smoothly even for unconfigured domains.

Latency-Based Node Switching

Configure a URL-test policy group with a short test interval (120 seconds) and low tolerance (30ms). Quantumult X will aggressively switch to better VPN07 nodes as network conditions change throughout the day, keeping your latency consistently low during peak hours.

Certificate Pinning Bypass

Some iOS apps use certificate pinning that prevents MitM inspection. When running rewrite scripts, only enable MitM for specific domains you need to inspect. Never enable global MitM — it can break banking apps, payment services, and apps with hardened security implementations.

VPN07: The Perfect Server for Quantumult X Power Users

🥇

VPN07 — #1 Choice for Quantumult X

9.9/10 — Best Quantumult X Compatible VPN
1000Mbps
Bandwidth
70+
Countries
10 Yrs
Proven Stability
$1.5
Per Month
  • Quantumult X-compatible subscription URL — import in one tap
  • Supports all protocols: VLESS, VMess, Trojan, Shadowsocks
  • 1000Mbps peak bandwidth — handles 4K streaming and bulk downloads
  • 30-day money-back guarantee — risk-free trial

VPN07 — Best VPN for Quantumult X

1000Mbps · 70+ Countries · Trusted Since 2015

VPN07 provides Quantumult X-optimized subscription URLs supporting VLESS, VMess, Trojan, and Shadowsocks protocols across 70+ countries. With 1000Mbps bandwidth, your Quantumult X URL-test groups will always find fast, stable nodes. Operating continuously for over 10 years, VPN07 is the server infrastructure that power users trust behind their Quantumult X setups.

$1.5
Per Month
1000Mbps
Bandwidth
70+
Countries
30 Days
Money Back
Start Free Trial → View Pricing

Related Articles

Shadowrocket Setup Guide 2026: Configure iOS Proxy in 10 Minutes

Complete Shadowrocket setup guide for iOS — the simpler alternative to Quantumult X for users who prefer a straightforward proxy client.

Read More →

Sing-box Setup Guide 2026: iOS, Android, Windows & Mac Full Config

Master sing-box — the universal cross-platform proxy that supports all modern protocols including VLESS+Reality and Hysteria2.

Read More →
$1.5/mo · 10 Years
Try VPN07 Free