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 和官方图标,而不是只看名称。