脚本字段 - Surge 使用手册

由于进行脚本修改会需要Surge 先将response body 完全下载后再进行处理，如果遇到了较大的数据将导致内存占用量暴增，Surge iOS 受系统内存限制在该情况下极易被直接 ... Surge使用手册搜索文档…简介总览代理规则策略DNSHTTP处理脚本基础HTTP请求HTTP响应脚本规则事件DNS计划任务其他更新日志由GitBook提供支持基础脚本需要SurgeiOS4或SurgeMac3.3.0以上版本脚本使用JavaScript随心所欲的拓展Surge功能。

脚本字段1[Script]2script1=type=http-response,pattern=^http://www.example.com/testscript-path=test.js,max-size=16384,debug=true3script2=type=cron,cronexp="*****",script-path=fired.js4script3=type=http-request,pattern=^http://httpbin.orgscript-path=http-request.js,max-size=16384,debug=true,requires-body=true5script4=type=dns,script-path=dns.js,debug=true6script5=type=event,event-name=network-changed,control-api=1,script-path=event.jsCopied!每一行都有两个组成部分：脚本名称、参数。

常见的参数：type：脚本的类型，可选值：http-request,http-response,cron,event,dns,rule.script-path：脚本的路径，可以是相对路径、绝对路径或者URL。

script-update-interval：当脚本路径为URL时的自动更新频率，单位为秒。

debug：开启debug模式，如果是一个本地脚本，那么每次执行脚本时，都会从本地存储重新加载脚本，方便调试。

control-api：允许脚本内使用$surge变量，控制Surge。

timeout：脚本的最长运行时间，默认为10s。

http-request/http-response类型脚本的可用参数：pattern：匹配URL的正则。

requires-body：表示该脚本需要对body进行处理，默认为false。

如果只需要修改URL或者Headers请不要开启该选项，将大幅节约资源。

max-size：表示该脚本最大允许处理的body大小，若超过则放弃处理，默认值为131072（128KB）。

由于进行脚本修改会需要Surge先将responsebody完全下载后再进行处理，如果遇到了较大的数据将导致内存占用量暴增，SurgeiOS受系统内存限制在该情况下极易被直接终止。

所以请务必仔细配置URL匹配规则，仅对需要的URL进行处理。

当返回的数据长度超过max-size设定值后，Surge将放弃对该请求执行脚本并回退到passthrough模式。

基本定义所有脚本允许异步操作，使用$done(value