Quantumult X 使用教程:配置文件与规则入门

先说结论

Quantumult X 的上手路径是先拿到一份能读懂的配置文件,再往里放节点、写分流规则、按需挂远程资源,最后用自己的办法核对流量是否走对。它不提供节点,字段细节以官方示例配置为准,建议先备份再改。

Quantumult X

类型
iOS 付费客户端
内核
—
支持系统
macOS、iPhone / iPad
最新版本发布于
—
版本核验时间
2026-10-10 12:27 UTC(来源:GitHub 官方接口)
官方地址
github.com/crossutility/Quantumult-X/releases

Quantumult X 是一个“读配置干活”的工具:节点、分流、重写都写在一份文本里,界面只是这份文本的外壳。所以这篇 Quantumult X 使用教程不从按钮讲起,而是从配置文件讲起,告诉你该先看哪几块、改之前该做什么、改完怎么确认没改坏。它只面向苹果设备,客户端本身的定位见 Quantumult X 档案。

为什么这份 Quantumult X 使用教程绕不开配置文件

很多图形化客户端把“导入订阅、选节点”做成两三步。Quantumult X 的思路不同:它把代理节点、分流条件、重写规则、MitM 主机名等都放进同一份配置,用分段的方式组织。读得懂这份文件,几乎等于读得懂这个工具。

这带来两个直接后果:

  • 上手门槛高一点:第一次打开可能看不懂各段的含义,但换来的是可以逐条审阅,不用担心有哪条规则是看不见的。
  • 一次改错会影响全部:规则顺序、缩进、拼写都可能让整份配置失效,所以备份比任何技巧都重要。

如果你更想要“导入订阅就能用”,先看 Shadowrocket 使用教程 再决定,两者的取舍在 Shadowrocket 与 Quantumult X 对比 里讲过。

第一步:拿到应用,并先备份一份空白配置

下载只认官方入口,即 App Store 里的 Quantumult X 页面,入口汇总在 下载导航。这个应用是付费的,价格与最低系统要求以商店页面为准,它在不同地区商店的可见性也可能不同,涉及 Apple ID 地区的问题见 苹果梯子怎么选。不要从聊天群或网盘里装来路不明的包,也不要使用共享账号。

装好之后,先别急着填节点,做这三件事:

  1. 打开配置编辑页,看一眼现有内容有哪些分段。
  2. 把整份内容复制一份,存到备忘录或文件里,命名带上日期。
  3. 打开官方示例配置,在手机上留个标签页,之后遇到不认识的字段就回来查。

这三步花不了五分钟,却能让你后面任何一次改动都有退路。

第二步:把节点放进配置,有两种放法

节点要么手写,要么挂订阅。两种放法适合不同的人:

放法 做法 适合谁 要注意
手写进本地节点段 一行一个节点,字段按示例配置的格式填 只有一两个节点、想看清每个字段的人 字段错一个符号就会失效,建议先在别处复制好再粘贴
挂远程订阅片段 在远程服务器段填入片段地址 节点会经常更新的人 片段必须是它自己的格式,地址等于凭证,不要外传

官方示例还提到,远程订阅可以挂资源解析器脚本,把别的格式转换成它能读的节点。这个功能方便,但脚本会处理你的订阅内容,来历不明的脚本等于把订阅交给了陌生人。在线转换的风险和本地做法,见 订阅转换怎么做才安全,浏览器本地的转换工具在 节点转换工具。订阅链接泄露后的处理见 订阅链接泄露了怎么办。

关于协议:官方示例里能核对到的包括 VMess、VLESS、Reality、Trojan、Shadowsocks、ShadowsocksR 和 AnyTLS;Hysteria2、TUIC、WireGuard 在官方示例与商店更新记录里都没有出现,写“资料待核实”,不要想当然地当作支持。需要这些协议的节点,先换成确认支持的客户端,对照 协议 × 客户端支持矩阵。

第三步:读懂 quantumult x规则 再动手写

配置里的分流条件,本质是一张从上到下匹配的清单:流量命中第一条符合的规则,就按那一条指定的策略去走。读规则时抓住三个要素:

  • 条件:按域名、域名后缀、关键字、IP 段等匹配,写法以示例配置为准。
  • 策略:直连、拒绝,或者某个节点或策略组。
  • 顺序:越具体的条件越靠前,兜底的条件放最后。

给你一个思考用的“举例”:假设你想让一个视频网站走代理、其余国内网站直连。思路是先写这个网站的域名条件指向代理策略,再写国内常见域名直连,最后放一条兜底。这里的域名只是示意,真实的域名列表请自己整理。

规则越写越多之后,不必全部手敲。可以引用远程规则集,把维护交给规则集的作者,但同样要先审阅内容再引用。分流这个概念在 分流 里有解释,Clash 系的规则写法虽然格式不同,思路相通,可以参考 Clash 规则怎么写。

第四步:重写、脚本与 MitM,先分清它们不是必需品

这几项是 Quantumult X 的特色,也是风险最集中的地方:

  • 重写:对特定请求做改写或拒绝,作用范围由你填写的条件决定。
  • 脚本:执行一段你提供的代码来处理请求或响应。
  • MitM:需要安装并信任一张证书,才能解开指定主机名的加密流量。

如果你的需求只是“让某些网站走代理”,这三项都不需要。开启之前自问两句:我明确知道要处理哪个主机名吗?我读过这段脚本在做什么吗?答不上来就先关着。证书一旦信任,就等于允许对应方查看加密内容,所以只信任自己生成或确实可信来源的证书,并在不用时移除。

怎么确认配置真的生效了

改完不要凭感觉判断,用下面几个办法核对:

  1. 看出口:打开 IP 与 DNS 检测导航 里的工具,对比开关前后的出口地址是否符合你选的节点。
  2. 看分流:分别访问一个应该直连和一个应该走代理的网站,确认各走各的路。
  3. 看日志:它有请求记录页,可以查看某个请求命中了哪条规则,命中不是你预期的那条,通常是顺序问题。
  4. 看 DNS:如果出口对了但仍有网站异常,参考 DNS 泄露怎么解决 排查。

如果规则改完整体失灵,先回退到备份,再逐条加回来,一次只加一两条,这样能立刻知道是哪一条出了问题。

读完 Quantumult X 使用教程后下一步去哪里

这篇没有覆盖的

  • 配置段落和字段的完整写法请对照官方示例配置,梯子岛不在这里复述每一个字段,也不保证示例之外的写法。
  • 脚本、重写与 MitM 涉及证书和解密流量,本文只提醒风险,不教具体脚本的写法。
  • 节点效果完全取决于你自备的线路,这里没有任何速度或稳定性结果可供参考。
  • 应用价格与最低系统要求会变,一律以 App Store 页面为准。

本文引用的官方来源

  1. Quantumult X 官方主页(quantumult.app)
  2. Quantumult X 官方文档(github.com)
  3. Quantumult X 官方下载入口(apps.apple.com)

以上链接均为官方页面,梯子岛在 2026-10-09 核对过;个别网站会拦截自动化访问,用浏览器直接打开即可。平台规则可能随时调整,以官方页面当前内容为准。

Quantumult X 使用教程常见问题

Quantumult X 自带节点吗?

不自带。它只是一个按规则转发流量的工具,节点要自己准备,可以手动写进配置,也可以通过订阅片段导入。梯子岛不提供也不推荐任何节点来源,拿到节点之后再回来看分流怎么写即可。

我把 Clash 订阅直接贴进去,为什么导入不了?

它读取的是自己格式的节点片段,并不直接认 Clash 的 YAML。官方示例里提到可以挂资源解析器脚本做转换,但脚本来源需要你自己审阅。更稳妥的做法是先用本地工具转换,再导入结果。

配置改乱了怎么办?

动手前先把整份配置导出或复制一份存在备忘录或文件里,改坏后粘贴回去即可。没有备份时,可以对照官方示例配置重新补齐段落,再把自己的节点和规则一条条加回来。

开了 MitM 就能解密所有 HTTPS 吗?

不是。它需要你主动安装并信任证书,并且只作用于你填写的主机名。这属于高风险操作,证书一旦被滥用后果很重,没有明确需要不要开,也不要信任来历不明的证书。

安卓或 Windows 上能用 Quantumult X 吗?

目前资料显示它只面向苹果设备,没有安卓、Windows 或路由器版本。需要这些平台时,请到站内客户端目录里找对应平台的客户端,而不是寻找所谓移植版或安装包。

接着读

文中出现的术语

接下来去哪儿?

找官方入口去网址导航,想核对仓库和版本看GitHub 项目导航;需要现成的机场,机场目录收了 28 家的价格与线路资料,性价比机场、便宜机场、VPN 机场分别有专项页。