导读：
Shadowrocket脚本功能通过JavaScript引擎实现请求级精细化控制,支持自动分流、广告过滤与API数据修改，本文详解脚本配置流程、路由模式差异及常见问题排查，助你构建高效的国际网络加速方案。
Shadowrocket脚本功能基础配置
启用脚本模块需完成以下配置流程：
-
开启脚本开关
进入「配置」→「模块」→启用「Script」功能，确保JavaScript引擎处于运行状态。 -
添加脚本规则
在「配置」→「编辑纯文本」中添加：[Script] 京东比价 = type=http-response,pattern=^https?://api\.m\.jd\.com/client\.action\?functionId=wareBusiness,requires-body=1,script-path=JD_Price.js -
配置MITM证书
脚本解密HTTPS流量需安装CA证书：「设置」→「证书」→「生成新的CA证书」→安装并信任。 -
调试与验证
开启「日志记录」查看脚本执行状态，确认$request和$response对象正常捕获。
全局路由模式深度解析
Shadowrocket脚本功能在不同路由模式下表现差异显著：
配置模式
按规则列表分流，脚本仅对匹配域名生效，适合跨境办公需求，可针对特定学术资源访问站点启用脚本重写。
代理模式
全部流量经过代理节点，脚本全局生效，适合需要统一修改API响应数据的场景，但会增加节点负载。
直连模式
绕过代理直接连接，脚本本地执行，适用于广告过滤等无需代理的本地处理任务。
场景模式
根据WiFi/蜂窝网络自动切换上述模式，建议设置：家庭WiFi使用「直连」运行本地脚本，移动数据切换「配置」模式保障国际网络加速稳定性。
实战脚本编写示例
以下脚本实现请求头自动修改：
// Header_Modify.js
const modifiedHeaders = $request.headers;
modifiedHeaders['User-Agent'] = 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15';
modifiedHeaders['X-Forwarded-For'] = '0.0.0.0';
$done({headers: modifiedHeaders});
配置参数：
[Script]
修改请求头 = type=http-request,pattern=.*,script-path=Header_Modify.js对于需要稳定运行复杂脚本的用户,建议选择具备BGP线路的节点服务商，确保脚本远程资源加载延迟低于100ms。
常见问题排查
现象：脚本生效但特定App无法连接
原因：MITM证书未正确安装或域名未加入解密列表，导致HTTPS握手失败。
解决方法：重新安装证书并检查hostname配置，将目标域名加入[MITM]段的hostname列表。
现象：脚本导致网络延迟增加
原因：脚本逻辑包含同步阻塞操作或远程脚本加载超时。
解决方法：启用「脚本缓存」功能，将远程脚本转为本地存储；简化正则匹配规则，避免全局通配符过度消耗资源。
现象：部分HTTPS请求报错
原因：目标App启用SSL Pinning或TLS指纹检测机制。
解决方法：在「脚本」→「排除域名」中添加相关Host，或切换至「代理」模式绕过本地解密。
现象：脚本间歇性失效
原因：内存不足导致JavaScript引擎被系统终止。
解决方法：关闭「后台刷新」中不必要的模块，定期清理日志缓存，对于长期运行脚本的用户，建议选择内存优化较好的高端专线节点，确保iOS后台保活率。
Shadowrocket脚本功能通过精细化流量控制,为学术资源访问和跨境办公需求提供了自动化解决方案，合理配置路由模式与脚本规则，配合稳定的节点服务，可显著提升网络使用效率，建议每月审查脚本规则有效性，及时更新过期API接口匹配模式。
