规则匹配
将条件与策略写在同一行。
Shadowrocket 是全平台规则代理客户端:导入已有的服务器或订阅,按规则分流;iPhone / iPad 在 App Store $2.99 一次性买断,Mac、Windows、安卓、Linux 版免费。
当前安装包版本 v2.2.92 · iPhone / iPad $2.99 一次性;Mac、Windows、安卓、Linux 版免费。
将条件与策略写在同一行。
使用已有链接;下方为假值。
连接时机与流量策略分开设置。
CONFIGURATION
先区分三个对象:服务器信息决定连接到哪里,配置文件决定请求走哪条路径,连接开关决定客户端是否接管流量。遇到故障时,按这个顺序逐项核对,比同时修改多个设置更容易确定原因。
RULE ROUTING
在 Home 的 Global Routing 选择 Config 后,客户端按当前配置文件逐条检查规则。具体域名的例外应写在更宽泛的规则之前,未命中前序条件的请求再交给末尾的 FINAL。临时比较连接行为时,可以切换到 Proxy 或 Direct,分别对照代理与直连的结果。对照结束后切回 Config,再确认当前选中的文件;否则即使规则已经保存,测试的也不是这份规则。
ON DEMAND
在 Settings 打开 On Demand,核对希望触发连接的网络条件。按需连接解决的是何时启动,不能代替 Global Routing 决定请求经代理还是直连。建议先在当前网络手动连通,再切换到需要测试的网络,观察触发结果。如果手动可连而自动连接不符合预期,先查看条件是否覆盖当前网络,并确认系统里实际启用的是哪份 VPN 配置,不要先改服务器参数。
PROTOCOLS
在 Add Server 先设置 Type,再按已有服务器信息填写 Host、Port 和所选协议要求的字段。不同类型需要的身份验证信息不同;某个字段在切换类型后消失,不表示信息丢失,而是当前类型可能用不到它。若复制后不能连接,逐项核对协议、主机、端口与凭据,并检查首尾有没有多余空格。不要用反复切换协议的方式猜测服务端配置。
SUBSCRIBE
已有订阅地址时,在 Add Server 选择 Subscribe,完整粘贴从服务商处取得的地址并保存。回到 Home 检查对应分组是否出现,以及准备使用的条目是否仍在列表中。订阅更新成功只说明客户端取到了列表,不代表每台服务器都可达。若更新失败,先分别检查地址是否完整、当前网络是否可用、链接是否已被替换。分享故障截图前,遮住地址中的查询参数和凭据。
CONFIG & DIAGNOSTICS
在 Config 确认选中的配置文件,编辑前保留一份可恢复的原配置。有多台设备时,可按应用中的 iCloud 设置核对可同步的项目,不把同步当作配置备份。连接异常时,在 Home 用 Connectivity Test 检查服务器,再看 Data 的流量统计和 Settings 中的 Diagnostics。流量增加只说明有请求经过客户端,不能据此判断某个目标命中了哪条规则。
先看 Global Routing 是否为 Config,再看 Config 里的当前选中项。若两处正确,记录实际访问的主机名,不要只看地址栏最后显示的域名;页面内容可能来自其他主机。检查目标规则之前有没有更宽的匹配条件,以及未匹配时交给了哪项策略。每次只改一处,用同一网络和同一目标复测,确认变化来自规则而不是网络切换。
先暂时关闭 On Demand,在当前网络手动连接一次。手动连接正常,再启用 On Demand,用同一台设备切换到明确需要触发的网络。记录切换前后的连接状态,不要同时更换服务器或规则文件。如果仍不触发,核对系统中当前启用的 VPN 配置和应用内的触发条件。若手动连接也失败,先恢复基本连接,再检查自动触发。
在不改变分流配置的前提下,先确认设备本身可以正常联网,再用 Connectivity Test 检查选中的服务器。失败时回到 Add Server 对照已有参数,优先看 Type、Host 和 Port 是否对应同一条记录;最后再检查协议所需的认证字段。测试通过也不代表所有目标都可访问,仍要用实际访问结果验证。
先区分是无法更新列表,还是列表已更新但其中某条服务器无法连接。前者应核对完整订阅地址、当前网络以及服务商提供的链接状态,后者应检查选中的条目和服务器参数。旧分组还在时,先保留它作对照,不必在核对地址前删除;如果需要记录错误提示,只保留错误内容,隐去订阅地址、识别参数与服务器凭据。
从 App Store 恢复的是客户端,不是原设备上的全部配置。重新打开应用后,分别核对订阅分组、已保存的服务器和 Config 的当前选中项。如果此前启用了 iCloud 相关设置,先检查能够同步的项目是否已到达新设备;其余内容从保留的配置或原始信息恢复。先验证手动连接,再恢复按需连接条件。
PLATFORM DOWNLOADS
iPhone / iPad 在 App Store $2.99 一次性;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费,安装包通过本站下载页的 /dl/shadowrocket/ 路径获取。以下入口先显示对应设备的选项,不会在点开卡片时直接启动安装。
购买前核对产品页和当前账号的商店;换机或重装时,从原购买账号的已购项目查找。两种设备可共用该笔购买,系统要求以 App Store 页面标注为准。
先打开「关于本机」,按显示的芯片或处理器类型选择对应的磁盘映像。下载页并列提供两个版本;如果更换了电脑,应以新设备显示的类型重新选择。
先在系统信息中核对设备与安装包的架构。若首次启动出现系统提示,确认来源是本站下载页,再对照安装说明处理;由组织管理的设备应先确认本机的安装权限。
核对设备架构后选择安装包。若内置浏览器无法开始下载,可改用系统浏览器打开下载页;系统要求授权时,先核对包来自本站,再按安装说明为当前来源处理权限。
先核对处理器架构,再按发行版的包管理方式选用相应格式。选择 AppImage 时,参照安装说明设置执行权限;使用软件包时,检查包管理器给出的依赖提示。
FIRST CONNECTION
以下步骤以 iPhone / iPad 的界面为例。先准备已有的服务器参数或订阅地址,并确认设备在未开启代理时能正常联网。这样如果首次连接失败,就能先排除设备本身没有接入网络的情况。
只有一台服务器的参数时,从 Home 进入 Add Server,核对 Type 后逐项填写,再保存并返回列表。有订阅地址时,则用 Subscribe 导入,让列表由订阅内容生成。两种方式都不需要重复添加同一条记录。保存后查看 SERVER 分组,确认选中的是这次准备用于测试的服务器,而不是上一次保留的条目。手动添加与订阅条目可能显示相近的名称,可以先按来源确认自己的选择;检查页面时不必把地址或凭据贴到公开位置。
Global Routing 模式需要按规则处理请求时,先在 Config 确认当前文件,再回到 Home 把 Global Routing 设为 Config。要判断故障是否与规则有关,可以在同一网络上选用 Proxy 和 Direct 进行对照。测试期间只改模式,不同时换服务器、配置文件或网络;若只有规则模式下的结果不同,就优先检查文件与匹配顺序。记录测试前采用的模式,结束后恢复日常设置,避免把临时选项当作之前的配置结果。
回到 Home 打开连接开关。首次出现系统 VPN 配置请求时,先确认请求来自当前打开的 Shadowrocket,再按系统提示授权。连接状态变化后,先做一次 Connectivity Test,再访问一个预期直连的目标和一个预期经过代理的目标。某项结果与预期不符时,记录网络类型、当前模式、配置文件和错误提示;不要把连接开关已打开当作业务验证通过。若两个目标都失败,可以暂时断开后复测同一目标,先判断基本网络是否也受影响。
STORE VERIFICATION
打开 Shadowrocket 的 App Store 产品页,先核对开发者是 Shadow Launch Technology Limited,再对照白底、蓝紫描边的官方图标,最后检查产品页链接里的 id932747118。搜索结果中的名称和图标可能相似,中文别称「小火箭」也不能作为购买凭据。核对时以产品详情为准,不只看列表摘要。开发者名与应用 ID 应来自同一个产品页;有任一项对不上,就不要把该条目当成本手册所述的应用。
应用是否显示与当前账号使用的 App Store 店面有关,不应只看设备的语言或系统地区。搜索不到时,先通过产品页核对是否有店面可用性提示,再打开 Apple 账号的「媒体与购买项目」,检查当前用于获取应用的账号与国家或地区。中国大陆店面不提供该条目;打开美区产品页仅用于核对,不会自动改变账号的店面。若店面可用但无法下载,再检查设备限制与兼容性;iPhone / iPad 的系统要求以 App Store 页面标注为准。需要进一步区分提示时,参见App Store 指南。
iPhone / iPad 在 App Store 美区 $2.99 一次性买断,各店面以当地显示为准;Mac、Windows、安卓、Linux 版免费。同一笔购买可供 iPhone 和 iPad 使用,不需要按设备分别购买。换机或重装时,用原购买账号打开 App Store,进入已购项目,找到 Shadowrocket 后重新下载。若出现价格而不是重新下载入口,先核对购买账号与店面,不必立即下单。重新下载恢复的是应用本身;已有订阅、手动添加的服务器和本地规则仍需按各自的同步或备份状态核对。
因此,应用可以正常打开,并不说明已有服务器仍可用;反过来,订阅一时无法更新,也不能据此判断购买记录有问题。遇到连接异常时,先分清是在获取应用、导入资料,还是访问目标时出现提示。应用获取问题看商店或安装入口;已有服务的信息变动按原服务记录核对;模式和规则问题回到 Home 与 Config 逐项检查。
iPhone 和 iPad 在 App Store 查看更新,可沿用系统的自动更新设置。Mac、Windows、安卓和 Linux 从本站下载页重新获取对应安装包,不必以文件名相似作为版本或来源判断。更新前记下正在使用的模式和配置文件,保留必要的本地备份;更新后先手动连接一次,再核对订阅更新、规则分流和 On Demand 是否仍按预期工作。若系统弹出安装提示,先核对下载来源,再查看下载页对应平台的安装说明,不要对来源不明的文件放行。
READING NOTES
按当前问题选读:域名偶发打不开,先看解析路径;拿到链接却不知道放在哪里,先辨认链接类型;只有分流结果不符时,再查规则的匹配条件和顺序。
说明系统 DNS、自定义 DNS、DNS over HTTPS 三种方式的解析路径与适用场景,以及域名解析异常导致连不上时的排查顺序。
拆解 ss://、vmess://、vless://、trojan:// 分享链接的结构,对比单条链接和订阅链接在导入方式与更新机制上的差异,所有示例均为假值。
讲清 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 各自匹配什么,规则自上而下的命中顺序,以及 PROXY / DIRECT / REJECT 的写法。