Skip to content

Detailed QuantumultX Tutorial for iOS

Introduction

QuantumultX is an advanced network tool for iOS with powerful traffic routing and scripting features, suitable for users who want fine-grained network control.

Download and Installation

  1. Search for "QuantumultX" in the App Store and purchase/install (requires a non-China Apple ID)
  2. Or download via App Store link

Basic Settings

First Launch

  1. Open the QuantumultX app
  2. Allow notification permissions when prompted
  3. Tap the round icon in the lower right to enter the main interface

Import Configuration

  1. Tap the settings icon in the lower right
  2. Select "Profiles"
  3. Tap the "+" in the upper right
  4. Select the "Download" tab
  5. Enter the configuration file link
  6. Tap "OK" to download the configuration

Configuration Conversion Note

If you use Clash configuration, you need to:

  1. Use a configuration conversion tool to convert Clash config to QuantumultX format
  2. Or use a subscription link that supports QuantumultX

Start Proxy

  1. Return to the QuantumultX main interface
  2. Tap the round button in the lower right to enable the proxy
  3. The first time you start, you'll be asked for MOFA permissions, tap "Allow" and verify

Proxy Mode Settings

On the main interface, tap the icon in the upper right to switch modes:

  1. All Proxy: All traffic goes through the proxy
  2. Rule: Smart routing based on rules (recommended)
  3. Direct: No proxy is used

Advanced Features

Policy Group Management

  1. Tap the "Policy" icon in the lower left
  2. View and manage all policy groups
  3. Tap a policy group to manually switch nodes
  4. Long-press a policy group for speed test, sorting, etc.

Custom Rules

  1. Tap the settings icon in the lower right
  2. Select "Profiles" and edit the current configuration
  3. In the [filter_local] section, add custom rules:
    host-suffix, example.com, direct
    host-keyword, google, proxy
    ip-cidr, 192.168.0.0/16, direct

Rewrite Function

  1. In the [rewrite_local] section of the configuration file, add rewrite rules
  2. Supports URL redirection, request header modification, etc.
  3. Example: ^https?:\/\/(www\.)?(g|google)\.cn url 302 https://www.google.com

Script Function

  1. Add JavaScript scripts in the configuration file
  2. Supports scheduled tasks, HTTP request interception, etc.
  3. Can implement ad blocking, auto check-in, and other advanced features

Resource Parser

  1. Enable "Resource Parser" in "Settings"
  2. Can parse subscription links in different formats
  3. Automatically convert to QuantumultX compatible format

Debugging and Optimization

MitM Settings

  1. In "Settings", find the "MitM" option
  2. Install and trust the certificate (follow in-app instructions)
  3. Enable MitM to decrypt HTTPS traffic

Network Testing

  1. In the policy group interface, long-press nodes for latency test
  2. Supports batch speed test and node sorting
  3. Choose the best node based on speed test results

Performance Optimization

  1. Adjust UDP forwarding, DNS settings, etc. in "Other Settings"
  2. Streamline rule count to improve matching efficiency
  3. Use local GeoIP database to accelerate rule matching

Common Issues

Connection Issues

  • Check if nodes are available
  • Confirm subscription link is valid
  • Try clearing DNS cache

Specific Apps Can't Connect

  • Set specific proxy for the app in rules
  • Check for conflicting rules
  • Try using different policy groups

Configuration Sync

  • Use iCloud to sync configuration to other devices
  • Export configuration file for backup
  • Update subscription regularly to get the latest nodes and rules