Quantumult X怎么用:安装、订阅导入与节点排错步骤
简答:导入后节点为空、开了代理却不生效时,先不要急着改大量规则:按“安装应用→获取兼容订阅→添加节点资源→检查 resource_parser_url→单节点测试→再启用规则模式”的顺序排查。Quantumult X 是付费应用,价格以当前 App Store 页面为准;本文最近核验于 2026-10-24,菜单名称和设备支持情况以当前版本显示为准。
定义:Quantumult X 是一款面向 Apple 设备的可配置网络工具,主要围绕节点资源、策略组、分流规则、DNS 和重写配置完成连接与请求路由。
先照做:首次连接的六步速查
如果你的目标只是先让一个节点正常工作,建议暂时不要配置重写、MitM 或大量规则。先完成下面六步,再逐项增加功能。
- 在 App Store 搜索
Quantumult X,核对开发者显示为 Cross Utility Ltd。 - 完成购买或下载并首次启动,按系统提示允许添加 VPN 配置。
- 从你已购买的网络服务提供方用户后台获取订阅链接,优先选择标明 Quantumult X、节点资源或兼容配置的格式。
- 进入应用的设置或配置入口;多数版本可从右下角图标进入资源或引用页面,再选择添加。界面名称可能变化,以当前版本为准。
- 更新资源后先选择一个具体节点,不要马上使用复杂策略组。
- 开启连接后访问普通网页,再查看请求记录、命中策略和 DNS 或连接错误。
| 现象 | 第一检查点 | 不要先做什么 |
|---|---|---|
| 搜不到应用 | App Store 账号地区、登录状态和关键词 | 不要从不明来源安装所谓安装包 |
| 导入后无节点 | 订阅返回内容、resource_parser_url、解析器开关 | 不要反复更换规则集 |
| 节点显示但连不上 | 单节点、网络环境和请求记录 | 不要同时叠加多个策略组 |
| 部分请求不走节点 | 规则命中结果和 DIRECT 策略 | 不要只看系统 VPN 图标判断成功 |
App Store 当前页面将 Quantumult X 标为付费应用,并列出 iPhone、iPad、Mac 和 Apple TV 等平台;价格、系统兼容性和页面描述可能变化,安装前应以当前页面为准。参考Apple App Store 产品页。
安装前要确认什么:付费应用与商店地区
Quantumult X 是付费应用,具体价格以当前 App Store 页面为准。安装时建议直接在 App Store 搜索应用名称,并核对开发者为 Cross Utility Ltd,不要把搜索结果中的其他页面直接认定为官方入口。
- 打开 iPhone 或 iPad 的 App Store。
- 搜索
Quantumult X,检查应用名称、图标和开发者信息。 - 如果当前账号搜索不到,先检查 Apple 账号所属商店地区、登录状态和搜索拼写。
- 完成购买或下载后启动应用。
- 首次开启连接时,允许系统添加 VPN 配置,并按设备提示完成授权。
中国区账号如果看不到该应用,不能据此判断应用已经下架;更稳妥的做法是先核对当前账号所在商店和 Apple 页面显示。App Store 页面显示的适用设备包括 iPhone、iPad、Mac 和 Apple TV,但实际使用入口仍可能因系统和版本不同而变化。参考App Store 的当前产品信息。
订阅链接从哪里获取:先分清链接和资源类型
订阅链接通常来自你已购买的网络服务提供方用户后台。登录后台后,寻找“订阅”“客户端配置”“节点订阅”或类似入口,并优先选择明确标注 Quantumult X、节点资源或兼容配置的导出选项。不同服务提供方的名称可能不同,不能把任意网页地址都当作订阅链接。
拿到链接后,可先在浏览器中打开进行初步判断:如果返回 Base64 文本、明文节点行或配置文本,可能是可解析的资源;如果返回登录页面、HTML 错误页、过期提示或需要再次点击的网页,就不能直接当作 Quantumult X 节点订阅使用。订阅链接通常包含授权信息,不要公开发布或粘贴到不可信网站。
| 资源类型 | 主要内容 | 适用场景 |
|---|---|---|
| 节点资源 | 具体服务器节点 | 已有本地配置,只增加节点 |
| 完整配置 | 可能同时包含节点、策略、规则和 DNS | 希望整体导入一套配置 |
| 规则资源 | 域名、IP 或关键词匹配规则 | 已有节点,需要分流 |
官方示例配置中可以看到 server_remote、filter_remote 等资源段。资源类型不同,导入入口和后续效果也不同,不能把完整配置、节点资源和规则资源混为一谈。参考Quantumult X 官方 sample.conf 配置示例。
具体怎么导入节点:路径、刷新与解析器检查
当前版本的菜单名称可能变化,下面给出便于新手寻找的操作方向:右下角图标→资源或引用→添加,然后粘贴订阅地址并保存;如果你的界面没有完全相同的文字,请按“配置、资源、引用、节点”这些功能名称寻找,以当前版本为准。
- 复制服务提供方后台生成的订阅链接。
- 打开 Quantumult X 的设置或配置入口。
- 进入资源、引用或节点资源列表,选择添加远程资源。
- 粘贴链接并保存,回到资源列表执行更新。
- 更新后打开节点列表,确认出现具体节点名称。
- 如果节点为空,检查订阅返回内容、
resource_parser_url和当前版本是否提供“启用解析器”或类似开关;存在时应打开后重新更新。
官方示例对 resource_parser_url 只给出占位形式,例如 resource_parser_url=http://www.example.com/parser.js,并没有在该示例中提供一个可直接照抄的通用解析器地址。因此,遇到非 Quantumult X 原生格式时,应填写你信任且确认兼容的解析器脚本地址,不要把占位地址当成可用服务。官方资源解析器协议说明还介绍了资源解析器与客户端之间的参数化交互,具体兼容范围取决于解析器本身。参考官方 sample.conf和官方资源解析器协议说明。
订阅、节点、策略、规则和请求是什么关系
可以把 Quantumult X 的基本工作链路理解为:订阅链接提供资源,节点资源生成具体节点,策略组决定如何选节点,规则决定请求交给哪个策略,最后在请求记录中查看实际命中结果。
| 层级 | 作用 | 排查问题时看什么 |
|---|---|---|
| 订阅链接 | 从服务提供方获取配置或节点数据 | 是否过期、是否返回错误页 |
| 节点资源 | 把远程内容转换成节点条目 | 是否更新成功、是否出现节点 |
| 策略组 | 把一个或多个节点组织成选择逻辑 | 组内是否有节点、策略是否可用 |
| 规则 | 根据域名、地址或关键词分配请求 | 规则顺序和命中策略 |
| 请求记录 | 显示请求、策略、DNS 和连接状态 | 实际是否 DIRECT、失败在哪一层 |
最容易出错的是把“有节点”误认为“请求一定会使用节点”。节点只是可选资源,最终是否使用,还要看当前模式、策略组和规则命中结果。
全部直连、全部代理、规则模式怎么选
三种模式的用途不同,建议先用单节点和全部代理完成基础验证,再切回规则模式。这样可以把“节点不能用”和“规则没有命中”区分开。
| 模式 | 含义 | 适合什么时候使用 |
|---|---|---|
| 全部直连 | 请求尽量不经过代理节点 | 确认本地网络、DNS 和目标站点是否正常 |
| 全部代理 | 请求尽量交给代理策略 | 短时间测试节点和代理链路 |
| 规则分流 | 按照规则决定直连、代理或拒绝 | 日常使用和精细控制 |
推荐测试顺序:单个节点→全部代理→规则模式。若单节点和全部代理正常,而规则模式异常,优先检查规则顺序、策略组名称和目标请求是否被安排为 DIRECT;若单节点本身也无法连接,再回到网络、节点参数和订阅状态排查。
请求记录怎么看:判断是节点、规则还是 DNS
代理开关显示开启,只能说明系统配置可能已经建立,不能单独证明某个应用的请求按预期经过指定节点。验证时要看请求记录或活动记录中的实际字段。
- 先选择一个具体节点,不要使用自动策略组。
- 开启当前版本提供的 Tunnel 或连接开关。
- 访问一个普通网页,让设备产生新请求。
- 打开请求记录、活动记录或 HTTP 活动相关页面,具体入口以当前版本为准。
- 检查目标域名、命中策略、DNS 结果、连接状态和错误提示。
| 记录表现 | 通常说明 | 下一步 |
|---|---|---|
| 显示 DIRECT | 规则将请求安排为直连 | 检查规则顺序和策略设置 |
| 没有请求记录 | 请求尚未产生,或当前入口未记录该流量 | 刷新页面并确认记录功能状态 |
| DNS 错误 | 域名解析或 DNS 配置存在问题 | 先做全部直连对照,再检查 DNS |
| 连接超时 | 节点、网络、目标站点或线路均可能相关 | 更换单节点并切换 Wi-Fi/蜂窝网络对照 |
Quantumult X 的官方项目说明提到请求历史、策略路由和 DNS 结果记录等能力,但具体菜单文字可能随版本变化。参考Quantumult X 官方 GitHub 项目说明。
常见故障排查:按现象逐层定位
| 现象 | 优先检查 | 处理顺序 |
|---|---|---|
| 节点列表为空 | 返回格式、resource_parser_url、解析器开关 | 浏览器打开订阅→确认不是错误页→检查解析器→重新更新 |
| 订阅更新失败 | 链接是否过期、当前网络能否访问、是否需要登录 | 重新获取链接→在浏览器测试→再回到应用更新 |
| 节点显示但无法连接 | 单节点、协议参数、端口和当前网络 | 切换另一个节点→查看请求记录→切换网络对照 |
| 连接超时、延迟高或丢包 | Wi-Fi、蜂窝网络、DNS 和节点线路 | 先全部直连→再单节点→最后比较不同网络 |
| 部分应用不走代理 | 规则命中、应用自身网络设置和 DNS | 查看请求记录→确认是否 DIRECT→临时全部代理对照 |
| 规则不生效 | 规则集更新状态、规则顺序和策略组名称 | 更新规则→检查命中顺序→确认目标策略存在 |
判断是否更像线路问题时,先做分层对照:如果普通国内站点和本地网络也异常,优先检查 Wi-Fi、蜂窝网络、DNS 或设备设置;如果本地访问正常,而特定境外目标持续超时或丢包,再比较不同节点和网络环境。联系运营商前,准备设备型号、网络类型、发生时间、目标域名、错误现象,以及更换网络后是否仍能复现。
重写和 MitM 要不要配置:新手先保持关闭
重写、HTTP 调试和 MitM 属于高级功能,不是完成首次连接的必要步骤。如果只是导入节点和访问网页,建议先不配置,避免把证书、规则和节点问题混在一起。
如果你确实需要调试自己有权限管理的服务,应先确认用途和风险,再按当前版本提供的证书流程操作:生成证书→安装描述文件→在系统证书信任设置中启用信任→仅配置必要的 hostname→完成测试后关闭或删除相关设置。
证书安装失败时,依次检查描述文件是否安装、系统是否允许信任该根证书、hostname 是否覆盖目标域名,以及当前配置是否真正启用了 MitM。官方配置示例提醒用户妥善保管 CA 密码和 p12 私钥;不要公开上传证书、私钥、订阅链接或包含个人信息的请求记录。参考官方 sample.conf 中的 MitM 配置说明。
iPhone、iPad、Mac 与 Apple TV 怎么理解
App Store 当前页面同时列出 iPhone、iPad、Mac 和 Apple TV,但不同设备的界面布局、系统权限和连接入口可能不同。因此,本文把 iPhone 和 iPad 作为主要教程范围;Mac 或 Apple TV 是否能按相同路径使用,应以当前 App Store 页面和设备实际界面为准。
| 设备 | 使用时的重点 | 遇到界面不同怎么办 |
|---|---|---|
| iPhone | 检查 Wi-Fi、蜂窝网络和系统 VPN 授权 | 按资源、节点和连接功能名称寻找入口 |
| iPad | 横竖屏和系统版本可能影响菜单布局 | 先确认配置文件和资源状态,不要重复导入 |
| Mac | 以当前商店页面显示的兼容性和权限为准 | 不要直接套用 iPhone 的按钮位置 |
| Apple TV | 页面虽列出设备,但实际功能入口需按设备核对 | 以当前设备页面和应用显示为准 |
本文最近核验于 2026-10-24。应用价格、系统支持、版本功能和菜单文字都可能变化,发布前或安装前应重新查看当前 App Store 页面。
常见问题
Quantumult X 是免费应用吗?
不是。当前 App Store 页面将 Quantumult X 标为付费应用,具体价格以你所在商店的实时页面为准。安装时还应核对应用名称和开发者信息,不建议使用来源不明的安装包。
如果 App Store 搜不到 Quantumult X,应该先查什么?
先检查 Apple 账号所属商店地区、登录状态和搜索拼写,再打开当前 App Store 产品页核对是否能访问。不要因为搜索不到就直接下载其他页面提供的安装包。
订阅导入成功但节点为空,最常见的排查顺序是什么?
先在浏览器打开订阅链接,确认返回的不是登录页、HTML 错误页或过期提示;然后检查 resource_parser_url 和当前版本是否有“启用解析器”开关,完成设置后再更新资源。
resource_parser_url 应该填写什么地址?
官方 sample.conf 展示的是占位格式,并没有提供一个适用于所有订阅的通用地址。应使用你信任且确认兼容的解析器脚本地址,不要直接照抄 example.com 或未经核验的脚本链接。
节点资源和完整配置可以互相替代吗?
不能简单替代。节点资源主要增加服务器条目,完整配置可能同时改动策略、规则、DNS 和重写设置。已有本地配置时,通常先导入节点资源,避免覆盖原有设置。
为什么开启代理后,请求记录仍然显示 DIRECT?
DIRECT 表示当前规则或策略把该请求安排为直连,不一定代表节点失效。先查看命中的规则和策略组,再用单节点、全部代理做短时间对照,确认问题是在规则还是连接本身。
什么时候应该怀疑是网络线路而不是客户端配置?
先用全部直连访问普通站点,并切换 Wi-Fi、蜂窝网络或其他节点。如果本地网络和普通站点都正常,只有特定境外目标持续超时或丢包,再进一步比较节点线路;否则优先检查本地网络、DNS 和设备设置。
第一次使用需要配置重写或 MitM 吗?
不需要。首次目标是完成订阅导入和基础连接,重写与 MitM 属于高级功能。只有在明确知道调试对象、证书风险和配置范围时才使用,测试完成后应关闭不必要的设置。