P 机场推荐与网络诊断
iOS (iPhone / iPad)

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 代理客户端把自身的外部流量又路由进了自身 关闭多开的二次代理软件,重置系统默认路由规则