---
url: https://eoht.net/serve/antiwall/quantumult-x.md
description: >-
  Quantumult X 的 iPhone/iPad 订阅节点资源导入、代理启动与运行模式教程，区分节点资源、策略组和分流规则，说明格式要求、VPN
  权限和资源解析失败的排查。
---

# Quantumult X 使用教程 {#quantumult-x-tutorial}

**Quantumult X（简称圈 X）** 是一款运行于 **iOS / iPadOS / macOS** 平台的高级网络代理客户端，集成节点管理、规则分流、策略组与脚本能力，适合日常代理与高级网络控制场景。

**支持协议包括**：\
Shadowsocks（SS）、ShadowsocksR（SSR）、VMess、VLESS、Trojan、HTTP / HTTPS、SOCKS5 等。

本文以 iPhone/iPad 界面说明节点资源导入和运行模式；macOS 等平台请核对 App Store 兼容条件与对应界面，不把手机截图视为所有平台的通用步骤。

| 核对项 | 说明 |
| --- | --- |
| 平台 | 本文使用 iPhone/iPad 界面；设备支持与付费条件见 App Store |
| 版本范围 | 截图为既有界面示例；本次未逐版本安装实测，菜单以当前发行版为准 |
| 导入格式 | 选择 Quantumult X 节点资源；Clash YAML 不能直接当作节点资源使用 |
| 权限 | 首次连接允许系统 VPN 配置；基础连接不需要启用 MitM |

配置由节点资源、策略组和分流规则共同组成。格式参考 [开发者 sample.conf](https://github.com/crossutility/Quantumult-X/blob/master/sample.conf)，系统要求参考 [App Store](https://apps.apple.com/us/app/quantumult-x/id1443988620)。

## Quantumult X 客户端下载 {#quantumult-x-download}

<Links
:grid="2"
:items="[
 {
   image: 'https://i.eoht.net/logo/qx.webp',
   name: 'Quantumult X',
   desc: 'Quantumult X（圈X），一款功能强大的 iOS / macOS 网络代理工具，支持 SS / SSR / V2Ray / Trojan / HTTP(S)。',
   link: 'https://apps.apple.com/us/app/quantumult-x/id1443988620'
 }
]"
/>

### 关于下载说明 {#quantumult-x-download-notes}

* 国区 App Store **无法直接下载**
* 推荐使用 **非大陆区 Apple ID（如美区）** 登录后下载
* 也可购买已包含 Quantumult X 的 Apple ID

相关说明可参考：

* [账号星球：Apple ID（购买前核对地区）](/serve/sharing/acc#accountboy-apple-id-pricing)
* [账号星球：带 Quantumult X 的 Apple ID](/serve/sharing/acc#accountboy-quantumult-x-account)

## Quantumult X 添加订阅 {#quantumult-x-subscription-setup}

### 获取订阅地址 {#quantumult-x-get-subscription-url}

<Links
:grid="2"
:items="[
 {
   icon: 'twemoji:airplane',
   name: 'VPN机场套餐与价格比较',
   desc: '按价格、流量和套餐类型初筛，再进入详情核对线路、解锁与优惠。',
   link: '/serve/airport/summary#vpn-airport-plan-comparison',
   linkText: '比较机场套餐'
 }
]"
/>

登录机场官网后台，复制 **订阅链接**。\
⚠️ 建议关闭浏览器自动翻译功能，避免订阅链接被破坏。

### 添加订阅节点资源 {#quantumult-x-add-subscription-resource}

1. 打开 Quantumult X
2. 点击右下角 **风车图标** 进入设置页面

![Quantumult X 设置页面 =300x](https://i.eoht.net/docs/20260104114502926.webp)

3. 在「节点」栏目中点击 **节点资源**

![Quantumult X 节点资源 =300x](https://i.eoht.net/docs/20260104114510976.webp)

4. 点击左上角按钮，进入 **添加节点资源** 页面

![Quantumult X 节点资源页面 =300x](https://i.eoht.net/docs/20260104114523115.webp)

5. 填写以下信息：
   * **资源标签**：自定义名称（如「机场订阅」）
   * **资源路径**：粘贴订阅地址
6. 点击右上角 **✔** 保存并更新资源，确认节点数量不为零；若报解析错误，先确认服务商提供的是 Quantumult X 格式

![Quantumult X 添加节点资源页面 =300x](https://i.eoht.net/docs/20260104114532832.webp)

## 启用代理与节点切换 {#quantumult-x-enable-proxy-and-switch-node}

添加完成后返回主界面，即可看到已导入的节点列表。

1. 选择任意节点
2. 点击右上角按钮启用代理，首次使用允许系统 VPN 连接
3. 确认当前策略组选中可用节点，打开目标网站，再在网络活动/请求记录中查看规则与出口

![Quantumult X 开启代理 =300x](https://i.eoht.net/docs/20260104114542699.webp)

## 运行模式说明与切换 {#quantumult-x-routing-modes}

Quantumult X 支持三种运行模式：

* **全部代理**\
  已接管请求使用对应的代理策略；未接管流量不受此开关保证

* **规则分流（推荐）**\
  根据分流规则与策略组决定流量走向，兼顾速度与可用性

* **全部直连**\
  已接管请求直接连接目标服务器；关闭 VPN 需另停用连接

### 切换方法 {#quantumult-x-switch-routing-mode}

长按右下角 **风车图标**，在弹出的菜单中选择所需运行模式。

![Quantumult X 切换运行模式 =300x](https://i.eoht.net/docs/20260104114552304.webp)

## 使用建议 {#quantumult-x-usage-tips}

* 新手建议使用 **规则分流模式**
* 日常使用优先通过 **订阅管理节点**
* 遇到连接异常可尝试切换节点或运行模式
* 高级用户可配合 **规则 / 策略组 / 脚本** 实现更复杂的控制

## 节点资源与分流排查 {#quantumult-x-troubleshooting}

* **资源下载成功但没有节点**：检查内容是否为兼容节点资源，是否误填后台网页或整份其他客户端配置；解析器/转换规则不是所有格式都兼容的保证。
* **有节点但策略组为空**：检查策略组的资源标签、名称筛选与正则表达式，确认能匹配导入的节点。
* **规则模式异常、全部代理可用**：查看具体请求的分流命中，核对远程规则资源是否成功更新，而不是将“规则分流”理解成自动国内直连。
* **启用脚本或重写后异常**：先停用相关资源作对照；基础代理无需为了“完整配置”启用全部脚本和解密功能。