Quantumult X(圈 X)由 crossutility 团队开发,2018 年起在 App Store 上架,中文社区习惯叫「圈 X」。它在 iOS / macOS 的脚本和重写圈子里是标杆级的存在。
Quantumult X 在 iOS 客户端中的位置
| 客户端 | 价格 | 脚本能力 | 重写能力 | MITM |
|---|---|---|---|---|
| Quantumult 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结尾,机场可指定输出格式