Shadowrocket 官方手册

Shadowrocket 名词解释

界面上看到的是入口还是开关?配置里写的是条件还是动作?按分类查阅,也可分享单个术语的链接。

界面与开关

先区分连接是否开启,再看开启后使用哪种处理模式。

Home
主界面提供连接开关、服务器列表和当前状态。选中服务器只是指定可能使用的远端,连接开关关闭时不会因此建立连接。若开关已开启而访问行为与预期不同,再检查 Global Routing。
Global Routing
这是选择连接处理方式的设置。Config(配置)按当前配置匹配规则,Proxy(代理)经由选定的代理路径,Direct(直连)不经代理服务器。切换模式不会改写配置文件中的规则。
Config
同一个词有两个用途:作为界面入口,用于查看和管理配置文件;作为 Global Routing 的选项,表示按当前配置处理连接。导入文件后若要测试其中的规则,要同时确认启用的是哪份文件,以及当前选的是哪种模式。
On Demand
按需连接由系统在满足已设条件时发起,例如网络环境变化后重新评估是否连接。它控制何时建立连接,不负责决定某个域名走哪条路径。若手动断开后又自动连上,可先查按需条件,再检查分流规则。
Connectivity Test
连通性测试用一次测试请求观察当前网络与服务器组合是否可用。显示的耗时与测试方式、目标及当时的网络状况有关,不能换算成下载速度。测试成功也不代表配置里每条分流规则都已得到验证。

代理协议

协议决定怎样与远端通信。手动录入时,以已有的服务器参数为准。

Shadowsocks
客户端按约定的加密方法和凭据与服务端通信。地址和端口确定连接位置,加密方法和凭据则决定双方能否正确处理数据。即使服务器地址能访问,加密方法选错也可能导致代理请求失败。
VMess
这种协议通常使用 UUID 标识用户。协议名称不能说明服务端采用哪种传输方式;传输方式及相关字段要与已有参数对应。若连接失败,可分别核对用户标识和传输参数,避免同时改动两类设置。
VLESS
这种协议通常也使用 UUID 标识用户,但不能仅凭凭据长得相似就套用另一种协议的配置。传输安全取决于单独配置的安全层,例如 TLS。录入时应分别确认协议、传输和安全选项。
Trojan
通常通过 TLS 建立连接,并使用密码完成认证。服务器地址指定连接位置,SNI 则是 TLS 握手时声明的服务名称,两者用途不同。证书名称出现错误时,应先核对服务方给出的名称,而不是关闭证书验证。
Hysteria2
这是基于 QUIC 的代理协议,底层使用 UDP。仅确认 TCP 服务能连通,并不能说明同一网络上的 UDP 流量也能到达。排查时,可以把网络条件和地址、端口、认证信息分开核对。
WireGuard
这是使用密钥标识对端、通过 UDP 传输封装数据的隧道协议。对端公钥用于识别远端,本地私钥用于本端身份,两者不能互换。记录配置或提交排查信息时不要公开私钥。

规则关键字

阅读一行规则时,先看匹配什么,再看匹配后怎么处理。

DOMAIN
按完整主机名精确匹配。条件写成 example.com 时,不会自动覆盖 www.example.com。主机名字段不包含网址中的协议前缀、路径或查询参数。
DOMAIN-SUFFIX
按域名后缀匹配域名本身及其子域名。例如,条件为 example.com 时可以匹配 api.example.com,但不匹配 notexample.com。若同一子域名要单独处理,应把更具体的规则放在通用后缀规则之前。
GEOIP
依据地址库中的国家或地区归类匹配 IP,不根据域名后缀推断位置。同一域名可能解析出不同的 IP,因而得到不同的匹配结果。该结果也不等同于服务器的精确物理位置。
IP-CIDR
用地址前缀和前缀长度描述一段 IPv4 地址。比如 192.0.2.0/24 匹配以 192.0.2 开头的地址;斜线后的数字不是端口。需要匹配 IPv6 地址段时,对应的关键字是 IP-CIDR6。
FINAL
为未命中前序规则的连接指定处理动作,通常写在规则列表末尾。FINAL,DIRECT 表示其余连接直接访问目标,不会把前面已经命中的连接改成直连。意外落入兜底时,先核对前序条件和排列顺序。
PROXY · DIRECT · REJECT
三者是规则命中后的动作:PROXY 交给代理路径,DIRECT 直接连接目标,REJECT 拒绝该连接。大写的 PROXY 和 DIRECT 出现在规则中,只处理命中项,不等同于切换界面里的 Proxy 和 Direct 模式。

订阅与配置文件

服务器列表决定有哪些远端可选,配置文件决定连接如何处理。

服务器
服务器是客户端连接的远端,条目通常记录协议、地址、端口和认证信息。已掌握这些参数时,可以通过 Add Server 录入。条目的显示名称只是便于辨认,改名不会改变实际连接地址。
订阅
订阅链接由用户已有的服务商提供,用于获取和更新一组服务器条目;应用内可通过 Subscribe 添加。能更新列表不代表列表中每台服务器都可达。订阅链接可能带有访问凭据,排查时不要公开完整链接。
配置文件
配置文件保存规则和相关设置,常见扩展名是 .conf。[General] 记录通用设置,[Rule] 记录分流规则。更新服务器订阅不等于替换当前配置;排查分流前,应先确认实际启用的文件。
DNS
DNS 用于查询域名对应的记录,常见用途是获得连接所需的 IP 地址。解析成功只说明拿到了记录,不说明目标端口一定可达。看到域名解析错误时,先查解析路径;已解析但请求超时,再查连接路径。
URL Rewrite
配置中的 [URL Rewrite] 可以按 URL 条件执行重写或重定向。分流规则回答连接经由哪条路径,重写规则处理的是请求地址。对于加密请求,能否匹配路径还取决于应用能否读取相应的请求信息。

系统权限与安装

购买记录、系统授权和应用内配置分别管理,换机时应逐项核对。

VPN 配置
在 iPhone 或 iPad 上首次开启连接时,系统可能请求允许添加 VPN 配置。该配置由系统管理,与应用内的 .conf 文件不同。若此前拒绝授权,可返回 Shadowrocket 再次尝试连接,并阅读系统提示。
已购项目
这是在 App Store 查看购买记录、重新下载符合条件应用的入口。换机或重装时,先确认当前商店账户与原购买账户一致。重新下载应用不会通过购买记录找回服务器条目或配置文件,应用内数据需要单独迁移。
Apple 芯片与 Intel
这是 Mac 的两类处理器架构。在「关于本机」查看芯片或处理器名称,再选择对应的 Mac 安装包。首次打开若出现系统拦截,先确认获取来源,再对照安装提示说明辨别提示类型。
应用 ID
这是 App Store 对产品条目使用的数字编号,和购买用的账户不同。Shadowrocket 的应用 ID 是 932747118,可在产品页网址末尾核对。辨认条目时还应核对开发者 Shadow Launch Technology Limited 和官方图标,而不是只看名称。
Shadowrocket 全平台下载