Quantumult X脚本功能使用，自定义规则与自动化配置指南

本文详解Quantumult X脚本功能的核心用法，包括脚本编写规范、自动化任务配置及常见问题解决方案，帮助用户实现精细化的流量管理和自动化操作。

Quantumult X脚本功能概述

Quantumult X作为iOS平台强大的网络代理工具，其脚本功能支持JavaScript运行时环境，可实现自定义规则解析、请求/响应修改、自动化任务调度等高级功能，脚本功能位于「设置」→「脚本」菜单，支持「rewrite」「mitm」「task」三种脚本类型。

1 脚本类型说明

• rewrite脚本：修改HTTP请求或响应头、body、状态码
• mitm脚本：处理HTTPS解密后的流量，可用于广告拦截、数据提取
• task脚本：定时执行任务，支持cron表达式调度

脚本功能配置步骤

1 环境准备

1. 打开Quantumult X，进入「设置」→「脚本」
2. 开启「脚本功能」开关
3. 如需mitm功能,需先配置证书并信任（设置→证书→安装描述文件→信任）

2 编写第一条rewrite脚本

// 广告拦截示例
const url = $request.url;
const response = {
    status: 404,
    body: '{"error":"blocked"}',
    headers: {"Content-Type":"application/json"}
};
if (url.includes("ad.doubleclick.net") || url.includes("googlesyndication.com")) {
    $done(response);
} else {
    $done({});
}

保存为.js文件，通过iCloud Drive或Files导入Quantumult X。

3 配置task自动化任务

// 定时签到脚本示例
const api = "https://example.com/api/signin";
const options = {
    url: api,
    method: "POST",
    headers: {"Authorization": "Bearer YOUR_TOKEN"}
};
$httpClient.post(options, (err, resp, data) => {
    if (err) {
        console.log("签到失败：" + err);
    } else {
        console.log("签到成功：" + data);
    }
    $done();
});

在task页面添加定时规则,cron表达式0 9 * * *表示每天9点执行。

核心概念与模式区别

1 TUN模式 vs 系统代理

TUN模式通过创建虚拟网卡实现全局代理,适合需要代理UDP流量或无法设置系统代理的应用；系统代理则通过HTTP CONNECT方式工作，兼容性更好。

2 分流规则优先级

Quantumult X规则按顺序匹配，优先级从高到低：

1. DOMAIN（精确域名）：domain:example.com
2. DOMAIN-SUFFIX（域名后缀）：domain-suffix:google.com
3. DOMAIN-KEYWORD（域名关键词）：domain-keyword:google
4. IP-CIDR（IP段）：ip-cidr:10.0.0.0/8
5. GEOIP（国家/地区）：geoip:cn
6. FINAL（最终兜底）：final:PROXY

规则示例：

# 广告域名直连
DOMAIN-SUFFIX,doubleclick.net,REJECT
# 国内网站走直连
GEOIP,cn,DIRECT
# 海外网站走代理
FINAL,PROXY

常见问题FAQ

1 脚本不生效

现象：编写脚本后未生效
原因：脚本语法错误或未正确关联节点
解决方法：检查脚本日志（脚本页面→日志），确认无JavaScript语法错误；确保脚本在对应节点策略下运行

2 mitm证书信任失败

现象：HTTPS流量解密失败
原因：证书未在系统设置中信任
解决方法：设置→通用→关于本机→证书信任设置→开启Quantumult X证书信任

3 task任务未执行

现象：定时任务未按计划运行
原因：后台刷新被系统限制
解决方法：确保Quantumult X后台刷新开启；或使用「前台运行时」模式

节点选择建议

不同使用场景对节点有差异化需求：

• 4K视频/大文件下载：选择高带宽专线，延迟可适当放宽
• 游戏/实时通讯：优先低延迟节点，丢包率需低于1%
• 办公/学术访问：注重稳定性，节点需支持常用端口

判断节点服务商可靠性可参考：是否提供测试节点、带宽是否虚标、客服响应速度等，建议选择支持多协议（vmess/trojan/shadowsocks）的服务商，便于在不同客户端间切换。