Quantumult X 分流规则不生效怎么办？

更新于 2026-11-10 · zhuiyunjiasu.shop

简答：Quantumult X 分流规则不生效，优先按“模式与连接→规则资源→匹配顺序→策略组→新请求验证”排查。最常见的误判不是规则语法错误，而是仍处于全部代理、全部直连，规则资源未启用，或规则命中后绑定了不可用策略。先切换到规则分流并重新建立连接，再用一个域名做最小测试。

定义：Quantumult X 分流规则不生效，是指请求没有按匹配到的 host、host-suffix、IP-CIDR 或其他过滤条件进入预期策略，而不一定代表节点或网络本身故障。

先用 5 步判断故障在哪一层

核验日期：2026-11-10。Quantumult X 的官方示例把本地规则放在 [filter_local]，远程规则放在 [filter_remote]；远程资源还可以设置 force-policy、enabled、inserted-resource 和更新间隔。先不要修改 DNS、MitM 或脚本，按下面顺序缩小范围。

检查层级	入口与动作	成功信号	失败分支
1. 运行模式	打开 Quantumult X 的连接控制，确认 VPN/Tunnel 已开启，并选择规则分流，而不是全部代理或全部直连。	系统状态栏显示 VPN，应用请求经过 Quantumult X。	若 VPN 未授权或连接未建立，先恢复连接；不要继续改规则。
2. 规则资源	检查本地规则或远程规则是否启用，远程 URL 是否能打开，资源类型是否确实是 filter，而不是 server 或 rewrite。	资源显示已加载、已启用，且没有解析错误。	重新下载或暂时停用该资源，回到最小本地规则测试。
3. 匹配顺序	把一个明确的精确域名规则放在测试规则区域，避免被更早的直连、拒绝或合集规则覆盖。	目标域名进入指定策略。	若仍不匹配，检查域名是否带有不同子域名，或请求实际使用了 IP。
4. 策略组	确认规则最后一列引用的策略名称确实存在，并且策略组中有可用服务器。	规则命中后显示正确策略，策略组能建立连接。	改用已存在的静态策略做测试，区分“规则命中”和“节点故障”。
5. 新请求	关闭目标应用或浏览器页面，重新打开并发起新请求。	新请求采用修改后的策略。	若只有旧页面异常，先排除连接复用、缓存或应用自身状态。

官方示例还说明，配置修改本身不会自动触发重新连接；因此修改后应主动重新连接 Quantumult X Tunnel，或至少用新建请求验证。

用最小规则确认“能不能命中”

复杂规则集容易把问题混在一起。建议先在配置的 [filter_local] 中加入一条只用于测试的精确域名规则，策略名称替换成你配置中真实存在的策略：

host, example.com, proxy

然后确认配置中存在一个兜底规则，例如：

final, direct

这里的 proxy 和 direct 只是示例策略名，不代表你的配置一定使用这两个名称。官方示例展示了 host、host-suffix、host-keyword、ip-cidr、geoip 和 final 等规则形式；规则动作必须指向当前配置里存在的策略或动作。

入口：编辑当前正在使用的配置，确认规则位于 [filter_local] 段。
动作：只保留一条测试规则和一个明确的 final，暂时不要叠加多个远程规则集。
预期结果：重新建立 Tunnel 后，用新请求访问该域名，策略记录应显示测试策略。
失败分支：若测试规则都不命中，优先查运行模式、当前配置是否生效，以及请求是否经过 Quantumult X。
回滚：测试完成后删除该行，恢复原配置；不要把临时规则长期放在复杂规则集最前面。

如果目标应用直接连接 IP，基于域名的 host 或 host-suffix 规则可能无法达到预期；这时要确认应用是否使用域名请求、是否发生了 DNS 解析，以及是否需要针对 IP 或网段使用合适的规则类型。不要为了让普通分流生效而开启 MitM、重写或脚本功能。

最容易造成误判的 4 类规则冲突

精确域名与后缀规则冲突

host 只针对指定主机名，host-suffix 针对域名后缀，host-keyword 则按关键词匹配。假如你希望只改变 api.example.com，优先使用精确的 host；不要直接用过宽的关键词规则，否则同一域名体系下的其他请求也可能被匹配。

本地规则与远程规则冲突

远程规则资源可能带有自己的策略，或者在配置中通过 force-policy 强制指定策略。官方示例明确说明，设置 force-policy 后，远程资源中原有的策略会被忽略，改用强制策略。因此看到“规则命中了但走错策略”时，要检查远程资源的强制策略，而不只是检查域名是否存在。

合集规则或地区规则覆盖测试规则

包含本地网络、地区 IP 或广告过滤的规则集可能先把请求判定为直连或拒绝。排查时应暂时停用非必要合集，只留下一个精确域名测试；确认命中后，再逐个恢复资源，找出覆盖来源。

final 规则造成“看起来没生效”

final 是未被前面规则匹配时使用的兜底策略。如果测试域名最终进入 final，通常说明前面的规则未加载、规则类型不匹配、域名与实际请求不同，或请求没有经过 Quantumult X。此时不要先更换节点，先验证规则是否真正命中。

远程规则更新失败、格式错误怎么处理

检查 URL：在浏览器中打开远程规则地址，确认返回的是文本规则内容，而不是登录页、HTML 错误页或需要授权的页面。
检查资源类型：远程过滤规则应放在 [filter_remote]；服务器订阅和重写脚本分别属于其他资源段，不能混用。
检查启用状态：确认资源的 enabled=true 或界面中的启用开关处于开启状态。
检查解析结果：若资源显示格式错误，先停用该资源，用官方示例格式写一条本地规则验证客户端本身，再决定是否更换规则文件。
检查更新周期：官方示例指出，远程资源默认同步间隔为 86400 秒，也可以通过 update-interval 自定义；修改后不要只等待缓存，执行一次手动更新并重新连接后再测试。

不要把订阅链接、Token、配置文件或包含个人信息的日志粘贴到公开讨论区。若需要回滚，保留原配置副本，删除新增远程资源，再恢复原来的配置文件并重新建立连接。

规则命中后仍打不开：不要把节点问题当成规则问题

可以把结果拆成三种：未命中、已命中但策略错误、策略正确但连接失败。

未命中：检查规则类型、域名拼写、实际请求主机名、规则资源启用状态和规则顺序。
已命中但策略错误：检查远程资源是否设置了 force-policy，以及策略组是否覆盖了规则动作。
策略正确但连接失败：单独测试策略组里的服务器，确认服务器状态、DNS、TLS、MTU 或丢包问题，不要继续改域名规则。
只有一个应用失败：检查应用是否使用独立网络栈、固定 IP、QUIC、代理例外或自身缓存；先用另一个应用发起同一域名的新请求。

Quantumult X 官方说明提供了请求历史、策略状态和 DNS 记录等诊断信息；这些信息适合用来确认请求实际采用的策略和 DNS 结果。

最短回退路径：停用新增远程规则→恢复原配置→重新建立 Tunnel→用新请求确认基础连接→再逐条恢复规则。这样可以避免一次修改多个变量，导致无法判断是哪一项造成异常。

常见问题

Quantumult X 必须开启哪种模式，分流规则才会生效？

需要确认 Quantumult X 的 VPN/Tunnel 已建立，并使用规则分流模式。全部代理和全部直连会改变规则测试结果；修改配置后还应重新建立连接并发起新请求。

为什么规则明明写了，最后还是走 final？

通常表示前面的规则没有加载、规则类型与实际请求不匹配、域名实际使用了不同子域名或 IP，或者请求没有经过 Quantumult X。先用一条精确 host 规则做最小测试。

远程规则导入后显示已添加，但不生效怎么办？

检查远程 URL 是否返回规则文本，资源是否放在 filter 资源位置，是否启用，是否存在解析错误，以及是否被 force-policy 改写策略。必要时停用远程资源，用本地最小规则验证客户端。

规则命中了，但网页还是打不开，是规则失效吗？

不一定。若请求已经进入正确策略，问题可能在策略组没有可用服务器、DNS、TLS、MTU、丢包或应用自身连接。先单独测试该策略，再继续排查网络层。

需要开启 MitM 或脚本才能修复分流吗？

普通域名分流通常不需要。先检查规则模式、资源、顺序、策略组和新请求；MitM、重写和脚本属于其他功能，误开启还会增加证书、权限和隐私风险。