Quantumult X 使用指南 2026【完整教程】| 圈X配置与进阶技巧

Quantumult X 是什么

Quantumult X，也就是大家常说的“圈X”，是一款由 Cross Utility Ltd 开发、在 App Store 售价 $7.99 的 iOS 网络工具。它最早是面向 iPhone 和 iPad 用户的代理客户端，但随着 Apple Silicon 普及，现在也能在部分 M 系列 Mac 上直接运行 iPhone/iPad 版本，这让它成为 Apple 生态里讨论度极高的高级客户端之一。

和只负责“导入订阅然后一键连接”的轻量工具不同，Quantumult X 的核心价值在于它把 节点管理、策略分流、Rewrite、MitM、JavaScript 脚本 都放进了同一个应用里。你既可以把它当成普通代理软件来用，也可以把它当成 iOS 上的小型网络自动化平台。

这也意味着它的学习曲线不会特别平缓。新手第一次打开 Quantumult X 时，通常会被资源、策略组、过滤规则、远程订阅和脚本这些概念同时包围。但一旦你理解了它的组织方式，就会发现圈X 在 Apple 平台上的可塑性非常强，远不是“只能导入机场订阅”的工具可以相比。

为什么 Quantumult X 一直很受欢迎

圈X 长期受欢迎，首先是因为它的能力边界足够宽。很多 iOS 客户端在“节点订阅”这个层级就停止了，但 Quantumult X 还继续往下做：它允许你把服务器订阅、过滤规则、Rewrite 资源、脚本任务拆开管理，并且支持本地和远程混合配置，这种灵活性对重度用户特别有吸引力。

第二个原因是它的 JavaScript 脚本引擎。在 Apple 生态里，能稳定承载请求脚本、响应脚本、定时任务和通知自动化的代理工具并不多，而 Quantumult X 正是靠这套能力建立了自己的护城河。很多签到、数据获取、请求头处理与自动化逻辑，都是通过这套脚本机制完成的。

第三个原因是它的 Rewrite + MitM 体系。只要你理解了域名匹配、证书信任和脚本触发条件，Quantumult X 可以非常细粒度地修改请求行为，甚至让一些只能在桌面端完成的网络调试工作，直接在 iPhone 或 iPad 上完成。

购买、下载与安装

安装 Quantumult X 的唯一正规入口是 App Store。搜索 Quantumult X，确认开发者是 Cross Utility Ltd，再完成购买。由于它是付费应用，所以不建议从共享账号、第三方签名平台或来路不明的 IPA 包获取，原因很简单：这类来源最容易带来证书失效、版本过旧或者配置残留问题。

在 iPhone 或 iPad 上首次启动时，系统会请求你授予 VPN 配置权限。这里不要紧张，Quantumult X 和其他代理客户端一样，需要通过系统 VPN 框架来接管流量。授权完成后，应用本身就能开始导入节点、应用规则和接管网络请求。

如果你使用的是 Apple Silicon Mac，也可以尝试在 Mac App Store 中安装这款 iPhone/iPad 应用。需要注意的是，能否直接看到安装入口，取决于当前 Apple ID 所在区域以及开发者是否允许该应用显示在 Mac 端。如果你的主要设备其实是 Mac，而且更希望获得真正的桌面原生体验，后面我们也会解释为什么 ClashX 下载页 往往是更省心的选择。

首次配置应该先做什么

圈X 第一次上手，最值得先弄明白的不是某个神秘脚本，而是它的配置层次。最常见的四个部分分别是：服务器资源、策略组、过滤规则、Rewrite/脚本。你可以把它理解成一条流水线：先把可用节点导进来，再决定这些节点如何被策略组调用，然后通过规则决定什么流量走代理，最后再用 Rewrite 和脚本对特定请求做精细处理。

如果你刚买完应用，建议先保留一个尽量干净的基础配置。不要急着开启几十个远程资源，也不要一开始就追求“和别人同款大而全面板”。一个能稳定打开网页、能切换几个常用节点、能看懂策略组名字的基础配置，价值远高于导入一份自己完全不了解的复杂配置。

另一个常见建议是先测试单节点，再测试策略组。很多人以为导入订阅后一切就结束了，结果真正的问题其实是：某些组没有默认策略、某些规则引用了不存在的组、某些模块依赖 MitM 但证书还没装好。只要按层拆开测试，Quantumult X 并没有想象中那么难。

如何导入订阅

Quantumult X 支持的导入方式不止一种。最常见的是从服务商那里拿到专门给 QX 使用的订阅链接，然后在资源页面添加远程资源。这里要注意一个细节：很多机场会把“节点订阅”“分流规则”“Rewrite 模块”拆成不同链接，所以你不能只粘贴一个地址，然后期待所有功能都自动出现。

更稳妥的做法是分开理解资源类型。服务器资源负责导入节点，过滤规则资源负责分流，Rewrite 资源负责请求改写与脚本挂载。如果你的服务商提供了专门的 Quantumult X 解析链接，优先用它；如果只给了 Clash YAML 或通用订阅链接，通常还需要经过解析器或者转换器处理，才能变成 QX 能稳定识别的格式。

导入成功之后，不要只看列表里有没有节点名称，还要实际切换一个节点测试网页访问，并观察策略组是不是已经正常引用。很多“导入失败”的本质，其实不是软件出错，而是拿到了错误类型的链接，或者导入了节点却没有同步导入配套规则。

规则管理：把分流思路理顺

对大多数人来说，Quantumult X 真正的门槛不是连接节点，而是理解“什么流量走哪里”。圈X 的规则管理通常分成两部分：一部分来自远程过滤规则，另一部分来自你自己的本地覆盖规则。远程规则适合承接大多数公共网站与服务，本地规则则专门处理你的个人需求，例如公司域名、局域网服务、特定 App 或某些站点的直连/代理策略。

规则不是越多越好，而是越清楚越好。你应该知道每个策略组对应什么用途，例如“手动选择”“自动延迟测试”“流媒体”“直连”“拦截”这些名字是否真的能反映实际作用。只要策略组命名混乱，后面再强的脚本和模块都会变成黑盒。

如果你刚开始尝试本地规则，不需要一口气写很多条。先从最常见的域名与私网地址开始，确保直连和代理的边界清晰。下面这段示例就体现了最简单的思路：本地域名和内网地址走直连，指定站点走代理，其余继续交给现有策略组处理。

host-suffix,apple.com,DIRECT
host-suffix,openai.com,Proxy
ip-cidr,192.168.0.0/16,DIRECT

当你发现某个网站总是走错出口时，优先检查两件事：这条规则是否真的生效，以及策略名称是否与你当前配置中的组名完全一致。圈X 的很多“玄学问题”，最后都只是规则顺序或组名引用写错而已。

Rewrite 系统怎么用

Rewrite 是 Quantumult X 最强也最容易误用的部分之一。简单理解，它负责在请求真正发出去之前，或者响应真正送回应用之前，对数据做一次“改写”。常见用途包括屏蔽广告请求、改写 Header、重定向 URL、挂载脚本，以及处理某些应用的功能修复。

很多网上流传的 QX 模块其实本质就是 Rewrite 集合。问题在于，模块数量越多，互相冲突的概率越高。你今天导入一个通用去广告包，明天再导入一个 App 专属增强包，后天再加一个签到脚本合集，最终最容易出现的情况不是“功能越来越强”，而是某个应用莫名其妙登录失败、支付页空白，或者请求被错误拦截。

正确的使用方式是分层管理 Rewrite：广告类一个组、功能修复类一个组、签到脚本类一个组，每次只新增一类，并立即验证受影响的 App。你不需要追求“全网最全模块”，只需要保留自己真正理解并且确实在用的那部分。

脚本基础：Quantumult X 的灵魂功能

如果说 Rewrite 是 Quantumult X 的骨架，那么 JavaScript 脚本 就是它的灵魂。圈X 支持请求脚本、响应脚本和定时任务脚本，这使它不仅能代理流量，还能处理自动签到、接口抓取、通知提醒、请求头改写和响应内容分析。很多人买 Quantumult X，本质上买的就是这套脚本生态。

但脚本并不是越多越好。一个脚本能否正常运行，至少取决于三件事：触发条件写得对不对、匹配的域名对不对，以及它是否依赖 MitM。很多新手复制脚本以后发现毫无反应，往往不是脚本坏了，而是没有让 HTTPS 请求正确解密，或者请求根本没有命中脚本指定的规则。

下面这个最小示例展示的是一个典型请求脚本的结构。它读取当前请求头，新增一个自定义字段，然后用 $done 把修改后的结果交回 Quantumult X。你不一定马上要自己写脚本，但理解这种基本结构会让你看懂大多数第三方脚本。

const headers = $request.headers;
headers['X-Debug'] = '1';
$done({ headers });

如果你准备长期用圈X，建议至少掌握三件事：如何判断脚本类型、如何确认脚本依赖的域名、以及如何查看脚本是否真的被触发。只要理解这三个点，大部分“脚本不生效”的问题都能自己排掉。

MitM 设置：进阶用户绕不开的一步

MitM，也就是中间人解密，是 Quantumult X 高级玩法的基础设施之一。很多响应脚本、Header 修改、登录态处理和某些 Rewrite 功能，本质上都需要先看到 HTTPS 里的真实内容，才能继续处理。所以你会发现，很多脚本说明都会写一句“请确认已正确配置 MitM”。

标准流程通常分为两步：先在 Quantumult X 内生成并安装证书，然后到 iOS 的 设置 > 通用 > 关于本机 > 证书信任设置 里手动开启完全信任。证书安装完成后，再回到圈X 中添加需要解密的域名。重点在于域名要精准，不要为了省事把一大堆无关主机名都加进去。

MitM 真正难的地方不在按钮，而在边界控制。你应该只为明确需要的服务开启解密，例如某个签到脚本依赖的 API 域名，或者某个功能修复模块指定的主机。范围越大，风险越高，也越容易和正常 App 行为产生冲突。

常见问题与排错思路

导入订阅后有节点但无法访问： 优先确认你拿到的是 Quantumult X 专用链接，而不是 Clash、Surge 或通用格式链接。很多机场面板会同时提供多个订阅地址，拿错格式是最常见的问题之一。

某个 App 开始异常、闪退或无法登录： 通常先怀疑 Rewrite 和脚本，而不是节点本身。最稳的办法是把最近新增的模块逐个关闭，再重开应用测试。圈X 的模块冲突比“节点坏了”更常见。

脚本完全不触发： 先检查脚本类型是否匹配请求场景，再检查域名是否写进了 Rewrite 或 MitM，最后再看证书是否真的完成信任。只要其中一步没做好，脚本都可能看起来像“没有任何反应”。

Mac 上能装但体验不顺手： 这是很正常的。Quantumult X 本质上仍然是 iOS 应用，哪怕能在 Apple Silicon Mac 上运行，菜单交互和系统整合也未必是你想要的桌面体验。如果你的主战场是 macOS，原生工具通常更舒服。

Quantumult X 适合什么人

圈X 并不是人人都需要的工具。假如你的需求只是“导入一个订阅，然后稳定上网”，那它的高级功能很可能大材小用。真正会从 Quantumult X 获益的人，通常有几个共同点：愿意自己理解规则、需要脚本能力、会折腾 MitM，或者希望把 iPhone、iPad 和 Apple Silicon Mac 纳入同一套代理逻辑。

简单说，如果你的主设备是 iPhone 或 iPad，而且你希望把代理当作“可编排工具”来用，Quantumult X 很值得。如果你只是需要一款免费、原生的 macOS 代理工具，那就没必要为了脚本生态强行在 Mac 上适配 iOS 应用。

给 macOS 用户的补充建议

Quantumult X 可以跑在 Apple Silicon Mac 上，这确实给了很多 Apple 全家桶用户一种“配置可以共用”的感觉。但从桌面体验来看，它终究还是 iPhone/iPad 应用在 Mac 上的延伸版本，而不是专门为菜单栏、系统代理切换和桌面网络习惯打造的原生客户端。

如果你主要使用的是 Mac，而且希望获得更轻量、更原生、更省心的代理工作流，直接试试 ClashX 会更实际。它本来就是面向 macOS 的免费原生工具，安装、开机自启、菜单栏控制和系统整合都更自然。你可以直接前往 ClashX 下载页面 获取更适合 Mac 的方案。

常见问题 FAQ

下面这 6 个问题，基本覆盖了大多数人在第一次接触 Quantumult X 时最容易踩到的坑：价格、平台兼容、MitM、脚本、订阅资源拆分，以及它和 macOS 原生工具之间的选择逻辑。