Quantumult X 圈X从零教程：先跑通，再分流与排查
简答：如果你遇到“导入后没有节点、部分应用打不开、开启 MitM 后异常”，不要先导入复杂配置。先在 App Store 核对当前版本与兼容设备，完成系统授权，备份现有配置，只导入一组节点并手动选择一个节点；确认隧道、请求记录和实际应用结果正常后，再逐层加入策略、规则、重写和脚本。本文按“安装准备→最小可用→分流→重写与证书→故障定位→回滚”展开。
定义：Quantumult X 是面向 Apple 设备的网络客户端，配置文件可以组织通用设置、节点、策略、规则、远程资源、重写、脚本和 MitM；具体平台、版本、菜单和字段行为应以当前 App Store 页面与官方示例文件为准。
先记住这张关系图：五类资源不要混着导入
Quantumult X 的新手问题，很多不是节点本身失效，而是把不同资源当成同一种配置。先按下面的关系理解：节点订阅提供节点；完整配置文件组织多个区块；策略决定使用哪个节点；规则集决定请求走直连、代理或其他动作；重写与脚本处理请求、响应或自动任务。官方 sample.conf 示例配置同时展示了这些区块，但并不意味着任意第三方资源都能直接组合。
| 资源 | 主要作用 | 导入前要确认 |
|---|---|---|
| 节点订阅 | 提供一个或多个可选择的节点 | 返回内容是否为客户端可识别格式，是否需要转换 |
| 完整配置 | 同时组织节点、策略、规则、重写等内容 | 是否会覆盖当前配置，是否含未知远程资源 |
| 策略 | 把节点组织成手动、可用性或其他选择方式 | 策略名称是否真实存在，候选节点是否为空 |
| 规则集 | 按域名、IP 或其他条件分配处理动作 | 规则格式、策略名称、冲突和兜底动作 |
| 重写与脚本 | 修改请求或响应，或按条件执行任务 | 来源、匹配范围、权限、证书需求和停用方式 |
最稳顺序：先安装并授权，再备份；先导入节点，再测试单节点；随后加入策略和规则；最后才处理重写、MitM 与脚本。每一步只改一类资源，并记录修改时间、资源名称和复测结果。
从下载安装到首次运行：iPhone 和 iPad 的基础步骤
- 核对平台和版本：打开 App Store 的 Quantumult X 应用页面，查看当前版本、兼容性和设备列表。当前页面列出 iPhone、iPad、Mac 和 Apple TV 等设备，但本文只讲 iPhone 与 iPad；具体可用功能仍以设备系统和应用当前版本为准。
- 完成获取和首次打开：从 App Store 获取应用后首次打开，按系统提示完成通知、VPN 或网络相关授权。不同 iOS/iPadOS 版本的弹窗文字可能变化，看到系统要求时先允许应用建立本地 VPN 配置；如果系统提示已有其他 VPN，先记录并暂时关闭冲突项目。
- 不要立即覆盖配置：首次进入后先观察当前配置、资源、重写、脚本和证书页面可能位于哪些入口。菜单名称可能随版本变化，可能出现在“设置、配置、资源、重写、脚本、证书或网络”等页面附近。
- 确认你手上的资源类型：节点订阅、完整配置和规则资源不是一回事。订阅服务的价格、可用性、状态、官网入口和格式应以对应服务方公开信息为准，本文未核实任何具体服务。
- 先做一次全直连复测：在没有添加复杂资源前，用系统当前网络打开一个平时可以访问的目标，记录网络类型和时间。这样后续出现问题时，能区分本地网络异常与客户端配置异常。
本文是第三方使用指南，不是 Quantumult X 官方页面，也不代表任何订阅服务的官方立场。版本号和购买信息不要引用旧教程中的截图；以 App Store 当前页面为准。
十分钟最小可用流程：先让一个节点跑通
如果你只想先完成基础连接，请按这五步执行，不要同时开启分流、重写、MitM 和脚本：
- 备份：导出或复制当前配置，另行记录订阅地址、策略名称和证书状态。没有备份时不要覆盖唯一配置。
- 导入一组节点：将节点订阅放入客户端对应的远程节点资源位置。导入后记录更新时间、错误提示和节点数量变化。
- 手动选一个节点：先选择一个明确显示的节点，不使用复杂自动策略。若策略列表为空，先检查节点资源是否启用、标签是否改变以及策略是否引用了该资源。
- 启动隧道：开启客户端的系统 VPN 或隧道开关，观察系统状态和应用内状态。若隧道无法启动，先关闭其他 VPN 并回到备份配置。
- 复测三项：查看请求记录、打开同一目标应用或网页、再次切换到全部直连做对照。一个网页打开成功不能证明所有应用都走同一路径，还要结合 DNS、IPv6、应用自身网络行为和记录判断。
| 检查项 | 通过表现 | 未通过时先查什么 |
|---|---|---|
| 节点资源 | 节点出现，数量和名称没有明显解析错误 | 订阅返回内容、登录状态、格式和更新结果 |
| 策略 | 当前策略明确指向一个节点或直连 | 策略组是否为空，标签是否发生变化 |
| 隧道 | 系统显示 VPN 或隧道已连接 | 系统授权、其他 VPN、网络切换 |
| 请求记录 | 打开目标应用后能观察到相关请求 | 应用是否使用独立网络连接或不同域名 |
| 重复复测 | 同一网络、同一节点下结果可重复 | 切换节点并关闭规则、重写后对比 |
最小配置示例：能复制结构，但不能伪装成可运行配置
这里必须说明边界：没有你的真实节点地址、协议、端口、认证信息和订阅格式，任何文章都不能提供一份可直接连接的通用完整配置。下面的片段是根据官方 sample.conf 中的区块结构整理的语法参考片段，可以复制到备份文件中理解结构，但不能直接运行，也不能把占位域名当成真实节点。
[policy]
;static = 手动节点, 节点标签A, 节点标签B
[server_remote]
;https://你的节点资源地址, tag=节点资源标签, enabled=true
[filter_remote]
;https://你的规则资源地址, tag=规则资源标签, force-policy=手动节点, enabled=true
[rewrite_remote]
;https://你的重写资源地址, tag=重写资源标签, enabled=true
[filter_local]
;host-suffix, example.com, 手动节点
;final, direct官方示例显示，[policy]可定义静态、可用性、轮询等策略；[server_remote]用于引用远程节点资源；[filter_remote]可以指定标签、策略和启用状态；[rewrite_remote]用于引用远程重写资源。相关参数是否被当前版本和具体资源接受，必须以 官方当前示例与导入后的错误提示为准。
替换清单：把“你的节点资源地址”“你的规则资源地址”“你的重写资源地址”换成你已核实的资源地址；把策略名称改成实际存在的名称；把规则中的 example.com 换成你明确需要测试的域名。若资源提供方没有说明 Quantumult X 格式，不要凭猜测添加协议参数。
为什么不提供可运行节点：节点需要真实服务器、端口、认证和协议参数，且这些信息属于具体服务方资料；编造一行“可用节点”会造成无法验证的连接承诺。导入前先备份，导入后检查解析结果、节点数量、策略候选项和资源更新状态。
分流、策略与 final：先做对照，再启用规则
建议按“全部直连→全部代理→规则模式”的顺序做对照。全部直连用于确认本地网络和应用本身是否正常；全部代理用于确认单个节点或代理链路；规则模式才用于日常分流。每次只改变一个变量，例如只换节点，不要同时更换节点、规则和 DNS。
策略名称必须与节点或规则引用的名称一致。官方示例列出了 static、available、round-robin、ssid 等策略结构，但策略类型、候选项和参数应以当前示例及实际解析结果为准。规则资源也可能通过 force-policy 指定处理策略；一旦设置，远程规则自身携带的策略可能不再起作用，具体以官方示例说明和当前版本表现为准。
final 是规则未匹配时的兜底写法，但兜底动作不是“所有流量都已代理”的证明。若部分应用超时，先查看请求记录和规则命中结果，再检查 DNS、IPv6、应用独立连接和策略是否为空。不要只凭出口 IP 或一次网页访问断言所有流量均按预期处理。
重写与 rewrite_remote：从关闭状态开始逐项验证
重写不是节点连接的必要条件。基础连接稳定后，再单独添加一条重写资源，并记录资源标签、启用状态、匹配域名和复测目标。官方 sample.conf 给出的 [rewrite_remote]结构包括资源地址、tag和enabled等可选参数；官方 rewrite.md 示例则展示了请求头、响应体和脚本响应体等重写形式。
[rewrite_remote]
;https://你的重写资源地址, tag=测试重写, enabled=true这段只表示远程资源引用方式，不代表资源内容一定安全或适合你的应用。导入后观察三项：资源是否更新成功、规则数量是否变化、目标请求是否出现预期记录。若应用异常，先停用最近添加的 rewrite_remote，再恢复备份。
重写规则可能修改请求头或响应内容；脚本型重写还可能读取请求信息、调用远程地址或保存数据。只使用能追溯来源、能看懂匹配范围并能关闭的资源。不要因为某个脚本声称“去除限制”就扩大 MitM 范围，也不要把陌生脚本当成普通节点订阅。
MitM、证书与敏感应用：按三层清理和回滚
MitM 涉及证书生成、安装、系统信任和主机名匹配。官方示例提醒用户妥善保管 CA 密码与私钥，并在 [mitm] 区块中配置证书和主机名。基础连接不需要先开启 MitM，建议只对明确需要的域名启用，避免使用过宽的通配符。
- 停用客户端内部配置：先关闭 MitM、相关重写和脚本资源，重新启动隧道。
- 检查系统证书：在 iOS/iPadOS 当前设置中查找“证书、描述文件、设备管理”相关页面，确认是否存在不再使用的描述文件或证书。不同系统版本名称可能不同。
- 撤销信任并删除：如果设备显示已安装的相关证书，取消不再需要的完全信任，并删除对应描述文件或证书；不要删除与其他工作用途有关的配置前不做记录。
- 重启并复测：重启 Quantumult X 或设备后，用全部直连测试支付、银行、企业和登录类应用，再逐项恢复需要的资源。
如果敏感应用异常，优先停用 MitM 和重写并恢复备份，不要为了单个应用扩大证书匹配范围。证书入口和操作结果以当前 iOS/iPadOS 页面为准，本文不把旧系统截图当作固定路径。
请求记录定位案例：用同一域名分辨规则、策略和 DNS 问题
假设你在同一 Wi-Fi 下测试同一个目标域名，记录时间、网络类型、当前节点、运行模式和结果。先切换全部直连，打开目标应用并记录请求；再切换全部代理，用同样操作记录；最后开启规则模式，对比同一域名的请求是否出现、命中的动作是否变化。
| 观察结果 | 更值得优先检查的层 | 下一步动作 |
|---|---|---|
| 三种模式都没有请求 | 应用可能使用独立连接、缓存或不同域名 | 确认实际请求域名，检查应用自身网络行为 |
| 直连有请求，代理没有请求且超时 | 节点、认证、协议或网络链路 | 换一个已知节点，暂时关闭规则和重写 |
| 全部代理有请求，规则模式动作不符 | 规则未命中、规则顺序或策略名称 | 检查规则资源状态、命中记录和策略候选项 |
| 请求出现但域名解析异常 | DNS、IPv6 或应用自身解析方式 | 记录 A/AAAA 行为，分别测试 IPv4、IPv6 和直连 |
| 关闭重写后恢复 | 重写匹配范围或脚本逻辑 | 停用最近一条资源，逐条恢复并记录结果 |
请求记录只能说明客户端观察到的请求，不等于证明所有流量都经过同一代理路径。结论应同时参考运行模式、策略、DNS、IPv6、应用行为和复测结果。
常见故障、复测与回滚顺序
- 导入后没有节点：先检查订阅返回的是文本、配置内容，还是登录页、验证码或错误页；再确认格式是否面向 Quantumult X。资源更新成功但策略为空时，检查节点资源标签和策略引用。
- 节点显示但连接超时：切换到另一个节点，记录时间、网络类型和错误提示。只有一个节点失败时优先核对节点参数；多个节点都失败时检查本地网络、订阅返回和系统 VPN 冲突。
- 规则模式下部分应用打不开：切换全部直连和全部代理做对照，再看请求记录、规则命中、DNS、IPv6 和应用自身连接方式。
- 配置更新后变空：停止继续更新，恢复更新前备份；检查远程地址是否失效、是否要求登录、返回内容是否改变，以及资源格式是否仍适配当前版本。
- 任何改动后变慢：按“关闭脚本和任务→关闭重写→停用 MitM→恢复规则→恢复节点配置”的顺序回滚，每次回滚一层并复测。
官方示例中说明，远程资源可以有标签、启用状态和更新间隔等参数，但具体资源更新行为仍要以当前版本解析结果、资源返回内容和错误提示为准。不要把教程中的固定间隔或参数当作所有资源都支持。
常见问题
Quantumult X 在 iPhone 和 iPad 上的安装步骤一样吗？
基本路径相近：从 App Store 获取应用、首次打开、按系统提示完成 VPN 或网络授权，然后备份并导入资源。但设备系统版本和应用当前版本可能改变菜单名称与授权提示，因此应以设备当前页面为准。本文重点覆盖 iPhone 和 iPad，不把 Mac 或 Apple TV 的界面步骤混用。
为什么 Quantumult X 订阅导入后没有节点？
先检查订阅地址返回的是节点内容还是登录页、验证码、错误页或空内容；再确认资源格式是否面向 Quantumult X。若资源更新成功但策略为空，检查资源是否启用、标签是否变化，以及当前策略是否引用了这组节点。不要在没有备份时覆盖原配置。
有没有可以直接复制运行的 Quantumult X 最小配置？
没有适用于所有用户的通用可运行配置。真正可连接的配置必须包含真实节点地址、端口、协议和认证信息，这些资料属于具体服务方且本文没有核实。文中的代码是根据官方示例整理的结构参考，可复制用于理解区块关系，但不能直接连接，导入前必须替换并以当前版本解析结果为准。
[rewrite_remote] 怎么导入，和重写规则有什么区别？
在配置文件中，<code>[rewrite_remote]</code>用于引用远程重写资源，通常包含资源地址、标签和启用状态等字段；重写规则本身则定义匹配 URL、请求头、响应体或脚本动作。先只添加一条可追溯来源的资源，检查更新状态和请求记录，异常时停用该资源并恢复备份。官方字段示例可参考 sample.conf 与 rewrite.md。
规则模式为什么部分应用正常、部分应用超时？
规则只处理它能观察并匹配到的请求，应用还可能使用不同域名、IPv6、独立连接或自身 DNS。先用全部直连和全部代理做对照，再查看请求记录、规则命中、策略是否为空以及 DNS/IPv6 行为。不能仅凭一个网页打开成功认定所有应用都经过同一路径。
MitM 证书异常时怎么彻底回滚？
先关闭 Quantumult X 内部 MitM、重写和脚本，再到 iOS/iPadOS 当前设置中查找证书、描述文件或设备管理相关页面，取消不再需要的证书信任并删除对应描述文件或证书，随后重启应用或设备并用全部直连复测。页面名称会因系统版本变化，操作前先记录证书用途，避免误删其他工作配置。
开启脚本后应用变慢或打不开怎么办？
先停用最近添加的脚本和计划任务，再关闭重写资源并恢复到最近一次正常配置。记录脚本名称、来源、匹配域名、执行时间和复测结果；一次只恢复一个脚本。陌生脚本可能读取请求信息、访问远程地址或保存数据，不要把它当作普通节点资源。