针对iOS平台网络加速需求，详解Quantumult X重写规则配置的完整流程，从基础语法结构到高级匹配逻辑，涵盖MITM证书安装、脚本注入技巧及常见故障排查,助力实现精准的流量分流与请求修改。
iOS平台缺乏官方Clash客户端，Quantumult X成为跨境办公需求下的主流选择，其重写规则配置功能支持请求修改、脚本注入和MITM解密,相比传统代理工具提供更细粒度的流量控制能力。
重写规则核心语法解析
Quantumult X重写规则配置采用特定JSON结构，包含匹配类型、正则表达式和执行动作三要素。
基础匹配类型
url-regex: 基于URL正则匹配，适用于特定路径拦截request-header: 修改请求头信息，常用于User-Agent替换response-body: 响应体替换，实现去广告功能
动作类型说明
reject直接阻断连接，302实现重定向，script-response-body调用JavaScript处理响应，配置时需注意优先级顺序，Quantumult X自上而下匹配,命中即停止。
配置步骤详解
-
证书安装与信任 设置 → 证书 → 生成新证书 → 安装描述文件 → 系统设置中信任根证书，MITM是重写规则生效的前提,缺失此步骤会导致HTTPS解密失败。
-
规则文件编写 在
[rewrite_local]段落下添加规则：# 请求重定向示例 ^https?://example.com/api/v1/(.*) url 302 https://new.example.com/api/$1 # 脚本注入示例 ^https?://api.service.com/users/profile url script-response-body https://raw.githubusercontent.com/example/profile.js
-
代理组策略绑定 重写规则需配合代理策略使用,建议配置三种代理组类型：
select: 手动选择节点，适合固定办公场景url-test: 自动测速选优，参数设置interval=300秒fallback: 故障自动切换，确保学术资源访问连续性
分流逻辑与Clash差异
Quantumult X重写规则配置与Clash规则体系存在架构差异，Clash采用YAML配置，依赖DOMAIN、DOMAIN-SUFFIX、IP-CIDR、GEOIP等规则类型进行分流；Quantumult X则通过host-suffix和ip-cidr实现类似功能。
TUN模式与系统代理区别：
- TUN模式：虚拟网卡接管所有流量（含UDP/游戏流量），实现全局代理
- 系统代理：仅处理HTTP/HTTPS请求，部分应用可能绕过
iOS受系统限制，Quantumult X主要使用系统代理+VPN隧道混合模式,相当于Clash的TUN轻量版。
高级应用场景
针对API请求修改，可结合script-request-body实现动态签名生成,配置示例：
[rewrite_local] ^https?://api.example.com/v2/verify url script-request-body https://raw.githubusercontent.com/user/sign.js
对于需要稳定国际网络加速的用户，建议选择支持Quantumult X订阅格式的服务商，优质节点订阅通常提供完整的重写规则集，包含去广告、解锁区域限制等预设配置,减少手动编写正则表达式的工作量。
FAQ
现象：重写规则已启用但无效果
原因：MITM证书未正确安装或域名未加入hostname列表
解决方法：检查设置→证书状态显示"已安装"，并在[mitm]段落添加hostname=*.example.com
现象：脚本执行导致应用闪退
原因：JavaScript内存溢出或语法不兼容
解决方法：关闭resource-parser缓存，更新Quantumult X至最新版本，或更换轻量级脚本
现象：特定应用无法连接 原因：该应用采用SSL Pinning证书锁定 解决方法：此类应用无法通过MITM解密，需排除在重写规则之外，使用直连策略
掌握Quantumult X重写规则配置能显著提升iOS设备跨境办公效率，建议定期备份配置文件，并关注节点订阅提供商的规则库更新,以适配不断变化的网络环境。
