Quantumult X(圈 X)由 crossutility 团队开发,2018 年起在 App Store 上架,中文社区习惯叫「圈 X」。它在 iOS / macOS 的脚本和重写圈子里是标杆级的存在。
Quantumult X 在 iOS 客户端中的位置
客户端价格脚本能力重写能力MITMQuantumult X$7.99 买断★★★★★★★★★★★★★★★Surge 5$49.99/年订阅★★★★★★★★★★★★★★★Loon$5.99/年订阅★★★★★★★★★★★★★Shadowrocket$2.99 买断★★★★★★★★★Stash$4.99 买断★★★(Override)★★❌
QuanX 的「脚本 + 重写 + MITM」三合一是性价比之王。
购买 + 安装
iOS / iPadOS
App Store 切美区 Apple ID
搜 “Quantumult X”
$7.99 购买
安装
macOS
Apple Silicon 直接同 Apple ID 在 Mac App Store 下载(iOS App on Mac 模式)。
第一次配置
1. 添加订阅
QuanX 没有图形化的 “添加订阅”。需要订阅 URL 后:
复制订阅 URL 到剪贴板
QuanX 主界面 → 一键导入按钮 → 自动识别剪贴板订阅 URL → 导入
或手动编辑配置:
主界面右下角 → 设置图标 → 配置 → 编辑
在 [server_remote] 段添加:
https://example.com/api/v1/client/subscribe?token=xxx, tag=机场名, update-interval=21600, enabled=true
2. 启动代理
主界面顶部圆形按钮 → 开启。iOS / macOS 弹 VPN 权限 → 同意。
3. 选节点
主界面 Proxies → 节点组 → 手动选 / 自动测速。
脚本系统
在 [task_local] 中注册定时脚本
event-interaction https://example.com/script.js, tag=每日签到, img-url=icon.png, enabled=true
脚本写法(JS)
const url = $request.url;
const headers = $request.headers;
const body = $request.body;
// 改请求 body
const newBody = body.replace("foo", "bar");
$done({ body: newBody });
支持的对象:$request、$response、$persistentStore(持久存储)、$httpClient(发 HTTP 请求)、$notification(推消息)。
社区脚本库
github.com/Choler/QuantumultX(淘宝京东自动签到大本营)
github.com/blackmatrix7/ios_rule_script(规则脚本一站式)
github.com/NobyDa/Script
URL 重写
基本语法
^https?://example\.com/api/ad url reject-200
^https?://api\.tb\.com/sign url script-response-body sign.js
^https?://(.+)\.bilibili\.com/api/dm/list url script-response-body bili-dm.js
支持动作:
reject / reject-200 / reject-dict:拦截
302 https://new.com:跳转
script-request-header:脚本改请求头
script-request-body:脚本改请求体
script-response-header:脚本改响应头
script-response-body:脚本改响应体
MITM 配置
[mitm]
hostname = api.example.com, *.tb.com, *.alipay.com
启动后 QuanX 提示「安装 CA 证书」→ 装到 iOS 信任根 → 启用 → 重写就可以解 HTTPS 改包。
常见报错
订阅导入后节点空
订阅 YAML 格式不对 → 经 Sub-Store 转 QuanX 格式
订阅过期 → 联系机场
脚本不执行
检查 [task_local] 段是否 enabled=true
看 QuanX 控制台日志(设置 → Console)
检查脚本 URL 能否访问
MITM 抓不到包
CA 证书未安装到信任根:iOS 设置 → 通用 → 关于本机 → 证书信任设置 → 启用
hostname 没匹配上:检查 [mitm] 段配置
QuanX 配套订阅
配套订阅参考 多格式测试订阅源(同时支持 QuanX / Clash / sing-box 格式)
QuanX 订阅 URL 通常以 ?flag=quanx 或 ?target=quanx 结尾,机场可指定输出格式