快速诊断流程
当Shadowrocket出现连接问题时，建议按以下顺序逐步排查，大多数问题可以在前三个步骤内解决。如果仍无法解决，可查阅后文的详细问题分类解决方案。
- 确认网络环境是否正常（能否访问普通网站）
- 检查Shadowrocket客户端是否为最新版本
- 尝试切换至其他节点
- 重启Shadowrocket客户端
- 重启计算机或重装客户端
问题一：订阅同步失败
❌ 订阅同步失败
症状表现：导入订阅链接后，节点列表为空或提示"订阅解析错误"，无法获取任何节点信息。
解决方案：
- 在浏览器中直接粘贴订阅链接，确认链接可访问并返回Base64或JSON格式数据
- 确认订阅链接未被机场商更改，部分服务商会在后台更换链接
- 清除Shadowrocket本地缓存：设置 → 订阅 → 清除缓存后重新导入
- 检查系统时间是否准确，TLS证书校验依赖正确时间
- 关闭杀毒软件或防火墙后重试（部分安全软件会拦截订阅请求）
问题二：节点连接超时
❌ 节点连接超时
症状表现：选中节点后一直显示"正在连接..."，等待30秒后提示"连接超时"或"无法连接到服务器"。
解决方案：
- 切换至其他节点尝试，同一订阅中的不同节点状态可能不同
- 联系机场客服确认节点是否在线，部分节点可能已被封禁
- 检查本地网络是否处于特殊网络环境（如公司内网限制）
- 尝试开启TLS混淆功能，部分协议在某些网络下需要混淆才能连接
- 使用"延迟测试"功能批量测速，选择延迟最低且稳定的节点
提示：一般延迟在200ms以内的节点体验较好，超过500ms建议更换。
问题三：代理已连接但无法访问外网
❌ 代理已连接但无法访问外网
症状表现：Shadowrocket显示"已连接"，但浏览器仍无法打开Google、YouTube等网站。
解决方案：
- 检查系统代理设置：确保浏览器或系统代理已指向Shadowrocket（127.0.0.1:1080）
- 确认是否开启了TUN/全局模式：PAC模式下部分网站可能不在代理列表中
- 尝试切换节点，部分节点可能仅能访问特定区域网站
- 清除浏览器DNS缓存或重启浏览器
- 确认节点是否为「拥抱审查」节点，部分节点仅覆盖国内流量
问题四：DNS泄漏
❌ DNS泄漏
症状表现：使用DNS泄漏检测工具（如ipleak.net）发现DNS请求来源为本地ISP，而非代理服务器。
解决方案：
- 开启Shadowrocket内置的DNS劫持功能：设置 → DNS → 启用本地DNS
- 启用TUN模式：设置 → TUN模式 → 开启（推荐）
- 配置DoH或DoT远程DNS：在DNS设置中选择可信DNS服务商
- 检查防火墙规则，确保所有DNS请求（UDP 53）被正确转发
推荐DNS：Cloudflare 1.1.1.1 / Google 8.8.8.8 / Quad9 9.9.9.9
问题五：macOS 提示"无法打开"或安全警告
❌ macOS 安全警告
症状表现：双击Shadowrocket后提示"无法打开，因为无法验证开发者"或"已损坏"。
解决方案：
- 前往"系统偏好设置 → 安全性与隐私 → 通用"
- 点击左下角锁图标解锁设置
- 选择"仍要打开"（如果出现此选项）
- 或在"允许从以下位置下载的应用"中选择"任何来源"
- 对于Apple Silicon Mac，还需允许系统扩展：系统偏好设置 → 隐私与安全性 → 网络扩展
问题六：Windows 下被杀毒软件拦截
❌ Windows 杀毒软件拦截
症状表现：安装或启动Shadowrocket时被Windows Defender或第三方杀毒软件拦截、删除或隔离。
解决方案：
- 将Shadowrocket安装目录添加到杀毒软件白名单
- 临时关闭实时防护后重新安装（安装完成后再开启）
- 如果文件被隔离，从隔离区恢复并添加例外
- 从Shadowrocket官方下载中心重新下载安装包确认文件完整性
问题七：启动后立即崩溃
❌ 启动后立即崩溃
症状表现：Shadowrocket可以正常启动但数秒后自动退出，或在启动时直接报错退出。
解决方案：
- 检查是否安装了不兼容的版本（如32位系统安装了64位版本）
- 确保系统满足最低要求：Windows 10 1903+ / macOS 11+ / Ubuntu 20.04+
- 删除配置文件后重试（配置文件通常位于用户目录的.shadowrocket文件夹）
- 查看日志文件定位具体崩溃原因，必要时联系官方技术支持
获取进一步帮助
如果以上方案均无法解决您的问题，建议通过以下方式获取帮助：
- 访问 Shadowrocket官方下载中心 下载最新版本
- 查阅 订阅配置指南 确认配置步骤正确
- 在社区论坛搜索相似问题，往往能获得有价值的解决方案
- 加入官方用户群，与其他用户交流使用经验