本文详解Quantumult X脚本配置流程，涵盖策略组设置、分流规则编写及自动化脚本部署，帮助iOS用户实现智能分流与网络加速，提升跨境办公效率。
环境准备与基础概念
Quantumult X作为iOS平台高级网络工具，其脚本功能使用需理解策略组与分流逻辑，不同于其他客户端的YAML配置，Quantumult X采用类INI语法，但核心架构相通：通过规则匹配实现流量定向，配合JavaScript扩展完成自动化操作。
脚本功能主要指通过[task_local]定时任务或[http_backend]本地服务，实现节点自动切换、Cookie刷新、数据监控等高级功能。
策略组类型与适用场景
配置脚本前需建立正确的策略组架构,Quantumult X脚本功能使用依赖以下三种核心策略：
- static（静态选择）：手动切换节点，适合需要固定出口访问特定资源的场景
- url-latency-benchmark（自动测速）：按延迟自动选择最优节点，适合日常国际网络加速
- available（故障转移）：主节点失效时自动切换，适合对稳定性要求极高的跨境办公需求
配置示例：
[policy] static=手动选择, direct, reject, img-url=https://example.com/manual.png url-latency-benchmark=自动选择, server-tag-regex=.*, check-interval=600, tolerance=50, img-url=https://example.com/auto.png available=故障转移, server-tag-regex=专线, img-url=https://example.com/failover.png
分流规则优先级配置
Quantumult X脚本功能使用需配合精准的分流规则，规则匹配顺序为从上到下，建议按以下优先级排列：
- host（精确域名匹配）
- host-suffix（后缀匹配，如google.com匹配mail.google.com）
- host-keyword（关键词匹配）
- ip-cidr（IP段匹配）
- geoip（国家地理匹配）
[filter_local] host, www.example.com, direct host-suffix, google.com, 自动选择 host-keyword, adkeyword, reject ip-cidr, 192.168.1.0/24, direct geoip, cn, direct final, 手动选择
TUN模式与系统代理差异
iOS设备需特别注意两种流量接管方式的区别：
- 系统代理：仅处理HTTP/HTTPS流量，配置简单但无法代理UDP流量，部分邮件客户端和即时通讯工具可能绕行
- TUN模式：通过虚拟网卡接管所有流量（包括游戏、视频通话的UDP数据），需在Quantumult X中开启"VPN"模式，并在脚本中配置
tun-excluded-routes排除国内直连流量
脚本功能部署步骤
实现Quantumult X脚本功能使用的标准流程：
- 获取脚本资源：通过可信仓库获取.js文件，审查代码确保无恶意请求
- 配置Task模块：在[task_local]段添加定时任务
[task_local] event-interaction https://raw.githubusercontent.com/user/script.js, tag=自动签到, enabled=true 0 9 * * * https://raw.githubusercontent.com/user/cron.js, tag=每日节点检测, enabled=true
- 设置HTTP Backend：如需本地服务器功能，配置[http_backend]监听127.0.0.1:9999
- 权限管理：iOS设置中开启Quantumult X的本地网络权限，确保脚本正常执行HTTP请求
常见问题排查
现象：脚本提示"Syntax Error"或API未定义
原因：JavaScript语法不兼容或使用了其他平台的API
解决：Quantumult X使用$task.fetch而非$httpClient，检查脚本是否适配QX引擎，必要时修改请求方法
现象：规则匹配失效，流量全部走final策略
原因：策略组名称拼写错误或规则文件未加载
解决：确认[filter_remote]中规则文件下载成功，检查policy名称大小写完全匹配
现象：定时脚本在后台不执行
原因：iOS后台刷新限制或省电模式拦截
解决：设置-通用-后台App刷新中开启Quantumult X，关闭低电量模式，并在脚本中添加persistent=true保持活跃
节点订阅优化建议
为充分发挥Quantumult X脚本功能使用效果，建议搭配高质量的节点订阅服务，选择支持Clash YAML格式的订阅商，通过SubConverter工具转换Quantumult X兼容的list格式，确保策略组能正确识别节点标签正则。
对于学术资源访问需求,建议选择具备BGP中转的节点，配合url-latency-benchmark策略组实现自动优选，避免手动切换中断研究流程，定期更新订阅链接并在脚本中配置自动更新任务，可确保规则库与节点状态始终保持最新。
