Shadowrocket (小火箭) 配置与排障手册
iOS 用户最普及的代理客户端,支持扫码导入与高度自动化规则分流
官方发布入口与版本要求
内核:轻量高效移动代理引擎 · 推荐版本:2.2.x 官方最新版安全提醒:国区 App Store 已下架,需使用美区/港区等非国区 Apple ID 购买下载。
图文配置与订阅导入流程
1 1. 安装并授权
从美区 App Store 下载安装后首次打开,点击顶部开关会弹出系统 VPN 配置授权请求,点击「允许」并完成指纹/面容确认。
2 2. 导入节点
点击右上角「+」号,类型选择「Subscribe」,粘贴订阅链接并完成备注。或者直接使用相机扫描服务商后台生成的订阅二维码。
3 3. 全局路由选择「配置」
确保首页「全局路由」设置为「配置 (Config)」模式,而不是「代理」或「直连」,以确保国内直连、国外分流。
常见报错排障与修复建议
⚠️ 更新订阅提示 404 或超时
解决办法:点击节点最下方的订阅右滑更新;若失败,长按订阅选择编辑,开启「自动更新」并在 Safari 中打开该订阅链接确认服务商后台是否正常。
✓ 配置完成后的连通性验证
导入订阅并开启代理后,请立即运行本站的 HTTP 请求耗时测试与公网出口 IP 检查,确认请求正常返回且出口地区与节点一致。
Shadowrocket (小火箭) 进阶网络机制:系统代理 vs TUN 虚拟网卡深度剖析
搞懂为什么终端命令(curl/git)不走代理,以及如何利用 TUN 模式实现全流量接管。
1. 普通系统代理(System Proxy)的局限
普通模式下,客户端仅在操作系统设置中配置了一个本地 HTTP/Socks5 监听端口(如 127.0.0.1:7890)。这种模式仅对主动遵循系统代理设置的应用程序生效(如 Chrome、Edge、Firefox)。
而像终端命令行(Terminal / CMD)、Git 拉取、Docker 镜像下载、Steam/Epic 外服联机游戏以及部分后台守护进程,默认完全忽略系统代理,数据包仍然直接向公网发起直连,导致频繁报 Connection Timeout 错误。
2. TUN 虚拟网卡模式(TUN Mode)的解决机制
开启 TUN 模式后,Shadowrocket (小火箭) 会在操作系统内创建一个虚拟三层网卡接口,并修改系统默认路由表,将主机上所有应用程序的 TCP/UDP IP 报文强制接管。
- 真正全局生效:无需在终端敲 export http_proxy,命令行与开发工具自动享受代理加速;
- UDP FullCone 支持:解决 Discord 语音断断续续、外服游戏联机 NAT 类型受限(Strict NAT)的问题;
- DNS 防污染:配合 Fake-IP 机制,操作系统在本地即可瞬间响应一个虚构 IP(如 198.18.0.x),将真实 DNS 解析交给远端节点处理,彻底杜绝 DNS 劫持。
3. 常见报错代码与速查自愈表
| 错误代码/日志提示 | 根本原因 | 一分钟修复方案 |
|---|---|---|
| EOF / Connection Reset | 节点入口断开或遭遇运营商 TCP RST 干扰 | 在节点列表中切换至同组备用专线节点,手动更新订阅 |
| TLS Handshake Timeout | 晚高峰骨干网丢包过高导致 TLS 握手无法完成 | 将直连/普通中继切换为 IEPL 内网专线节点 |
| Proxy Loopback Detected | 代理客户端把自身的外部流量又路由进了自身 | 关闭多开的二次代理软件,重置系统默认路由规则 |