Shadowrocket的脚本功能可实现智能分流与自动化处理，本文详解脚本模块配置流程、全局路由四种模式差异及常见问题排查,帮助用户实现高效的国际网络加速与跨境办公需求。
脚本模块基础配置
小火箭脚本功能使用的核心在于模块化配置，不同于传统的手动添加规则,脚本功能通过JavaScript引擎实现动态请求处理与响应修改。
配置流程分为四步：
-
获取脚本模块：访问GitHub或专业维护的模块仓库，下载
.sgmodule格式文件，或复制脚本URL链接，优质模块通常包含去广告、重定向、API优化等功能。 -
导入配置：在Shadowrocket首页点击右上角"+"，选择"添加模块"，粘贴URL或导入本地文件，系统会自动解析模块内的脚本类型（HTTP请求/响应）与匹配域名。
-
设置规则优先级：进入"配置"页面，长按脚本模块调整执行顺序，建议将精细化规则置于通用规则之上,避免被宽泛规则覆盖。
-
调试与验证：开启"日志记录"功能，在"工具"→"日志"中查看脚本执行状态，绿色标记表示成功匹配,红色标记需检查语法或URL可达性。
全局路由四种模式解析
理解小火箭脚本功能使用必须掌握全局路由的四种工作模式,这决定了脚本何时介入处理：
配置模式（Config） 默认分流模式，根据配置文件中的规则列表决定流量走向，脚本在此模式下按域名、关键词、IP段进行智能匹配,适合日常跨境办公需求与学术资源访问。
代理模式（Proxy） 所有流量强制通过代理节点，忽略规则列表，当脚本需要处理加密DNS或特定协议时,建议临时切换此模式测试连通性。
直连模式（Direct） 全部流量不走代理，用于验证本地网络环境或排除节点干扰,脚本中的本地映射功能在此模式下仍可生效。
场景模式（Scene） 根据网络环境自动切换上述三种模式，可设置"Wi-Fi环境下直连，蜂窝网络下代理"等条件策略,实现无感切换。
脚本参数实战调优
针对国际网络加速场景,常用脚本参数配置如下：
[Script] HTTP-Request = type=http-request,pattern=^https?:\/\/api\.example\.com,script-path=local.js,requires-body=true,max-size=30720 HTTP-Response = type=http-response,pattern=^https?:\/\/.*\.video,script-path=modify.js,requires-body=true,timeout=30
关键参数说明：
requires-body=true：允许脚本读取响应体，用于修改API返回数据max-size：限制处理数据大小，防止大文件下载时内存溢出timeout：脚本执行超时时间，建议设置在10-60秒之间
对于4K流媒体解锁需求，建议在脚本前插入节点延迟测试模块,自动选择延迟低于150ms的线路。
典型问题排查
现象：脚本显示已启用但规则未生效
原因：模块URL使用HTTP而非HTTPS，或本地脚本路径包含中文符号
解决：更换为HTTPS链接，将脚本文件移至Shadowrocket/Documents目录并确保路径为纯英文
现象：开启脚本后特定App加载缓慢
原因：脚本正则表达式过于宽泛，导致非目标请求也被拦截处理
解决：优化pattern字段，使用精确域名匹配而非通配符，或在MITM设置中排除该App证书
现象：学术资源访问时频繁触发人机验证
原因：脚本修改了请求头中的User-Agent或IP归属地信息不一致
解决：在脚本中添加preserve-headers参数，保持原始请求头信息，或配置分流规则让学术域名绕过脚本处理
节点选择与脚本协同
小火箭脚本功能使用的效果高度依赖节点质量，建议搭配具备BGP中转或IEPL专线的服务商，确保脚本处理后的请求仍能保持低延迟，对于跨境办公需求，选择支持TCP/UDP全协议转发的节点可避免视频会议卡顿。
配置完成后，建议每月检查脚本仓库更新，及时替换失效的API规则，通过合理的脚本编排,Shadowrocket可实现比传统VPN更精细化的流量管理。
掌握小火箭脚本功能使用的底层逻辑后，用户可根据自身网络环境定制专属规则,在保障隐私安全的同时获得流畅的国际网络访问体验。
