Quantumult X 可以在 iPhone、iPad 上管理代理节点、选择策略并接管连接。第一次使用时，关键是把订阅变成客户端能读取的节点，再确认流量确实使用了选中的线路。

本文只讲 **Quantumult X**。Quantumult 是另一个应用，两者的界面和配置不能混用。这里也不涉及重写脚本、广告过滤或 HTTPS 解密，先完成基本连接即可。

<figure class="guide-diagram"><div class="diagram-label">从免费订阅到第一次连接</div><div class="guide-flow"><div><b>安装 Quantumult X</b><small>核对开发者与系统要求</small></div><span>→</span><div><b>导入节点资源</b><small>必要时使用资源解析器</small></div><span>→</span><div><b>选择节点与策略</b><small>确认请求的去向</small></div><span>→</span><div><b>开启连接</b><small>允许VPN配置并实际访问</small></div></div><figcaption>图 1 · 订阅导入、策略选择和VPN开关分别对应不同环节，缺少其中一步都可能无法使用。</figcaption></figure>

<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载应用</a><a href="#format">选择订阅格式</a><a href="#parser">资源解析器</a><a href="#import">导入节点</a><a href="#connect">连接与验证</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav>

<h2 id="install">01　从 App Store 获取 Quantumult X</h2>

打开[Quantumult X 的 App Store 页面](https://apps.apple.com/us/app/quantumult-x/id1443988620)，核对应用名和开发者 **Cross Utility Ltd**。这是付费应用，实际价格与是否可购买，以你使用的商店地区为准。

以 **1.8.1** 为例，系统要求为 **iOS 15.0 / iPadOS 15.0 或更高版本**。若当前商店搜索不到，不要把名字相近的应用当成同一个客户端；先核对商店是否提供该应用。

安装后先打开应用查看初始界面。不同版本的“节点资源”“策略”和连接开关位置可能略有变化，可按功能名称查找。

<h2 id="format">02　先看订阅是什么格式</h2>

在本站[免费节点页面](/freenode)中打开较新的分享。页面会提供不同格式的资源，但**目前不能把本站通用订阅直接视为 Quantumult X 原生订阅**。

| 手里的内容 | 如何处理 |
|---|---|
| 明确标注为Quantumult X节点资源 | 可按原生节点资源导入 |
| 本站v2ray订阅 | 需要能识别其内容的资源解析器，再导入节点 |
| Clash / Mihomo或sing-box完整配置 | 不要当成Quantumult X完整配置直接覆盖 |
| 普通文章网址 | 先进入文章，复制里面真正的订阅地址 |

“资源解析”主要解决格式转换，不会让失效节点恢复，也不能保证任意协议和参数都能转换。第一批导入失败时，先确认格式与解析器，不必立刻重装应用。

<h2 id="parser">03　通用订阅需要先配置资源解析器</h2>

通用订阅可通过 [KOP-XIAO 资源解析器](https://github.com/KOP-XIAO/QuantumultX)转换为 Quantumult X 能读取的节点资源。它是**第三方脚本**，并非 Quantumult X 内置功能。可以先在作者仓库查看说明和脚本内容，再决定使用。

在应用设置中找到当前配置的编辑入口。在已有的 `[general]` 区域内加入或修改这一项，保存配置：

```ini
[general]
resource_parser_url = https://raw.githubusercontent.com/KOP-XIAO/QuantumultX/master/Scripts/resource-parser.js
```

这里展示了节名，方便定位；已有 `[general]` 时，只放入其中的 `resource_parser_url` 这一行，不要重复建立整段，也不要把当前配置全部替换成这两行。若原来已经指定了其他解析器，先保留原配置副本，再决定是否更换。

解析器由客户端下载并在本地解析资源内容。这个路径仍需要设备能够访问；下载失败时先核对脚本地址和连接条件，不能把“已填入地址”当成“脚本已加载成功”。使用上面给出的解析器地址，避免误填其他示例脚本。

<figure class="guide-diagram"><div class="diagram-label">资源解析器做了什么</div><div class="guide-flow"><div><b>下载订阅内容</b><small>取得分享链接或节点列表</small></div><span>→</span><div><b>客户端运行解析器</b><small>转换支持的格式与参数</small></div><span>→</span><div><b>生成可用节点条目</b><small>随后再测试连接</small></div></div><figcaption>图 2 · 转换成功只表示客户端能读取节点。协议兼容性、节点是否在线和实际访问仍需分别检查。</figcaption></figure>

<h2 id="import">04　添加节点资源，并确认列表出现</h2>

复制本站较新分享中的 **v2ray 订阅地址**，进入 Quantumult X 设置中的节点资源或节点引用管理，添加远程资源：

1. 为资源填写一个容易辨认的名称，例如“本站免费节点”。
2. 粘贴实际订阅地址，启用该资源。
3. 对需要转换的通用订阅开启资源解析选项，再保存并更新。
4. 返回节点列表，确认出现了实际节点，而不是只有资源名称或错误提示。

如果当前版本界面入口不易辨认，也可以按开发者配置格式，在已有的 `[server_remote]` 区域加入资源行：

```ini
[server_remote]
https://example.invalid/subscription, tag=本站免费节点, opt-parser=true, enabled=true
```

**上面的地址是占位示例，必须换成从本站复制的真实订阅链接。** 已有节名时只加入资源行，保留原来的其他配置；不要同时在界面和配置中重复添加同一份资源。`opt-parser=true` 表示对这份资源调用解析器，`enabled=true` 表示启用资源。

原生 Quantumult X 节点资源通常不需要这个转换步骤。导入结果少于原订阅节点数时，可能存在解析器或客户端不支持的参数，应检查资源更新提示，不把条目数量当成连接质量。

<h2 id="connect">05　选择策略，再开启 VPN 连接</h2>

有了节点后，先选一条线路作为当前代理使用的节点。Quantumult X 的策略组负责选择节点，分流规则负责选择策略；具体名称取决于当前配置，导入一份节点资源不会自动生成你想要的全部分流规则。

首次排查可以暂时使用应用的**全局代理模式**，并确认其当前策略选中了实际节点，而不是 `direct` / 直连；先减少规则差异，确认这一条线路能够工作。完成验证后再切回规则分流，检查常用服务是否按预期选择策略。全局代理模式也不等于已经完成所有泄漏检查。

开启应用连接开关。首次连接时，iOS 会询问是否允许添加 VPN 配置，按系统提示允许并完成设备验证。基础代理使用不需要安装用于 HTTPS 解密的根证书。

连接后打开 Safari，访问实际需要的网页；再查看应用中的请求记录，确认目标域名、命中策略和节点。看到系统VPN标记只说明VPN配置在运行，并不能单独证明节点可达或目标服务可用。

<h2 id="daily">06　日常更新与停止使用</h2>

| 要做的事 | 建议操作 |
|---|---|
| 当前节点不通 | 在当前策略中换其他节点，再重新请求 |
| 订阅节点需要刷新 | 在节点资源管理中更新对应资源 |
| 旧批次普遍失效 | 回本站免费节点页面查看较新的分享，按需要更新资源地址 |
| 停止代理 | 关闭应用连接开关，并确认VPN已断开 |
| 启动后又自动连接 | 检查是否启用了按需连接及其他相关自动化设置 |

如果同时使用 Mac，可以继续看[Mac 客户端下载指南](/a/m172.html#download)。Mac 上的 Clash Verge Rev 需要对应的 Clash / Mihomo 订阅，不能把这篇教程的 Quantumult X 配置直接搬过去。

<h2 id="faq">07　常见问题</h2>

**订阅更新成功，为什么没有节点？** 核对导入的是节点资源而非文章页；对通用订阅，检查解析器是否成功下载，以及该资源是否开启解析。再看资源是否启用、内容是否为空或包含不支持的格式。

**节点有延迟，网页还是打不开。** 延迟检查只是一次特定请求；目标网站、出口策略或当前线路仍可能失败。查看实际请求记录，再尝试其他节点或另一个目标，分开判断节点和网站的问题。

**VPN已连接，但走的是直连。** 检查运行模式、命中规则与策略组选择。只更新订阅不会自动把现有的直连策略改为某个节点。

**别的教程让我导入完整配置。** 完整配置可能同时改变节点资源、规则、DNS、脚本和重写设置。本文只需要完成节点连接，导入前先看清它会覆盖哪些部分，保留自己的原配置。

<div class="guide-footnote">参考资料：<a href="https://github.com/crossutility/Quantumult-X/blob/master/sample.conf">开发者示例配置</a>、<a href="https://github.com/KOP-XIAO/QuantumultX/blob/master/Scripts/resource-parser.js">解析器作者源码</a>。</div>