本文基于长期跨境办公实践，系统讲解小火箭脚本功能使用的完整配置流程，深入解析全局路由四种模式差异，并提供脚本调试技巧与节点选择建议,帮助用户实现高效稳定的国际网络加速。
脚本功能的核心价值
Shadowrocket的脚本模块并非简单的规则补充，而是实现智能分流的核心组件，通过JavaScript脚本，可针对特定域名实现请求修改、响应处理、重定向等高级操作，对于需要频繁切换学术资源访问与本地服务的用户，合理的脚本配置能显著降低延迟,提升国际网络加速效率。
配置流程详解
获取脚本资源
从可信渠道获取.js或.conf格式脚本文件，建议优先选择维护活跃的仓库，保存至iCloud Drive或本地文件管理器,确保Shadowrocket有读取权限。
导入配置 进入配置编辑界面，点击「添加脚本」模块，选择本地文件导入或URL远程订阅，远程订阅需开启自动更新,建议设置24小时同步周期。
启用脚本模块 在配置详情页开启「脚本」开关,检查脚本类型匹配：
// 典型脚本结构示例 [Script] Google Scholar = type=http-request,pattern=^https?:\/\/scholar\.google\.com,script-path=scholar.js,requires-body=true
验证运行状态
开启抓包模式，访问目标站点查看日志输出，脚本正常执行时，请求头应包含修改标记，若出现ERR_SCRIPT报错,检查语法兼容性与MIME类型设置。
全局路由模式深度解析
小火箭脚本功能使用的效果与路由模式强相关,四种模式适用场景截然不同：
配置模式（Config） 默认推荐模式，根据配置文件中的规则列表进行分流，脚本仅在匹配规则后执行，适合大多数跨境办公场景,能精准区分国内外流量。
代理模式（Proxy） 全局流量强制走代理节点，脚本对所有请求生效，适用于需要完整网络环境模拟的测试场景,但会增加不必要的节点负载。
直连模式（Direct） 跳过所有代理规则，脚本仅处理本地请求，用于排除法调试,确认问题源于网络层还是脚本层。
场景模式（Scene） 基于地理位置或Wi-Fi名称自动切换配置，建议搭配脚本使用：设定「公司Wi-Fi自动启用学术优化脚本」,实现无感切换。
脚本调试与优化
复杂脚本建议分模块测试，使用$notify()方法输出关键变量：
const url = $request.url;
const headers = $request.headers;
console.log(`[Debug] Processing: ${url}`);
$notify("Script Debug", "URL captured", url);
内存占用过高时，检查是否未释放$done()对象，长期运行建议每周清理一次脚本缓存，路径：设置→高级→清除脚本缓存。
常见问题排查
现象：脚本显示已启用但无实际效果 原因：规则优先级冲突或MITM证书未安装，脚本修改HTTPS请求需开启HTTPS解密。 解决：检查「HTTPS解密」开关，安装并信任描述文件，确认脚本pattern语法正确,建议使用通配符测试基础功能。
现象：频繁出现脚本执行超时
原因：远程脚本服务器响应慢或本地处理逻辑死循环。
解决：切换至本地脚本模式，检查JavaScript正则表达式是否存在贪婪匹配，对于复杂DOM操作，增加timeout=10参数。
现象：特定App无法连接 原因：该应用使用SSL Pinning或证书校验，脚本修改触发安全机制。 解决：在「通用」设置中添加该App至「跳过代理」列表,或禁用针对该域名的脚本模块。
节点选择与性能优化
脚本功能对节点质量有隐性要求，处理大量重写规则时，建议选择支持TCP Fast Open的中转节点，对于4K流媒体场景,专线节点的丢包率控制优于普通中转。
若需长期稳定的学术资源访问环境，可考虑具备专用IP池的服务商，优质节点通常提供WireGuard或Hysteria2协议支持,与脚本模块配合能进一步降低握手延迟。
定期测试节点延迟并非唯一标准，建议通过curl -o /dev/null -s -w "%{time_total}"命令测试实际下载速度，脚本优化后的配置配合低负载节点,可实现接近直连的响应速度。
