【晚高峰不限速】网际快车 | 专为搞钱而生的极速原生IP机场

Quantumult X 配置:从零导入、分流设置与连接排错

更新于 2026-10-30 · wj-kc.top

简答: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 步,再根据具体需求增加模块。

  1. 确认安装入口:在 App Store 搜索“Quantumult X”,核对应用名称和开发者信息;不要把名称相近的应用、来路不明的安装包或共享账号当作官方入口。当前商店页面显示开发者为 Cross Utility Ltd,并列出 iPhone、iPad、Mac 和 Apple TV 等设备支持情况,具体价格、地区和系统要求以当前页面为准。App Store 页面
  2. 先备份:打开 Quantumult X 的配置编辑或设置入口,把当前配置导出到安全位置。远程配置有可能替换现有远程资源,尤其不要在没有备份的情况下直接使用“更新全部配置”类链接。
  3. 选择一种入口:优先使用服务提供方明确标注为 Quantumult X、Quantumult 或原生配置的链接;如果只有其他客户端格式,应先确认是否需要资源解析器或转换服务,不要直接假设格式兼容。
  4. 导入配置:通过系统分享菜单、“从 URL 导入”或应用内的远程配置入口导入。导入完成后,先查看配置列表是否出现,再检查节点、策略和规则资源是否分别存在。
  5. 选择策略:在策略或策略组页面选择一个可用节点,首次测试建议只使用一个明确节点,不要同时叠加多个自动选择、负载均衡或重写规则。
  6. 开启 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。不要因为配置教程中出现某个模块,就默认所有用户都必须开启它。

订阅导入后节点为空或策略组没有节点

  1. 先看远程资源状态:确认订阅地址没有被截断,标签没有重复,资源状态不是禁用或更新失败。
  2. 确认格式:Quantumult X 原生配置、纯节点订阅以及其他客户端配置并不一定能直接互换。若服务方提供的是其他格式,应查看其是否明确支持 Quantumult X,或是否需要资源解析器;不要把一段普通配置文本直接当成节点 URL。
  3. 检查节点是否单独存在:节点出现在服务器列表,不代表它已经进入某个策略组。打开策略组查看成员;如果策略组只包含一个已经失效的固定名称,新增节点也不会自动生效。
  4. 关闭筛选条件:暂时移除地区、关键词、正则或延迟筛选,先确认原始节点能否显示,再逐项恢复筛选。
  5. 重新更新:在网络稳定时手动更新一次;若仍失败,回到服务提供方获取新的订阅地址,不要重复导入同一条已经返回错误的地址。

官方示例显示,远程节点资源可通过标签、启用状态和更新时间管理;其中资源解析器属于可选参数,不应在没有确认格式需求时盲目打开。远程节点与解析器示例

分流规则不生效时的检查顺序

分流问题应先排除“连接本身失败”,再判断规则是否命中。建议按以下顺序:

  1. 确认 VPN 已开启,并且当前策略组中有可用节点。
  2. 临时切换到明确的单节点或全局策略,判断目标地址是否能建立连接。
  3. 如果单节点可以访问,再恢复规则模式,检查目标域名是否属于规则覆盖范围。
  4. 检查规则顺序和策略名称是否一致;规则写的是某个策略名,但策略组名称已经改动时,可能出现规则存在但无法按预期执行。
  5. 暂时停用重写、脚本和 MitM,排除请求被修改、证书校验或脚本逻辑影响。

常见策略含义可以这样理解:DIRECT 通常表示直连,PROXY 通常表示交给代理策略,REJECT 通常表示拒绝请求;具体行为仍取决于当前配置内容,不能仅凭名称判断最终效果。官方示例展示了过滤器通过 force-policy 强制指定策略的方式,因此一个规则资源可能覆盖配置中的默认策略。官方过滤器与 force-policy 示例

MitM、证书和重写:基础连接不需要先开启

Quantumult X 的 App Store 说明提到,MitM 可用于 HTTP 流量解密,重写可处理 URL 跳转、请求头、请求体或响应内容;这些属于高级功能,不是普通节点连接的前置条件。App Store 功能说明

  1. 先明确用途:如果只是访问网页、连接办公服务或测试节点,先不要开启 MitM。
  2. 只从可信来源获取配置:导入重写规则、脚本或证书前,查看来源、更新时间、启用范围和是否包含账号相关处理。
  3. 限制主机名:只对确实需要处理的域名启用,不要为了“省事”扩大到所有 HTTPS 流量。
  4. 按系统提示安装并信任证书:iOS 的证书安装与信任入口可能随系统版本变化,操作时以当前系统页面为准;如果找不到对应入口,先关闭 MitM,不要反复安装未知证书。
  5. 完成测试后回退:关闭 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,或确认需要资源解析器;不确定时不要直接覆盖现有配置。

相关阅读

参考资料

  1. Quantumult X App Store 页面:开发者、支持设备与功能说明
  2. Quantumult X 官方 GitHub 示例配置:远程节点、规则、重写与策略参数