官方手册

Shadowrocket 概念速查

先确认界面词指向哪个操作,再区分协议、匹配条件与处理策略。本页供阅读 Shadowrocket 配置时查词使用;实际选项以应用内显示为准。

平台iPhone / iPad 获取入口App Store 导入用户已有的配置

按用途定位

五类术语,先看所在层级

界面项用于找到入口,协议说明连接类型,规则决定请求如何匹配。订阅与配置负责导入和组织用户已有内容;DNS 与网络项用于理解解析及请求处理。

01 / INTERFACE

界面与开关

这里的英文是应用内界面词。查找操作入口时,先按英文名称核对,不要把路由选项与规则策略混为一谈。

Home
主界面用于查看已有服务器条目与连接状态。首次使用时先确认已导入自己的配置,再选择要使用的条目。
Global Routing
决定连接时采用哪种默认路由姿态。常见选项是 Config、Proxy、Direct;切换前应先确认自己希望规则参与处理,还是采用统一的连接方式。
Config
在 Global Routing 中,Config 表示按当前配置文件中的规则处理请求。规则通常从上到下匹配,命中后停止,因此条目顺序会影响结果。
On Demand
按预设网络条件决定何时尝试连接。设置时分别检查 Wi-Fi、Cellular、Domain 等条件,避免多个条件同时生效却与预期不符。
Add Server
添加用户已有服务器信息的入口。选择相应协议后,地址、端口与认证参数应逐项按自己的原始信息填写。
Subscribe
导入用户已有订阅链接时使用的条目类型。链接能打开并不代表内容一定能解析;导入后还要检查应用内是否出现预期条目。
Connectivity Test
用于检查所选连接的可达性。测试结果受当前网络与目标影响,不应把单次测试数字直接当作实际加载速度。

02 / PROTOCOL

协议

协议名用于辨认已有服务器信息的类型。导入时以原始参数为准,不能只凭协议名称补齐缺失的设置。

Shadowsocks
一种通过客户端与服务器参数建立连接的代理协议。填写时核对服务器地址、端口、加密方式及认证信息是否与已有资料一致。
VMess
一种需要配套服务器参数的连接协议。导入后若不能连接,应逐项核对身份信息、传输设置以及服务器端提供的其他条件。
VLESS
一种连接协议,协议名称本身不足以确定完整配置。传输方式、安全参数与服务器设置需要对应,不能在填写时任意互换。
Trojan
一种使用服务器地址、端口及认证信息建立连接的协议。核对时也要留意已有资料中对安全连接的要求。
Hysteria2
一种基于 QUIC 的连接协议。填写服务器信息时,认证及其他连接参数应与用户已有的服务器配置保持一致。
WireGuard
一种依据密钥与对端参数建立连接的网络协议。配置时要区分本地接口参数与对端参数,并检查地址范围是否按已有资料填写。

03 / MATCH & ACTION

规则关键字与策略

规则左侧描述匹配条件,末尾策略描述命中后怎样处理。先看顺序,再看条件和策略;FINAL 留在最后处理未命中的请求。

DOMAIN-SUFFIX
按域名后缀匹配,也会覆盖对应的子域名。例如 DOMAIN-SUFFIX,example.com,PROXY 表示命中该后缀时采用 PROXY 策略。
DOMAIN-KEYWORD
检查域名中是否包含指定文字。它的覆盖范围可能比完整域名匹配更广,写规则时应先想清楚哪些域名也会包含同一段文字。
GEOIP
按 IP 地址归属信息进行匹配。GEOIP,CN,DIRECT 是一种规则写法;实际命中情况还与解析结果及当前配置有关。
IP-CIDR
按 IPv4 地址或网段匹配。网段范围由前缀长度决定,填写前应检查地址与掩码,避免把不相关的地址纳入同一条规则。
IP-CIDR6
按 IPv6 地址或网段匹配。它与 IP-CIDR 面向不同的地址格式;需要覆盖两类地址时,应分别检查对应规则。
FINAL
处理此前规则均未命中的请求,通常放在规则清单最后。FINAL,PROXY 是兜底示例;若前面的规则已经命中,就不会再走到这一条。
PROXY / DIRECT / REJECT
三者是规则命中后的处理策略:PROXY 交由代理处理,DIRECT 直接连接,REJECT 拒绝请求。这里的 PROXY、DIRECT 是规则策略词;Global Routing 中的 Proxy、Direct 则是界面选项。

04 / INPUT

订阅与配置

本类术语都以用户已有自己的订阅或服务器信息为前提。导入是一项配置操作,不会自动产生连接所需的资料。

服务器信息
通常包含地址、端口、协议及对应的认证参数。手动添加时先核对协议,再逐项对照自己已有的信息,不要根据名称猜测参数。
配置文件
用于组织规则、策略及相关设置。编辑后应核对规则顺序与 FINAL 的位置,并确认文件内容适用于当前连接场景。
Scan QR Code
扫描用户已有配置二维码的导入入口。扫码后先查看识别出的协议与参数,再保存和测试;二维码本身不能替代对来源资料的核对。

05 / NETWORK

DNS 与网络

连接已建立但访问结果不符合预期时,可把域名解析、请求规则和连接数据分开检查,不要只看开关状态。

DNS
将域名解析为网络地址的过程,也指应用内相关解析设置。排查某个域名时,先区分解析结果是否符合预期,再检查连接与规则是否命中。
URL Rewrite
按匹配条件处理请求地址的配置功能。规则的作用范围取决于匹配写法,修改前应确认它会影响哪些请求。
Data
应用内查看连接数据的界面项,具体内容以实际界面为准。数据能辅助判断连接活动,但不能单独证明某条规则按预期命中。

接下来怎么查

从术语返回操作步骤

要导入已有内容,先看使用说明;要逐项定位连接异常,转到排查手册。Shadowrocket 客户端一次性买断 ≠ 线路套餐,购买应用不等于取得服务器信息或订阅。系统要求以 App Store 页面标注为准。