无法连接：TLS handshake failed
检查系统时间是否准确，尝试更换节点或协议（如从Vmess切换为Trojan），确保节点证书未过期。
订阅更新失败：invalid URL
在Shadowrocket中删除旧订阅，重新粘贴完整链接（含 https://），若仍失败请联系服务商获取新地址。
| 错误代码 | 说明 | 快速修复 |
|---|---|---|
| timeout | 网络超时 | 切换网络，检查节点可用性 |
| tls handshake failed | TLS握手失败 | 校准时间，更换节点/协议 |
| invalid config | 配置错误 | 重新导入配置文件 |
| dns resolve failed | DNS解析失败 | 开启DoH或更换DNS服务器 |
| subscription expired | 订阅过期 | 联系服务商续期或更新链接 |
| connection refused | 连接被拒绝 | 检查端口是否开放，尝试其他节点 |
Shadowrocket 常见故障深度排查手册
Shadowrocket 问答库 汇集了上万名用户在实际使用中遇到的高频问题， 覆盖安装、连接、订阅、规则、DNS等全部核心模块。无论你是刚入门的新手还是经验丰富的老用户， 都可以在这里找到精准的解决方案。
连接超时与握手失败
timeout 和 tls handshake failed 是最常见的错误类型。
前者通常由网络封锁或节点不可用引起，后者多因证书问题或设备时间偏差导致。
建议优先检查系统时间是否自动同步，然后通过 Shadowrocket 的测速功能筛选低延迟节点。
若使用 Vmess 协议频繁超时，可尝试切换至 Trojan 或 Hysteria，它们在不同网络环境下表现更优。
订阅自动同步异常的修复策略
订阅更新失败时，不要立即删除订阅。先手动复制链接在 Safari 中打开，确认能否返回节点数据。 如果可以，说明链接本身有效，问题出在 Shadowrocket 的网络权限或 DNS 解析。 此时可前往 iOS 设置 → Shadowrocket → 无线数据，确保已允许 WLAN 与蜂窝网络。 同时在 Shadowrocket 内开启 DNS over HTTPS，可有效规避运营商对订阅域名的干扰。
广告拦截失效与规则冲突
广告拦截依赖于规则集中对广告域名的 REJECT 策略。若发现拦截失效， 请检查规则列表中是否包含广告过滤条目，并确保它们位于规则集顶部。 部分订阅自带规则可能覆盖了你本地添加的拦截规则，此时可以进入 规则实验室 获取最新的广告屏蔽模板单独导入。