Quantumult X的重写规则可实现请求重定向与本地映射，适用于学术资源访问与国际网络加速场景，本文详解配置文件结构、MitM证书安装步骤及常见错误排查方法，助你构建高效的iOS端网络工具环境。
重写规则的核心机制与适用场景
Quantumult X的重写规则（Rewrite）通过拦截HTTP/HTTPS请求实现URL重定向、请求头修改及本地资源映射，与Clash的纯分流逻辑不同，QX支持在客户端层面对特定域名进行请求改造，适用于前端调试、广告过滤及API端点切换，配置前需明确：重写规则仅对HTTP请求生效，HTTPS需配合MitM证书解密。
配置文件初始化与基础结构
- 创建空白配置文件,首行必须包含
[general]字段，设置server_check_url用于节点延迟测试 - 添加
[policy]策略组，QX支持三种核心类型：static：手动选择节点，对应Clash的select模式url-latency-benchmark：自动选择延迟最低节点，类似url-testround-robin：轮询负载均衡，适用于多线路跨境办公需求
- 在
[filter_remote]引入分流规则订阅，本地[filter_local]写入自定义规则
MitM证书安装与信任设置
重写HTTPS请求前必须完成证书配置：
- 生成证书：QX设置 → MitM → 生成CA证书
- 安装描述文件：Safari访问
quantumult://cert，安装后进入iOS设置 → 通用 → 关于本机 → 证书信任设置 → 启用完全信任 - 配置文件添加
[mitm]段，声明需要解密的域名：
[mitm] hostname = *.example.com, api.target.com
重写规则编写与调试
在[rewrite_local]或[rewrite_remote]中定义规则，语法结构为：
pattern type script-tag常见类型对比：
302：临时重定向，适用于API端点切换307：保留请求方法的重定向reject：阻断请求，用于广告过滤header：修改请求头，需配合JavaScript脚本
示例配置片段：
[rewrite_local] ^https?://api\.old-domain\.com/v1 url 302 https://api.new-domain.com/v1 ^https?://.*\.googlevideo\.com/.* url reject
分流规则优先级与匹配逻辑
QX采用自上而下匹配机制,规则类型包括：
HOST：精确匹配域名HOST-SUFFIX：匹配域名后缀，相当于DOMAIN-SUFFIXHOST-KEYWORD：关键词匹配IP-CIDR：IP段匹配，支持no-resolve参数避免DNS泄漏GEOIP：地理位置匹配，用于国内外流量分流
优先级策略：本地规则 > 远程规则订阅，建议将精确规则置于文件顶部。
常见问题排查（FAQ）
现象：重写规则未生效，请求仍访问原始地址
原因：MitM证书未正确安装或hostname未包含目标域名
解决方法：检查iOS证书信任状态，确认[mitm]段hostname使用逗号分隔且无误
现象：部分App提示证书错误无法联网
原因：该App启用SSL Pinning，拒绝中间人证书
解决方法：将该App相关域名从hostname列表移除，或改用[filter]层面分流而非重写
现象：策略组自动切换频繁导致连接中断
原因：url-latency-benchmark测试间隔过短或节点质量波动大
解决方法：调整interval=600（秒）延长检测周期，设置tolerance=50（毫秒）避免敏感切换
现象：配置导入后QX闪退 原因：YAML语法错误，如冒号后缺少空格或缩进混乱 解决方法：使用在线YAML校验工具检查，确保使用UTF-8编码无BOM格式
对于需要稳定国际网络加速的用户,建议搭配高质量的节点订阅服务，选择支持Clash YAML格式或Quantumult X原生格式的订阅商，可确保策略组与分流规则完整兼容，定期更新重写规则订阅以适配目标网站的API变更，是维持学术资源访问流畅度的关键维护动作。
