Shadowrocket日志查看与故障排查指南

在 Shadowrocket 中查看日志是排查连接失败、延迟高或节点切换异常最直接的手段。由于 iOS 系统的沙盒机制限制，日志信息主要存储在客户端内部或系统日志中，而非传统的本地文本文件。本文将详细说明如何通过客户端界面、系统日志以及外部辅助工具来查看和提取日志，并解释如何根据日志内容定位常见的配置或网络问题。

客户端内置日志功能

Shadowrocket 的客户端界面提供了基础的实时日志窗口，这是最快速的排查入口。

开启实时日志视图

默认情况下，日志窗口可能被折叠或隐藏在后台。要查看实时连接状态：
• 打开 Shadowrocket 主界面。
• 点击顶部导航栏中的“日志”图标（通常是一个文档或列表样式的图标）。
• 确保顶部的“实时”或“Live”开关处于开启状态。

此时，屏幕下方会显示滚动的日志流。当你在客户端中切换节点、刷新订阅或尝试访问网络时，日志会实时记录客户端与服务器之间的握手过程、DNS 解析结果以及代理规则匹配情况。

日志内容的解读逻辑

日志窗口中的信息通常包含时间戳、级别（如 Info, Warn, Error）以及具体的操作描述。理解这些字段有助于快速定位问题：

* DNS 解析记录：如果看到 `DNS lookup failed` 或 `DNS timeout`，说明客户端无法正确解析域名或 DNS 服务器响应超时。这通常与本地网络环境或 DNS 设置有关。
* 连接握手记录：若出现 `Handshake failed` 或 `Connection refused`，表明客户端与代理服务器之间的 TCP/TLS 握手失败。这可能是节点失效、端口被封或服务器端配置错误。
* 规则匹配记录：显示 `Rule matched: …` 表示流量被特定规则拦截或放行。如果预期走代理的流量显示为 `Direct` 或 `Reject`，则可能是规则配置有误。

导出日志文件

客户端内置的日志通常会在应用重启或缓存满时清空。若需保存日志供后续分析或提交给技术支持：
• 在日志界面，查找“导出”或“Share”按钮（通常在右上角或长按日志区域）。
• 选择通过邮件、AirDrop 或文件管理器导出 `.log` 或 `.txt` 格式文件。
• 将文件发送至电脑或其他设备进行详细分析。

注意：部分版本的客户端可能限制直接导出完整历史日志，仅支持导出当前会话的日志。若无法导出，需借助系统级日志工具。

通过 iOS 系统日志查看深层信息

Shadowrocket 作为 iOS 应用，其运行日志也同步写入 iOS 系统的统一日志系统（Unified Logging System）。通过系统日志可以查看更底层的网络栈信息、权限请求以及崩溃堆栈。

使用 Console 应用查看

iOS 设备自带“控制台”（Console）应用（在 iPadOS 上可能需通过 Mac 连接查看，或下载第三方 Console 应用）：
• 打开“控制台”应用。
• 在左侧设备列表中选择当前连接的 iPhone 或 iPad。
• 在搜索栏中输入 `Shadowrocket` 或 `Shadow` 进行过滤。
• 实时观察日志输出。当你在 Shadowrocket 中进行操作时，系统日志会记录相关事件。

日志分析要点

系统日志中的 Shadowrocket 条目通常包含更详细的技术参数：

* 权限请求：查看是否有 `VPN configuration` 或 `Network extension` 相关的权限拒绝记录。如果显示 `Permission denied`，说明应用未获得必要的网络扩展权限，需前往“设置”>“通用”>“VPN 与设备管理”中信任配置文件。
* 内核模式日志：Shadowrocket 支持多种内核模式（如 System Proxy、TUN 模式等）。系统日志会显示内核加载状态。若显示 `Kernel module load failed`，可能是内核模式不兼容或 iOS 版本限制，需切换回代理模式或更新应用。
* 崩溃报告：若应用闪退，系统日志中会包含 `Exception type` 和 `Backtrace`。这些堆栈信息对开发者定位代码错误至关重要，普通用户可将其提供给开发者以寻求帮助。

通过 Mac 或电脑远程查看日志

对于更复杂的故障排查，将 iOS 设备与 Mac 电脑连接，通过 Xcode 或第三方工具查看日志是更专业的方法。

使用 Xcode 设备日志

• 用数据线将 iPhone 连接到 Mac。
• 打开 Xcode，点击 `Window` > `Devices and Simulators`。
• 选择你的设备，点击 `Open Console`。
• 在搜索栏输入 `Shadowrocket` 或 `com.shadowrocket`（Shadowrocket 的 Bundle ID 通常为 `com.shadowrocket`，但具体可能因版本而异，可尝试搜索 `Shadow`）。
• 实时查看日志输出。Xcode 提供的日志更结构化，包含线程 ID、调用栈等详细信息。

使用 Wireshark 进行网络包分析

日志仅反映客户端行为，而网络包分析能揭示网络层的问题。Shadowrocket 本身不直接输出 pcap 文件，但可通过以下方式间接分析：
• 在 Mac 上启用网络共享：将 iPhone 的 Wi-Fi 或 USB 共享给 Mac。
• 在 Mac 上运行 Wireshark：捕获共享网卡的流量。
• 过滤代理流量：在 Wireshark 中过滤 Shadowrocket 相关的端口（如常见的 1080, 10808, 8080 等，具体取决于客户端设置）。
• 分析 TCP 握手和 TLS 记录：观察客户端与服务器之间的 TCP 三次握手是否完整，TLS 握手是否成功。若出现 `TCP Retransmission` 或 `TLS Alert`，则表明网络层或加密层存在问题。

注意：此方法需要一定的网络知识，且仅适用于分析客户端发出的流量，无法直接解密 HTTPS 内容（除非配置了中间人证书，但这涉及安全风险，不建议普通用户操作）。

常见日志错误及排查步骤

根据日志中出现的典型错误，可以归纳出以下几类常见问题及其排查方向。

日志错误关键词	可能原因	排查与解决步骤
`DNS lookup failed` / `DNS timeout`	本地 DNS 污染、DNS 服务器不可用、DNS 设置错误	1. 检查 Shadowrocket 的 DNS 设置，尝试更换为公共 DNS（如 8.8.8.8, 1.1.1.1）。 2. 检查本地网络是否允许 DNS 查询。 3. 尝试在客户端中启用“Fake IP”或“Redir Host”模式以绕过 DNS 污染。
`Handshake failed` / `Connection refused`	节点失效、端口被封、服务器宕机、协议不匹配	1. 刷新订阅，确认节点状态。 2. 尝试切换其他节点或地区。 3. 检查客户端协议设置（如 VMess, Trojan, Shadowsocks）是否与节点信息一致。 4. 检查是否有防火墙或安全软件拦截。
`Permission denied` / `VPN configuration`	权限未授予、配置文件损坏、iOS 系统限制	1. 前往 iPhone“设置”>“通用”>“VPN 与设备管理”，检查并信任配置文件。 2. 重启 Shadowrocket 应用。 3. 重新导入订阅配置。 4. 检查 iOS 版本是否过低，导致内核模式不支持。
`Rule matched: Direct` / `Reject`	规则配置错误、域名未匹配、策略组设置不当	1. 检查规则列表，确认目标域名是否在“直连”或“拒绝”列表中。 2. 检查策略组设置，确认流量是否被正确分配。 3. 尝试使用“全局模式”测试，若全局模式正常，则问题出在规则配置。
`Kernel module load failed`	内核模式不兼容、iOS 版本限制、权限不足	1. 切换代理模式为“代理”或“系统代理”。 2. 更新 Shadowrocket 至最新版本。 3. 检查 iOS 系统更新，确保系统版本支持当前内核模式。

日志查看的注意事项

在通过日志进行故障排查时，需注意以下几点以避免误判：
• 日志的时效性：日志是实时滚动的，若未及时记录或导出，信息会丢失。建议在复现问题时，提前打开日志窗口并滚动到底部，以便捕获新事件。
• 信息的局限性：日志仅反映客户端视角。若问题出在中间网络链路（如运营商劫持、路由丢包），日志可能仅显示超时，无法直接定位根源。此时需结合 Ping、Traceroute 等网络诊断工具。
• 隐私与安全：日志中可能包含域名、IP 地址等网络信息。导出日志时，注意保护个人隐私，避免将包含敏感信息的日志公开分享。
• 应用版本差异：不同版本的 Shadowrocket 日志格式和内容可能有所不同。若日志格式不清晰，可参考官方文档或社区资源，了解当前版本的日志规范。

通过以上方法，你可以有效地查看和分析 Shadowrocket 的日志，从而快速定位和解决网络连接问题。若问题依旧存在，建议将日志文件提供给技术支持或社区专家，以获得更深入的帮助。