Shadowrocket 官方手册
Shadowrocket 名词解释
从界面上的英文词定位操作入口,从规则行里的字段判断请求如何处理。手边已有订阅或服务器资料时,可按名称对照;本手册不提供、不销售、不推荐此类资料。
界面与开关
先区分决定请求走向的选项、触发连接的开关,以及录入和测试入口。
- Global Routing
- 决定受客户端接管的请求按什么方式选择出口。Config(配置)按照当前配置处理,Proxy(代理)使用代理出口,Direct(直连)不经过代理服务器。排查某条分流规则时,先确认当前选的是 Config。
- On Demand
- 在满足所设条件时触发连接,适合需要按网络条件自动启动的场景。它决定何时连接,不负责判断单个请求走哪个出口。即使条件已满足,也仍需确认服务器本身可用。
- Add Server
- 用于添加已有服务器信息的入口。先选协议,再填写对应的地址、端口和认证项;不同协议出现的字段不一定相同。保存条目只表示资料已录入,并不代表客户端已连通服务器。
- Connectivity Test
- 检查客户端在当前网络下能否通过指定路径完成测试。结果中的耗时只反映这一次测试的条件,不能换算成文件下载速度。比较结果时,应尽量保持测试目标、网络和测试方式一致。
代理协议
协议描述客户端与服务器如何通信。录入时以已有资料为准,不根据端口或名称猜测协议。
- Shadowsocks
- 使用对称加密的代理协议,配置资料通常包括服务器地址、端口、加密方法和密码。端口可达并不代表连接一定成功;加密方法或密码与服务器不一致时,仍无法正常交换数据。
- VMess
- 带身份验证的代理协议,常用 UUID 标识用户。录入时还应核对实际使用的传输方式及相关字段,不能只凭 UUID 判断两条配置能否互换。验证失败时,先与原始资料逐项比对。
- VLESS
- 将身份校验与传输保护分开配置的代理协议。即使资料中同样有 UUID,也不能把 VMess 条目仅改协议名后直接复用。传输方式和安全参数应与对端保持一致。
- Trojan
- 通常通过 TLS 传输并使用密码认证的代理协议。连接失败时,应分别核对认证资料和 TLS 所需的服务器名称。证书名称不匹配与密码错误属于不同问题。
- Hysteria2
- 以 QUIC 为传输基础的代理协议,依赖网络能够传递 UDP 流量。普通网页可访问,并不代表相同网络下的 QUIC 连接也可用。排查时可记录故障是否只出现在某一种接入网络。
- WireGuard
- 以公钥标识对端并经 UDP 传输的加密隧道协议。配置中用于识别对端的公钥,与本机必须妥善保管的私钥不是同一字段。分享排查记录时,应移除私钥等敏感资料。
规则关键字
规则行开头的关键字决定用什么条件做匹配;行末的策略决定命中后如何处理。
- DOMAIN
- 匹配完整域名。条件写成
example.com时,不会因此匹配www.example.com,也不用于判断 URL 路径。只需改变一个确定主机名的处理方式时,可选用这类精确条件。
- DOMAIN-SUFFIX
- 匹配指定域名及其子域名。以
example.com为条件时,可以匹配img.example.com,但不会匹配notexample.com。若某个子域名需要例外处理,应把对应的精确规则放到后缀规则之前。
- IP-CIDR
- 把目的 IPv4 地址与指定网段比较,例如
192.0.2.0/24。斜线后的位数是前缀长度,不是端口号。请求最初以域名表示时,要结合地址是否已解析以及规则参数判断匹配结果。
- GEOIP
- 根据地址库记录的目的 IP 地区分类做匹配,不是根据网页内容使用的语种、域名后缀或设备所在地判断。一个域名可能在不同网络解析到不同地址,因此同一域名并不总是命中同一地区条件。
- FINAL
- 为前面规则均未命中的请求指定兜底策略。它不需要额外的域名或地址条件,例如
FINAL,DIRECT。将它放在需要优先判断的规则之后,避免较早结束匹配。
策略与匹配顺序
界面里的 Proxy、Direct 是 Global Routing 选项;规则里的 PROXY、DIRECT 则是单条规则的处理策略。
- PROXY
- 将命中的请求交给代理出口处理。规则命中只说明出口已经选定,不表示代理服务器能够连通目标。如果诊断记录显示已命中而请求仍失败,下一步应检查所用服务器和目标的可达性。
- DIRECT
- 命中的请求直接使用当前网络连接目标,不经代理服务器。直连不是跳过 DNS 查询,也不等同于关闭客户端;启用规则处理时,客户端仍可通过规则为不同请求选择不同路径。
- REJECT
- 拒绝已进入客户端处理且命中该策略的请求。规则只处理满足条件的流量,并不会识别网页中的每个内容元素。选用宽泛的后缀条件前,应确认它不会一并拦截同域下需要保留的服务。
- 匹配顺序
- 按配置顺序检查规则,以先命中的一条为准,而不是找出全部匹配项后选最具体的一条。若宽泛的后缀规则挡在精确域名规则前面,应先调整顺序,再用同一个目标验证结果。
阅读规则时,先找第一个逗号前的匹配类型,再看最后的策略。例如
DOMAIN-SUFFIX,example.com,PROXY表示:域名后缀匹配example.com时,使用代理出口。
订阅与配置文件
订阅用来获取已有服务器列表,配置文件用来描述请求如何处理。更新列表不等于切换分流规则。
- Subscribe
- 导入已有订阅地址并读取其中的服务器条目。列表刷新后,应重新确认当前所选条目仍存在且参数符合预期。订阅地址可能包含访问凭据,提交故障记录时不要附上完整链接。
- Config
- 作为页面入口时,用于查看和管理配置文件;出现在 Global Routing 中时,表示按当前配置处理流量。编辑了一个文件,并不意味着它已被选用。验证规则前,应核对实际启用的是哪份配置。
- DNS
- 用于查询域名记录,连接请求常借此取得目标地址。域名查询和连接目标是两个环节,能查到地址不表示目标一定可达。排查地址型规则时,应关注实际取得的地址,而不是仅查看输入的域名。
- URL Rewrite
- 对可识别的 URL 按条件执行改写等操作,与规则里选择请求出口是不同的任务。URL 可能包含路径和查询参数,域名条件并不能区分这些部分。编写条件前,应先确认客户端在当前场景能看到哪些请求信息。