Quantumult X脚本功能使用可实现自动签到、流量监控和智能分流，本文详解脚本配置流程、常见API调用方法及MitM证书安装要点，帮助用户构建自动化代理工作流。
脚本功能核心逻辑
Quantumult X脚本功能使用依赖于其JavaScript引擎，通过模块化设计插入网络请求生命周期，与Clash的静态YAML配置不同，QX支持动态修改请求头、响应体及定时任务，适用于跨境办公需求中的自动化数据抓取。
基础配置四步法
证书安装与MitM配置
脚本解密HTTPS流量需先安装CA证书：
- 生成证书：设置 → MitM → 生成密钥
- 安装描述文件：Safari下载后进入系统设置 → 通用 → VPN与设备管理
- 信任证书：关于本机 → 证书信任设置 → 启用Quantumult X根证书
模式说明：QX采用VPN模式（类TUN）接管系统流量，与Clash TUN模式类似，可处理TCP/UDP全部流量及ICMP请求；而系统代理仅转发HTTP/HTTPS流量，无法处理游戏或UDP应用数据。
脚本仓库订阅
在配置文件 [task_local] 与 [rewrite_local] 区块添加资源：
[rewrite_local] ^https?://api\.example\.com/v1/user url script-response-body https://raw.githubusercontent.com/xxx/profile.js [task_local] 0 9 * * * https://raw.githubusercontent.com/xxx/checkin.js, tag=自动签到, enabled=true
代理组策略设置
Quantumult X脚本功能使用常需配合智能策略组，类型与Clash核心概念对应：
- static：手动选择节点（对应Clash select）
- url-latency-benchmark：自动测速选优（对应Clash url-test），按延迟排序自动切换
- round-robin：轮询负载均衡（对应Clash load-balance）
- fallback：故障转移，主节点失效时自动切换备用（对应Clash fallback）
配置示例：
[policy] static=手动选择, direct, 香港节点, 日本节点, img-url=https://example.com/icon.png url-latency-benchmark=自动优选, 香港节点, 日本节点, check-interval=600, tolerance=50 fallback=故障转移, 香港节点, 日本节点, 美国节点, check-interval=300
分流规则编写
分流规则优先级自上而下,支持以下匹配类型：
- DOMAIN：精确匹配（如
domain, www.google.com, proxy） - DOMAIN-SUFFIX：后缀匹配，覆盖子域名（如
domain-suffix, google.com, proxy匹配mail.google.com） - IP-CIDR：IP段匹配（如
ip-cidr, 10.0.0.0/8, direct） - GEOIP：国家地理IP匹配（如
geoip, cn, direct）
建议配置顺序：
[filter_local] host-suffix, google.com, proxy host-keyword, ad, reject ip-cidr, 192.168.0.0/16, direct geoip, cn, direct final, 自动优选
脚本实战应用场景
流量监控与自动切换
通过 $task.fetch API获取节点流量信息，实现超额自动切换：
const url = "https://api.airport.com/check";
$task.fetch({url: url}).then(response => {
const data = JSON.parse(response.body);
if(data.used > data.total * 0.9) {
$notify("流量预警", "节点即将耗尽", "已自动切换备用线路");
// 切换至fallback策略组备用节点
}
});
定时任务配置
在 [task_local] 定义cron表达式实现自动化：
[task_local] # 每日9点执行签到 0 9 * * * https://raw.githubusercontent.com/xxx/qiandao.js, tag=机场签到, img-url=icon.png # 每小时检查节点延迟 0 * * * * https://raw.githubusercontent.com/xxx/check.js, tag=延迟检测, enabled=true
常见问题排查
现象：脚本提示"MitM证书未信任"但已安装证书
原因：iOS 13+需额外在"关于本机"中开启证书信任开关，仅安装描述文件不足
解决：设置 → 通用 → 关于本机 → 证书信任设置 → 启用Quantumult X CA
现象：定时任务不执行或执行无响应
原因：后台刷新权限未开启或脚本URL被墙
解决：iOS设置 → 通用 → 后台App刷新 → 开启QX；使用jsdelivr或ghproxy镜像加速脚本加载
现象：分流规则匹配异常，国内流量走代理
原因：GEOIP数据库未更新或规则顺序错误（final规则置顶导致后续规则失效）
解决：设置 → 配置文件 → 更新GEOIP数据库；确保 `geoip,
