两年实战总结，Quantumult X重写规则配置深度优化

本文基于长期实践经验,系统讲解Quantumult X重写规则配置的完整流程，涵盖MitM证书安装、规则语法解析及常见故障排查，助力实现精准的网络流量分流与请求改写。

重写规则核心机制解析

Quantumult X重写规则配置是实现请求拦截与修改的核心模块，与分流规则协同工作，重写模块通过MitM（中间人攻击）技术解密HTTPS流量，支持URL重定向、请求头修改及响应体替换等操作，广泛应用于广告拦截与API调试场景。

策略组类型决定流量调度逻辑：

• static：手动选择节点，适用于需要固定出口的场景
• url-latency-benchmark：自动测速选择延迟最低节点，适合跨境办公需求
• round-robin：轮询分配，用于负载均衡
• dest-hash：基于目标地址哈希，保证同一域名走同一节点

配置步骤详解

1. 证书安装与信任 生成并安装MitM证书：设置 → MitM → 生成证书 → 安装描述文件 → 系统设置信任根证书，未正确配置将导致重写规则对HTTPS流量失效，表现为规则匹配但修改未生效。

2. 重写规则编写 在[rewrite_local]或[rewrite_remote]段添加规则：

   # 广告拦截示例
   ^https?://(www.)?example.com/ad/ url reject
   # 302重定向
   ^https?://old.example.com/(.*) url 302 https://new.example.com/$1
   # 请求头修改
   ^https?://api.example.com/v1/ url script-request-header https://raw.githubusercontent.com/xxx/header.js

3. 分流策略绑定 在[filter_local]中指定策略组：

   host-suffix, google.com, proxy
   ip-cidr, 192.168.0.0/16, direct
   geoip, cn, direct

   规则优先级自上而下递减,建议将精确规则置于顶部，避免宽泛规则过早匹配。

4. 调试验证 开启日志记录：设置 → 日志级别 → Debug，检查请求是否命中重写规则，确认MitM状态显示为绿色，使用Safari开发者工具验证请求头修改是否生效。

TUN模式与HTTP代理差异

TUN模式通过虚拟网卡接管系统全局流量（含UDP、ICMP），适用于游戏加速和UDP依赖型应用；HTTP代理模式仅处理支持代理配置的客户端流量，系统底层流量不经过代理，国际网络加速场景建议开启TUN模式以确保完整性，但需注意部分银行类应用可能触发VPN检测机制。

规则语法优先级说明

• host：精确匹配域名，优先级最高
• host-suffix：匹配域名后缀，如.google.com
• host-keyword：关键词匹配，慎用以防误伤
• ip-cidr：IP段匹配，用于绕过局域网地址
• geoip：基于GeoIP数据库的国家/地区匹配

节点订阅配置建议

稳定的节点订阅是Quantumult X重写规则配置生效的基础，建议选择提供Clash YAML格式或Quantumult X原生格式的服务商，通过SubConverter工具转换订阅链接时，注意保留udp: true参数以支持TUN模式下的UDP转发，对于学术资源访问需求，优先选择具备低延迟专线节点的订阅方案，确保重写后的请求能快速到达目标服务器。

常见问题排查

现象：HTTPS请求重写不生效 原因：MitM证书未在系统设置中完全信任，或目标域名未加入MitM主机名列表。 解决方法：检查设置 → 通用 → 关于本机 → 证书信任设置；确认[mitm]段包含hostname = *.example.com。

现象：规则匹配顺序混乱 原因：Quantumult X采用自上而下优先匹配机制，宽泛规则置于精确规则之上。 解决方法：调整配置文件，将host规则置于host-suffix之上，使用final规则作为兜底策略。

现象：TUN模式下部分应用断连 原因：应用使用硬编码DNS或绕过VPN检测机制。 解决方法：在[dns]段配置本地DNS映射，或启用icmp-auto选项处理ICMP流量，必要时将该应用加入TUN排除列表。

掌握Quantumult X重写规则配置需要理解MitM原理与正则表达式语法，建议从简单重定向开始，逐步过渡到复杂的脚本修改，结合稳定的节点订阅服务，可显著提升国际网络加速体验。