在使用 Shadowrocket（小火箭）过程中，遇到节点无法连接、订阅更新失败、设置误操作导致无法上网等问题十分常见。本 troubleshooting 指南系统性地梳理了十大高频故障场景，并提供清晰的自检步骤与解决方案。建议按顺序排查，一般可在三分钟内恢复稳定的代理连接。
根据你的症状，点击对应卡片下方的 FAQ 分类，即可跳转到具体的解决方案。
按照故障类型分组，点击问题展开详细解决步骤。
先检查节点格式：SS/SSR/V2Ray/Trojan 的地址、端口、加密方式是否与提供商一致。若格式正确但仍不通，尝试在设置中将“延迟测试方法”切换为 TCP。部分服务器禁 Ping，ICMP 测速正常但实际无法连接。最后确认代理开关是否开启且路由模式不是“直连”。
请检查“全局路由”模式是否误设为“直连”。应选择“配置”模式以启用规则分流，确保海外域名走代理。如果仍然是直连，进入“设置”→“连接”确认 CONNECT 模式已启用。
这种情况通常是网络环境变化导致。首先关闭代理，用浏览器访问一个海外网站确认本地网络是否正常。如果本地网络本身不通，代理自然无效。其次检查订阅是否已过期或节点端口被封，可尝试更新订阅并重新测速。
首先用 Safari 浏览器直接打开订阅链接，检查链接是否有效。部分订阅源限制访问环境，可尝试关闭代理后重试。如果链接本身能打开，在小火箭中删除订阅重新添加，并确保添加时网络环境允许访问该链接。
可能是订阅服务端返回了空数据。进入小火箭“设置”→“订阅”，长按订阅条目选择“立即更新”。如果仍然为空，请登录你的订阅服务网站确认套餐状态。
确认“设置”→“订阅”中的“自动更新”开关已打开，并检查更新间隔设置。iOS 的后台机制可能会限制更新频率，建议将间隔设为 6 小时以上以确保系统允许后台执行。
ICMP 速度快，但某些服务器禁 Ping 会导致测速显示正常实际无法连接。建议切换为 TCP，它模拟真实代理握手，延迟数据更可靠。在“设置”→“延迟测试方法”中更改。
如果路由模式设为“代理”，所有流量（包括国内网站）都会走代理节点，自然会变慢。请改为“配置”模式，并确保已导入有效的分流规则文件。
部分应用使用非标准 HTTPS 请求，需要 CONNECT 方法建立隧道。在“设置”→“连接”中确保 CONNECT 开关为开启状态。
如果未开启“按需求连接”，每次需要手动打开代理开关。开启后，小火箭会根据规则自动决定是否启用 VPN，省电且无感。该选项在“设置”→“按需求连接”中。
确保节点协议与 Shadowrocket 当前版本兼容。小火箭已全面支持 SS/SSR/V2Ray/VLESS/Trojan，但仍需确认你的节点配置（如 Flow 选项）符合标准。可尝试用同一个订阅链接在其他客户端验证节点可用性。
当连接失败时，小火箭会显示错误代码。以下是高频代码及其对应解决方法。
| 错误代码 | 含义 | 解决方法 |
|---|---|---|
| kCFErrorDomainCFNetwork | 网络连接失败 | 检查节点地址和端口，或切换网络环境。 |
| connection refused | 服务器拒绝连接 | 端口可能被封锁，更换节点或联系提供商。 |
| no route to host | 无路由到达主机 | 节点 IP 不可达，尝试 Ping 该 IP 或更换节点。 |
| handshake timeout | TLS 握手超时 | 将 Ping Method 改为 TCP，或检查 TLS 配置。 |
按以下清单逐项核对，避免因小疏忽导致长时间无法上网。