Shadowrocket 连接失败怎么排查？按症状定位问题
简答：Shadowrocket 连接失败时，先关闭客户端确认 Wi-Fi 或蜂窝数据能正常上网，再只选一个节点手动连接并记录现象。开关立即弹回重点查 VPN 配置与冲突工具；节点超时重点查节点参数和网络；显示已连接但网页打不开，则继续检查 Global Routing、Config 规则、DNS 和真实网页请求。
定义：Shadowrocket 连接失败，是指客户端无法建立代理连接、连接建立后请求无法通过，或只有特定网站、App 访问异常的统称。
先做 1 分钟速查：不要先删除订阅
本文是第三方使用指南站，页面不代表该客户端开发者或任何节点服务方。Shadowrocket 在 App Store 的描述中包含规则路由、请求记录、DNS、Wi-Fi 与蜂窝网络等功能；具体菜单名称可能随当前版本和系统语言变化，遇到差异时以设备实际显示为准。App Store 应用页面
| 现象 | 先检查什么 | 初步判定 |
|---|---|---|
| 打开开关后立即弹回 | iOS 的 VPN 配置、其他 VPN 或网络过滤工具 | 更像本机权限、系统配置或软件冲突 |
| 一个节点超时 | 该节点的 Address、Port、认证信息和 TLS 参数 | 优先怀疑单个节点或参数 |
| 全部节点超时 | 当前 Wi-Fi/蜂窝网络、订阅更新、系统时间和网络切换 | 优先排查本地网络、订阅或整体线路 |
| 显示已连接但网页打不开 | Global Routing、Config、DNS 和真实请求 | 连接状态正常，但请求路径可能不正确 |
| 只有一个 App 或网站失败 | 规则匹配、App 自身网络、域名解析和目标服务 | 不宜直接判定为节点失效 |
- 关闭 Shadowrocket，确认当前 Wi-Fi 或蜂窝数据能打开普通网页。
- 重新打开客户端，只选择一个节点，暂时不要启用 On Demand 或复杂规则。
- 手动打开连接开关，记录“是否弹回、是否超时、是否显示已连接”。
- 固定同一个节点、同一个目标网站和同一种网络，只改一个变量后复测。
Connectivity Test 有结果，不等于 DNS、规则和真实网页请求全部成功。更稳妥的顺序是：连接状态→节点设置→DNS→规则→真实目标请求，再查看诊断记录。Shadowrocket 使用指南中的诊断顺序
按故障现象分流排查
开关立即弹回，或始终无法保持连接
- 在 iPhone 的“设置”中查看 VPN 与设备管理相关项目，确认没有残留或重复的 VPN 配置。Apple 说明，已安装的配置文件可以在“设置→通用→VPN 与设备管理”中查看。Apple：查看和移除 iPhone 配置文件
- 暂时退出其他 VPN、DNS 过滤、网络防火墙或抓包类工具，然后只保留 Shadowrocket 进行一次手动测试。
- 如果系统再次弹出添加 VPN 配置的请求，阅读权限提示后确认；若没有提示而开关仍弹回，记录 iOS 版本、客户端版本、网络类型和弹回时间。
- 复测后若恢复，逐个重新启用其他网络工具，找到冲突变量；不要一次性恢复全部设置。
节点超时、全部节点都无法连接
- 先在当前网络下测试一个节点，再切换到蜂窝网络重复测试，保持节点、目标和测试方法不变。
- 如果只有一个节点超时，打开节点编辑界面，对照服务方提供的资料核对 Address、Port、密码、UUID、加密方式、TLS、SNI 和传输方式。没有资料支持的字段不要凭模板填写。
- 如果全部节点超时，确认订阅是否仍存在、订阅更新是否完成、更新后是否实际选中了新节点。订阅更新成功只说明列表获取完成，不代表每个节点都能建立连接。
- 检查系统日期与时间是否自动同步。若日志出现 TLS 握手、证书或有效期相关错误，先校准时间，再只复测原节点。
显示已连接，但网页仍打不开
- 先记录当前节点、Global Routing 模式和选中的 Config。Global Routing 决定整体流量处理方式，On Demand 决定何时自动发起连接，两者不是同一个开关。Shadowrocket 设置说明
- 为了缩小变量，可暂时使用明确的 Proxy 模式测试一个已知目标；如果当前设置必须使用 Config，则先备份配置，再检查规则顺序和 FINAL 行为。
- 检查 DNS 是否能解析目标域名。若连接测试有结果但网页请求失败，不能仅凭延迟或连接状态判断代理已经对该网页生效。
- 用同一个节点分别测试一个网页和一个 App。若网页正常、只有某个 App 失败，继续查该 App 的域名、系统网络权限或规则匹配，不要立即删除订阅。
只有某个网站或 App 失败
固定节点和网络后，记录失败目标、时间、错误原文以及是否能打开其他目标。检查 Config 中是否存在针对域名、域名后缀、IP 段或最终规则的匹配；同时排除目标服务本身异常、App 缓存和 IPv6/IPv4 差异。Shadowrocket 的 App Store 描述列出了域名规则、CIDR、GeoIP、DNS 请求记录等能力，但具体配置是否适用于当前文件，仍需查看实际规则内容。App Store 功能说明
日志错误怎么判断：先看错误层级
| 日志或现象 | 优先检查 | 下一步动作 |
|---|---|---|
| timeout、i/o timeout | 当前网络、Address、Port、节点是否可达 | Wi-Fi 与蜂窝网络交叉复测，确认是否只有单个节点失败 |
| connection refused | 端口、服务端监听状态、节点资料 | 核对 Port，不要把拒绝连接当成 DNS 问题 |
| TLS handshake failed | TLS、SNI、传输方式、系统时间 | 逐项对照服务方原始资料，只改一个字段 |
| certificate、expired、not yet valid | 设备日期时间和证书有效期 | 先启用自动日期时间，再重新连接 |
| DNS failed、domain not found | DNS 设置、域名拼写、规则路径 | 记录 DNS 错误，再对照同一目标测试其他节点 |
| connected 但请求失败 | Global Routing、Config、FINAL、目标网站 | 查看请求记录和规则命中情况，不只看开关状态 |
向服务方反馈时，只提供脱敏后的错误原文、发生时间、网络类型、节点名称或编号、客户端版本和复测结果。不要公开订阅链接、密码、UUID、私钥、完整配置文件或包含个人信息的截图。
复测、回滚与结束标准
- 复测记录：写下日期、网络类型、节点、Global Routing、目标网站、Connectivity Test 结果和真实网页结果。
- 只改一个变量：先换网络，再换节点，再检查规则或 DNS；不要同时更新订阅、改配置和切换多个节点。
- 确认恢复：同一个节点在当前网络下能够保持连接，目标网页能实际打开，失败 App 的请求也有明确结果。
- 回滚设置：恢复原来的 Global Routing、Config、DNS 和 On Demand 状态；删除临时测试规则，关闭不再使用的 VPN 或过滤工具。
- 仍未恢复：整理完整排查记录后，再联系配置或线路提供方核对节点资料。无法确认服务端状态时，不要把一次测试结果写成线路长期不可用。
如果问题只在某个 Wi-Fi 或蜂窝网络出现，保留两组对照结果；如果所有网络、所有节点和多个目标都失败，再把问题升级为“订阅、节点资料或客户端版本需要进一步核验”，而不是继续盲目修改 DNS。
常见问题
Connectivity Test 成功，为什么网页还是打不开？
Connectivity Test 只代表选定测试方法获得了结果，不能单独证明 DNS 解析、规则匹配、协议认证和目标网页请求都成功。应保持节点和网络不变，继续查看请求记录、Global Routing、Config 和真实目标访问结果。
Shadowrocket 开关一打开就弹回，应该先换节点吗？
不建议先换节点。开关立即弹回更应先检查 iOS VPN 配置、残留配置文件以及其他 VPN 或网络过滤工具冲突；只有客户端能够保持连接后，换节点才有排查意义。
订阅更新成功，是否说明节点一定可用？
不是。订阅更新成功通常只说明客户端完成了列表获取或更新动作，不能替代节点连接测试。更新后仍要确认实际选中的节点，并用固定网络和目标进行复测。
什么时候可以判断是 DNS 问题？
当节点能够保持连接、其他请求有记录，但目标域名解析失败或日志明确出现 DNS 错误时，才适合优先检查 DNS。若日志是端口超时、连接拒绝或 TLS 握手失败，应先处理对应层级，不要混用 DNS 方案。
排查时可以直接删掉 Config 或重装客户端吗？
不建议作为第一步。先备份当前配置并记录节点、规则和 DNS 状态；只有在确认配置损坏且能够重新获取可靠配置时，才考虑删除或重装。完成测试后应恢复原设置，避免把临时改动变成新的故障来源。
常见问题
Connectivity Test 成功，为什么网页还是打不开？
Connectivity Test 有结果不等于 DNS、规则、协议认证和真实网页请求都成功。请保持节点和网络不变，继续查看请求记录、Global Routing、Config 以及目标网页的实际访问结果。
Shadowrocket 开关一打开就弹回，应该先换节点吗？
不建议先换节点。先检查 iOS VPN 配置、残留配置文件，以及其他 VPN、DNS 过滤或网络防火墙工具是否冲突；客户端能保持连接后，再测试节点。
订阅更新成功，是否说明节点一定可用？
不是。订阅更新成功只说明列表获取或更新动作完成，不能证明节点可连接。更新后仍需确认实际选中的节点，并固定网络和目标进行复测。
什么时候可以判断是 DNS 问题？
当节点能保持连接，日志明确出现 DNS 失败或目标域名无法解析时，才应优先检查 DNS。端口超时、连接拒绝和 TLS 握手失败应分别排查网络、端口或 TLS 参数。
排查时可以直接删除 Config 或重装客户端吗？
不建议作为第一步。先备份配置并记录节点、规则、DNS 和 On Demand 状态；确认配置损坏且有可靠恢复来源后，再考虑删除或重装。
相关阅读
参考资料
- App Store：Shadowrocket 应用页面与功能说明
- Shadowrocket 使用指南：连接测试、DNS、规则与诊断顺序（shadow-official.com）
- Shadowrocket 设置说明：Global Routing 与 On Demand（shadow-official.com）
- Apple 支持：在 iPhone 上安装或移除配置文件