Shadowrocket如何排查DNS与规则导致的访问问题

核心结论是先核对 DNS 解析策略是否被 Shadowrocket 拦截或走代理，其次检查规则分流是否误将目标域名指向错误的节点，逐步禁用/调整规则并清理缓存，结合日志与 DNS 测试定位问题位置，最终在不同网络环境复现验证。

Shadowrocket DNS排查全流程

准备工作与信息收集

• 短语：在此阶段完成对网络状态、设备信息、应用配置、代理状态等的详细记录，并标注具体时间点与操作环境，确保后续对照规则和 DNS 行为时能快速定位异常点，避免因偶发网络波动导致错误判断。
• 短语：记录 Shadowrocket 的版本、规则集来源、DNS 模式、是否开启分流、以及当前网络环境的变化，建立基线以便后续对比，减少重复排查的成本与时间。
• 短语：建立测试清单，明确需要验证的域名、代理服务器、DNS 服务器与网络条件，确保每一步可追溯并可重复验证，避免单点故障误导分析。

检查 DNS 设置与代理状态

• 短语：核对当前 DNS 模式（直连、代理、自动）和分流规则是否一致，若 DNS 请求在本地解析后再走代理，需确认是否与目标站点的路由策略相符，以避免解析结果被缓存或被错误路由所影响。
• 短语：验证 Shadowrocket 的代理开关是否在测试期内保持开启、关闭状态的一致性，排查应用内开关与系统代理设置之间是否产生冲突，确保 DNS 请求不会绕过预期路径。
• 短语：检查规则文件的最近修改时间、来源以及校验和，确保生效的规则版本与日志所指向的一致，避免引用过期或未生效的规则集导致的访问异常。

Shadowrocket 规则排查基础

核对规则优先级与命中日志

• 短语：分析规则的匹配优先级，确保前端的域名/路径模式没有被后续规则提前覆盖，结合命中日志确认实际走向与预期是否一致，必要时临时调整规则的顺序以验证影响。
• 短语：查看日志中对目标域名的命中情况，尤其是包含 DNS 结果与分流回路的条目，判断是否存在多重转发导致的递归或错配现象，及时纠正指向。
• 短语：根据命中日志对比同域名在不同网络条件下的行为，记录不同场景下的走向差异，帮助定位是否为规则覆盖导致的不可达或错误路由。

别名与域名模式是否匹配

• 短语：检查是否使用了域名别名、通配符或正则表达式等高级匹配方式，确保目标域名的模式能被正确识别并落到正确的规则分组，避免误匹配造成的请求错配。
• 短语：验证是否存在多个域名以相似前缀开始的情况，排查是否因为模式的粒度不够导致误拦截或漏报，必要时调整模式粒度以提升准确性。
• 短语：确认是否有中间件或中转节点对域名进行额外处理，排查是否存在第三方 DNS 改写、缓存污染等环境因素影响域名解析结果。

DNS 解析与分流诊断

分析 DNS 服务器返回结果

• 短语：对比在 Shadowrocket 内部与系统 DNS 解析返回的 IP、CNAME、TTL 等数据，排查缓存污染或 DNS 劫持的可能性，确保解析结果与实际期望一致。
• 短语：记录不同解析源（本地、上游、代理）的响应时间和成功率，定位是否某一源在特定域名上表现异常，进而确定是不是解析源的差异导致的访问问题。
• 短语：检测域名解析是否因为代理导致分流而改变了返回的端点，必要时在同一设备上使用独立 DNS 客户端比对结果，找出差异点。

测试多 DNS 服务器对比

• 短语：在不同 DNS 服务器（如本地缓存、公共 DNS、运营商 DNS）之间进行对比测试，记录每次解析的最终结果、走向与可达性，以揭示可能的解析偏差。
• 短语：通过手动清理本地 DNS 缓存、刷新域名并重复解析，观察结果是否随缓存状态变化，以判断缓存的影响权重。
• 短语：将测试域名替换为等效测试域名进行验证，避免真实域名的特殊策略对结果造成干扰，确保排错路线的可重复性与透明性。

网络环境与缓存影响

排查本地缓存与系统代理

• 短语：清理本地 DNS 缓存及应用缓存，重启 Shadowrocket 与相关服务，排除缓存无意导致的解析错误或路径错乱，确保重新缓存后的结果真实反映当前规则。
• 短语：对比系统代理设置与应用代理策略，排除二者不一致导致的请求走向异常，尤其是在 iOS 与 Android 平台上代理接口实现差异。
• 短语：验证是否存在跨应用共享代理的场景，若有需单独对 Shadowrocket 的代理策略进行独立设置以避免干扰。

跨网络环境复现与对比

• 短语：在家用 Wi-Fi、移动网络、企业网等不同环境中重复关键测试，记录每个环境下的 DNS 结果、分流路径及可达性，判断环境因素对故障的贡献度。
• 短语：使用同一规则集在多设备上执行对比，观察是否存在设备特异性问题，便于快速锁定原因是在设备端还是在云端/网络端。
• 短语：开启/关闭特定规则组的对比实验，确认是否某一组规则导致跨网络的不可达情况，以及规则切换时的回滚策略。

高阶排错与复现验证

启用调试日志并解读分流

• 短语：开启 Shadowrocket 的调试日志，结合 DNS 请求与分流决策的时间线，逐条解读每次命中与转发的逻辑，定位异常的具体节点。
• 短语：将日志导出为可分析格式，使用时间戳对比不同网络或不同规则版本的行为差异，缩小排错范围，避免凭直觉判断。
• 短语：对比日志中的错误码、返回值及代理节点信息，整理成可重复的排错脚本，提升团队协作效率。

综合排错步骤与验证结果

• 短语：将所有排错步骤串联成一个可执行的清单，按优先级执行、逐步回滚，确保每一步都能产生可验证的结果以支撑最终结论。
• 短语：在完成排错后对关键域名重新进行端到端的测试，确保问题不再复现，并对比故障前后的网络性能指标以评估影响。
• 短语：最终整理成一份文档，包含问题根因、修复过程、配置变更、回归测试和后续监控建议，便于日后快速参考。