Quantumult X（圈X）使用教程：Quantumult 的重建版，从 conf 配置到脚本重写

软件介绍

Quantumult X（圈X，简称 QX）是 iOS 上功能上限最高的代理客户端之一，$9.99 买断制，开发者是 Cross Utility Ltd，需要外区 Apple ID 购买。官方 README 给自己的定位是「Quantumult Rebuilt from Scratch」——Quantumult 的完全重建版，不是小版本升级。

这个名字背后有个老坑：App Store 上同时存在两个 App——灰色图标的 Quantumult 基础版和蓝色图标的 Quantumult X 进阶版。文档说明，不带 X 的灰色版作者已停更多年，要买的是蓝色图标那个。每年都有新手搜「Quantumult」买错版本，下载安装部分会再强调一次。

QX 和其他两个 iOS 付费客户端的定位差异很清楚：小火箭 Shadowrocket 开箱即用，导入订阅就能跑；Loon 界面精致、有插件商店，介于两者之间；QX 把一切交给 conf 配置文件——节点、分流、重写、定时任务全写在文本配置里，上限最高，上手成本也最高。

围绕 QX 有一整套社区生态：KOP-XIAO 的资源解析器能把 Clash、V2rayN 等格式的订阅转成 QX 格式，GitHub 上截止到本文更新时间有 2981⭐；blackmatrix7 的 ios_rule_script 规则库截止到本文更新时间有 27,532⭐，提供几十个 App 的现成分流规则；Sub-Store 订阅管理的官方 README 支持列表里排第一的就是 QX；还有 BoxJs 脚本数据管理。具体用法放在后面的深入配置进阶篇里。

截止到本文更新时间，App Store 最新版本为 v1.6.0，2026-05-21 更新。注意：QX 本体是闭源买断制 App，不开源；GitHub 上的官方维护仓库 crossutility/Quantumult-X（截止到本文更新时间 3158⭐）放的是官方维护的示例配置、脚本和文档——sample.conf、资源解析器、重写说明、抓包脚本等，不是 QX 源码，下载后可以直接抄配置用。

优点和缺点

我的看法：QX 是「功能独一档、配置劝退一档」的典型。只翻墙的话它性价比很低；想要一个客户端把去广告、签到、解锁全包了，iOS 上只有它给得起这个折腾空间。

下载安装

在哪里买

先判断自己适不适合 QX：适合愿意编辑文本配置、需要脚本/重写/规则精细控制的人；不适合只想导入订阅、完全不想维护规则的人——后者选 Shadowrocket 更省心。另外 MitM 解密会看到指定域名明文流量，介意这点的也要慎重。

QX 需要外区 App Store 购买：中国大陆区 App Store 已下架，文档说明，在中国大陆商店购买的用户无法获得更新或重新下载。常见做法是注册美区 Apple ID，用 Apple 礼品卡充值后自行购买。

购买时注意：不要借朋友的 Apple ID，也不要去二手平台买成品账号或兑换码。文档说明，QX 有共享验证机制，用共享账号购买可能钱花了 App 却无法正常使用。礼品卡购买时地址选免税州，比如特拉华、蒙大拿、新罕布什尔、俄勒冈，可以省下消费税。

首次开启

安装后第一次打开，系统会询问本地网络、无线数据、通知权限，按文档说明选择允许。第一次开启代理时 iOS 会弹出「允许 VPN 配置」的确认，选择允许后顶部状态栏出现 VPN 图标，QX 开始接管流量。

使用教程

两种使用方式：简单模式 vs 配置模式

先看主界面长什么样（图片来自社区维护的 QX Wiki 教程，标注了各区域功能）：

图注：主界面各区域功能（图源：QX Wiki 社区文档）：顶部开关、节点面板、分流/重写/网络活动标签、底部工具栏。注意此图为旧版界面截图，当前版本底部工具栏最右侧是**三色风车图标**（代表出站模式），长按风车可切换模式、呼出资源更新和 HTTP 抓取

机场用户只需要三步，全程不碰配置文件：复制订阅链接 → 按下面「订阅导入」导入 → 打开首页开关。代理就跑起来了（见「开启代理」）。

QX 和 Shadowrocket 最大的不同是：它靠 conf 配置文件驱动，不是导入订阅那么简单。本文按使用复杂度把它分成两种上手路径：系统自带默认配置，导入机场订阅后就能用，这是简单路径；想去广告、解锁、自动签到，就要用别人做好的配置或自己写，这是配置路径。

订阅导入（简单模式）

机场后台一般都有「复制订阅链接」按钮（有的标「Quantumult X 一键导入」），点一下复制，然后：打开 App → 点击右下角彩色风车图标进入设置页 → 点击节点资源 → 点击右上角链接图标 → 在资源路径栏粘贴订阅地址，资源标签填写机场名字 → 右上角✔保存 → 打开开关 → 选择节点即可使用。第一次打开开关时系统会询问是否允许 VPN，选择是。全程不用手动写配置。

订阅添加后 QX 会自动写进配置文件的 server_remote 字段（就是"远程节点列表"），图形化添加时自动处理，不用手动改配置文件。节点列表里每个节点显示延迟测试结果。文档说明，QX 的延迟测试是网页响应性测试：对 server_check_url 发 HTTP HEAD 请求，记录通过该节点拿到 HTTP 响应所需的时间。Trojan 协议没有响应校验，即使测出延迟也不等于节点一定可用。节点名前出现 ⚠ 图标，文档说明这是节点名称重复的意思。

开启代理与切换节点

配置完成后，首页的开关就是总开关。QX 有三种出站模式，文档说明如下：

• 全部代理：首页风车为蓝绿色，所有请求都走节点
• 全部直连：风车为纯黄色，所有请求直连
• 规则分流：风车为三色，按分流规则和策略组决定出口

三种模式通过长按首页右下角风车切换。长按还能呼出资源更新和HTTP 抓取入口：资源更新按钮 🔁 会更新所有外部资源，包括节点、分流、重写及其引用的脚本，这是文档说明的。

切换节点：首页节点面板直接点选节点，或进入策略组选择。节点名旁边显示延迟测试结果。左上角出现红色🔺警告时，表示有资源出错，点击可查看具体是哪个资源的问题，这是文档说明的。

首页的 proxy 策略对应当前选中的节点，分流规则里写 proxy 表示走当前选中的节点。想按地区或用途细分，就在 [policy] 里定义策略组并让分流规则引用组名。

深入配置（进阶篇）

配置文件（conf）体系

QX 的配置文件是纯文本，用 [字段名] 分节。文档说明，一个配置文件里不能有重名字段，比如不能出现两个 [general]；以 ;、#、// 开头的是注释行。

[general]
server_check_url = http://www.qualcomm.cn/generate_204
resource_parser_url = https://raw.githubusercontent.com/KOP-XIAO/QuantumultX/master/Scripts/resource-parser.js

[dns]
no-system
no-ipv6
server = 119.29.29.29
server = 223.5.5.5:53

[policy]
static=全球加速, 香港节点, 美国节点, 日本节点

[server_remote]
https://example.com/你的机场订阅链接, tag=我的机场, update-interval=86400, opt-parser=false, enabled=true

[filter_local]
geoip, cn, direct
final, proxy

[rewrite_local]

[task_local]
0 0 * * * https://raw.githubusercontent.com/crossutility/Quantumult-X/master/sample-task.js#force-timeout=10000&method=POST, tag=Sample, img-url=https://raw.githubusercontent.com/crossutility/Quantumult-X/master/quantumult-x.png, enabled=true

[mitm]
hostname = 

先认一遍设置页，QX 的入口都在这（图源：QX Wiki 社区文档，中文界面）：

图注：设置页总览（图源：QX Wiki 社区文档）：节点、分流、重写、MitM、工具&分析、配置文件六大块

编辑配置文件：设置 → 配置文件 → 编辑。勾选 iCloud 云盘后，配置文件存放在「iCloud 云盘/Quantumult X」目录，否则在「我的 iPhone/Quantumult X」，里面通常有 Script、Profiles、Images 三个文件夹，分别放脚本、配置片段和策略图标，按文档说明，适合在电脑上编辑后同步。

配置片段也就是 .snippet，可以把一段独立配置单独保存、按需启用，比如一组本地节点或一个去广告重写片段，不需要每次改主配置。通过 设置 → 配置文件 → 配置片段 管理，文档说明本地片段放在 Profiles 文件夹。

[policy]
static=全球加速, 香港节点, 美国节点, 日本节点
available=香港故障转移, server-tag-regex=香港|HK|Hong
url-latency-benchmark=香港最低延迟, server-tag-regex=香港|HK|Hong, check-interval=600, tolerance=0

分流规则

分流是 QX 的灵魂。文档说明，每条分流规则由三部分组成：类型、参数、策略。参数满足时规则命中，流量按策略处理。

优先级从高到低：filter_local 本地规则 > filter_remote 远程规则集 > final 兜底。文档说明，开启「分流优化」后，同级别规则按 host > host-suffix > host-keyword wildcard > geoip = ip-cidr ip6-cidr > user-agent 的顺序匹配；不开优化则完全按配置里的书写顺序从上到下匹配。

补充：iOS 15 之后系统不再在 CONNECT 请求里提供 User-Agent，所有 HTTPS 请求在未开启 MitM 时 UA 规则不生效，这是文档说明的。

[filter_local]
; 局域网与内网：直连
ip-cidr, 10.0.0.0/8, direct
ip-cidr, 127.0.0.0/8, direct
ip-cidr, 172.16.0.0/12, direct
ip-cidr, 192.168.0.0/16, direct
; 去广告：拒绝
host-keyword, adsite, reject
; 国外必须代理
host, www.google.com, proxy
host-suffix, googleapis.com, proxy
; 国内直连
geoip, cn, direct
; 特定 ASN 走代理
ip-asn, 6185, proxy
; 兜底
final, proxy

[filter_remote]
https://example.com/reject.txt, tag=广告拦截, force-policy=reject, update-interval=86400, opt-parser=true, inserted-resource=true, enabled=true

规则集的添加路径（以奈飞走新加坡节点为例，文档说明）：

1. 找到规则集 raw 链接，比如 blackmatrix7 的 Netflix 规则
2. 设置 → 分流 → 规则资源 → 右上角链接图标，资源路径粘贴 raw 地址
3. 策略偏好选择新加坡节点，资源标签写「奈飞视频」
4. 右上角✔保存；长按规则集条目可拖动调整顺序

分流规则的排列原则是小范围规则在上、大范围规则在下、最后兜底。完整配置的规则顺序通常是：修正规则直连、去广告 reject、特殊服务单独分流、国外必须代理、国内直连 GEOIP、FINAL 兜底，这是文档说明的。

重写（Rewrite）

重写是 QX 的招牌功能，官方 README 把它列为新特性。文档说明，QX 的重写可以修改：

图注：重写类型选择（图源：QX Wiki 社区文档）：reject 拦截、302/307 重定向、请求响应修改、echo-response、script 脚本

• 重定向：302、307，302 会把 POST 改成 GET 且不保留请求体，307 保留请求体
• 请求头/请求体：request-header、request-body
• 响应头/响应体：response-header、response-body
• 本地映射：echo-response，直接返回自定义静态响应，相当于 mock
• JavaScript 脚本：script-request-header、script-response-body 等，对请求响应做任意处理

常用的拦截类重写：

这些类型的典型用途是去广告：App 的广告接口返回空数据，前端拿不到广告内容自然不展示。

重写要生效，HTTPS 流量需要先经过 MitM 解密。文档说明，QX 的 MitM 根证书用于 HTTPS 解析，只有配置了主机名的域名才会被解密；主机名支持 *、? 通配符，前缀 - 排除特定主机名，单独的 * 会匹配全部主机名。官方文档明确提醒：不要随意添加带大量 * 的主机名，有些 App 比如 App Store、抖音、支付宝，MitM 会导致无法使用。

证书安装流程：MitM 设置里生成证书 → 允许下载 → 手机「设置 → 已下载描述文件 → 安装」→「通用 → 关于本机 → 证书信任设置」启用（菜单名称在不同 iOS 版本可能有差异），以上按文档说明。信任完成后 MitM 开关才能打开。证书信息，包括 passphrase 和 p12，会写进配置文件的 [mitm] 字段，换配置时复制过去就不用重新装证书。

[rewrite_local]
^https:\/\/mbasecc\.bas\.cmbchina\.com\/Edge\/api\/mlife\.clientface\.clientservice\.api\.advertiseService\/preCacheAdvertiseSec url reject-dict

[mitm]
hostname = mbasecc.bas.cmbchina.com

[rewrite_remote]
https://raw.githubusercontent.com/crossutility/Quantumult-X/master/sample-import-rewrite.snippet, tag=Sample, enabled=true, update-interval=86400, opt-parser=true

脚本玩法

先说边界：脚本、重写、抓包这些玩法只建议用在自己设备、自己的账号上做合法用途——去自己账号的广告、签自己的到没问题；绕过付费、访问他人数据、分发含凭据的脚本都不在本教程范围内。下面按社区常见用法介绍。

QX 的脚本生态是它区别于其他 iOS 客户端的核心。社区常见玩法：

• 去广告：拦截开屏广告、网页广告接口
• Cookie 同步：抓取网页 Cookie 存到 BoxJs，供签到脚本使用
• 自动签到：定时任务每天自动执行签到脚本
• 会员解锁：改写部分 App 的会员权益接口，注意合规与风险

脚本以定时任务形式运行，对应配置文件的 [task_local] 字段，语法是 cron 表达式 + 脚本地址：

[task_local]
0 0 * * * https://raw.githubusercontent.com/crossutility/Quantumult-X/master/sample-task.js#force-timeout=10000&method=POST, tag=Sample, img-url=https://raw.githubusercontent.com/crossutility/Quantumult-X/master/quantumult-x.png, enabled=true

和签到脚本配套的通常是 BoxJs——脚本数据管理工具，用来存 Cookie、用户名、密码等参数。QX 里通过重写资源添加 BoxJs 订阅，然后在 BoxJs 面板里填参数，官方说明在 docs.boxjs.app。涉及 Cookie 的脚本需要先抓包拿到 Cookie，再填进 BoxJs。

资源解析器

资源解析器是 QX 生态里绕不开的一环，作者是 KOP-XIAO，也就是资源圈常说的 Shawn，GitHub 仓库 QuantumultX 截止到本文更新时间有 2981⭐。仓库 README 注明纯自用、不保证维护和更新，仅资源解析器仍维护——规则和脚本内容参考即可，别当长期依赖。它在配置文件 [general] 字段里通过 resource_parser_url 指定，只能添加一个，不要重复添加，这是文档说明的。

解析器做三件事：

1. 节点转换：把 V2rayN、SS/SSR/SSD、HTTP(S)、Trojan、Quantumult(X)、Surge、Clash、Shadowrocket、Loon 等格式的订阅转成 QX 格式，支持筛选、重命名等个性化参数
2. 重写/分流转换：把 Surge 的 rule-set、domain-set、module，Clash 的 Rule Provider，纯域名 list 等转成 QX 支持的内容
3. 筛选修改：按参数删除或保留指定的重写、主机名、分流规则

用法是在订阅或资源链接后面加 # 和参数，多个参数用 & 连接：

你的订阅链接#emoji=1&tfo=1&in=香港+台湾

Sub-Store 是订阅管理工具，官方 README 首行支持列表是「QX, Loon, Surge, Stash, Egern and Shadowrocket」。它可以把多个机场订阅合并成一个、过滤节点、转换格式，生成给 QX 用的订阅地址，和解析器配合使用效果最好。

规则库生态

blackmatrix7/ios_rule_script 是 QX 圈最常用的规则库，27,532⭐，截止到本文更新时间。仓库按 App 分类，目录结构是 rule/QuantumultX/App名/App名.list，覆盖几十个常见 App，比如奈飞、OpenAI、YouTube、Spotify，都是现成的分流规则。

以添加 OpenAI 分流为例（文档说明路径）：

1. 打开 blackmatrix7 仓库，进入 rule/QuantumultX/OpenAI/ 找到 .list 文件
2. 复制 raw 格式地址：仓库里 blob 开头的网页地址要改成 raw.githubusercontent.com 开头，或者直接点页面的 Raw 按钮
3. 设置 → 分流 → 规则资源 → 右上角链接图标，粘贴 raw 地址，策略偏好选你的美国或日本节点，保存

规则集之间的顺序可以调整：长按规则集条目，最右侧出现三横线图标后拖动。特殊分流比如 OpenAI、奈飞，建议放在通用国外规则上方，这是文档说明的。

排查问题时，QX 内置的 HTTP 抓取和网络活动页是主要工具，官方 README 把 HTTP Analyzer 列为新特性：

图注：网络活动页（图源：QX Wiki 社区文档）：每条请求的时间、耗时、策略走向、命中的分流规则、MitM 状态都能看

• 开启抓包：长按首页右下角风车 → 点击 HTTP抓取；或 设置 → 工具&分析 → HTTP抓取 → 右上角 HTTP 图标。开启后首页开关左侧出现 ⚠️ 警告标识，提醒正在记录流量，这是文档说明的
• 查看数据：抓包页能看到每条请求的 URL、请求头、请求体、响应码、响应头和响应体，找到广告或签到接口后写成重写规则
• 网络活动：首页网络活动页记录 TCP/UDP 连接，某个 App 打不开时来这里看是不是被 REJECT 了、命中了哪条规则，这是文档说明的
• 日志：脚本运行记录在日志页，级别分 Error、Warning、Info、Debug 四档，脚本报错时调到 Debug 再手动触发一次任务，这是文档说明的

排查流程：开抓包 → 复现问题 → 网络活动看命中规则 → 日志看脚本报错 → 改配置 → 资源更新。

远程托管配置

QX 官方文档仓库里有一页 remote-managed-configuration 专门讲远程托管配置：把配置文件放到 GitHub 等远程地址，在 设置 → 下载配置 里粘贴链接，QX 拉取远程内容作为当前配置。好处是配置跟着链接走，换设备、分享都方便；下载配置会覆盖当前全部内容，导入前先导出备份，这是文档说明的。

社区常用配置（来源：社区整理的官方文档 Wiki）：

• Lucky 配置
• Shawn 配置
• 小白配置

除了完整配置，还有专门的配置分享项目，按需引用规则集或直接拿懒人配置：

• 帝少代理配置库（323⭐）：懒人完整配置，QX 版直接下 quanx.conf（注意仓库更新停在 2024 年，规则可能偏旧）
• FuGfConfig（255⭐）：按需引用的规则集（FuckRogueSoftware 反流氓软件、Apple 更新等），支持 QX/Loon/AdGuard，配置里加一行远程引用即可
• 黑猫规则库（27,532⭐）：不是完整配置，是按 App 分好的分流规则集，上文「规则库生态」讲过用法

下载完配置后，记得导入自己的机场订阅，并检查 [server_remote] 里引用的节点是不是自己套餐的，这是文档说明的。

常见问题

1. Quantumult X、Shadowrocket、Loon 怎么选？

省心选 Shadowrocket，美区 $2.99 买断，导入订阅就能用；要插件商店和精致界面选 Loon，美区 $7.99 买断，介于两者之间；要功能上限选 Quantumult X（美区 $9.99）——脚本、重写、策略组最全，但要学配置。只翻墙的话小火箭足够，想折腾去广告和自动签到才需要 QX。

2. 配置能分享吗？

能。QX 配置是纯文本，直接复制 conf 内容即可分享，也可以做成 .snippet 配置片段。网上流传的配置模板大多来自 GitHub 和 Telegram 频道，用之前先看作者说明。

3. 脚本有安全风险吗？

有，而且比其他客户端更大。脚本运行在 QX 的网络处理流程里，可以看到全部请求内容。只用长期维护的知名仓库的脚本，不用来源不明或要求填账号密码的脚本。

4. 支持 Clash 配置吗？

QX 用自己的 .conf 格式，不能直接导入 Clash 的 YAML 配置。但机场订阅如果是 Clash 格式，可以开资源解析器转换；规则集也可以用解析器把 Clash Rule Provider 转成 QX 格式。

5. 买错 Quantumult 基础版怎么办？

App Store 购买后短时间内可以申请退款，退款后重新购买 Quantumult X，认准蓝色图标。官方文档也提醒，不要借别人的 Apple ID 或买二手账号，QX 有共享验证，共享账号可能无法正常使用。

6. 支持 VMess 和 VLess 吗？

支持。文档说明，QX 可以通过文本配置添加 VMess 和 VLess 节点，格式是 vmess=、vless=，VLess 支持 tls、ws、wss 等多种混淆方式；官方 README 还提到 V2Ray websocket+TLS over SS，mux 参数为 0。手里的订阅是 v2rayN 或 Clash 格式时，用资源解析器转换即可。

7. 配置编辑不方便怎么办？

手机端在 设置 → 配置文件 → 编辑 里改；长配置建议电脑上编辑。开启 iCloud 后配置文件在「iCloud 云盘/Quantumult X」目录，电脑改完保存，手机上更新资源即可。多段独立配置做成配置片段按需启用，不用反复改主配置。

8. 订阅多久更新一次？

默认 update-interval=86400，也就是 24 小时自动更新一次，可以在订阅条目上改。手动更新：长按风车点 🔁 全部更新，或在规则资源里左滑单条更新。左上角红色🔺表示有资源出错。

9. 一定要外区 Apple ID 吗？

是。QX 已从中国大陆区 App Store 下架，需要外区 Apple ID 购买，这是文档说明的。注册美区 ID + 礼品卡充值最常见，礼品卡地址选免税州能省消费税。

10. 延迟测试准吗？

文档说明，QX 的延迟测试是网页响应性测试，通过 HTTP HEAD 请求 server_check_url，显示的是拿到 HTTP 响应的时间。延迟低不等于速度快——延迟只代表响应时间短，带宽可能很低；Trojan 协议无响应校验，测出延迟也不等于节点一定可用。

11. 一次购买能用在哪些设备上？

App Store 页面列出 iPhone、iPad、Mac、Apple TV 支持，一次购买多平台通用（按当前商店政策），这是文档说明的。系统要求：iOS/iPadOS 13.0+、macOS 11.0+、tvOS 17.0+。

12. 规则报错出现「Shawn 策略组」是怎么回事？

这是开启资源解析器且远程规则没设置策略偏好导致的：解析器自动把规则策略改成 Shawn 策略组。到规则资源的策略偏好里指定一个实际存在的策略组，报错消失，Shawn 策略组也可以删掉，这是文档说明的。

13. 去广告规则不生效怎么办？

按顺序排查：MitM 开关是否打开、证书是否已信任、hostname 是否包含目标域名、重写规则是否被解析器筛选掉了、脚本是否失效。开抓包确认请求确实命中规则，再决定是否换脚本或更新规则集。

14. 会额外消耗流量吗？

QX 本身只转发流量，不产生额外消耗。但出站接口选了「Wi-Fi&蜂窝网」或「负载均衡」模式时，在 Wi-Fi 下也会使用蜂窝数据，这是文档说明的，流量套餐用户注意别误开。

对比与取舍

我的取舍建议：只翻墙选 Shadowrocket，省钱又省心；想轻度折腾、又要好看界面选 Loon；要一个 App 干完去广告、签到、解锁所有事，才轮到 Quantumult X。QX 的学习曲线是真实的——跨过 conf 语法这一关之后，iOS 上确实没有第二个客户端能给你同样的控制力。它的价值不在「翻墙」本身，而在把网络请求变成可以编程修改的东西。