导读：
Shadowrocket脚本功能可实现智能分流、自动去广告及API数据重写，掌握JavaScript注入与MitM证书配置是解决脚本失效的关键，本文提供从基础调试到高阶应用的完整技术方案。
脚本功能的核心价值
Shadowrocket脚本功能基于JavaScript引擎,允许用户在HTTP/HTTPS请求传输过程中插入自定义逻辑，相比传统规则匹配，脚本可实现动态判断、数据解密、响应体修改等高级操作，特别适用于跨境办公场景下的复杂网络环境适配。
配置流程四步走
证书安装与MitM启用
脚本功能依赖中间人攻击（MitM）解密HTTPS流量，进入配置 → 证书 → 生成新的CA证书，安装后需在iOS设置中信任该证书。
[MITM] enable = true ca-passphrase = Shadowrocket ca-p12 = 证书路径 hostname = *.example.com, *.api.com
脚本文件导入
支持本地文件与远程订阅两种方式,推荐将.js脚本托管在GitHub或私有服务器，通过URL订阅实现自动更新。
[Script] 京东比价 = type=http-response,script-path=https://raw.example.com/jd.js,requires-body=1,pattern=^https?://api\.m\.jd\.com
Rewrite规则关联
在配置 → 编辑纯文本中添加Rewrite段落，将特定URL指向脚本处理，注意requires-body参数决定是否需要解析响应体。
调试模式开启
开启设置 → 高级 → 日志级别为Verbose，通过最近请求查看脚本执行日志，定位SyntaxError或API匹配失败问题。
全局路由模式深度解析
Shadowrocket脚本功能在不同路由模式下表现差异显著,需根据国际网络加速需求选择：
配置模式（Config）
默认推荐选项，优先使用当前加载的配置文件规则，脚本在此模式下按配置文件中的[Script]段落顺序执行，支持最复杂的分流逻辑。
代理模式（Proxy） 所有流量强制走代理节点，脚本仅处理已建立连接的流量，适用于节点稳定性测试，但会绕过直连规则导致国内流量浪费。
直连模式（Direct） 流量不经过代理，脚本功能受限，仅建议在网络诊断或纯局域网环境使用，此时Rewrite和Script模块基本失效。
场景模式（Scene） 根据Wi-Fi名称、蜂窝数据状态自动切换配置，可设置"公司Wi-Fi走直连+脚本去广告，移动数据走代理+全功能脚本"的自动化策略。
高阶应用：自动分流脚本示例
以下脚本实现学术资源访问自动识别：
// 学术分流脚本
const url = $request.url;
const academicHosts = ['scholar.google', 'ieee.org', 'arxiv.org'];
if (academicHosts.some(host => url.includes(host))) {
$done({matched: true, policy: "US-学术专线"});
} else {
$done({});
}
常见问题排查（FAQ）
现象：脚本显示执行但无实际效果 原因：MitM证书未正确安装或hostname未覆盖目标域名，导致HTTPS流量未解密，脚本无法获取明文数据。 解决方法：检查设置 → 通用 → 关于本机 → 证书信任设置，确保Shadowrocket CA处于开启状态；核对hostname列表包含目标API域名。
现象：配置界面闪退或加载缓慢
原因：脚本存在内存泄漏或正则表达式过于复杂，JavaScript引擎超时。
解决方法：简化pattern匹配规则，避免使用贪婪匹配；将大型脚本拆分为多个小型脚本，通过script-path分别引用。
现象：部分App功能异常
原因：脚本修改了关键API响应导致签名验证失败。
解决方法：在配置 → 编辑配置 → Hostname中添加该App的API域名到排除列表，或使用script-update-interval=0暂停特定脚本更新。
节点选择与脚本性能优化
Shadowrocket脚本功能对节点质量有隐性要求,低延迟节点（<100ms）可确保脚本API请求及时响应，避免超时导致的逻辑中断，建议选择支持BGP中转的专线服务商，确保在启用复杂脚本时仍保持4K视频流畅播放。
对于需要频繁更新脚本的学术访问场景,可考虑配备自动订阅维护的节点服务，减少手动维护成本，优质节点配合精心编写的脚本，可实现近乎无感的国际网络加速体验。
