TL;DR

Quantumult X（白菜「圈 X」）$7.99 一次性买断，是 iOS / macOS 上脚本能力最强的代理客户端。核心差异化：JS 脚本 + URL 重写 + MITM 抓 HTTPS 三套合一。适合：要做 App 去广告 / API 改包 / 自动化签到 / 抓包调试的进阶玩家。对比：协议最全选 Shadowrocket；要极致体验选 Surge 5；免费选 Karing。

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

  1. App Store 切美区 Apple ID
  2. 搜 “Quantumult X”
  3. $7.99 购买
  4. 安装

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（推消息）。

社区脚本库

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 结尾，机场可指定输出格式

来源与最后核对

本文最后实际验证日期：2026-05-20。