Quantumult X 分流规则:最小配置、场景模板与不生效排查
简答:Quantumult X 分流规则的核心是“匹配条件 + 策略名称”:先准备实际存在的策略组,再把域名、IP或地区规则放入 filter_local 或 filter_remote,最后切换到规则模式并查看活动记录。最快的验证方法是只保留一条本地 host 规则,确认策略能命中后,再逐组加入远程规则。本文核验日期为 2026-11-06,规则集链接和客户端行为仍应以当前页面与活动记录为准。
定义:Quantumult X 分流规则是根据域名、IP、地区或用户代理等条件,把请求交给直连、代理、拒绝或指定策略组处理的匹配规则。
先试最小配置:先确认策略组和规则都能命中
如果你已经导入节点,先不要直接套用大型懒人配置。Quantumult X 官方示例配置提供了 [policy]、[filter_local]、[filter_remote] 以及 filter、all_proxy、all_direct 等运行模式示例,可先用它核对字段位置和拼写:Quantumult X 官方 sample.conf。
下面是一份用于验证语法的最小模板。Node-A、Node-B 必须替换成当前配置里真实存在的节点标签;AI、Video、Apple、Direct、Reject 也必须是实际存在的策略名或策略组名。
[policy]
static=AI, Node-A, Node-Bstatic=Video, Node-A, Node-Bstatic=Apple, Node-A, Node-B
[filter_local]
host, example.com, AIhost-suffix, example.org, Directip-cidr, 192.168.0.0/16, Directfinal, Direct
- 先确认节点标签和策略组名称逐字一致。
- 把客户端运行模式切到规则模式,不要停留在全部代理或全部直连。
- 访问测试域名,再查看活动记录中的实际请求和命中策略。
- 如果提示策略不存在,停止添加规则,先修正策略名称。
- 最小规则能命中后,再加入 AI、办公、视频或苹果服务规则。
如果全部代理也打不开,先排查节点、延迟、丢包和基础网络;如果全部代理可以访问而规则模式不对,才继续检查规则顺序、策略名称和远程资源。
三种运行模式怎么选:全部代理、全部直连还是规则分流
| 模式 | 用途 | 适合先排查什么 | 注意事项 |
|---|---|---|---|
| 全部代理 | 把请求统一交给当前代理策略 | 判断节点或代理路径是否能访问目标服务 | 不能证明分流规则正确,也可能让本地服务绕路 |
| 全部直连 | 不使用代理策略 | 判断原始网络、DNS和本地访问是否正常 | 需要特定线路的服务可能无法连接 |
| 规则分流 | 根据规则选择直连、代理、拒绝或策略组 | 日常使用和按业务拆分线路 | 最容易受到规则冲突、策略名错误和 FINAL 设置影响 |
官方示例中的运行模式触发器包含 filter、all_proxy 和 all_direct。实际界面名称、可选项和显示位置可能随客户端版本变化,因此本文不把某个菜单路径写成所有设备都相同的固定结论:查看官方模式配置示例。
推荐使用“全部直连 → 全部代理 → 规则分流”的三段式诊断:第一步测原始网络,第二步测节点,第三步才测规则。若全部直连和全部代理都失败,不要继续修改规则;若两者都正常而规则模式失败,问题更可能在规则匹配或策略选择。
规则类型与场景模板:AI、办公、视频和苹果服务怎么写
Quantumult X 官方示例列出了 host、host-suffix、host-keyword、host-wildcard、ip-cidr、ip6-cidr 等写法。下面的场景域名用于演示规则结构,不是完整域名清单;实际访问时应以活动记录中的真实请求为准。
| 场景 | 示例规则 | 推荐策略 | 核对重点 |
|---|---|---|---|
| ChatGPT或OpenAI服务 | host-suffix, chatgpt.com, AIhost-suffix, openai.com, AI | AI | OpenAI官方帮助页确认 ChatGPT 网页入口为 chatgpt.com;登录、图片、文件或接口请求可能使用其他域名,需以活动记录补充:OpenAI 关于 ChatGPT 网页入口的说明 |
| Claude | host-suffix, claude.ai, AI | AI | Anthropic官方帮助页将 claude.ai 列为 Chat 入口,但不代表一个后缀规则覆盖全部桌面端、移动端或 API 请求:Anthropic 的 Claude 访问方式说明 |
| YouTube | host-suffix, youtube.com, Videohost-suffix, googlevideo.com, Video | Video | 这里只演示常见分流写法,不把两条规则视为完整服务域名清单;视频播放失败时应从活动记录确认实际请求 |
| Netflix | host-suffix, netflix.com, Videohost-suffix, netflix.net, Video | Video | 域名、地区和内容服务可能变化;规则命中不等于账号、地区或节点一定可用 |
| 苹果账户与 iCloud | host-suffix, apple.com, Applehost-suffix, icloud.com, Applehost-suffix, apple-cloudkit.com, Apple | Apple或Direct | Apple官方企业网络文档列出了 account.apple.com、icloud.com、apple-cloudkit.com 等服务域名,实际配置仍应按具体业务缩小范围:Apple 企业网络服务域名说明 |
| 跨境办公域名 | host-suffix, your-company.example, Work | Work | your-company.example 是占位符,必须替换成公司实际域名,不要把示例直接启用 |
| 局域网和常见内网段 | ip-cidr, 10.0.0.0/8, Directip-cidr, 192.168.0.0/16, Direct | Direct | 只覆盖示例网段;如果公司使用其他网段,应先由网络管理员确认 |
不要把其他客户端的 DOMAIN、DOMAIN-SUFFIX 写法未经转换直接粘贴到 Quantumult X。本文示例使用 Quantumult X 官方配置中的小写规则类型;若规则集来自其他客户端,先核对格式,再用一条本地规则测试。
完整最小配置:策略组、filter_local、filter_remote 一起验证
下面的模板比单独给几条规则更适合首次验证。它仍然需要替换节点标签,并且只把官方仓库中的远程样例作为格式测试,不把它当作长期维护的业务规则集。
[policy]
static=AI, Node-A, Node-Bstatic=Video, Node-A, Node-Bstatic=Apple, Node-A, Node-Bstatic=Work, Node-A, Node-B
[filter_remote]
https://raw.githubusercontent.com/crossutility/Quantumult-X/master/filter.snippet, tag=Official-Sample, force-policy=AI, enabled=true
[filter_local]
host-suffix, chatgpt.com, AIhost-suffix, openai.com, AIhost-suffix, claude.ai, AIhost-suffix, youtube.com, Videohost-suffix, netflix.com, Videohost-suffix, apple-cloudkit.com, Applehost-suffix, icloud.com, Appleip-cidr, 192.168.0.0/16, Directfinal, Direct
官方 sample.conf 对 filter_remote 的说明包含 tag、force-policy、enabled 和默认远程资源同步间隔;其中 force-policy 会让远程规则中原有的策略被指定策略替代。官方样例远程地址适合核对格式和下载链路,不代表它就是适合你日常使用的规则集:官方 filter_remote 示例。
- Node-A、Node-B:替换为真实节点标签。
- AI、Video、Apple、Work:是策略组名称,必须与
[policy]中定义的名称一致。 - force-policy=AI:只用于验证远程规则如何被强制指定策略;正式使用时应确认远程规则内容和目标场景。
- final, Direct:表示未命中前面规则时默认直连。若你的业务需要默认代理,可以改成实际存在的代理策略,但不要把 FINAL 当作修复规则冲突的办法。
每次只改一处:先测试本地规则,再测试策略组,再测试远程资源。这样才能判断问题来自语法、策略还是远程下载。
规则优先级与冲突:能确认什么,不能过度推断什么
Quantumult X 官方示例说明了规则所在区块和远程资源参数,但没有在 sample.conf 中给出一份适用于所有规则类型的完整“总优先级表”。因此,不建议把“本地一定永远高于远程”或“所有远程规则按文件顺序覆盖”写成绝对结论。
可以直接复现和确认的现象是:官方仓库 issue #251 记录了 filter_local 中过宽的 host-keyword, ., proxy 可能使 filter_remote 规则不再触发。换句话说,过宽的本地规则可能先把大量请求接走,导致你误以为远程规则失效:Quantumult X 官方仓库 issue #251。
- 先停用全部远程规则,只保留一条明确的
host或host-suffix。 - 确认活动记录能看到该请求,并且命中预期策略。
- 检查是否存在
host-keyword, ., proxy、过宽通配符或过早的final。 - 每次只恢复一组远程规则,并为资源设置清晰的
tag。 - 如果两个规则集都覆盖同一域名,不要凭猜测判断谁会最终生效,直接停用其中一组做对照测试。
一个典型冲突示例是:本地规则写了 host-keyword, ., Proxy,远程规则希望把 chatgpt.com 交给 AI。由于本地规则过于宽泛,活动记录可能显示请求被 Proxy 接走,而不是 AI。解决方法不是继续添加更多规则,而是先删除或缩小这条宽泛规则,再验证具体的 host-suffix, chatgpt.com, AI。
远程规则失效怎么查:下载、内容、解析和命中分四层
远程规则不能只看“地址能打开”。建议按下面四层检查,任何一层无法确认,就先回滚到本地最小规则。
| 检查层 | 可操作方法 | 预期现象 | 失败处理 |
|---|---|---|---|
| 下载 | 在浏览器或客户端资源页面打开远程地址,观察是否能返回内容 | 页面返回文本,而不是登录页、错误页或空白页 | 确认地址、网络和证书;仍无法确认时停用资源 |
| 内容 | 查看返回文本是否由 Quantumult X 可识别的规则行组成 | 能看到类似 host、host-suffix 或其他已核对格式 | 如果是 HTML、JSON 配置或其他客户端语法,不要直接导入 |
| 解析 | 检查资源是否启用、tag 是否清晰、策略名是否存在 | 客户端能保存资源,且没有策略不存在或格式错误提示 | 先删除 force-policy 或改成真实策略名做对照 |
| 命中 | 访问目标服务并查看活动记录 | 实际请求显示命中的资源或策略 | 停用宽泛本地规则,检查域名是否被拆分或以 IP 形式连接 |
官方 sample.conf 还说明,Quantumult X 的 DNS 查询结果主要用于评估过滤规则或直连连接;通过代理服务器连接时,客户端未必知道目标域名对应的最终 IP。因此,如果活动记录显示请求以 IP 形式发起,host 类规则通常无法直接匹配,应进一步检查 IP-CIDR、DNS 和应用连接方式,而不是直接断定规则一定失效:官方 DNS 与过滤说明。
规则不生效的三步排查卡
| 现象 | 先查什么 | 失败分支 | 停止条件 |
|---|---|---|---|
| 规则模式下仍全部直连 | 运行模式、Quantumult X Tunnel状态、规则是否启用 | 切换全部代理测试节点,再切回规则模式 | 全部代理也失败时,转查节点和基础网络 |
| 提示策略不存在 | 策略名、大小写、空格和符号 | 改用当前配置中真实存在的节点或策略组 | 名称一致仍报错时,检查配置是否保存成功 |
| AI服务部分页面能开、文件或图片打不开 | 活动记录中的实际请求域名 | 为新增域名补充最小范围 host-suffix 规则 | 无法确认域名归属时不要扩大到整个顶级域名 |
| 远程规则下载失败 | 地址、返回内容、资源开关和证书 | 删除远程资源,用本地规则验证 | 来源或格式无法核验时不继续启用 |
| 命中策略但页面打不开 | DNS、节点延迟、丢包和目标服务状态 | 用全部直连与全部代理做对照 | 两种模式都失败时停止改规则,转查原始网络 |
如果你使用 ChatGPT 或 Claude 做测试,先分别测试主页、登录、文件上传和实际业务页面。官方资料确认 ChatGPT 网页入口为 chatgpt.com,Claude 的 Chat 入口为 claude.ai,但这不代表全部功能只使用一个域名;活动记录比猜测域名更可靠。
常见问题 FAQ
Quantumult X 分流规则应该放在哪里?
自己维护的少量规则放在 [filter_local];需要引用远程文本资源时放在 [filter_remote]。新手建议先用本地规则验证策略名称和命中结果,再加入远程规则。
Proxy、Direct、Reject 是固定策略名吗?
不应默认认为它们在每份配置中都存在。规则最后的策略字段必须与当前配置中的节点标签或策略组名称一致。本文使用这些名称只是为了展示常见分工,实际导入前应逐字替换。
本地规则和远程规则谁优先?
不能仅凭区块名称推导出适用于所有情况的完整优先级。可以确认的是,过宽的本地规则可能压过远程规则。最稳妥的办法是停用远程资源、保留一条具体本地规则,再逐组恢复并查看活动记录。
为什么设置了国内直连,某个服务仍然走代理?
先看活动记录中的真实请求。页面、登录、图片、接口和验证码可能使用不同域名,也可能出现 IP 形式连接。按实际请求补充最小范围的 host、host-suffix 或 ip-cidr 规则,不要直接扩大到所有域名。
远程规则越多越好吗?
不是。重复覆盖会增加冲突和维护成本。建议一次启用一组,确认下载、解析和命中都正常后再增加,并为每组设置清晰的 tag。规则集的维护状态和语法需要在启用前自行核验。
FINAL 应该写 Direct 还是 Proxy?
取决于你的默认网络策略。写 final, Direct 表示未匹配请求默认直连;写成实际存在的代理策略则表示默认交给代理。FINAL 只是兜底规则,不是修复 DNS、节点或丢包问题的通用办法。
规则命中但延迟很高,应该先改规则还是换线路?
先用全部直连和全部代理做对照,再查看节点延迟、丢包和活动记录。如果两种模式都慢,优先查原始网络;只有在规则模式明显不同且命中策略不符合预期时,才先改规则。
常见问题
Quantumult X 分流规则不生效怎么办?
先确认处于规则模式,再用一条本地 host 规则测试;随后检查策略名称、宽泛 host-keyword、远程资源状态和活动记录。若全部直连与全部代理都失败,应停止改规则,转查原始网络。
filter_local 和 filter_remote 有什么区别?
filter_local 直接写本地规则,适合少量自定义规则;filter_remote 用于引用远程资源,适合定期同步,但必须核验来源、返回内容、语法和策略名称。
ChatGPT、Claude 的域名可以直接用一条规则覆盖吗?
可以先用 chatgpt.com、openai.com 或 claude.ai 做语法测试,但不能视为完整域名清单。登录、文件、图片和接口请求可能使用其他域名,应以活动记录补充。
为什么 FINAL 会影响所有分流结果?
FINAL 是未命中前面规则时的兜底策略。若前面的规则没有命中,流量就会按 FINAL 处理;若 FINAL 设置不符合业务需求,就会造成整体偏直连或偏代理。
远程规则地址能打开,为什么客户端仍然不生效?
能打开只说明下载链路可能正常,还要检查返回内容是否为 Quantumult X 可识别的规则文本、资源是否启用、策略名是否存在,以及活动记录是否真正命中。