Official Manual / Defined Terms

Shadowrocket 名词解释

按界面位置与配置职责查阅术语。英文保留界面和语法原文,中文说明含义、使用边界与容易混淆的地方。

先区分模式、条件与动作

Proxy 不等于 PROXY

Global Routing 中的 Proxy 是全局模式;规则行末尾的 PROXY 是处理策略。前者决定整体采用哪种路由方式,后者说明一条规则命中后如何处理请求。排查时先确认模式,再检查规则顺序与最终策略。

本表以用户已经持有自己的订阅或服务器信息为前提。客户端一次性买断 ≠ 线路套餐;本站不提供、不销售、不推荐节点或订阅。Shadowrocket 是 Apple 平台的付费应用,获取与购买请先阅读 App Store 正版核验说明。

01 / Interface

界面与开关

先辨认所在界面,再判断操作改变的是服务器记录、路由模式,还是连接状态。

界面与开关

Home

主要用于查看已有服务器、当前选择与连接状态。列表里出现一条记录,只表示信息已经保存,并不表示连接已经建立。首次操作可按入门指南依次完成导入、选择与系统授权。

界面与开关

Add Server

手动录入已有服务器信息的入口,先选协议类型,再填写对应字段。地址、端口、认证信息、传输方式和 TLS 设置应以你已持有的服务器资料为准。仅修改显示名称不会修复连接参数错误。

界面与开关

Global Routing

用于选择全局路由模式,常见三种姿态是配置、代理、直连,对应界面词 Config、Proxy、Direct。它决定请求采用哪种总体处理方式,不是服务器协议选项。检查某条分流规则前,应先确认当前是否使用 Config。

界面与开关

Config

在 Global Routing 中,Config 表示依据当前生效配置文件中的规则处理请求。相同请求可能因规则顺序、解析结果和策略选择不同而走向不同路径。这个模式名称与用于管理配置文件的 Config 界面同名,阅读步骤时应结合所在位置判断。

界面与开关

Proxy

Global Routing 中以代理路径处理请求的模式,常用于核对当前代理连接是否可用。不能简单理解成设备上的每一种流量都必然经过同一路径,系统流量和相关配置仍有处理边界。它也不同于单条规则中使用的大写 PROXY。

界面与开关

Direct

Global Routing 中以直连路径处理请求的模式。选择 Direct 与关闭连接开关不是同一个操作,前者改变路由方式,后者改变连接状态。排查前后应记录所选模式,避免把模式切换造成的结果变化误认为服务器变化。

界面与开关

On Demand

依据系统与应用中设定的条件触发连接行为的机制。它解决的是何时尝试连接,不负责判断订阅是否有效,也不等于持续检测每个网站是否可访问。启用后如果出现连接再次建立的情况,应先检查相关条件,再重复手动关闭。

02 / Protocols

协议

协议名称描述通信方式,不代表速度等级。导入时需要同时核对认证、传输与安全层参数。

协议

Shadowsocks

一种代理协议,常见参数包括服务器地址、端口、密码与加密方法。加密方法必须与服务器端配置一致,不能因为名称相近而替换。若资料还指定了额外的传输参数,也应一并核对,不能只确认密码。

协议

VMess

使用 UUID 等参数进行身份识别的代理协议。UUID、传输方式与 TLS 分属不同字段,填写其中一项正确不代表整组参数完整。遇到连接问题时,还应检查设备时间是否准确,以及服务器提供的路径和主机名是否对应。

协议

VLESS

使用 UUID 识别用户的代理协议,本身不提供载荷加密,因此需要结合实际传输和安全设置理解。它与 VMess 不是修改类型名称即可互换的两种填法。添加已有服务器时,应按资料逐项检查 UUID、传输方式、服务器名称及相关安全参数。

协议

Trojan

通常结合 TLS 使用密码认证的代理协议。除密码外,还需核对连接地址、TLS 服务器名称与证书是否匹配。证书校验失败应先检查名称和设备时间,不应把跳过校验当作常规修复步骤。

协议

Hysteria2

基于 QUIC 的代理协议,底层依赖 UDP 通信。能否建立连接与实际表现取决于 UDP 可达性、网络拥塞、服务器资源及参数是否匹配。协议名称本身不能保证更低延迟或更高吞吐量,也不能代替具体网络下的测试。

协议

WireGuard

使用公私钥识别通信双方的 VPN 协议,与以密码或 UUID 为主的参数结构不同。端点、密钥、隧道地址以及路由范围需要按已有配置配套核对。私钥属于敏感信息,向他人提供排查材料时应删除。

03 / Match & Policy

规则关键字与策略

规则前半段说明匹配条件,末尾说明处理动作。关键字保留大小写与逗号结构,修改前先备份当前配置。

规则关键字与策略

Rule

规则把请求特征与处理策略关联起来,配置文件中通常位于 [Rule] 分节。规则通常自上而下匹配,前面的适用规则会影响后续规则是否还有机会生效。检查结果时应同时看条件、位置与策略,而不是只搜索某个域名是否出现。

规则关键字与策略

DOMAIN

精确匹配指定域名,例如 DOMAIN,example.com,DIRECT。该条件不会自动包含 www.example.com 等子域名。需要覆盖主域名及其子域名时,应理解 DOMAIN-SUFFIX 的匹配范围后再选择写法。

规则关键字与策略

DOMAIN-SUFFIX

匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY。它按域名后缀边界判断,并不是任意位置包含相同字符串就会命中。若更具体的子域名需要另一策略,应把对应精确规则放在较宽泛规则之前。

规则关键字与策略

GEOIP

根据目标 IP 在地理数据库中的分类结果进行匹配。分类结果可能受数据库更新、地址分配及解析结果影响,不能等同于对服务器物理位置的实时测量。遇到域名规则与 GEOIP 结果不同,应结合规则顺序和实际目标 IP 分析。

规则关键字与策略

IP-CIDR

按 IPv4 地址段匹配,例如 IP-CIDR,192.168.0.0/16,DIRECT。斜杠后的前缀长度决定地址范围,不是服务器端口。IPv6 地址段使用 IP-CIDR6,配置时应区分地址族,不能只复制同一条 IPv4 规则。

规则关键字与策略

FINAL

前序规则均未命中时使用的兜底规则,例如 FINAL,DIRECT。它通常放在规则列表末尾,否则后续规则可能失去匹配机会。FINAL 后的策略决定未分类请求的去向,不代表整份配置中所有请求都使用该策略。

规则关键字与策略

PROXY

规则行中的代理策略标识,表示命中后采用对应代理路径。它不创建服务器,也不能补齐缺失的认证或传输参数。与 Global Routing 的 Proxy 模式相比,PROXY 是单条规则的处理结果,需要结合当前模式和所选代理理解。

规则关键字与策略

DIRECT

规则行中的直连策略标识,表示该请求不通过代理服务器转发。请求仍受本地网络、目标服务及相关解析设置影响,因此直连也可能失败。DIRECT 不等于关闭 Shadowrocket,也不意味着其他规则不再生效。

规则关键字与策略

REJECT

拒绝命中规则的请求,例如 DOMAIN,example.com,REJECT。它处理的是请求,不负责删除页面中的视觉元素,也不能按域名区分同一域名承载的全部内容。过宽的拒绝条件可能同时影响登录、图片或其他正常功能。

04 / Subscription & Config

订阅与配置文件

服务器记录说明连接对象,配置文件说明处理方式。两者可能通过同一份资料导入,但职责仍需分别核对。

订阅与配置文件

Subscribe

通过用户已有的订阅地址读取、更新服务器记录的机制,具体可导入内容取决于返回格式。订阅更新成功只说明读取或解析完成,不代表每个服务器都能连接。订阅地址可能包含访问凭据,应避免公开分享;购买客户端与订阅的有效状态相互独立。

订阅与配置文件

Server

一组用于连接的服务器参数,通常包括地址、端口、协议及认证信息。记录的显示名称只是识别标签,不足以证明实际地理位置、可用状态或网络表现。排查时应对照已持有的原始资料核对字段,而不是根据名称猜测参数。

订阅与配置文件

配置文件

保存处理选项与规则的文本文件,常见分节包括 [General]、[Rule]、[Host] 与 [URL Rewrite]。它与服务器订阅不是同义词,导入服务器后仍需确认当前使用哪份配置。编辑前保留可恢复副本,并检查修改的是当前生效文件而不是另一份同名记录。

订阅与配置文件

Scan QR Code

读取二维码中兼容的服务器或订阅信息的入口。二维码只是一种数据载体,能否导入取决于内部内容和格式,不是所有图片都能识别为连接资料。导入后应核对类型与关键字段,同时避免传播包含密码或订阅凭据的二维码。

05 / Settings & Diagnostics

设置项

测试值、日志和同步各自回答不同问题。调整设置时一次只改变一项,并保留调整前后的观察结果。

设置项

Settings

集中管理应用设置的界面,具体项目以设备上的实际界面为准。应用级选项与配置文件中的参数属于不同层级,不能仅凭名称相似就认为作用范围相同。修改前记录原值;不确定继承关系时,可查阅Settings 设置项参考再进行验证。

设置项

DNS

将域名解析为 IP 地址的机制,配置中的 dns-server = system 表示使用系统解析器。解析成功与网站请求成功是不同阶段,后续仍可能受规则、连接或目标服务影响。更换解析设置前,应先区分问题发生在域名解析还是连接建立阶段。

设置项

Connectivity Test

按指定测试方法检查可达性的工具,结果需结合测试目标与测试方式解读。显示的耗时不是下载速度,也不能保证实际应用的全部请求正常。比较前应保持网络和测试条件一致,测试失败后再用实际请求与日志交叉确认。

设置项

Log

用于观察连接、解析和规则处理线索的日志。排查时先复现一次明确操作,再对照时间与目标查找相关记录,避免混用不同请求的结果。日志可能包含访问域名、服务器地址与认证相关信息,对外分享前应删除敏感内容。

设置项

URL Rewrite

按照匹配表达式与指定动作处理 URL 的配置机制,常见于 [URL Rewrite] 分节。它与 Rule 决定请求路由的职责不同,不能用同一套匹配思路直接替换。对于加密请求,可见信息与是否需要额外配置取决于具体操作,不应据此假设能够读取所有请求内容。

设置项

iCloud 同步

通过 iCloud 在符合条件的设备间同步应用所支持的数据,需同时检查系统账户、iCloud 权限和应用内设置。同步不等于保留每一次修改的历史备份,误删内容也可能随同步传播。换机前应另行保存必要配置,并在新设备上核对服务器记录与生效配置。