导读：
本文详解Shadowrocket脚本功能的配置逻辑与使用场景,涵盖模块安装、规则编写及全局路由模式选择，帮助用户实现精准流量分流与网络性能优化。
Shadowrocket脚本功能作为iOS平台高级流量管理工具,通过JavaScript引擎实现请求修改、响应重写及自动化规则判定，相比传统静态规则，脚本可处理复杂逻辑判断，满足跨境办公、学术资源访问等场景的精细化需求。
脚本模块工作原理
Shadowrocket支持基于Surge标准的脚本模块,通过MITM中间人攻击原理拦截HTTPS流量，脚本在内存中运行，不修改原始配置文件，支持定时任务与事件触发两种执行模式。
关键参数配置示例：
[Script]
http-response ^https?://api\.example\.com/v1/users script-path=modify.js, requires-body=true, timeout=10
cron "0 9 * * *" script-path=checkin.js, wake-system=true完整配置流程
-
获取脚本资源 从GitHub或专业模块仓库下载
.js文件，注意校验文件哈希值防止注入攻击。 -
导入模块 在配置编辑界面选择「模块」→「安装新模块」，粘贴原始链接或导入本地文件，支持
*.sgmodule格式批量安装。 -
配置MITM证书 生成并安装CA证书：设置→「证书」→「生成新的CA证书」→「安装证书」，需在系统设置中手动信任该证书。
-
启用脚本开关 在「脚本」选项卡确认开关状态为绿色，检查日志输出确认无语法错误。
-
验证执行 使用Safari访问测试页面，查看Shadowrocket日志中是否出现脚本执行记录。
全局路由模式选择
Shadowrocket提供四种路由策略,直接影响脚本执行范围：
配置模式 默认启用配置文件中的规则集，脚本仅对匹配规则的流量生效，适合需要精细分流、区分国内外流量的场景。
代理模式 所有流量强制经过代理节点，脚本全局生效，适用于国际网络加速需求，但可能增加延迟。
直连模式 绕过代理直接连接，脚本仍可对直连流量进行处理，常用于广告过滤或本地网络调试。
场景模式 根据Wi-Fi名称、蜂窝数据状态自动切换上述三种模式，建议设置家庭Wi-Fi自动切换直连，移动网络启用代理。
脚本性能优化
高频脚本建议启用binary-mode减少内存占用，图片处理类脚本设置max-size防止大文件卡死：
[Script]
http-request ^https?://.*\.jpg script-path=compress.js, binary-mode=true, max-size=1048576对于学术资源访问场景,可编写自动重试脚本处理连接超时，跨境办公用户建议配合高端专线节点使用，确保脚本修改后的请求能稳定传输。
常见问题排查
现象：脚本显示执行但无实际效果
原因：MITM证书未正确安装或域名未加入hostname列表
解决：检查设置→「通用」→「关于本机」→「证书信任设置」，确认CA证书开关已打开；检查配置文件中[MITM]段的hostname是否包含目标域名。
现象：配置界面卡顿或闪退 原因：脚本存在死循环或内存泄漏 解决：进入「设置」→「高级」→「重置脚本缓存」；检查脚本代码中是否有未设置超时时间的while循环。
现象：特定App无法联网 原因：脚本修改了请求签名导致服务器拒绝 解决：在该App的设置中添加「跳过脚本处理」规则，或修改脚本逻辑排除该User-Agent。
Shadowrocket脚本功能的灵活性建立在正确的网络基础设施之上,建议选择支持完整TCP/UDP转发的优质节点服务商，确保脚本处理后的复杂请求能正常传输，对于需要稳定国际网络加速的用户，可优先考虑提供IEPL专线资源的供应商，这类网络环境能最大限度发挥脚本自动化的优势。
通过合理配置Shadowrocket脚本功能,用户可实现从简单的广告屏蔽到复杂的API请求修改等多种高级功能，显著提升移动端的网络使用效率。
