折腾半年Shadowrocket脚本功能，这些坑别踩

导读：

1. Shadowrocket脚本功能基础配置
2. 全局路由四大模式详解
3. 实战脚本配置示例
4. 常见问题排查
5. 节点选择对脚本性能的影响
6. 进阶优化建议

Shadowrocket脚本功能通过JavaScript实现请求重定向与响应修改，本文详解模块安装、脚本调试及全局路由模式配置,助你优化国际网络加速体验。

Shadowrocket脚本功能基础配置

Shadowrocket脚本功能基于JavaScript引擎，可在请求发出前或响应返回后执行自定义逻辑,配置流程如下：

1. 获取脚本模块：在「配置」-「模块」中添加GitHub托管的脚本仓库地址，或手动导入.sgmodule文件
2. 启用MITM证书：脚本功能需解密HTTPS流量，安装并信任CA证书至系统钥匙串
3. 分配执行域：在「脚本」标签页设置匹配域名，支持通配符如*.example.com
4. 调试日志输出：开启「设置」-「高级」-「记录JavaScript日志」，便于排查语法错误

全局路由四大模式详解

Shadowrocket脚本功能在不同路由模式下表现差异显著,理解以下四种模式至关重要：

配置模式（Config） 根据规则列表自动分流，脚本仅对命中代理规则的请求生效,适合精细化控制跨境办公流量。

代理模式（Proxy） 强制所有流量经过节点，脚本作用于全部网络请求，此模式下延迟较高,但确保脚本覆盖完整。

直连模式（Direct） 绕过代理直接连接，脚本功能依然可用但无法修改境外请求,适用于本地调试场景。

场景模式（Scene） 基于Wi-Fi名称或蜂窝数据自动切换上述三种模式,脚本执行环境随场景变化而动态调整。

实战脚本配置示例

以下配置实现广告拦截与重定向：

[Script]
AdBlock = type=http-response,pattern=^https?:\/\/api\.example\.com\/v1\/ads,requires-body=1,script-path=https://raw.githubusercontent.com/user/adblock.js
Redirect = type=http-request,pattern=^https?:\/\/old\.domain\.com,script-path=https://raw.githubusercontent.com/user/redirect.js

关键参数说明：

• requires-body=1：必须声明以解析响应体
• pattern：正则匹配URL，支持RE2语法
• script-path：支持本地路径或远程URL

常见问题排查

现象：脚本显示已加载但无实际效果 原因：MITM证书未针对该域名启用，或域名不在证书白名单 解决方法：检查「证书」-「域名」列表，添加目标域名并重新生成证书

现象：学术资源访问时脚本导致页面空白 原因：脚本修改了Content-Type或破坏了响应完整性 解决方法：在脚本中添加$done({})兜底返回，或对该域名禁用脚本功能

现象：国际网络加速过程中脚本执行超时 原因：远程脚本服务器连接不稳定，或JavaScript引擎内存限制 解决方法：将脚本缓存至本地，或优化正则表达式减少回溯

节点选择对脚本性能的影响

脚本执行效率与节点质量直接相关，高延迟节点会导致脚本超时，建议选择支持BGP中转的专线服务，对于需要频繁执行复杂脚本的跨境办公场景，优先考虑具备低丢包率的IEPL线路,确保脚本逻辑完整运行而不中断。

进阶优化建议

Shadowrocket脚本功能支持Cron定时任务,可定期更新远程脚本：

Update-Scripts = type=cron,cronexp="0 6 * * *",script-path=https://raw.githubusercontent.com/user/update.js

建议每月清理一次脚本缓存（「设置」-「高级」-「清除脚本缓存」），避免旧版本脚本干扰新规则生效，同时开启「IPv6」支持可提升部分脚本对现代网络环境的兼容性。

掌握Shadowrocket脚本功能需要理解JavaScript异步特性与iOS网络栈的交互机制，建议从简单重写规则入手，逐步过渡到复杂响应体修改，为获得最佳脚本执行体验，建议选择提供稳定API端点的优质节点服务商,确保脚本资源加载不受网络波动影响。