在Shadowrocket中开启并使用日志功能时，标准的操作路径是点击底部导航栏的“日志”标签进入实时日志面板，根据需要点击面板顶部的“暂停”或“清空”按钮控制日志的收集状态，并在设置页面中将日志级别调整为“信息”以获得平衡的详细程度。当遇到节点连接失败或规则分流异常时，在操作的同时观察日志面板的实时输出，通过颜色编码快速识别红色错误条目并解读其描述信息中的具体错误类型（如超时、连接拒绝或证书错误），长按复制关键错误信息或通过分享按钮导出完整日志文件用于后续分析和反馈。在公共场所完成故障排查后应立即切换出日志标签页并清空历史日志以防窥屏风险，日常使用中将日志级别恢复至“警告”或“信息”以平衡可维护性与隐私保护。
日志功能的界面入口与开启步骤
主界面实时日志面板的直接访问
Shadowrocket的日志功能入口位于应用主界面的最底部导航栏中，用户只需点击底部标签栏中的“日志”图标（通常显示为文档或列表形状的按钮），即可立即进入实时日志查看面板。进入日志面板后，日志记录功能会自动激活并开始捕获当前VPN连接中的所有网络请求，包括DNS解析过程、规则匹配结果、策略组选择详情以及连接建立状态等完整信息流。用户无需进行任何额外的开关设置或配置调整即可开始查看日志，因为该面板的日志记录默认在进入时自动开启。若希望停止记录或清除当前日志内容，可在面板顶部点击“暂停”或“清空”按钮来控制日志的收集行为，这种随时可控的设计既方便了用户按需查看又避免了历史日志堆积造成的界面干扰。
设置页面中日志级别的全局调整
进入Shadowrocket的“设置”页面后，向下滑动找到“日志”或“高级”选项区域，用户可以看到一个用于控制日志详细程度的开关或下拉菜单。该设置允许用户选择日志的记录级别，常见的选项包括“错误”、“警告”、“信息”和“调试”四个级别，级别越低记录的内容越详细，级别越高则仅记录严重事件。当用户仅需查看节点连接状态时，保持默认的“信息”级别即可获得平衡的详细程度；当用户正在排查复杂的规则匹配或连接握手失败问题时，应切换至“调试”级别以获取最完整的底层网络请求数据包信息。设置页面中的级别调整会影响日志面板中显示的内容粒度，但不会影响日志功能的开启或关闭状态，即使将级别设置为“错误”，日志面板依然会在有错误事件发生时主动显示相关内容。
通过下拉手势快速呼出日志浮窗
在Shadowrocket主界面的任何标签页中，用户都可以通过从屏幕顶端向下拉动的全局手势快速呼出一个轻量化的日志浮窗，该浮窗悬浮在当前界面上方并实时滚动显示最新的日志条目。这种快捷访问方式无需切换到日志标签页即可快速查看当前的网络请求匹配状态，特别适合在访问某个网站遇到问题时即时查看规则匹配结果而无需打断当前的操作流程。浮窗顶部配有“最小化”和“关闭”按钮，用户可以将其缩小为一个悬浮气泡在后台持续运行，当需要重新查看时点击气泡即可重新展开日志内容。
日志面板的界面布局与信息解读
日志条目的时间戳与颜色编码
日志面板中的每一条记录均包含精确到毫秒的时间戳、日志级别标识和具体的描述文本三个核心组成部分，时间戳帮助用户将日志事件与实际操作的时间线进行关联匹配。不同严重级别的日志条目采用差异化的颜色编码进行区分，信息级别的日志通常以白色或灰色显示，警告级别以黄色或橙色标注，错误级别以红色突出显示，这种视觉编码让用户能够快速从大量滚动日志中定位关键问题。颜色编码的规范使得即使是初次接触日志功能的用户也能直观理解当前网络状态是否存在异常，红色错误条目密集出现时意味着存在较严重的配置或网络故障，应立即暂停使用并进行排查。
规则匹配结果的日志输出格式
当用户访问某个网站或应用发出网络请求时，日志面板中会按照配置文件中的规则顺序逐条输出每个规则的匹配尝试过程，最终显示命中的规则行号、规则类型和执行的策略动作。例如，日志中显示“DOMAIN-SUFFIX,google.com,PROXY (matched rule #12)”表明该请求在规则列表的第12行成功匹配了google.com的域名后缀规则并执行了代理转发。通过观察日志中的规则匹配输出，用户可以清晰验证自己的分流规则是否按照预期的顺序和逻辑被执行，当发现某个域名的实际匹配规则与预期不符时，日志能够帮助快速定位是哪一条规则提前拦截了流量。
连接建立与DNS解析的详细日志
除了分流规则的匹配信息外，日志面板还会输出每个网络请求的DNS解析结果、TCP连接建立状态、TLS握手详情以及代理协议的认证过程等底层连接信息。当节点连接失败时，日志中会出现具体的错误描述，例如“dial tcp 1.2.3.4:443: i/o timeout”表明与节点服务器的TCP连接超时，“x509: certificate is valid for domainA, not domainB”表明TLS证书的SNI字段与节点域名不匹配。这些底层连接日志是排查节点可用性问题的核心依据，远比任何外部的直观猜测更为准确和有针对性。
日志功能在实际故障排查中的应用
节点连接失败时的日志解读方法
当用户点击节点连接后发现代理通道无法建立时，立即打开日志面板查看最新的日志条目，错误信息通常显示在日志列表的最后几行。若日志中出现“connection refused”，表明节点服务器拒绝了当前端口的连接请求，原因可能是端口号填写错误或服务器端代理服务未运行；若日志中出现“timeout”，则表明数据包在网络传输过程中被丢弃或节点IP地址不可达，通常与本地防火墙或运营商封锁有关。根据日志中的具体错误信息制定针对性的解决方案，远比盲目更换节点或重启应用更为高效，能够在几分钟内准确定位故障根源。
分流规则误判时的日志回溯技巧
当用户发现某个网站意外走代理或直连时，在浏览器中打开该网站的同时观察日志面板的实时输出，日志中会显示该域名在规则列表中的完整匹配过程。如果日志显示某个域名匹配到了不正确的规则行，用户可通过日志中的规则行号快速定位配置文件中的对应条目，检查该规则的匹配条件和策略动作是否配置有误。如果日志中显示该域名未匹配任何前置规则而是由FINAL兜底策略处理，则说明配置文件中缺少针对该域名的精确规则，需要新增一条规则并将其放置于合适的位置以确保后续能够正确命中。
DNS解析异常的日志特征识别
当Shadowrocket的DNS配置出现问题时，日志中会频繁出现“DNS lookup failed”或“no such host”等解析失败记录，表明设备无法将目标域名转换为IP地址进行后续通信。这类问题通常源于DNS服务器列表中的服务器全部不可达，或DNS劫持功能将请求重定向到了不可用的目标服务器。查看日志中显示的DNS服务器地址是否与用户配置的DNS服务器列表一致，若日志显示解析请求发往了未知的DNS地址，则说明劫持功能正在生效但目标可能不正确，需要返回DNS配置页面检查劫持目标的IP地址和端口号的可达性。
日志信息的导出与持久化存储
长按日志条目复制关键错误信息
在日志面板中，用户可以通过长按任意日志条目触发复制功能，将该条完整的内容拷贝到设备的剪贴板中，方便粘贴到备忘录或通讯工具中进行保存和分享。当用户需要向技术社区或节点服务商反馈问题时，复制完整的错误日志能够使对方快速理解问题的具体表现，大幅提高沟通效率和问题解决的准确性。复制操作仅复制单条日志内容而非整个日志列表，用户应当选择包含关键错误信息的那条记录而非全部复制，避免信息过载导致对方无法快速提取有效内容。
通过系统共享功能导出完整日志文件
Shadowrocket内置了日志导出功能，用户可以在日志面板中点击分享按钮（通常显示为矩形带箭头的图标），系统会生成一个包含当前日志面板所有内容的纯文本文件并提供隔空投送、邮件和云存储等多种分享渠道。导出完整日志文件对于需要将故障信息发送给服务商技术支持或开发者进行深度分析时尤为有用，因为完整的日志包含了从VPN启动到当前时间点的全部事件序列，能够提供比单条错误信息更为全面的上下文背景。导出的日志文件中不包含节点的密码或订阅链接等敏感信息，但用户仍应在发送前审查日志是否包含了不必要的隐私信息。
日志文件自动轮转与存储空间管理
Shadowrocket的日志记录功能会持续将日志数据缓存在内存中直至用户手动清空或重启应用，长时间运行后累积的日志内容可能占用大量内存并导致应用响应变慢。用户应养成每次故障排查完成后点击日志面板中的“清空”按钮清理历史日志的习惯，避免无关的历史日志内容干扰后续的排查工作。当日志文件过大时，应用会在后台自动轮转日志缓存，保留最近约500条记录并丢弃更早的内容以防止内存溢出，因此如果用户希望长期保存某次故障的详细日志，必须在问题发生时立即导出而非等待数日后再进行。
日志隐私保护与使用安全建议
日志中可能包含的敏感信息类型
Shadowrocket的日志在输出规则匹配和连接建立信息时，可能会暴露用户正在访问的域名、DNS查询记录以及节点服务器的IP地址和端口号，这些信息虽然不包含密码或Cookie等直接凭证，但长期累积的访问记录仍能勾勒出用户的上网行为画像。用户在截图或导出日志与他人共享时，应当先审查日志内容中是否包含不希望公开的访问记录，必要时使用图像编辑工具对敏感内容进行马赛克覆盖处理。对于个人设备而言，定期清理日志历史是维护数字隐私的一项基础但必要的习惯。
公共场所使用后及时关闭日志功能
当用户在咖啡厅、图书馆或公司等公共场所使用Shadowrocket时，应避免长时间开启日志面板或将日志浮窗保持在屏幕可见区域，因为旁人有视线接触屏幕的风险。在完成故障排查后，建议立即切换出日志标签页或关闭日志浮窗，使应用回到节点列表或配置页面等不直接显示敏感信息的界面。锁屏前如果日志面板处于开启状态，应在解锁后先清空日志内容再进行其他操作，防止他人通过窥屏获取日志中的域名访问记录。
日志级别与隐私风险的平衡
将日志级别设置为“调试”会输出最为详尽的网络请求信息，包括每个数据包的头部信息和完整的握手过程，这些信息在排查复杂问题时不可或缺，但也意味着更多的隐私数据被记录在应用的内存中。在完成调试和问题修复后，用户应将日志级别从“调试”回调至“信息”或“警告”，既能减少不必要的隐私暴露范围，也能降低日志记录对设备性能和电池续航的微小消耗。日常使用中保持较低的日志级别是平衡可维护性与隐私安全的合理选择。
常见问题FAQ
日志面板中没有任何内容显示，怎么办？
首先确认Shadowrocket的VPN连接处于激活状态，因为日志仅在VPN隧道运行且有网络流量通过时才会产生记录。若VPN已连接但仍无日志，检查设置页面中的日志级别是否被设置为“关闭”或“错误”，适当降低级别至“信息”即可恢复正常输出。
日志记录过多导致界面卡顿，如何快速清理？
点击日志面板顶部的“清空”按钮可以立即清除所有历史日志内容并释放内存资源，清空后新的日志记录将重新开始累积。若清空后仍然卡顿，可尝试退出日志面板切换至其他标签页等待数秒后再切回。
导出的日志文件怎么打开查看？
导出的日志文件为纯文本格式（.txt），可以在iPhone上使用系统自带的“文件”应用或任何文本编辑器打开查看，也可通过隔空投送传输至电脑使用专业文本编辑器进行搜索和分析。文件编码为UTF-8，兼容主流操作系统的默认文本显示。
日志中的红色错误条目很多，但网络使用正常，需要理会吗？
不需要。某些红色错误条目可能来自应用尝试连接某些已被过滤或暂时不可用的资源（如统计服务或广告域名），这些请求被REJECT策略正常拦截并记录为红色，并不表示代理通道本身存在问题。只有当红色错误伴随实际的网络访问失败时才需要关注。