官方手册 · 术语索引

Shadowrocket 术语表

先确认词语出现的位置,再判断它影响什么。这里按界面、协议、规则、配置与购买分类,保留英文原文,解释操作含义与容易混淆的边界。

  • 界面词区分大小写
  • 规则从上到下匹配
  • 协议参数以已有信息为准
01 / interface

界面与开关

这些名称用于定位入口、切换模式或观察连接状态。模式选择、系统连接开关与测试结果各自代表不同信息。

界面与开关Home
Home 是查看服务器列表、选择当前服务器与操作连接开关的主要页面。导入条目后,需要先确认选中了预期服务器,而不是仅看到它出现在列表中。列表有条目、开关已打开、实际请求可用,是需要分别确认的三个状态。
界面与开关Global Routing
Global Routing 决定请求采用哪种整体路由方式。配置、代理、直连分别对应界面中的 Config、Proxy、Direct:Config 依据当前配置处理,Proxy 使用代理路径,Direct 使用直连路径。它不是服务器协议选择器,切换模式不会自动修正服务器认证参数。
界面与开关Config
Config 可指配置文件管理页面,也可指 Global Routing 中按配置运行的模式。在页面里查看或编辑文件,不等于该文件已成为当前使用的配置。希望分流规则生效时,应同时确认当前配置及 Global Routing 的选择。
界面与开关Proxy
Proxy 是 Global Routing 中的代理模式,用于让受该模式处理的请求采用代理路径。它不能替代对服务器地址、认证信息和可达性的核对。注意它与规则策略 PROXY 的大小写和位置不同,后者只描述规则命中后的处理动作。
界面与开关Direct
Direct 是 Global Routing 中的直连模式,表示使用直连路径处理请求。选择 Direct 不等同于关闭系统 VPN 配置,也不代表已经删除服务器条目。排查时可借此区分代理路径与直连路径的表现,但一次测试不能证明所有目标均可访问。
界面与开关On Demand
On Demand 用于在符合预设条件时触发连接,实际行为同时受到应用设置与系统 VPN 配置影响。它不是保证连接始终可用的状态指示器。如果手动断开后又出现连接,应检查相关条件,再核对系统中的 VPN 设置。
界面与开关Connectivity Test
Connectivity Test 是检查连接可用性的测试入口,结果反映测试当时的网络与服务器状态。一次通过不代表每个域名、应用或协议都能正常工作;一次失败也不能单独定位到认证错误。应结合当前服务器、Global Routing 和实际访问目标一起判断。
界面与开关Data
Data 用于查看应用记录的流量使用情况,适合辅助观察连接期间是否产生了数据传输。应用统计与服务商计费可能采用不同的范围、周期和计算方式。核对剩余额度时,应以你的服务商提供的账户记录为准,不把本地数值直接当作账单。
界面与开关Settings
Settings 是管理应用设置的入口,具体选项以当前应用显示为准。遇到连接问题时,应先记录原有值,再一次只调整一个相关选项。把多项设置同时改动后,即使结果改善,也难以判断真正起作用的是哪一项。
02 / protocols

协议

协议名称决定参数如何被解释,并不是速度等级。添加前先核对已有服务器的协议类型,再逐项填写对应字段。

协议Shadowsocks
Shadowsocks 是代理协议之一,常见配置包括服务器地址、端口、加密方法与密码。加密方法必须与服务端一致,不能仅凭名称相近进行替换。若服务商还提供其他参数,也应一并核对,不能只复制地址与端口。
协议VMess
VMess 使用用户标识等参数进行认证,配置中还可能涉及传输方式与 TLS。用户标识正确,只能说明核对了认证信息的一部分,并不代表传输层设置匹配。导入后连接失败时,应对照原始信息检查相关字段,而不是反复更换 Global Routing。
协议VLESS
VLESS 是代理协议之一,用户标识、传输方式与安全层参数需要分别核对。协议名称本身不说明连接已经具备哪些加密或证书校验条件。使用时应以服务端给出的完整参数为准,不能把另一条配置的安全设置直接套用。
协议Trojan
Trojan 通常结合 TLS 使用,认证密码和证书相关参数都会影响连接。服务器的连接地址与 TLS 校验所用的名称可能承担不同作用,应按已有配置填写。证书校验报错时,先检查名称、设备时间及服务端证书情况,不应把跳过校验当作常规处理。
协议Hysteria2
Hysteria2 是基于 QUIC 的代理协议,网络中的 UDP 可达性会影响其连接表现。认证信息、TLS 与其他相关参数同样需要匹配服务端。协议支持不等于当前网络路径一定可用,排查时应把网络条件与字段填写分开检查。
协议WireGuard
WireGuard 是使用公钥认证的隧道协议,配置涉及本地密钥、对端公钥、对端地址与允许的地址范围等信息。允许的地址范围会影响哪些目标进入隧道,不只是认证参数。私钥应作为敏感信息保存,分享截图或诊断文本前须移除。
协议HTTP / SOCKS5
HTTP 与 SOCKS5 是两类不同的代理协议,在 Add Server 中应按服务器实际类型选择。二者的认证方式、域名解析处理与 UDP 能力不能混为一谈。支持某种代理协议,也不等于连接默认采用加密传输,需另外核对相应设置。
03 / rules

规则关键字

一条规则通常由匹配类型、匹配目标与处理策略组成。规则按顺序检查,因此具体规则应放在较宽泛的规则之前。

规则关键字DOMAIN
DOMAIN 用于匹配完整域名,适合只处理一个明确的主机名。例如 DOMAIN,example.com,DIRECT 指向 example.com,不自动覆盖所有子域名。域名规则的目标是主机名,不应在该字段中填写带路径的完整网页地址。
规则关键字DOMAIN-SUFFIX
DOMAIN-SUFFIX 按域名后缀匹配,可用于同时处理指定域名及其子域名。例如以 example.com 为目标时,也可覆盖 www.example.com。它不是任意字符串包含匹配;需要匹配域名中的某段字符时,应区分 DOMAIN-KEYWORD 的含义。
规则关键字DOMAIN-KEYWORD
DOMAIN-KEYWORD 检查域名中是否包含指定关键字符串,匹配范围可能明显大于某一个域名。例如关键字 example 可能命中多个不同后缀的域名。写规则时应评估误匹配范围,不宜把短小、常见的字符串当作精确站点标识。
规则关键字GEOIP
GEOIP 根据目标 IP 在地址数据库中的地区归类进行匹配,不是识别页面内容所用的文字、域名后缀或用户所在地。数据库记录可能与服务的实际运营位置不同,且会受到地址变化影响。需要稳定处理特定域名时,不应只依赖地区归类来推断命中结果。
规则关键字IP-CIDR / IP-CIDR6
IP-CIDR 匹配 IPv4 地址范围,IP-CIDR6 匹配 IPv6 地址范围;斜杠后的数字是网络前缀长度。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示一个 IPv4 范围。检查目标时应同时留意地址族,只写 IPv4 规则不代表已经覆盖对应的 IPv6 连接。
规则关键字FINAL
FINAL 是前面的规则均未命中时采用的兜底规则,通常应位于规则列表末尾。例如 FINAL,PROXY 表示剩余请求交给 PROXY 处理。若将兜底规则提前,后续规则便可能没有匹配机会,因此排查时必须同时看规则内容和位置。
规则关键字PROXY / DIRECT / REJECT
这些是规则中的处理策略:PROXY 使用代理路径,DIRECT 使用直连路径,REJECT 拒绝请求。策略描述的是命中之后怎么处理,不负责描述匹配什么。PROXY 本身也不包含服务器凭据,实际代理路径仍依赖当前有效的服务器或配置中的策略安排。
04 / configuration

订阅与配置

服务器条目负责连接参数,配置文件负责规则及相关行为。两者可以配合使用,但不能把导入其中一项等同于完成全部设置。

订阅与配置Subscribe
Subscribe 对应通过订阅获取和更新服务器条目的机制,订阅链接从你的服务商处获取。更新订阅可能改变条目名称、数量或连接参数,不等于同步更新本地所有分流规则。链接常含访问凭据,复制给他人或公开展示前应先移除敏感部分。
订阅与配置Add Server
Add Server 是添加服务器信息的入口,Type 需要对应用户已有服务器的协议。地址、端口、认证信息与传输参数应成套核对,不能混用不同条目的字段。手动添加完成后,还需回到 Home 选择条目并进行连接验证。
订阅与配置配置文件
配置文件承载规则及相关设置,与只提供服务器条目的订阅不是同一概念。导入文件后,应确认它是否被选为当前配置,并核对 Global Routing 是否使用 Config。远程更新与本地修改也可能互相影响,调整前宜先保存原有内容以便恢复。
订阅与配置DNS
DNS 将域名解析为 IP 地址,解析成功与后续连接成功属于两个不同阶段。若域名访问失败而直接使用 IP 的测试表现不同,可以把解析过程列为检查方向,但不能据此直接确定原因。更换 DNS 设置前应记录原值,并核对当前配置是否另有相关设置。
订阅与配置URL Rewrite
URL Rewrite 对匹配到的 URL 应用改写规则,与只决定连接路径的规则分流不同。它可能改变请求的目标或处理方式,因此需要同时理解匹配条件和改写动作。涉及加密请求时,还须具备相应的可处理条件,不能认为写入一行规则就必然生效。
05 / app store

App Store 与购买

应用购买、服务器服务与配置数据是不同事项。Shadowrocket 只在 Apple 平台发行,唯一获取入口为 App Store。

App Store 与购买App Store 正版核对
购买前核对开发者 Shadow Launch Technology Limited、与本站一致的官方图标,以及产品页应用 ID 932747118。只看名称相似或搜索排序,不能代替这三项核对。iPhone 与 iPad 为主要使用设备,Mac、Apple TV、Apple Vision 的兼容性、系统要求及购买适用性均以 App Store 页面标注为准。
App Store 与购买一次性买断
一次性买断指购买客户端的付费方式,当前价格与购买适用性以 App Store 页面标注为准。客户端一次性买断 ≠ 线路套餐,付款购买应用不会自动获得服务器连接资料。使用前仍需准备已有的订阅或服务器信息,相关资料从你的服务商处获取。
App Store 与购买已购项目
已购项目指 App Store 账号中的购买记录,可用于重装或换机时查找已购买的应用。需要核对当前商店账号是否为原购买账号,具体恢复条件以 App Store 页面标注为准。应用能够重新获取,并不代表本地配置、服务器信息和其他数据也已自动恢复。

需要核对商店入口或恢复流程?查看正版核对说明与已购项目恢复步骤。其他连接问题可继续查阅FAQ。