官方手册 / 术语查阅

Shadowrocket
术语手册

先辨认词语所在的位置,再判断它的含义。界面上的模式、配置中的策略与服务器的协议属于不同层级,不能互相替代。

32 个术语 5 个分类 英文原文对照

以下说明以用户已有自己的订阅或服务器信息为前提。客户端一次性买断 ≠ 线路套餐;应用购买、服务器服务与配置管理应分别核对。

01 / Interface

界面与开关

先看设置所在的页面。同一个词出现在入口名称和路由模式中时,可能指向不同操作。

Home

用于查看和选择已添加的服务器、订阅分组等连接项目。列表中出现条目只说明信息已保存,不表示认证有效或远端当前可达;准备连接时,还应确认选中的条目及 Global Routing 模式。

Global Routing

决定整体路由方式的设置,三种姿态为配置、代理、直连,对应界面词 Config、Proxy、Direct。需要按规则分流时通常选择 Config;排查问题时可以临时对照不同模式,但模式变化本身不会修复失效的服务器信息。

Config

出现在配置管理入口时,指向配置文件及其相关操作;出现在 Global Routing 中时,表示按当前配置处理请求的模式。导入配置后要核对当前启用的是哪一份文件,不能只凭文件已经出现在列表中就认定规则生效。

Proxy

Global Routing 中的代理模式,通常将受应用处理的请求交给所选代理路径。它适合用来对照问题是否与分流有关,但不等于配置里的大写策略 PROXY;所选服务器不可用时,切换到 Proxy 仍可能无法连接。

Direct

Global Routing 中的直连模式,表示不使用所选代理服务器转发请求。它可作为核对当前网络基础连通性的对照条件,但访问结果仍受本地网络、DNS 和目标服务状态影响,不能据此单独判断服务器配置是否正确。

On Demand

按已设置条件触发 VPN 连接的机制,具体行为由应用选项与系统状态共同决定。它不是订阅自动更新,也不会替换失效的认证信息;遇到关闭连接后又自动连接的情况,应先核对此项及系统中的 VPN 设置。

Add Server

添加服务器信息的入口,填写时应先选对协议,再核对地址、端口和认证字段。所有字段都应以用户已有的服务器资料为准;仅凭协议名称猜测其余参数,通常无法得到有效连接,保存后也仍需验证实际访问。

Protocol / 连接参数

协议

协议名只说明通信方式的一部分。地址、认证、传输与安全参数必须和服务器端保持一致。

Shadowsocks

一种代理协议,常见配置需要服务器地址、端口、加密方法和密码。客户端与服务器的加密方法必须一致,额外参数也应按原始资料填写;导入成功只表示信息能够被读取,并不能代替认证与连接测试。

VMess

一种带身份验证的代理协议,配置通常包含用户标识以及传输相关设置。排查时应分别核对标识、地址、端口和传输参数;设备系统时间明显不准也可能影响认证,因此不宜只反复修改服务器地址。

VLESS

一种代理协议,名称本身不能完整说明采用何种传输与安全设置。填写时应使用服务端提供的完整参数,不能因为同属 VLESS 就交换不同连接的字段;涉及 TLS 等选项时,还需核对对应的名称和验证条件。

Trojan

通常结合 TLS 使用的代理协议,配置涉及密码、服务器地址以及证书验证所需的名称。地址可达并不表示 TLS 验证或密码认证已经通过;出现连接错误时应保留证书验证,先检查名称、证书状态和原始参数。

Hysteria2

基于 QUIC 的代理协议,连接条件涉及认证信息、TLS 设置与当前网络对 UDP 的支持。不能只通过其他类型连接可用就认定此协议也可用;更换网络做对照,有助于区分网络传输限制与服务器配置错误。

WireGuard

基于密钥的隧道协议,配置通常涉及密钥、接口地址、对端端点和路由范围。它的字段组织方式与密码式代理不同,应按完整配置核对;私钥属于敏感信息,分享日志或截图时应先移除相关内容。

HTTP / SOCKS5

两类不同的代理协议,不能仅因使用相同地址或端口就混用。添加时需核对服务器类型、认证方式与相应的传输支持;这些名称本身不保证链路加密,安全属性应结合实际连接方式判断。

03 / Match → Policy

规则关键字与策略

左侧关键字描述匹配条件,末尾策略描述处理动作。先匹配到哪条规则,通常就采用哪条规则的策略。

一条规则的阅读顺序

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-SUFFIX 是条件类型,example.com 是示例匹配值,PROXY 是动作。此片段用于解释语法,不是完整配置,也不提供服务器信息。

DOMAIN

按完整域名匹配的规则关键字,例如指定 example.com 时,不自动包含它的所有子域名。需要对某个独立主机精确处理时可使用此类条件;如果实际请求来自另一个子域名,应核对日志里的完整名称。

DOMAIN-SUFFIX

按域名后缀匹配的规则关键字,可用于覆盖指定域名及其子域名。它比 DOMAIN 的匹配范围更广,但不是任意文字包含匹配;设置策略前应确认覆盖范围,避免将本应采用不同策略的子域名一起处理。

IP-CIDR

按 IPv4 网段匹配,地址后斜杠中的数字表示前缀长度,例如 192.168.0.0/16 表示一个网段范围。它匹配的是地址而不是域名文本;IPv6 地址需使用对应的 IP-CIDR6,不能直接套入 IPv4 网段规则。

GEOIP

按 IP 地理数据库给出的归属匹配,例如 GEOIP,CN,DIRECT。数据库归属不等同于用户位置、网页显示的文字或服务运营主体所在地;当结果与预期不符时,应核对实际目标 IP 和数据库信息,而不是只看页面内容。

FINAL

当前面规则均未命中时,使用该条指定的兜底策略,通常放在规则列表末尾。FINAL,PROXY 表示剩余请求采用 PROXY;如果更早的规则已经命中,修改 FINAL 并不会改变那部分请求的路径。

PROXY

规则中的代理策略,表示命中的请求交由代理路径处理。它不是协议名称,也不天然绑定某一条服务器记录;判断请求实际去了哪里,还要结合当前所选服务器、配置中的策略安排以及连接日志。

DIRECT

规则中的直连策略,表示命中的请求不经过所选代理服务器转发。大写 DIRECT 是单条规则的动作,与 Global Routing 中的 Direct 模式层级不同;直连请求仍可能受到 DNS 与当前网络条件影响。

REJECT

规则中的拒绝策略,用于阻止命中的请求。若匹配范围过大,可能影响登录、图片加载或其他正常功能;排查时先核对被拒绝的具体请求与命中规则,再缩小条件,不宜直接移除全部规则。

DNS

将域名解析为 IP 地址的系统,是域名访问过程中的一个环节。解析成功不等于后续连接一定成功,连接超时也不一定由 DNS 引起;排查应区分解析错误、地址连接失败、TLS 验证失败与应用层响应错误。

Subscription / Configuration

订阅与配置

订阅管理服务器信息,配置组织处理行为。导入其中一类内容,不应假定另一类内容也已设置完成。

订阅

通过链接获取并更新一组服务器信息的方式,链接应从用户自己的服务商处获取。订阅链接可能包含访问凭据,应像密码一样保管;更新成功只说明内容已获取,不表示分组中每一条服务器都可正常使用。

服务器

客户端连接的远端端点,一条记录通常包含协议、地址、端口与认证信息,也常被称为节点。订阅可以组织多条服务器记录,但名称只是识别标签;判断连接是否正确,应核对字段与实际访问,而不是只看名称。

Subscribe

处理订阅导入的界面词,使用时应粘贴用户已有的完整链接,并确认内容属于支持的格式。订阅更新通常影响对应分组内的条目,不能把它理解成更新应用;更新前后可对照分组变化,并重新核对当前选中项。

规则

将匹配条件与处理策略组合的配置条目,通常自上而下检查,命中后采用对应动作。更具体的条件一般应安排在范围更大的条件之前;规则是否参与处理,还取决于当前是否选择 Config 及启用的配置文件。

URL Rewrite

按条件对 URL 请求进行重写或重定向的配置能力,与选择代理路径的路由规则不同。具体可处理的内容取决于请求类型与相关配置,不能认为所有加密请求都可直接改写;使用前应读清来源与匹配范围。

05 / Permission & Account

系统权限与账号

系统授权、购买资格和应用内配置是三件事。恢复其中一项,不代表其余两项自动恢复。

VPN 配置

Apple 系统用于管理应用网络隧道的配置,首次连接时可能弹出添加配置的授权提示。授权让应用能够建立相应的网络通道,不代表服务器已经验证可用;拒绝或删除后,可按应用提示重新发起连接并检查系统设置。

Apple 账户

App Store 购买记录所关联的账户,恢复应用时需核对“媒体与购买项目”使用的账户。它与 iCloud 当前登录的账户可能不同;排查购买记录缺失时,应先检查原购买账户与商店状态,不要将其与订阅认证混为一谈。

已购项目

App Store 中查找购买记录与重新获取应用的入口,具体名称可能随系统界面变化。重新获取应用不等于恢复全部服务器资料;设备兼容性、系统要求与购买适用范围均以 App Store 页面标注为准。

iCloud 同步

通过 iCloud 在设备间同步应用支持的数据,具体范围取决于应用选项与系统设置。不能将它视作所有配置和凭据的完整备份;换机前应核对同步内容,应用恢复后也应重新确认配置、服务器选择与系统授权。

按当前问题继续查阅

术语用于解释含义,实际操作仍需按顺序验证。涉及连接错误时,记录所在页面、所选模式和具体提示,比只记录“不能用”更有助于定位。

Shadowrocket 是 Apple 平台的闭源商业应用,唯一获取入口为 App Store。本站为 Shadowrocket 官网与官方手册;购买应用与使用用户已有的订阅或服务器信息,应分别确认。