Quantumult X 使用教程：先连通，再配置分流
简答：Quantumult X 使用的最短路径是：从 App Store 安装并允许 VPN 配置，添加节点资源订阅，选择节点后开启连接，再用请求记录或出口 IP 验证。刚开始不要启用 MitM、Rewrite 和脚本。
定义：Quantumult X 是面向 iPhone、iPad 和 Mac 的规则型网络客户端，可导入节点资源、配置文件和分流资源，并按策略处理网络请求。
先做这 5 步：Quantumult X 最短成功路径
如果你的目标只是让客户端先连通，不要一开始编辑完整配置，也不要启用 MitM、Rewrite 或脚本。按下面顺序操作：
- 在 App Store 搜索 Quantumult X，核对开发者为 Cross Utility Ltd，再从商店完成安装。App Store 页面列出的支持设备包括 iPhone、iPad 和 Mac，具体系统要求与价格以你所在地区的页面为准。查看 App Store 页面
- 首次打开时，如果系统询问是否添加 VPN 配置，选择允许，并按提示输入设备密码。
- 从你的线路服务后台复制 Quantumult X 可用的订阅链接。订阅链接属于敏感信息，不要公开粘贴到群聊、截图或公共网页。
- 打开 Quantumult X，进入右下角的设置入口，找到节点资源，点击添加，填写容易识别的资源标签，在资源路径粘贴订阅链接并保存。
- 返回主界面，等待资源更新，选择一个节点，打开右上角连接开关；首次连接时再次允许系统创建 VPN 配置。
如果节点列表出现且连接开关保持开启，下一步只做验证，不要立即增加规则、脚本或证书功能。
节点资源、完整配置和规则资源有什么区别？
Quantumult X 的配置体系不是“把任意客户端订阅地址粘贴进去就一定能用”。官方示例把远程内容区分为 server_remote、filter_remote 和 rewrite_remote，分别对应服务器节点、分流规则和重写资源。官方 URL Scheme 与资源字段说明
| 类型 | 主要作用 | 新手是否先用 | 常见误区 |
|---|---|---|---|
| 节点资源 | 导入一个或多个可选择的服务器节点 | 是 | 导入成功不代表已经开启代理 |
| 完整配置文件 | 同时携带节点、策略、规则及其他配置段 | 谨慎 | 可能覆盖已有设置，来源不明时不应直接导入 |
| 分流资源 | 根据域名、IP 或其他条件决定直连或代理 | 连通后再用 | 规则引用了不存在的策略时会表现为规则不生效 |
| 重写资源 | 修改请求或响应，部分场景还涉及脚本 | 暂不建议 | 它不是节点订阅，基础代理不需要它 |
如果服务方只提供 Clash YAML、JSON 或其他客户端格式，不能据此断定 Quantumult X 可以直接识别。优先询问服务方是否提供 Quantumult X 格式；没有对应格式时，不要盲目改后缀名。
如何选择代理模式并验证连接？
Quantumult X 常见的使用思路是先选节点，再选择运行模式。模式名称可能因界面语言或版本略有差异，以下按功能理解：
| 模式 | 流量处理方式 | 适合场景 |
|---|---|---|
| 全部代理 | 请求统一交给当前代理策略处理 | 只想快速判断节点能否工作 |
| 规则分流 | 根据规则和策略决定直连或代理 | 日常使用，减少不必要的代理流量 |
| 全部直连 | 请求直接连接目标，不使用代理节点 | 排查是否是代理导致的异常 |
切换模式前，可以在主界面长按右下角设置图标，查看运行模式菜单。资源模型和配置入口可参考项目维护者公开的示例文件，其中包含 server_remote、filter_remote 与 rewrite_remote 等配置段。官方 sample.conf 示例
- 先使用全部代理，选择一个节点并开启连接。
- 打开一个你平时能访问的网页，确认页面可以正常加载。
- 查看 Quantumult X 的请求记录，确认请求命中了预期的节点或策略，而不是只看 VPN 图标。
- 再切换到规则分流，分别测试一个应直连的站点和一个应走代理的站点。
- 如果规则模式异常，先回到全部代理；若全部代理正常而规则模式异常，问题通常在规则、策略名称或规则顺序，而不是节点本身。
验证时不要把某个网站能否打开当作唯一标准。更稳妥的方法是同时看连接状态、请求记录和出口 IP；不同网络环境下，单个网站的响应也可能受 DNS、目标站点或本地网络影响。
节点导入成功但不能用：按现象排查
现象一：节点资源为空。先检查订阅链接是否完整，是否复制了失效页面地址而不是订阅地址；再重新进入节点资源页面手动更新。如果仍为空，确认服务方提供的格式是否明确支持 Quantumult X。
现象二：能看到节点，但连接立即关闭。先换一个节点测试，并确认设备已经允许 VPN 配置；然后使用全部代理模式排除规则影响。若所有节点都失败，检查当前 Wi-Fi 或移动网络是否能正常访问订阅域名及节点地址。
现象三：节点能连，但策略组为空。节点资源与策略组不是同一个概念。策略组通常来自完整配置、策略定义或规则资源；仅添加节点资源，不一定会自动生成你期待的自定义策略组。先查看当前配置里是否存在对应策略，再检查规则是否引用了同名策略。
现象四：规则分流不生效。先确认运行模式确实是规则分流，再查看请求记录命中了哪条规则和哪个策略。规则顺序、策略名称拼写、资源是否更新，以及最后的兜底规则都会影响结果。不要直接把顶层规则段替换成网上找到的片段，除非你确认其中引用的策略和资源都已声明。
现象五：国内应用误走代理或网页打不开。先临时切换到全部直连，判断应用本身和本地网络是否正常；再回到规则分流检查该域名命中的规则。若只有 DNS 解析异常，优先检查 Quantumult X 的 DNS 配置和当前网络的 DNS 可达性，不要先启用 MitM。
安全边界：哪些功能先不要碰？
- MitM：基础代理不需要它。它涉及 HTTPS 流量解密和证书信任，只有在你明确知道用途、来源和撤销方法时才考虑。
- Rewrite：用于修改请求或响应，不等于节点订阅。来源不明的重写规则可能改变网页请求，先不要批量启用。
- 脚本和定时任务：它们可能读取网络请求、执行额外逻辑或持续访问远程地址。新手排查连接时应保持关闭。
- 配置文件：完整配置可能包含多个远程资源。导入前先查看内容，确认没有未知的远程地址、重写、脚本或证书配置。
- 订阅链接：它通常具备获取节点配置的权限。若链接泄露，应按服务方提供的方式重置或重新生成。
Quantumult X 官方项目公开的示例也将服务器、分流和重写放在不同资源字段中；因此，先完成“节点—连接—验证”三步，再逐项增加功能，最容易定位问题。查看官方资源导入示例
iPhone、iPad 与 Mac 的操作差异
iPhone 和 iPad 的首次授权重点是系统 VPN 配置；Mac 版本同样通过 App Store 获取，但窗口、菜单栏入口和权限提示可能不同。App Store 页面将 Quantumult X 列为支持 iPhone、iPad 与 Mac 的应用，安装前应以当前商店页面显示的设备兼容性为准。查看 Mac App Store 页面
- iPhone/iPad：安装后先允许 VPN 配置，再进入节点资源添加订阅。
- Mac：安装后从应用或菜单栏打开设置，若系统出现网络扩展或 VPN 权限提示，按 macOS 的系统提示放行。
- iOS 没有对应客户端的场景：Quantumult X 不是 Windows、Linux 或 Android 客户端；这些平台应选择与自身系统匹配的其他客户端，不要下载来源不明的安装包。
恢复默认与重新开始
- 先关闭 Quantumult X 的连接开关。
- 删除无法更新或来源不明的节点资源、规则资源和重写资源。
- 暂时关闭 MitM、Rewrite、脚本及定时任务。
- 只重新添加一条确认格式正确的节点订阅。
- 使用全部代理模式测试单个节点，确认连通后再恢复规则分流。
如果问题只在某个完整配置文件导入后出现，优先撤销该配置，而不是继续叠加新的规则。这样可以把变量减少到节点、系统授权和运行模式三个部分。
常见问题
Quantumult X 订阅导入后为什么没有节点？
先确认粘贴的是完整订阅链接，再手动更新节点资源；如果仍为空，向服务方确认是否提供 Quantumult X 可识别的格式。不要仅通过修改文件后缀解决格式不兼容。
Quantumult X 需要开启 MitM 才能使用吗？
不需要。基础节点连接和普通代理测试不依赖 MitM。MitM 涉及 HTTPS 解密与证书信任，只有明确了解用途和来源后才应配置。
为什么节点能用，但规则分流没有效果？
先确认运行模式是规则分流，再查看请求记录命中的规则和策略。重点检查策略名称、规则顺序、远程资源更新状态及最后的兜底规则。
节点列表正常但策略组为空怎么办？
节点资源只负责提供节点，不一定会创建自定义策略组。检查当前配置是否声明了策略，以及规则引用的名称是否与策略名称完全一致。
Quantumult X 能安装在 Windows 或 Android 上吗？
App Store 页面列出的平台包括 iPhone、iPad 和 Mac。Windows、Linux 和 Android 不属于该应用的对应平台，应选择适配自身系统的其他客户端。