Quantumult X 使用教程:下载、导入订阅、分流与重写概念与常见错误

发布于 2026/10/08约 8 分钟读完
客户端
Quantumult X
支持平台
iPhone / iPad
价格
付费
  1. 下载
  2. 安装
  3. 导入订阅
  4. 设置
  5. 排错

Quantumult X(常简称“圈 X”)是 iOS / iPadOS 平台的付费代理客户端,以分流规则灵活、功能丰富著称。它把配置拆成几类“资源”:节点资源(订阅)、分流资源(规则)和重写资源,每一类都可以单独引用远程链接。理解这几个概念,是用好 Quantumult X 的关键。

本文侧重日常使用:导入机场订阅、选择节点、切换模式。重写、脚本等进阶功能只做概念介绍。Quantumult X 的界面以图标为主,不同版本的位置会有调整,和本文略有不同时按功能含义查找即可。

下载

Quantumult X 下载示意图

Quantumult X 是付费应用,只通过 App Store 分发,未在中国区 App Store 上架:

  1. 使用你自己注册的非中国区(外区)Apple ID 登录 App Store;
  2. 搜索 Quantumult X,购买并下载;
  3. 下载完成后可以切回原来的 Apple ID,已安装的应用照常使用(更新时需要再登录购买时的账号)。

请不要使用网上的“共享 Apple ID”:账号可能被他人修改密码,严重时可能锁定你的设备,也存在隐私泄露风险。

不要安装来路不明的破解版、“免费企业签名版”。代理客户端能看到你的全部网络流量,被篡改的安装包风险极高。价格以 App Store 页面实际显示为准。

安装

从 App Store 安装后打开。首次开启连接时,iOS 会弹出“添加 VPN 配置”的提示,点击允许,并验证面容 ID、触控 ID 或锁屏密码。这是所有 iOS 代理类应用的正常流程,并不会安装额外的描述文件。

导入订阅

Quantumult X 导入订阅示意图

Quantumult X 有自己的订阅格式。在机场后台复制“Quantumult X 订阅”(有的机场写作“QX 订阅”);如果没有,部分通用订阅也可以被识别,但兼容性不如专用订阅。订阅格式的区别见机场订阅是什么。

在 Quantumult X 中,机场订阅被称为“节点资源”(配置文件中对应 server_remote 部分):

  1. 打开主界面右下角的设置入口(风车形状的图标);
  2. 进入节点相关的设置,找到“引用”或“资源”类入口,添加一条节点资源;
  3. 在资源路径中粘贴机场订阅链接,标签填一个便于识别的名称;
  4. 保存后,Quantumult X 会下载订阅,节点出现在节点列表中。

很多机场后台提供“一键导入 Quantumult X”按钮,在 iPhone 的浏览器中点击会自动唤起应用并填好链接,效果与手动添加相同。

订阅链接等同于账号凭证,不要截图分享。怀疑泄露时到机场后台重置,再重新导入。

添加节点

Quantumult X 节点选择与测试

如果只有单个节点,可以在节点设置中选择手动添加或从剪贴板、二维码导入,按协议填写服务器地址、端口、密码等信息。Quantumult X 支持的协议以官方说明为准,常见的 Shadowsocks、VMess、Trojan 等在支持范围内。

选择节点:在主界面点击节点区域(或长按节点卡片),进入节点列表,点选需要使用的节点或策略组中的节点。

测试延迟:节点列表中可以对节点进行延迟测试,结果以毫秒显示。延迟代表连通性,不等于下载速度;超时的节点可能在维护,换一个即可。

更新订阅

  • 手动更新:在节点资源的管理界面,对订阅执行更新(部分界面支持下拉刷新或长按资源选择更新);
  • 自动更新:Quantumult X 可以设置资源的自动更新间隔,在其设置中查找资源更新相关选项。

机场增删节点或更换域名后,更新节点资源即可同步。如果更新失败,可以先连接一个可用节点再更新,或检查套餐是否到期。

VPN 连接

在主界面打开右上角的连接开关,Quantumult X 会通过 iOS 的 VPN 配置接管流量,状态栏出现 VPN 标识即表示生效。iOS 上没有“系统代理”开关的概念,开启连接就意味着设备的大部分应用流量会交给 Quantumult X 处理,再按分流规则决定直连还是走代理。

TUN 模式

Quantumult X 不需要、也没有单独的 TUN 开关。iOS 的 VPN 机制本身就是基于虚拟网卡实现的,开启连接后效果相当于电脑客户端的 TUN 模式。

规则模式

分流资源

Quantumult X 的规则称为“分流”(配置文件中对应 filter_remote 和 filter_local)。分流资源是一组规则的远程引用,每条规则指定匹配的域名、关键词或 IP 段,以及对应的策略(直连、代理、拒绝或某个策略组)。机场的专用订阅或配置通常已附带合适的分流;你也可以自行引用规则资源,但要注意来源可信。

重写资源(概念)

“重写”(rewrite_remote / rewrite_local)用于在请求发出前修改或拦截请求,例如改写网址、屏蔽特定请求。部分重写需要配合 MitM(中间人解密)和自签证书才能生效。重写属于进阶功能,与能否正常使用节点无关,新手无需开启,更不要随意安装来源不明的证书和重写规则,它们能看到你的 HTTPS 内容。

运行模式

Quantumult X 有三种运行模式,在主界面可以切换:

运行模式 作用
规则分流 按分流规则决定直连还是代理,日常推荐
全部代理 所有流量走选定的策略
全部直连 所有流量直连,相当于暂停代理

日常请使用规则分流。

节点资源、策略和分流的关系

初次接触 Quantumult X 容易被几个名词绕晕,可以这样理解:节点资源提供“有哪些节点可用”,策略(策略组)把节点组织成“手动选择”“自动选择”等分组,分流规则则决定“某个网站的流量交给哪个策略”。三者串起来,才构成一次完整的分流过程。分流规则按顺序从上往下匹配,命中即停止,最后由兜底规则处理剩余流量。如果某个网站走错了策略,通常是有更靠前的规则先命中了它。

全局模式

切换到“全部代理”即为全局模式,适合临时排查某个网站打不开是否因为规则未命中。国内应用也会绕道海外,速度变慢、流量增加,排查完请切回规则分流。流量扣除方式可以参考机场流量怎么算。

常见错误

现象 可能原因 解决方法
App Store 搜不到 使用的是中国区 Apple ID 用自己注册的外区 Apple ID 登录
添加资源后没有节点 订阅格式不对或订阅过期 改用 Quantumult X 专用订阅;检查套餐
所有节点超时 套餐到期或流量用完 登录机场后台检查套餐状态
开关打开后立即断开 VPN 配置被删除或与其他代理应用冲突 关闭其他 VPN 类应用,重新允许 VPN 配置
部分网站证书报错 开启了 MitM 但证书未信任或规则有误 关闭 MitM 或停用对应重写
国内应用变慢 处于全部代理模式 切回规则分流
导入的分流不生效 分流资源未启用或顺序被覆盖 检查资源是否启用,必要时更新资源

更多 iPhone 客户端可以看 iOS 客户端教程,入门用户也可以先看 Shadowrocket 教程。

下一步

换个客户端

iPhone / iPad 其他客户端