要正确使用Shadowrocket的预匹配功能，用户应先进入“设置-高级”面板找到预匹配开关将其开启，随后根据自身网络环境在预匹配IP列表中添加常用的私有地址段（如公司内网子网或固定公网服务IP），确认保存后即可生效。开启后，所有匹配预匹配列表的IP流量将直接绕过主规则引擎执行对应的路由动作，访问速度因省略规则匹配和DNS解析环节而显著提升。同时用户应认识到预匹配仅对IP地址有效且无法处理域名级分流，广告屏蔽和特定域名代理仍需依赖规则引擎中的精确规则，在实际使用中将预匹配定位为优化局域网访问和已知IP服务连接的加速器而非完整的分流解决方案。
预匹配功能的技术原理与定位
在规则引擎之前建立流量预筛选层
预匹配是Shadowrocket中一项位于规则引擎前端的高级流量处理机制，它在配置文件中的规则匹配流程开始之前就介入网络请求的初步筛选工作。当设备发出网络请求时，预匹配模块会基于IP地址段、端口号或目标域名的特定属性进行快速的粗颗粒度判断，将明显属于特定类别的流量提前分流出去，从而避免这些请求进入后续繁琐的规则引擎逐条匹配流程。这种前置处理层本质上是一个轻量级的快速通道，专门用于处理那些具有明确路由指向且无需复杂规则判断的流量类型。
预匹配与主规则引擎的处理时序差异
预匹配的执行时机早于配置文件中所有规则，包括DOMAIN-SUFFIX精确规则和GEOIP批量规则，这意味着通过预匹配处理的流量完全不会经过规则引擎的匹配消耗。如果某个请求在预匹配阶段被成功匹配并分配了路由策略，该请求将直接执行该策略并绕过规则列表中全部规则的检查，后续的规则内容对该请求完全失效。这种时序上的绝对前置性使得预匹配成为整个分流链条中优先级最高的决策层，其处理结果具有不可被后续规则覆盖的最高权重。
预匹配作为性能优化工具的核心价值
预匹配功能的设计初衷是提升Shadowrocket在高负载网络环境下的处理效率，通过提前筛选出大量具有确定路由特征的流量来减少规则引擎的匹配工作量。在处理数百条甚至上千条规则的复杂配置时，每个请求都需要遍历大量规则条目才能找到匹配项，这种重复性的计算消耗会随着请求数量的增加而显著累积。预匹配通过在前面拦截一大部分规则可预测的流量，让规则引擎只需要处理剩余的不确定流量，从而大幅缩短了整体的匹配处理时间。
预匹配对局域网和私有地址的优化处理
内网流量的超快速直连通道
处理局域网流量是预匹配最具实用价值的应用场景之一，当设备访问家庭路由器、NAS存储设备、网络打印机或局域网内其他设备时，这些请求的目标IP地址都属于私有地址段（如192.168.x.x、10.x.x.x）。预匹配功能允许用户在规则引擎之前就为这些私有地址段建立专门的直连规则，当系统检测到目标IP属于预定义的局域网段时，流量直接通过本地网络发出而不经过任何代理通道和规则匹配。这种处理的响应速度远快于通过规则引擎匹配IP-CIDR规则，因为在预匹配阶段完成分流意味着完全绕过了后续的全部规则检查流程。
避免内网请求被代理通道错误转发
在没有启用预匹配的情况下，如果配置文件中的IP-CIDR规则因排序靠后或被GEOIP规则提前拦截，内网请求可能错误地进入代理通道导致无法访问本地设备。预匹配通过在处理流程的最前端强制执行局域网直连策略，从源头上杜绝了内网请求被误转发到代理节点的可能性。这种强制执行不依赖于配置文件中规则的排列顺序，也不受FINAL兜底策略的影响，为用户访问局域网资源提供了最高的可靠性和确定性。
私有地址段预匹配的默认配置与调整
Shadowrocket在预匹配功能中默认包含了标准的私有IP地址段，包括10.0.0.0/8、172.16.0.0/12、192.168.0.0/16以及本地回环地址127.0.0.0/8，这些默认配置覆盖了绝大多数家庭和办公网络的内网环境。用户可以在高级设置中查看这些预置的私有地址段，并根据自身网络环境的需要添加其他特定的内网段（如公司内部使用的特定私有子网）。默认配置已经能够满足绝大多数用户的内网访问需求，通常不需要用户进行额外的修改或扩充。
预匹配在DNS污染规避中的关键作用
在域名解析前拦截特定IP段的异常请求
当Shadowrocket处理一个包含域名的请求时，系统首先需要将域名解析为IP地址才能进行后续的路由判断，但在某些网络环境中DNS解析本身就存在被污染的风险。预匹配功能允许用户为已知的、不需要DNS解析的直连流量建立预匹配规则，这类流量在发出时直接基于目标IP地址进行路由决策而完全不需要触发DNS查询过程。当用户访问局域网设备或已知IP地址的外部服务器时，预匹配能够跳过DNS解析环节直接将流量直连，从根本上规避了因DNS污染而导致的解析错误和连接失败。
预匹配与DNS解析的时序关系
在预匹配启用的情况下，网络请求的处理顺序是先检查目标是否匹配预定义的IP地址段，然后再决定是否需要进入DNS解析流程。如果目标地址已经在预匹配规则中被判定为直连流量，系统会直接通过本地网络发出请求而不执行任何域名解析操作，这使得访问内网设备的速度大幅提升。相反，如果预匹配阶段未命中任何规则，请求才会进入正常的DNS解析和规则引擎匹配流程，此时需要面对可能存在的DNS污染问题。用户可以通过将频繁访问的内网设备IP预先加入预匹配列表，来确保这些请求在任何网络环境下都能稳定快速直连。
减少不必要的DNS查询以加速连接
当用户访问大量使用固定IP地址的内网服务或云服务器时，每次连接都需要进行DNS解析会引入不必要的延迟，特别是在DNS服务器响应较慢的网络环境中尤为明显。预匹配通过提前拦截这些基于IP的请求，让它们在不经过DNS解析的情况下直接完成路由选择并发出，将连接建立时间缩短到极致。这种优化对于需要频繁建立新连接的应用场景（如数据库访问、内部API调用）效果非常显著，能够将连接延迟降低数十毫秒甚至更多。
预匹配与主规则引擎的性能协同机制
通过预筛选降低主规则集的匹配深度
当预匹配规则成功匹配一个请求时，该请求会被立即分流并终止后续的所有规则处理流程，这意味着规则引擎需要遍历的规则数量被有效减少。在一个包含数百条规则的大型配置文件中，如果预匹配能够拦截大约30%的请求（主要是局域网和常见直连流量），这些请求就不再消耗规则引擎的遍历计算资源。随着预匹配拦截比例的提升，规则引擎整体的平均匹配深度会明显降低，应用处理网络请求的效率也随之稳步提高。
预匹配的缓存机制与匹配加速
Shadowrocket对预匹配规则的匹配结果进行了内存缓存处理，当相同目标IP的请求在短时间内重复出现时，系统会直接从缓存中读取上次的匹配结果而无需再次执行预匹配检查。这种缓存机制进一步放大了预匹配的性能优势，因为局域网设备之间的通信往往具有高度重复性，同一内网IP在数秒内可能产生数十次连接请求。缓存的存在使得预匹配的处理开销在第一次匹配之后几乎降为零，将性能优化效果最大化。
大流量场景下的负载缓解效应
当用户同时运行多个需要网络访问的应用（如在线游戏、视频会议、文件下载同时进行）时，设备会产生大量的并发网络请求，这些请求如果全部进入规则引擎逐个匹配将造成明显的CPU占用和响应延迟。预匹配通过在规则引擎前拦截大量可预测的流量，显著降低了高并发场景下规则引擎的峰值负载水平。这种负载缓解效应在资源受限的旧款iPhone上表现尤其突出，能够有效减少因规则匹配过载而导致的VPN连接不稳定现象。
预匹配配置项的具体设置与调整方法
在高级设置中启用预匹配功能
预匹配功能的配置入口位于Shadowrocket的“设置-高级”面板中，用户进入后需要在列表中找到“预匹配”或“PRE-MATCHING”相关的开关选项并将其启用。启用预匹配后，应用会激活内置的默认预匹配规则（主要是私有IP地址段），并在后续的所有网络请求处理中自动应用这些规则。用户在启用预匹配前无需对现有配置文件进行任何修改，因为预匹配是在规则引擎之外独立运行的附加层，不会影响现有配置文件的逻辑结构。
自定义预匹配IP地址段的添加方法
在预匹配设置页面中，用户可以点击“编辑预匹配列表”或类似选项进入IP地址段管理界面，在该界面中通过点击加号按钮添加新的IP段条目。添加时需要指定IP地址或CIDR格式的子网（如192.168.1.0/24），然后选择对应的策略动作（通常为DIRECT直连），保存后新规则即生效。建议用户将公司内部网络段、常用VPN网关地址或特定云服务器的固定公网IP加入预匹配列表，以享受这些流量绕过规则引擎的加速效果。
预匹配规则与配置文件的独立存储
预匹配规则独立于配置文件存储，即使更换了配置文件或订阅源，已经设置的预匹配规则仍然保持不变并继续生效。这种独立存储的设计使得用户可以在不同配置文件之间切换时保持预匹配规则的一致性，无需为每个配置文件单独配置预匹配参数。当用户清空应用数据或重置所有设置时，预匹配配置也会被一并清除，因此在执行重置操作前建议将预匹配列表的配置截图或导出保存。
预匹配功能启用后的注意事项与适用边界
预匹配无法处理域名级别的分流需求
预匹配基于IP地址段进行路由决策，这意味着它无法识别那些需要使用域名进行匹配的流量，因为域名需要在DNS解析后才能获得对应的IP地址。对于需要精确控制特定域名的分流需求（如指定openai.com走代理、指定baidu.com直连），预匹配完全无能为力，这些请求仍然需要进入规则引擎通过DOMAIN-SUFFIX规则进行匹配。用户应当将预匹配视为规则引擎的补充而非替代，两者协同工作才能实现完整的流量控制覆盖。
预匹配规则的适用范围限制
预匹配仅在目标地址为IP地址时才能生效，当请求的目标是一个域名且该域名尚未被解析为IP时，预匹配无法对该请求进行任何处理，会直接放行进入DNS解析和规则引擎流程。这意味着预匹配的优化效果主要集中在对已知IP地址的访问上（包括局域网设备和固定公网IP服务），对于大量基于域名的互联网访问，其性能提升作用相对有限。用户不应对预匹配寄予过高的优化期望，应根据自身实际的网络使用模式合理评估其价值。
预匹配启用后的调试与故障排查
启用预匹配后如果发现某些局域网设备无法访问或部分IP流量被错误路由，用户应首先进入预匹配的规则列表检查是否有冲突或错误的IP段配置。由于预匹配的处理顺序优先于规则引擎，预匹配阶段发生的路由错误无法通过调整配置文件中的规则顺序来修正，唯一的解决方法是直接在预匹配列表中修改或删除对应的IP段条目。在进行排查时可以临时关闭预匹配功能以验证问题是否确实源于预匹配配置，确认后再逐一调整有问题的条目。
常见问题FAQ
预匹配功能和配置文件中的IP-CIDR规则有什么区别？
预匹配在规则引擎之前执行，处理优先级远高于IP-CIDR规则且不经过规则列表遍历。预匹配适用于处理绝对确定的路由决策（如局域网直连），而IP-CIDR规则需要进入规则引擎参与优先级排序和匹配竞争，在处理速度上预匹配明显更快。
开启预匹配会影响我配置文件中已有的DOMAIN-SUFFIX规则吗？
不会。预匹配仅处理基于IP地址的流量，域名类请求仍需经过DNS解析后才会进入规则引擎匹配，因此配置文件中所有域名规则的功能和行为完全不受预匹配功能开启的影响。
预匹配能用来屏蔽广告域名吗？
不能。预匹配只针对IP地址段进行路由决策，无法识别域名信息，广告屏蔽需要基于域名的REJECT规则在规则引擎中完成。预匹配无法替代广告拦截规则的任何功能。
如何确认某个请求是否被预匹配拦截了？
打开Shadowrocket的实时日志功能，在日志输出中如果某条请求标记了“PRE-MATCH”或“预匹配命中”等标识，则说明该请求在预匹配阶段被处理。如果没有这些标识，则请求进入了正常的规则引擎匹配流程。