Quantumult X重写规则配置实战指南

本文深入讲解Quantumult X重写规则的核心语法与实战技巧，帮你掌握请求头修改、响应体重定向等高阶操作,实现精细化的流量控制与数据处理。

什么是重写规则

重写规则（Rewrite）是Quantumult X的核心功能之一，允许用户对HTTP/HTTPS请求和响应进行修改，与普通分流规则不同，重写规则直接干预请求头、响应头、URL以及响应体内容，适用于去广告、Header定制、请求重定向等场景。

重写规则分为两种类型：

• 请求重写：修改发往服务器的请求参数
• 响应重写：修改服务器返回的数据

重写规则语法结构

Quantumult X重写规则采用正则表达式匹配,基础语法如下：

hostname = example.com
^https://example.com/api/user url reject
^https://example.com/ad url reject

常用正则修饰符

典型配置示例

# 去除广告请求
^https://ads\.example\.com/.* url reject
# 修改User-Agent
^https://api\.example\.com/.* header User-Agent Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X)
# 重定向URL
^https://old\.example\.com/(.*) url https://new.example.com/$1

重写规则配置步骤

开启重写功能

在Quantumult X主界面依次点击：设置 → 重写 → 开启「重写」开关

添加规则集

点击右上角「+」号，选择「添加规则集」,填写名称与订阅链接或本地规则文件路径。

配置hostname

在规则集顶部指定生效域名：

hostname = api.example.com, cdn.example.com

编写重写规则

根据需求编写正则匹配规则，注意正则表达式的精确性,避免误匹配正常流量。

代理组类型与适用场景

Quantumult X支持三种代理组配置方式：

• select（手动选择）：列出所有节点供手动切换，适合需要精准控制出口的场景
• url-test（自动测速）：自动测试节点延迟，选择最优节点
• fallback（故障转移）：优先使用列表中第一个可用节点，失效后自动切换

重写规则可与代理组联动,实现域名级别的智能路由：

- name: "广告拦截"
  type: select
  proxies:
    - REJECT
    - DIRECT

常见问题FAQ

现象：重写规则未生效

原因：hostname未匹配目标域名，或正则表达式语法错误

解决方法：检查规则语法是否正确，确认hostname已包含目标域名，尝试简化正则表达式

现象：部分请求被拦截

原因：正则匹配过于宽泛，误伤正常请求

解决方法：使用更精确的正则表达式，增加域名限定条件

现象：规则冲突导致循环

原因：重写规则形成无限重定向

解决方法：检查是否存在URL重写闭环，确保终止条件明确

配置建议

1. 规则编写遵循「精确优先」原则，避免使用过于宽泛的通配符
2. 定期更新规则集，适配目标网站的结构变化
3. 重写规则与分流规则配合使用，实现精细化流量管理
4. 测试环境建议先在本地验证规则效果，再部署到生产环境

掌握Quantumult X重写规则配置，能够显著提升跨境访问效率与数据处理能力，建议从简单规则入手，逐步深入复杂场景,不断优化配置策略。