Shadowrocket脚本功能通过JavaScript引擎实现请求级别的动态处理，支持修改HTTP请求头、重定向URL及自定义分流逻辑，本文详解脚本配置流程、路由模式差异及实际应用场景,帮助用户构建高效的国际网络加速方案。
Shadowrocket脚本功能为iOS用户提供了基于JavaScript的运行时环境，允许在HTTP/HTTPS请求层面执行自定义逻辑，相比静态规则，脚本可实现动态判断、API请求修改及响应内容处理,显著提升国际网络加速的精细化程度。
脚本引擎工作原理
Shadowrocket内置的JavaScriptCore框架支持ES6语法，脚本在请求发出前（$request）或响应返回后（$response）执行，通过$done()方法传递修改后的对象，实现流量重定向、Header注入或Body修改，该功能特别适用于需要Token自动刷新、广告参数过滤或特定域名强制走代理的跨境办公需求。
配置流程详解
-
获取脚本资源
在配置文件的[Script]段落添加脚本URL，支持本地文件或远程订阅，推荐从可信仓库获取开源脚本,避免执行未审计的代码。 -
启用MITM证书
脚本功能处理HTTPS流量需安装并信任CA证书，设置 → 证书 → 生成新的CA证书 → 安装描述文件 → 关于本机 → 证书信任设置中开启完全信任。 -
配置脚本参数
在[Script]区块按格式声明：[Script] 脚本名称 = type=http-request,pattern=^https?://api\.example\.com,script-path=local/script.js,requires-body=true -
调整执行顺序
脚本按配置文件中的先后顺序执行，建议将高频规则前置，在[General]中设置script-update-interval=86400控制远程脚本自动更新频率。
全局路由模式差异
Shadowrocket提供四种路由决策机制,与脚本功能协同工作：
配置模式
优先匹配配置文件中的规则集，未命中时按默认策略处理，脚本在此模式下可覆盖规则决策,适合需要动态调整路由的学术资源访问场景。
代理模式
所有流量强制经过代理服务器，脚本仍可执行但主要用于Header修改而非分流决策，适用于网络环境复杂、需要全局穿透的跨境办公需求。
直连模式
除脚本明确指定代理的域名外，其余流量直接连接，该模式下脚本承担主要分流职责,对脚本编写质量要求较高。
场景模式
基于地理位置或网络类型自动切换上述三种模式，脚本可读取$network变量识别当前网络环境，实现Wi-Fi与蜂窝数据的差异化处理。
实用脚本示例
以下脚本实现特定API域名自动添加Authorization头：
const url = $request.url;
const headers = $request.headers;
if (url.includes("api.researchgate.net")) {
headers['Authorization'] = 'Bearer ' + getToken();
$done({headers});
} else {
$done({});
}
function getToken() {
// 从持久化存储读取或刷新Token逻辑
return $persistentStore.read("academic_token");
}
常见问题排查
现象：脚本显示已执行但请求未按预期修改
原因：MITM证书未正确安装或域名未在[MITM]段落声明hostname。
解决方法：检查证书信任状态，确保配置包含hostname = %APPEND% api.target.com。
现象：启用脚本后国际网络加速速度明显下降
原因：脚本中存在同步阻塞操作或正则表达式过于复杂。
解决方法：优化正则匹配模式，避免在脚本内发起额外HTTP请求，使用$task.fetch替代同步API。
现象：部分应用闪退或无法连接
原因：脚本修改了应用完整性校验所需的Header或Body内容。
解决方法：添加更精确的URL匹配规则，排除健康检查类请求,或对该应用单独设置直连规则。
节点选择与脚本协同
脚本功能的性能表现与节点质量直接相关，处理大量动态请求时，建议选择支持HTTP/2或QUIC协议的中转节点，降低TLS握手延迟，对于需要频繁API调用的学术资源访问场景,具备BGP线路的专线节点能减少脚本执行超时概率。
配置完成后，建议通过ping和tcping测试节点连通性，确保脚本中的超时设置与节点实际延迟匹配，优质的节点服务商通常提供详细的API文档,便于在脚本中实现节点自动切换逻辑。
掌握Shadowrocket脚本功能的核心在于理解请求生命周期与JavaScript执行环境的交互机制，通过合理配置MITM、优化正则匹配逻辑，并结合稳定的网络基础设施,用户可构建高度自动化的跨境办公网络方案。
