Quantumult X 配置:从零导入、分流设置与连接排错
简答:Quantumult X 配置的最短流程是:从 App Store 获取应用,备份现有配置,导入服务提供方给出的配置文件或节点订阅,选择策略组并开启 VPN。基础连接不需要先启用 MitM;只有确实要做 HTTP 调试、重写或脚本处理时,才按需配置证书和主机名。Quantumult X 的安装入口、开发者和系统要求应以当前 App Store 页面为准,检索时间为 2026-10-30。<a href="https://apps.apple.com/us/app/quantumult-x/id1443988620">查看 Quantumult X App Store 页面</a>。
定义:Quantumult X 是一款面向 iPhone、iPad、Mac 和 Apple TV 的网络工具,配置文件负责组织 DNS、节点、策略、分流规则、重写和 MitM 等功能模块。
先用最短流程完成基础配置
如果你的目标只是让 Quantumult X 识别节点并建立连接,不要一开始就加入脚本、重写或 MitM。先完成下面 6 步,再根据具体需求增加模块。
- 确认安装入口:在 App Store 搜索“Quantumult X”,核对应用名称和开发者信息;不要把名称相近的应用、来路不明的安装包或共享账号当作官方入口。当前商店页面显示开发者为 Cross Utility Ltd,并列出 iPhone、iPad、Mac 和 Apple TV 等设备支持情况,具体价格、地区和系统要求以当前页面为准。App Store 页面
- 先备份:打开 Quantumult X 的配置编辑或设置入口,把当前配置导出到安全位置。远程配置有可能替换现有远程资源,尤其不要在没有备份的情况下直接使用“更新全部配置”类链接。
- 选择一种入口:优先使用服务提供方明确标注为 Quantumult X、Quantumult 或原生配置的链接;如果只有其他客户端格式,应先确认是否需要资源解析器或转换服务,不要直接假设格式兼容。
- 导入配置:通过系统分享菜单、“从 URL 导入”或应用内的远程配置入口导入。导入完成后,先查看配置列表是否出现,再检查节点、策略和规则资源是否分别存在。
- 选择策略:在策略或策略组页面选择一个可用节点,首次测试建议只使用一个明确节点,不要同时叠加多个自动选择、负载均衡或重写规则。
- 开启 VPN 并验证:在 Quantumult X 中开启连接,按 iOS 提示允许添加 VPN 配置;随后用一个普通网页或你明确知道可访问的业务地址测试。若无效,先关闭重写和 MitM,再回到节点与策略排查。
官方示例配置将远程节点、远程分流和远程重写分别放在 [server_remote]、[filter_remote] 和 [rewrite_remote] 等区段中;这意味着“节点已经导入”并不等于“规则已经导入”,两者需要分开检查。Quantumult X 官方示例配置
配置文件、节点订阅和策略组有什么区别
很多“Quantumult X 配置失败”其实是把不同类型的资源混在了一起。可以先按下面的关系理解:
| 项目 | 作用 | 导入后检查什么 |
|---|---|---|
| 配置文件 | 集中保存通用设置、DNS、策略、节点、规则和重写等内容 | 配置是否成功加载,原有配置是否被覆盖 |
| 节点订阅 | 提供多个代理节点或服务器条目 | 节点数量、标签、协议和更新时间 |
| 策略组 | 决定请求使用直连、某个节点或自动选择 | 策略组中是否真正包含可用节点 |
| 分流规则 | 按域名、后缀、关键词等条件决定请求走哪种策略 | 规则是否启用、是否命中、是否被更高优先级规则覆盖 |
| 重写与脚本 | 修改请求或响应,或执行特定任务 | 来源、权限、匹配范围和关闭后的回退效果 |
| MitM | 用于特定 HTTPS 流量的调试或处理 | 证书是否正确安装、是否信任、主机名是否限制在必要范围 |
官方示例还说明,远程资源可以设置标签、更新时间、是否启用以及是否使用资源解析器;因此导入成功后要分别查看资源状态,而不是只看配置文件名称。官方 sample.conf 参数说明
三种配置方式怎么选
新手:导入一份完整配置
适合刚安装、只想先完成基础连接的人。优点是步骤少;缺点是你不容易知道其中包含哪些规则、重写和脚本。导入前应先备份,导入后逐项查看 server_remote、filter_remote、rewrite_remote 和 mitm 相关内容。
进阶:配置文件与节点订阅分开
适合希望自己控制分流规则的人。节点订阅只负责提供服务器条目,分流规则和策略组由你单独管理。这样出现节点失效时,不必同时重换整份配置;但需要确认策略组确实引用了新导入的节点。
高级:本地配置加远程资源
适合需要自定义 DNS、策略、规则、重写或调试范围的人。官方示例支持使用远程节点、远程过滤器和远程重写资源,并可设置标签、启用状态和更新间隔。高级配置建议一次只增加一个模块,每次修改后立即测试,避免多个远程资源同时出错。官方配置区段示例
选择原则:只想连接就先导入节点或最小配置;需要按应用、域名分流再添加规则;只有明确需要请求调试或重写时才考虑 MitM。不要因为配置教程中出现某个模块,就默认所有用户都必须开启它。
订阅导入后节点为空或策略组没有节点
- 先看远程资源状态:确认订阅地址没有被截断,标签没有重复,资源状态不是禁用或更新失败。
- 确认格式:Quantumult X 原生配置、纯节点订阅以及其他客户端配置并不一定能直接互换。若服务方提供的是其他格式,应查看其是否明确支持 Quantumult X,或是否需要资源解析器;不要把一段普通配置文本直接当成节点 URL。
- 检查节点是否单独存在:节点出现在服务器列表,不代表它已经进入某个策略组。打开策略组查看成员;如果策略组只包含一个已经失效的固定名称,新增节点也不会自动生效。
- 关闭筛选条件:暂时移除地区、关键词、正则或延迟筛选,先确认原始节点能否显示,再逐项恢复筛选。
- 重新更新:在网络稳定时手动更新一次;若仍失败,回到服务提供方获取新的订阅地址,不要重复导入同一条已经返回错误的地址。
官方示例显示,远程节点资源可通过标签、启用状态和更新时间管理;其中资源解析器属于可选参数,不应在没有确认格式需求时盲目打开。远程节点与解析器示例
分流规则不生效时的检查顺序
分流问题应先排除“连接本身失败”,再判断规则是否命中。建议按以下顺序:
- 确认 VPN 已开启,并且当前策略组中有可用节点。
- 临时切换到明确的单节点或全局策略,判断目标地址是否能建立连接。
- 如果单节点可以访问,再恢复规则模式,检查目标域名是否属于规则覆盖范围。
- 检查规则顺序和策略名称是否一致;规则写的是某个策略名,但策略组名称已经改动时,可能出现规则存在但无法按预期执行。
- 暂时停用重写、脚本和 MitM,排除请求被修改、证书校验或脚本逻辑影响。
常见策略含义可以这样理解:DIRECT 通常表示直连,PROXY 通常表示交给代理策略,REJECT 通常表示拒绝请求;具体行为仍取决于当前配置内容,不能仅凭名称判断最终效果。官方示例展示了过滤器通过 force-policy 强制指定策略的方式,因此一个规则资源可能覆盖配置中的默认策略。官方过滤器与 force-policy 示例
MitM、证书和重写:基础连接不需要先开启
Quantumult X 的 App Store 说明提到,MitM 可用于 HTTP 流量解密,重写可处理 URL 跳转、请求头、请求体或响应内容;这些属于高级功能,不是普通节点连接的前置条件。App Store 功能说明
- 先明确用途:如果只是访问网页、连接办公服务或测试节点,先不要开启 MitM。
- 只从可信来源获取配置:导入重写规则、脚本或证书前,查看来源、更新时间、启用范围和是否包含账号相关处理。
- 限制主机名:只对确实需要处理的域名启用,不要为了“省事”扩大到所有 HTTPS 流量。
- 按系统提示安装并信任证书:iOS 的证书安装与信任入口可能随系统版本变化,操作时以当前系统页面为准;如果找不到对应入口,先关闭 MitM,不要反复安装未知证书。
- 完成测试后回退:关闭 MitM、删除不再使用的证书,并恢复最小规则范围。若关闭后基础连接恢复,说明问题更可能来自证书、重写或脚本,而不是节点本身。
不要把“能导入”当作“可信”。尤其是涉及登录、Cookie、请求头或账号操作的脚本,无法确认来源和行为时,应保持关闭。
按现象排查 Quantumult X 连接问题
| 现象 | 优先检查 | 回退方法 |
|---|---|---|
| 配置文件无法下载 | URL 是否完整、当前网络是否能打开、远程地址是否仍有效 | 改用服务方提供的最新入口,或先下载到本地后通过系统分享导入 |
| 订阅更新失败 | 订阅是否过期、是否被禁用、格式是否被支持 | 删除失败资源后重新添加,不要叠加多个相同订阅 |
| 节点列表为空 | 资源返回内容、解析器设置、筛选条件 | 关闭筛选与解析器,先测试原始订阅 |
| 策略组没有节点 | 策略组成员、节点标签、规则引用的策略名称 | 临时选择一个明确节点,确认节点可用后再恢复策略组 |
| 规则不生效 | 规则顺序、目标域名、策略名称、是否被强制策略覆盖 | 切换单节点测试,再逐条恢复规则 |
| VPN 无法连接 | 系统 VPN 权限、其他 VPN 配置、当前节点协议和网络环境 | 关闭其他 VPN,重启 Quantumult X,使用最小配置重新测试 |
| 开启 MitM 后报错 | 证书信任、主机名范围、重写或脚本内容 | 关闭 MitM 与重写,确认基础连接恢复后再逐项启用 |
如果问题只在某个 Wi-Fi、蜂窝网络或办公网络出现,应额外记录网络类型、DNS 设置、连接时间和错误提示;不要只凭“感觉变慢”判断节点或线路故障。
配置完成后的验收清单
- App 来源和开发者信息已核对,未使用未知安装包。
- 原有配置已经备份,导入后没有误删需要保留的资源。
- 节点订阅、策略组和分流规则分别能够看到。
- 策略组中至少有一个明确可测试的节点。
- VPN 可以开启,系统没有同时运行冲突的 VPN 配置。
- 普通连接测试通过后,再考虑 DNS、规则、重写和 MitM。
- 所有远程资源都有标签,来源和用途能够解释。
- 不使用的脚本、证书和重写规则已经关闭或删除。
如果你主要处理跨境办公、企业系统连接或多设备网络问题,建议先把 Quantumult X 的配置范围控制在“节点、策略、分流”三部分,确认延迟、丢包和 DNS 表现后,再添加高级规则。这样更容易判断问题来自客户端配置、网络环境还是远端线路。
常见问题
Quantumult X 配置文件导入后,原来的配置会不会被覆盖?
有可能,取决于你使用的是追加资源还是更新整份配置的入口。导入前先导出当前配置;如果只是添加节点或规则,优先使用明确标注为添加资源的方式,完成后再检查原有策略和规则是否仍在。
Quantumult X 节点订阅导入后为什么没有节点?
先检查订阅地址是否完整、资源是否更新成功、格式是否被 Quantumult X 支持,以及是否开启了不合适的筛选或解析器。关闭筛选条件后重新更新,如果仍为空,应向订阅提供方确认该地址是否支持 Quantumult X。
Quantumult X 配置一定要开启 MitM 和证书吗?
不需要。普通节点连接、策略选择和基础分流不要求先启用 MitM。只有在明确需要 HTTPS 调试、请求重写或特定脚本功能时才考虑证书,并且应限制主机名范围,使用完及时关闭。Quantumult X 官方商店说明也将 MitM 和 Rewrite 作为单独的高级功能。<a href="https://apps.apple.com/us/app/quantumult-x/id1443988620">官方功能说明</a>
为什么策略组里看不到刚导入的节点?
节点列表和策略组是两个不同层级。先确认节点已经出现在服务器资源中,再打开策略组检查成员是否包含该节点;如果策略组使用固定标签、正则或筛选条件,新节点可能不会自动加入。可以临时选择一个明确节点验证基础连接。
Quantumult X 规则不生效,应该先改 DNS 还是先换节点?
先用单节点或明确策略测试连接,再判断规则是否命中。若单节点能用而规则模式不能用,优先检查规则顺序、目标域名和策略名称;只有确认是解析异常时,再进一步检查 DNS。一次只改一个变量,便于定位。
Quantumult X 配置中可以直接使用其他客户端订阅吗?
不能默认兼容。原生 Quantumult X 配置、纯节点订阅以及其他客户端格式的字段结构可能不同。使用前应确认提供方明确支持 Quantumult X,或确认需要资源解析器;不确定时不要直接覆盖现有配置。