官方手册 / 名称与判断依据

Shadowrocket 术语表

按使用环节查找界面名称、协议和规则关键字。每条先说明含义,再标出容易混淆的边界;卡片标题旁的链接可直接定位到该术语。

34 个常用术语 英文界面词保留原文
01 / 界面与开关

页面入口与路由方式

先确认名称出现在哪里。同一个 Config,在页面导航与 Global Routing 选项中承担不同作用。

Home #
用于查看已有服务器、当前选择与连接入口的主要页面。列表出现服务器条目,只能说明信息已保存,不能说明连接已经建立;应再检查连接状态与实际访问结果。
Global Routing #
决定当前连接采用哪种全局路由方式,常用选项是 Config、Proxy、Direct,分别对应配置、代理、直连。排查某条规则为什么没有生效时,应先核对这里的选择,而不是先修改规则内容。
Config #
在 Global Routing 中,Config 表示按照当前配置处理流量,规则分流通常在这个方式下验证。在页面导航中,Config 则是管理配置文件的入口;仅进入该页面,不等于已经选中或启用了某份配置。
Proxy / Direct #
在 Global Routing 中,Proxy 让客户端可接管的流量使用代理,Direct 则采用直接连接。它们是全局路由方式,不是服务器的协议类型,也不要与规则末尾的大写 PROXY、DIRECT 策略名混为一谈。
On Demand #
依据预先设置的网络等条件触发按需连接,用于减少重复手动操作。它不负责判断已有订阅是否有效,也不能保证远端服务器可用;验证时应分别观察条件是否命中、连接是否建立和目标是否可访问。
Add Server #
用于手动填写服务器信息,先选择正确的协议类型,再填写对应字段。地址、端口、认证信息和传输参数应以你已有的服务器资料为准;更换协议类型并不会让原参数自动兼容。
Connectivity Test #
用于检查指定测试目标的连通情况,结果受测试方式、网络环境与目标自身状态影响。测试通过不代表所有网站都能访问,测试失败也不应直接等同于订阅失效;应配合实际请求和连接记录判断。
02 / 协议

连接类型与参数边界

协议是客户端与服务器约定的通信方式。优先匹配已有服务的类型与参数,不按名称推断速度、耗电或稳定性。

Shadowsocks #
一种基于代理转发的加密协议,基础参数包括服务器地址、端口、加密方法与密码。客户端与服务器两端的加密方法必须对应;遇到认证或连接问题时,应先核对字段,而不是仅凭测试耗时判断原因。
VMess #
一种带有身份验证与加密机制的代理协议,配置中通常包含用户标识等认证信息。传输方式及其附加字段同样需要与服务器一致;地址和用户标识正确,并不代表传输层设置已经完整。
VLESS #
侧重精简认证与转发的代理协议,通常与额外的传输或安全机制组合使用。VLESS 这个名称本身不代表自动包含 TLS 保护;填写时需要分别核对认证、传输方式及安全相关字段。
Trojan #
通常配合 TLS 使用的代理协议,密码与 TLS 连接条件共同影响连接是否成功。服务器名称、证书有效性和系统时间都值得核对;不宜把关闭证书验证当作常规排障步骤。
HTTP / SOCKS5 #
两类常见代理协议,均需要明确服务器地址、端口及可能存在的认证要求。HTTP 代理不能因名称就被视为已加密的连接;SOCKS5 的 UDP 能力也取决于服务端与具体使用条件,不能仅凭类型判断。
WireGuard #
一种基于密钥的隧道协议,常见参数包括接口地址、对端公钥、Endpoint 与 AllowedIPs。AllowedIPs 涉及隧道内的地址范围选择,不应直接当作域名规则;私钥属于敏感数据,排查时不要公开。
Hysteria2 #
一种基于 QUIC 的代理协议,连接依赖 UDP 通路以及匹配的认证与 TLS 参数。实际表现会受到丢包、服务器资源和网络条件影响;带宽相关字段应依据服务资料与实际环境填写,而不是任意调大。

需要比较参数与使用场景时,继续阅读协议参考。系统要求以 App Store 页面标注为准。

03 / 规则关键字与策略

匹配条件与处理结果

关键字回答“匹配什么”,策略回答“如何处理”。以下规则仅用于解释语法,example.com 为示例域名,不代表任何实际服务。

规则 #
将匹配条件关联到处理策略的配置条目,例如将某个域名交给 PROXY。规则通常自上而下匹配,前面的宽泛条件可能先覆盖后面的精确条件;保存后应查看新建连接的实际匹配结果。
DOMAIN #
按完整域名匹配,例如 DOMAIN,example.com,DIRECT 只针对该域名。它不会自动覆盖 www.example.com 等子域名,也不按网页路径或页面内容进行匹配。
DOMAIN-SUFFIX #
按域名后缀边界匹配,example.com 可覆盖自身与其子域名。它不等于任意字符串包含关系,例如 notexample.com 不属于这个域名后缀;适合按网站域名范围组织规则。
DOMAIN-KEYWORD #
检查域名中是否包含指定字符串,例如关键字 example 可能匹配多个不同的域名。它的范围通常比 DOMAIN 或 DOMAIN-SUFFIX 更宽;使用前需要评估误匹配,不能把它当作同一网站的精确集合。
GEOIP #
依据 IP 数据库中的地区归属匹配目标 IP,而不是识别页面内容或运营者所在地。结果受数据库与目标地址变化影响;当域名解析到不同地址时,同一网站的匹配结果也可能变化。
IP-CIDR / IP-CIDR6 #
分别用于匹配 IPv4 与 IPv6 地址网段,斜杠后的前缀长度决定覆盖范围。例如 192.168.0.0/16 是一个 IPv4 网段,不是单台设备;填写前应确认目标范围,避免把更大网段交给错误策略。
FINAL #
当前面规则均未命中时,指定最终处理策略,例如 FINAL,DIRECT。通常将它放在规则末尾;调整兜底策略会影响所有未被前面规则覆盖的连接,不应只验证一个已被精确规则命中的网站。
PROXY / DIRECT / REJECT #
规则中的策略名,分别表示交给代理路径、直接连接与拒绝连接。PROXY 的具体去向需要结合当前服务器选择或配置判断;REJECT 拒绝匹配连接,不是删除网页元素,无法保证清除所有页面内容。
DNS #
将域名解析为 IP 地址的机制,解析结果与解析路径可能影响规则判断及连接表现。修改 DNS 不会自动修复认证错误或服务器故障;排查时应把解析失败、连接失败与策略不符合预期分开观察。
04 / 订阅与配置

导入、更新与测试

服务器信息、订阅地址和配置文件用途不同。先确定拿到的资料属于哪一种,再选择对应入口。

Subscribe #
通过你已有的订阅地址获取或更新服务器条目的功能,地址应从自己的服务商处获取。订阅地址可能带有账户标识或访问凭据,不宜公开;导入服务器条目也不意味着同时获得了完整的规则配置。
服务器 #
客户端连接的远端端点信息,通常包括地址、端口、协议与认证参数,也常被称为节点。列表中的显示名称只是便于识别的标签,不能证明位置、速度或可用性;应核对参数并进行实际连接测试。
配置文件 #
承载规则、DNS 等处理设置的文本配置,与主要提供服务器条目的订阅用途不同。导入前应检查内容与来源,导入后确认当前选中的文件;仅保存文件,不等于其中的规则已经参与当前连接。
订阅更新 #
重新请求已有订阅地址,以刷新其中的服务器条目或参数。它不等于通过 App Store 更新应用,也不等于重新购买客户端;失败时应先检查地址是否仍有效、请求是否成功,以及返回内容能否被识别。
延迟 #
特定测试条件下测得的响应耗时,具体含义取决于测试目标与测试方式。延迟较低不等于带宽较高,也不能证明所有网站均可访问;比较时应尽量使用相同网络、目标与方法,避免混用不同条件的结果。
Scan QR Code #
读取二维码中连接信息的导入入口,二维码也可能包含普通文本或不适用的内容。扫描后应核对识别出的协议类型、地址与参数是否完整;成功识别并保存,不代表远端连接已经验证通过。
05 / 系统权限与账号

授权、购买与数据恢复

系统连接权限、App Store 购买记录与 iCloud 数据同步是三个不同环节。换机时应分别确认,不用其中一个状态代替另一个。

VPN 配置 #
首次连接时,系统可能请求允许添加 VPN 配置,用于网络扩展建立连接。允许后只表示系统授权已完成,不代表服务器认证和实际访问都成功;拒绝或删除后,可回到客户端重新发起连接并检查系统提示。
Apple 账户 #
App Store 购买与已购记录关联的账户,应与 iCloud 同步所使用的账户用途区分。恢复应用时先确认商店当前登录的是原购买账户;系统要求、账户地区相关可用性与购买适用范围,以 App Store 页面标注为准。
已购项目 #
在 App Store 中查找原账户购买记录并重新下载应用的入口,具体入口名称可能随系统界面变化。换机或重装时,先使用原购买账户查找 Shadowrocket;恢复应用本身不会自动还原所有本地服务器信息。
iCloud 同步 #
在满足账户、系统授权与应用设置条件时,同步受支持的数据。同步不等于完整备份,也不等于恢复 App Store 购买记录;换机前应确认所需数据确实可恢复,涉及凭据的导出内容应妥善保存。
一次性买断 #
指应用本身的购买方式,价格与购买适用范围以 App Store 页面标注为准。客户端一次性买断 ≠ 线路套餐,后续连接仍需用户已有的订阅或服务器信息;购买记录恢复与连接参数恢复应分别处理。
前往 App Store