节点添加失败：扫码识别错误或订阅链接无法保存？
问题现象：扫描二维码后无反应，或手动添加订阅时提示“保存失败”。
🔍 故障根因树
- 二维码格式不是
ss:///ssr:///vmess://→ 请重新生成标准格式 - 订阅链接以
ftp://开头或未包含完整 URL → 必须以http://或https://开头 - 添加时选择了错误的类型（如将订阅错选为 Local） → 类型必须选 Subscribe
- 网络环境阻止了链接访问 → 在浏览器中打开测试，必要时先挂载全局代理
# 正确的订阅链接示例
https://sub.example.com/link/abcd1234?flag=shadowrocket
手动填写节点参数时 Host / Port 填写失误导致连不上？
常见错误：端口号误填为域名、加密方式与服务器不匹配、混淆插件参数多余空格。
✅ 标准字段检查清单
| 字段 | 正确示例 | 常见错误 |
|---|---|---|
| Address | node.example.com | 多余的 http:// 前缀 |
| Port | 443 | 字母或符号混入 |
| Encryption | aes-256-gcm | 大小写混淆 |
测速结果全部超时或 Ping 值波动巨大？
排查方向：先确认测速模式是 ICMP 还是 TCP。部分节点运营商禁 Ping，需改用 TCP 模式。
# 在 Shadowrocket 测速页长按节点选择 TCP 模式
默认 Ping 超时 → 切换至 TCP → 恢复正常
若切换后仍异常，检查 Wi-Fi / 蜂窝数据环境，关闭 VPN 类冲突应用后重试。
带宽测试结果与实际体验不符？
测速工具的多线程并发测试可能受本地网络限速策略影响。建议在非高峰时段测试，并关闭其他占用带宽的应用。如果结果始终偏低，可能是节点本身带宽有限，尝试切换至不同地区的节点。
规则文件导入后配置不生效或报错？
首要检查：导入前务必核对文件 SHA256 校验码，防止下载过程中损坏。
# 在终端验证下载文件的校验码
shasum -a 256 ~/Downloads/shadowrocket_rules.conf
其次，确认规则语法中关键字均为大写，无多余逗号或空格。导入后需在“配置”页手动启用该配置。
远程规则链接过期或无法访问怎么办？
首先在浏览器中直接打开该链接，确认是否为 404 或证书错误。若链接已失效，可从本站规则库重新获取最新地址。如果只是临时不可达，可先启用本地备份规则并等待远程恢复。
后台更新失效或打开时更新未触发？
设置检查清单：
- 进入 Shadowrocket → 设置 → 确认“打开时更新”与“自动后台更新”均已开启。
- iOS 系统设置 → Shadowrocket → 允许“后台应用刷新”。
- 如果仍无效，手动左滑订阅条目并点击“更新”。
多设备间配置不一致如何同步？
目前最可靠的方式是使用同一份远程配置文件链接。在一台设备上修改并导出配置，上传至可访问的服务器，其他设备通过订阅该链接自动同步。不建议通过 iCloud 直接同步应用数据，容易导致版本冲突。