导读：
本文深入解析Shadowrocket脚本模块的启用逻辑与配置技巧,详解全局路由四种工作模式差异，并提供常见脚本失效问题的排查方案，助你实现精准的网络流量管理。
Shadowrocket的脚本功能使用是提升网络加速效率的核心手段,通过JavaScript注入，可实现请求重写、响应修改、自动签到等高级操作，掌握正确的配置流程，能显著优化跨境办公与学术资源访问体验。
脚本模块启用与基础配置
完整的小火箭脚本功能使用流程包含四个关键步骤：
-
获取脚本资源
在配置页面选择「添加模块」，导入包含脚本规则的远程链接，建议优先选择维护频繁的公开仓库，确保脚本兼容最新版App。 -
配置脚本路径
进入「脚本」标签页，检查script-path指向的URL是否可访问，本地脚本需通过iCloud Drive或文件App导入，路径格式为file:///var/mobile/...。 -
设置匹配规则
在「规则」板块添加MITM域名，启用HTTPS解密，脚本生效依赖正确的pattern匹配，建议使用正则表达式精确控制作用域：
[Script]
YouTube Premium = type=http-response,pattern=^https://youtubei\.googleapis\.com,requires-body=1,script-path=https://example.com/ytb.js- 调试与验证
开启「日志记录」功能，在「最近请求」中查看脚本执行状态，200状态码伴随脚本标签即表示注入成功。
全局路由四大模式差异
小火箭脚本功能使用的效果与全局路由设置紧密相关,四种模式决定了流量是否经过脚本处理：
配置模式（Config）
基于规则分流，仅对匹配规则的流量应用脚本，适合需要精细控制国际网络加速与本地直连并行的场景，是脚本功能使用的推荐模式。
代理模式（Proxy）
全部流量强制走代理节点，脚本对所有请求生效，适用于全站加速需求，但可能增加不必要的延迟。
直连模式（Direct）
流量不经过代理服务器，脚本仅在本地执行，适合测试脚本逻辑或处理纯本地请求。
场景模式（Scene）
根据Wi-Fi/蜂窝网络自动切换上述三种模式，建议为家庭宽带设置直连，为公共网络设置代理，实现脚本功能的智能化触发。
实战脚本编写规范
高效的脚本需遵循Shadowrocket特定API,以下代码块展示标准请求修改模板：
const $rocket = new API("TestScript");
$rocket.httpClient.get(url, (error, response, data) => {
if (!error) {
let body = JSON.parse(data);
body.data.isPremium = true;
$rocket.done({body: JSON.stringify(body)});
}
});
注意$rocket对象与Surge、Quantumult X的API差异，调试时建议先用$rocket.log()输出变量，确认逻辑无误后再修改实际请求。
节点质量对脚本执行的影响
脚本功能使用稳定性高度依赖节点质量,低延迟节点能确保脚本请求及时响应，避免超时导致的逻辑中断，对于需要频繁改写请求的重写类脚本，建议选择支持TLS 1.3的中转线路，减少握手过程中的数据包丢失。
若需处理4K视频流或大型API响应,高端专线比免费节点更适合承载脚本附加的计算开销，稳定的网络环境是脚本功能使用的前提条件。
高频问题诊断
现象：脚本显示已加载但无实际效果
原因：MITM证书未信任或域名未添加到解密列表
解决方法：进入「证书」页面安装描述文件，在「关于本机」中启用完全信任，并检查规则中是否包含DOMAIN类型的MITM条目
现象：特定App脚本间歇性失效
原因：App启用SSL Pinning或证书固定
解决方法：尝试切换代理模式为全局，或使用支持更完整TLS处理的节点，部分银行类App无法通过脚本修改
现象：配置更新后脚本路径报错
原因：远程脚本URL变更或本地文件被清理
解决方法**：检查「脚本」页面的路径有效性，本地脚本建议关闭iCloud优化防止被系统删除
掌握小火箭脚本功能使用的技术细节,能构建高度定制化的网络加速方案，建议定期备份配置文件，并在升级iOS系统后验证脚本兼容性，确保跨境办公与学术访问的连续性。
