导读：
Shadowrocket脚本功能通过JavaScript引擎实现智能分流与请求重写，可自动识别流量类型并匹配最优节点，本文详解脚本配置流程、四种路由模式差异及常见报错排查,助你构建高效的国际网络加速方案。
脚本功能核心机制
Shadowrocket脚本功能基于iOS原生JavaScriptCore框架，支持在请求发出前执行自定义逻辑，与静态规则不同，脚本可动态读取响应体、修改Header参数、实现定时任务切换节点,特别适合处理复杂的跨境办公需求。
四步完成脚本部署
-
启用模块支持
进入「配置」→「模块」→开启「脚本转换」,确保系统已安装MitM证书并开启解密模式。 -
导入脚本资源
在「脚本」页面点击右上角+号，输入远程脚本URL,推荐格式：https://example.com/resource/rewrite.conf支持Quantumult X格式自动转换。
-
配置解析器参数
关键设置项：[Script] 京东比价 = type=http-response,pattern=^https?://api\.m\.jd\.com,requires-body=1,script-path=jd_price.js 节点延迟测试 = type=cron,cronexp="0 */6 * * *",script-path=check_latency.js -
验证执行环境
开启「调试日志」查看脚本输出，确认无SyntaxError或Network Error提示。
全局路由模式深度对比
Shadowrocket脚本功能需配合正确的路由模式才能生效：
| 模式 | 流量走向 | 脚本生效范围 | 适用场景 |
|---|---|---|---|
| 配置 | 按规则文件分流 | 仅匹配规则部分 | 日常使用，平衡速度与延迟 |
| 代理 | 强制走节点 | 全部请求 | 学术资源访问，确保连通性 |
| 直连 | 直接连接 | 仅本地脚本 | 国内应用调试，节省流量 |
| 场景 | 自动切换上述三种 | 依场景而定 | 跨网络环境移动办公 |
关键区别：「配置」模式下脚本仅处理被规则捕获的流量；「场景」模式需提前在「场景」页面设置Wi-Fi/蜂窝网络触发条件。
实战：智能节点切换脚本
以下脚本实现根据目标域名自动选择延迟最低的专线节点：
const $ = new API("AutoSelect");
const TEST_URL = "http://cp.cloudflare.com/generate_204";
const NODES = ["香港CN2", "日本BGP", "美国GIA"];
(async () => {
const results = await Promise.all(
NODES.map(node => testLatency(node))
);
const bestNode = NODES[results.indexOf(Math.min(...results))];
$surge.setSelectGroupPolicy("自动选择", bestNode);
$.done();
})();
高频问题排查
现象：脚本显示已加载但规则未生效
原因：MitM证书未信任或域名未加入解密列表
解决：设置→通用→关于本机→证书信任设置→开启完全信任；在「解密」中添加hostname = *.example.com
现象：运行脚本后内存占用持续升高
原因：循环引用未释放或定时任务间隔过短
解决：在脚本末尾添加$done()强制回收；cron表达式建议不低于*/5 * * * *
现象：规则模式与脚本逻辑冲突
原因：静态规则优先级高于脚本重写
解决：在配置文件中调整[Rule]与[Script]段落顺序，或使用script-update-interval=0强制刷新
性能优化建议
对于4K流媒体或远程桌面场景，建议搭配具备BGP线路的节点服务商，Shadowrocket脚本功能可配合network-changed事件触发器，在Wi-Fi切换至蜂窝数据时自动降级为省流模式,避免高端专线节点产生不必要的流量消耗。
定期检查脚本日志中的TCP connection timeout错误，若特定节点频繁超时，可通过脚本自动将其标记为disabled状态,确保国际网络加速通道的稳定性。
掌握Shadowrocket脚本功能后，用户可实现从简单分流到智能流量调度的跨越，合理运用JavaScript的灵活性，结合稳定的跨境传输节点,能显著提升多任务并发时的网络响应效率。
