2609 字
13 分钟

Quantumult X配置完全指南:iOS高级代理工具从入门到精通(2026最新)

Quantumult X(简称 QX)是 iOS 上最强大的代理工具之一,以其灵活的规则系统和强大的扩展能力著称。相比 Shadowrocket,QX 提供了更精细的路由控制、更强大的 DNS 配置和脚本自动规则功能。

Quantumult X配置完全指南

阅读提示

本文与 《iOS Clash Mi教程》《Shadowrocket入门教程》 互为补充:后者聚焦简单配置,本文聚焦QX的高级功能。


一、QX vs Shadowrocket 对比#

1.1 核心功能对比#

维度Quantumult XShadowrocket
规则系统Filter(强大灵活)Rule(简单直观)
DNS配置非常灵活(规则分流/FakeIP)基础(手动选择)
协议支持更丰富(Hy2/WS等)常用协议
脚本规则支持自动规则有限支持
易用性中等(需学习成本)高(简单直观)
社区资源较少丰富
价格¥68一次性¥29一次性
更新频率稳定更新稳定更新

1.2 适用场景#

场景推荐理由
高级用户/开发者QX规则灵活、功能强大
新手用户Shadowrocket简单易用
需要精细分流QXFilter规则系统
需要DNS防污染QX强大的DNS配置
需要自动规则QX脚本自动规则
需要简单配置Shadowrocket一键导入

二、安装与基础配置#

2.1 购买安装#

  1. App Store购买:搜索”Quantumult X”,价格 ¥68
  2. 设置网络权限:首次打开允许VPN配置
  3. 导入配置文件:使用订阅链接或手动配置

2.2 基础配置界面#

主界面结构:
├── 连接开关(左上角)
├── 当前节点(顶部)
├── 配置列表(中间)
├── 快捷操作(底部)
│ ├── 连接
│ ├── 断开
│ ├── 节点选择
│ ├── 规则测试
│ └── 设置
└── 统计信息(底部面板)

2.3 配置文件结构#

配置文件格式(JSON):
{
"general": {}, // 通用设置
"dns": {}, // DNS配置
"route": {}, // 路由规则
"policy": {}, // 策略组
"servers": [], // 节点列表
"scripts": [], // 脚本规则
"advanced": {} // 高级设置
}

三、订阅配置#

3.1 添加订阅链接#

步骤:
1. 打开 QX → 点击右下角「配置」
2. 点击「订阅」→ 「添加订阅」
3. 输入订阅名称和链接
4. 设置更新频率(建议30分钟)
5. 点击「保存」
6. 点击订阅名称右侧的刷新按钮更新

3.2 订阅配置选项#

选项说明
自动更新按设定频率自动更新节点
订阅链接机场提供的配置链接
更新频率建议30分钟-1小时
配置格式自动识别(Clash/QX/SSR等)

3.3 手动添加节点#

步骤:
1. 打开 QX → 点击右下角「配置」
2. 点击「服务器」→ 「添加服务器」
3. 选择协议类型
4. 填写节点信息
5. 保存并启用

3.4 支持的协议#

协议说明配置要点
VLESS主流协议uuid、security、flow
VMess主流协议uuid、alterId、security
Shadowsocks经典协议method、password
ShadowsocksRSSR协议需额外参数
Trojan安全协议password
Hysteria2高速协议password、obfs
WireGuard现代协议privateKey、peerPublicKey
WebSocket隧道协议path、headers

四、Filter规则编写#

4.1 规则格式#

[类型],[规则],[策略],[注释]

示例

DOMAIN-SUFFIX,google.com,PROXY,#Google服务代理
DOMAIN-SUFFIX,baidu.com,DIRECT,#百度直连
IP-CIDR,192.168.0.0/16,DIRECT,#内网直连
DOMAIN-KEYWORD,twitter,PROXY,#Twitter代理
DOMAIN,www.facebook.com,PROXY,#Facebook代理

4.2 规则类型#

类型说明示例
DOMAIN精确域名匹配DOMAIN,www.google.com,PROXY
DOMAIN-SUFFIX域名后缀匹配DOMAIN-SUFFIX,.google.com,PROXY
DOMAIN-KEYWORD域名关键词匹配DOMAIN-KEYWORD,google,PROXY
IP-CIDRIP地址段匹配IP-CIDR,10.0.0.0/8,DIRECT
PROCESS-NAME进程名匹配PROCESS-NAME,com.apple.Safari,PROXY
PROTOCOL协议匹配PROTOCOL,http,DIRECT
URL-REGEXURL正则匹配URL-REGEX,^https://.*\.google\.com,PROXY
USER-AGENTUser-Agent匹配USER-AGENT,^Mozilla.*Chrome,PROXY

4.3 策略类型#

策略说明
DIRECT直连(不走代理)
PROXY代理(走当前节点)
REJECT拒绝连接
NO_PROXY不代理(与DIRECT类似)

4.4 常用规则示例#

# 国内域名直连
DOMAIN-SUFFIX,.cn,DIRECT
DOMAIN-SUFFIX,.taobao.com,DIRECT
DOMAIN-SUFFIX,.jd.com,DIRECT
# Google服务代理
DOMAIN-SUFFIX,.google.com,PROXY
DOMAIN-SUFFIX,.googleapis.com,PROXY
DOMAIN-SUFFIX,.gstatic.com,PROXY
# 社交媒体代理
DOMAIN-SUFFIX,.twitter.com,PROXY
DOMAIN-SUFFIX,.facebook.com,PROXY
DOMAIN-SUFFIX,.instagram.com,PROXY
DOMAIN-SUFFIX,.youtube.com,PROXY
# 流媒体代理
DOMAIN-SUFFIX,.netflix.com,PROXY
DOMAIN-SUFFIX,.disneyplus.com,PROXY
DOMAIN-SUFFIX,.hbomax.com,PROXY
# 内网直连
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR,172.16.0.0/12,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,127.0.0.0/8,DIRECT
# 广告拦截
DOMAIN-SUFFIX,.doubleclick.net,REJECT
DOMAIN-SUFFIX,.googleadservices.com,REJECT
DOMAIN-SUFFIX,.facebook.com,REJECT

4.5 规则优先级#

规则按顺序匹配,第一个匹配生效。
建议规则顺序:
1. 拒绝规则(广告、恶意网站)
2. 直连规则(国内域名、内网IP)
3. 代理规则(国外域名、GFW网站)
4. 默认规则(默认走代理或直连)

4.6 规则组(Rule Groups)#

规则组允许将多条规则组织在一起:
[Rule Group]
Group: China
DOMAIN-SUFFIX,.cn,DIRECT
IP-CIDR,103.235.46.0/24,DIRECT
[Rule Group]
Group: Google
DOMAIN-SUFFIX,.google.com,PROXY
DOMAIN-SUFFIX,.googleapis.com,PROXY
[Rule Group]
Group: Ads
DOMAIN-SUFFIX,.doubleclick.net,REJECT
DOMAIN-SUFFIX,.googleadservices.com,REJECT

五、DNS配置#

5.1 基础DNS配置#

步骤:
1. 打开 QX → 点击右下角「配置」
2. 点击「DNS」→ 配置DNS服务器
3. 添加DNS服务器(国内/国外)
4. 配置DNS规则
5. 启用DNS缓存和防污染

5.2 DNS服务器配置#

{
"dns": {
"servers": [
{
"name": "国内DNS",
"address": "223.5.5.5",
"type": "udp",
"policy": "direct"
},
{
"name": "Google DNS",
"address": "8.8.8.8",
"type": "https",
"policy": "proxy",
"url": "https://dns.google/dns-query"
},
{
"name": "Cloudflare DNS",
"address": "1.1.1.1",
"type": "tls",
"policy": "proxy"
}
],
"rules": [
{
"domain-suffix": ".cn",
"server": "国内DNS"
},
{
"domain-keyword": "google",
"server": "Google DNS"
},
{
"domain-keyword": "twitter",
"server": "Cloudflare DNS"
}
],
"cache": {
"enabled": true,
"ttl": 3600
},
"fake-ip": {
"enabled": true,
"range": "198.18.0.0/15"
}
}
}

5.3 DNS规则#

规则类型说明示例
domain精确域名domain,www.google.com,Google DNS
domain-suffix域名后缀domain-suffix,.cn,国内DNS
domain-keyword域名关键词domain-keyword,google,Google DNS
ip-cidrIP地址段ip-cidr,10.0.0.0/8,国内DNS
default默认规则default,Google DNS

5.4 FakeIP模式#

"fake-ip": {
"enabled": true,
"range": "198.18.0.0/15",
"fallback": true,
"ipref": true
}

作用

  • 将域名解析为虚拟IP(FakeIP)
  • 避免DNS污染
  • 减少DNS查询次数
  • 提高连接速度

六、策略组配置#

6.1 策略组类型#

类型说明适用场景
Selector手动选择手动切换节点
Auto自动选择根据规则自动选择
URL-Test自动测速选择最快节点
Fallback故障转移主备切换
Load-Balance负载均衡多节点分摊

6.2 配置策略组#

{
"policy": {
"groups": [
{
"name": "Auto",
"type": "selector",
"servers": [
"HK-节点1",
"HK-节点2",
"JP-节点1",
"US-节点1",
"DIRECT"
],
"default": 0
},
{
"name": "Fastest",
"type": "url-test",
"servers": [
"HK-节点1",
"HK-节点2",
"JP-节点1"
],
"url": "http://www.gstatic.com/generate_204",
"interval": 300
},
{
"name": "Main",
"type": "fallback",
"servers": [
"HK-主节点",
"JP-备用节点",
"US-备用节点"
],
"url": "http://www.gstatic.com/generate_204"
}
]
}
}

6.3 在规则中使用策略组#

DOMAIN-SUFFIX,google.com,Auto,#Google服务用Auto策略组
DOMAIN-SUFFIX,youtube.com,Fastest,#YouTube用最快节点
DOMAIN-SUFFIX,twitter.com,Main,#Twitter用主备策略组

七、脚本自动规则#

7.1 脚本规则类型#

类型说明示例
cron定时执行定时切换节点
url-test测速触发节点变快时自动切换
network网络变化切换WiFi时执行
battery电量变化低电量时切换

7.2 定时切换节点#

{
"scripts": [
{
"name": "定时切换",
"type": "cron",
"cron": "0 9 * * *",
"action": "switch-server",
"server": "HK-节点1"
},
{
"name": "晚高峰切换",
"type": "cron",
"cron": "0 20 * * *",
"action": "switch-server",
"server": "JP-节点1"
}
]
}

7.3 网络变化触发#

{
"scripts": [
{
"name": "WiFi连接",
"type": "network",
"trigger": "connected",
"action": "connect",
"policy": "Auto"
},
{
"name": "蜂窝数据",
"type": "network",
"trigger": "cellular",
"action": "disconnect"
}
]
}

7.4 自动更新规则#

{
"scripts": [
{
"name": "自动更新规则",
"type": "cron",
"cron": "0 0 * * *",
"action": "update-rules",
"url": "https://raw.githubusercontent.com/xxx/rules.txt"
}
]
}

八、Hysteria2协议配置#

8.1 手动配置#

{
"servers": [
{
"name": "HK-Hy2",
"type": "hysteria2",
"server": "hk.example.com",
"port": 443,
"password": "your-password",
"obfs": {
"type": "salamander",
"password": "obfs-password"
},
"alpn": [
"h3"
],
"hop-interval": 10,
"hop-interval-jitter": 3,
"recv-window": 67108864,
"max-conn-duration": 1800
}
]
}

8.2 通用链接格式#

hysteria2://password@server:port?obfs=salamander&obfs-password=xxx&alpn=h3&hop-interval=10

8.3 配置要点#

参数说明建议值
server服务器地址机场提供
port端口通常443
password密码机场提供
obfs混淆类型salamander
obfs-password混淆密码机场提供
alpnALPN协议h3
hop-interval跳跃间隔10
recv-window接收窗口67108864

九、高级配置#

9.1 分流模式#

{
"general": {
"routing": {
"mode": "rule-based",
"default-policy": "proxy"
}
}
}

分流模式

  • rule-based:规则分流(推荐)
  • global:全局代理
  • direct:全局直连

9.2 连接设置#

{
"general": {
"connection": {
"timeout": 10,
"keep-alive": true,
"max-connections": 100,
"retry-count": 3
}
}
}

9.3 Mux多路复用#

{
"advanced": {
"mux": {
"enabled": true,
"concurrency": 8,
"protocol": "http2"
}
}
}

9.4 监听端口#

{
"general": {
"listen": {
"http": 8080,
"socks5": 1080,
"redsocks": 1081
}
}
}

十、常见问题排错#

Q1:连接成功但无法上网#

排查步骤

  1. 检查节点配置是否正确
  2. 检查网络权限是否授予
  3. 检查规则是否正确(是否有REJECT规则拦截)
  4. 切换分流模式为全局代理测试
  5. 查看日志(设置→日志)

Q2:DNS解析失败#

解决

  1. 检查DNS服务器配置
  2. 启用FakeIP模式
  3. 配置DNS规则按域名分流
  4. 使用DNS over HTTPS/TLS

Q3:规则不生效#

排查

  1. 检查规则格式是否正确
  2. 检查规则顺序(按顺序匹配)
  3. 使用规则测试功能(点击规则右侧测试按钮)
  4. 检查是否有更高优先级规则覆盖

Q4:节点连接失败#

解决

  1. 检查服务器地址和端口
  2. 检查协议配置(密码、UUID等)
  3. 尝试更换节点
  4. 检查网络连接

Q5:脚本规则不执行#

排查

  1. 检查脚本格式是否正确
  2. 检查触发条件是否满足
  3. 查看脚本执行日志
  4. 重新启用脚本规则

十一、完整配置示例#

{
"general": {
"routing": {
"mode": "rule-based",
"default-policy": "proxy"
},
"connection": {
"timeout": 10,
"keep-alive": true
}
},
"dns": {
"servers": [
{
"name": "国内DNS",
"address": "223.5.5.5",
"type": "udp",
"policy": "direct"
},
{
"name": "Google DNS",
"address": "8.8.8.8",
"type": "https",
"url": "https://dns.google/dns-query",
"policy": "proxy"
}
],
"rules": [
{
"domain-suffix": ".cn",
"server": "国内DNS"
},
{
"default": "Google DNS"
}
],
"cache": {
"enabled": true,
"ttl": 3600
},
"fake-ip": {
"enabled": true,
"range": "198.18.0.0/15"
}
},
"route": {
"rules": [
"DOMAIN-SUFFIX,.cn,DIRECT,#国内域名直连",
"DOMAIN-SUFFIX,.google.com,PROXY,#Google代理",
"DOMAIN-SUFFIX,.twitter.com,PROXY,#Twitter代理",
"DOMAIN-SUFFIX,.youtube.com,PROXY,#YouTube代理",
"IP-CIDR,10.0.0.0/8,DIRECT,#内网直连",
"IP-CIDR,192.168.0.0/16,DIRECT,#内网直连",
"DOMAIN-SUFFIX,.doubleclick.net,REJECT,#广告拦截"
]
},
"policy": {
"groups": [
{
"name": "Auto",
"type": "selector",
"servers": ["HK-节点1", "JP-节点1", "US-节点1", "DIRECT"],
"default": 0
}
]
},
"servers": [
{
"name": "HK-节点1",
"type": "hysteria2",
"server": "hk.example.com",
"port": 443,
"password": "xxx",
"obfs": {
"type": "salamander",
"password": "xxx"
}
},
{
"name": "JP-节点1",
"type": "vmess",
"server": "jp.example.com",
"port": 443,
"uuid": "xxx",
"security": "auto"
},
{
"name": "US-节点1",
"type": "vless",
"server": "us.example.com",
"port": 443,
"uuid": "xxx",
"security": "auto"
}
]
}

十二、总结#

Quantumult X 是 iOS 上功能最强大的代理工具:

功能说明推荐度
Filter规则多维度匹配、灵活强大⭐⭐⭐⭐⭐
DNS配置FakeIP、规则分流、防污染⭐⭐⭐⭐⭐
策略组Selector/URL-Test/Fallback⭐⭐⭐⭐⭐
脚本规则自动切换、定时任务⭐⭐⭐⭐
协议支持Hy2/VLESS/VMess等⭐⭐⭐⭐⭐

行动建议

  1. 从订阅配置开始,快速上手
  2. 学习Filter规则编写,精细控制分流
  3. 配置DNS防污染,提高连接稳定性
  4. 使用策略组实现自动切换
  5. 配置脚本规则实现自动化

📚 相关文章推荐#


:::info 免责声明 本文为技术信息分享,不构成任何建议。请遵守当地法律法规,合理使用网络服务。 :::

Quantumult X配置完全指南:iOS高级代理工具从入门到精通(2026最新)
https://971918.xyz/posts/proxy-tools/quantumult-x-guide/
作者
九所长
发布于
2026-07-12
许可协议
CC BY-NC-SA 4.0