Shadowrocket 术语表
glossary从界面名称、协议类型到规则关键字,按使用环节查找词义。英文保留应用中的写法,中文说明用途、边界与容易混淆的地方;具体位置与可用选项以当前平台的应用界面为准。
33 个术语条目
界面词 ≠ 规则策略
每条均可通过锚点定位
界面与开关
interface · 06先确认正在修改哪一层设置。切换全局模式、选择配置文件和打开连接开关,是三个不同操作。
- Home
- 主要操作页面,用于查看已添加的服务器条目、选择连接对象及检查连接开关。选中条目只是确定连接目标,不代表连接已经建立;连接成功也不代表所有请求都会使用代理,实际路径还取决于 Global Routing 与配置规则。
- Global Routing
- 全局路由设置,包含 Config(配置)、Proxy(代理)、Direct(直连)三种模式。它先确定总体处理方式,再由对应设置决定具体路径;修改规则后若没有进入 Config,观察到的结果可能与规则文本不一致。日常理解规则行为时,先检查这一项。
- Config
- 在 Global Routing 中表示配置模式,即根据当前启用的配置文件匹配连接。作为页面名称时,Config 又指管理、选择和编辑配置文件的入口。看到同一个词时,应结合所在位置判断:模式控制是否使用规则,页面负责管理规则所在的文件。
- Proxy / Direct
- 在 Global Routing 中,Proxy 表示代理模式,Direct 表示直连模式;它们是整体路由选择,不是单条域名条件。Proxy 不会修复错误的服务器参数,Direct 也不会删除已有订阅。注意首字母大写的界面词与规则行内全大写的 PROXY、DIRECT 所处层次不同。
- On Demand
- 按需连接功能,用于根据设定条件触发连接,减少反复手动操作。它处理的是何时建立连接,而不是某个域名应走哪条规则;后者仍由路由模式和配置决定。排查连接自动恢复或网络切换后的行为时,应同时查看 On Demand 条件与系统 VPN 设置。
- Add Server
- 手动添加服务器信息的入口,适用于用户已经持有服务器地址及认证参数的情况。应先选择正确的协议类型,再按服务信息填写地址、端口及该类型需要的字段。保存成功只说明条目已写入本地,仍需选择它并验证实际连接。
协议
protocols · 07协议类型必须与用户已有的服务器相符。不能只在客户端改一个名称,就让服务器支持另一种协议;速度与耗电也不能仅凭协议名判断。
- Shadowsocks
- 使用预共享密码及相应加密方法的代理协议,配置重点通常是服务器地址、端口、密码和加密方法。加密方法必须与服务器一致,名称相近也不能随意替换。若服务信息包含额外传输参数,应一并核对,不能只复制地址与密码。
- VMess
- 带有用户身份验证与协议级加密机制的代理协议,UUID 是常见身份字段。传输方式、路径、Host 与 TLS 等设置属于需要分别核对的参数,并非填写 UUID 后就全部确定。部分认证机制对设备时间敏感,连接异常时可先确认系统时间准确。
- VLESS
- 采用精简身份验证与转发设计的代理协议,常用 UUID 标识用户;数据机密性通常由外层安全传输提供。VLESS 与 VMess 的字段和处理机制不同,不能把同一组参数仅改类型后使用。应完整保留服务信息指定的传输与安全设置。
- Trojan
- 通常结合 TLS 与密码认证使用的代理协议,地址、端口、密码和服务器名称需要配套填写。服务器地址与 TLS 校验名称可能不同,应依照已有配置理解二者用途。证书验证失败时先检查名称、设备时间和服务端证书,不宜用关闭验证代替定位问题。
- HTTP / SOCKS5
- 两类不同的代理协议:HTTP 代理常通过 CONNECT 建立隧道,SOCKS5 则定义了面向连接及数据报转发的协商方式。它们的用户名、密码、域名解析位置和 UDP 能力取决于服务端与客户端实现。协议名称本身不保证链路加密,需核对是否另有安全传输保护。
- WireGuard
- 基于 UDP 与公私钥身份验证的网络隧道协议,通常涉及隧道地址、对端公钥、端点和路由范围。它与仅填写主机和密码的代理条目不同,地址及允许路由范围同样影响可达性。私钥属于敏感信息,排查或分享配置时应先移除。
- Hysteria2
- 基于 QUIC 的代理协议,依赖当前网络允许相应 UDP 通信,并需要正确的认证与 TLS 参数。它的表现受丢包、拥塞、服务端能力和带宽设置共同影响,不能理解为固定更快。若其他类型可用而此类型失败,UDP 可达性是值得单独检查的一层。
需要核对参数含义与选型条件时,阅读协议详解。
规则关键字
rule-set · 08规则通常由匹配类型、匹配内容与处理策略组成。从上到下检查,首条命中即停止继续匹配,因此顺序也是配置的一部分。
- Rule
- 规则是按域名、IP 网段等特征识别连接,再指定处理策略的条件。更具体的规则通常放在前面,覆盖范围大的规则放在后面,避免前者被提前命中覆盖。规则决定路径,不负责修正服务器认证信息,也不能使失效的服务器恢复服务。
- DOMAIN
- 精确匹配指定域名的关键字,例如匹配 example.com 时,不自动包含 api.example.com。适合只需要改变单一主机处理方式的情况。若希望覆盖一组子域名,应考虑 DOMAIN-SUFFIX,而不是不断补写相似的精确匹配规则。
- DOMAIN-SUFFIX
- 匹配指定域名及其子域名,例如 example.com 与 api.example.com 都可由同一条后缀规则覆盖。它按域名层级匹配,不是任意字符串包含关系。遇到某个服务主站正常而部分资源异常时,还需确认资源是否来自其他域名。
- DOMAIN-KEYWORD
- 按域名是否包含指定字符串进行匹配,覆盖面通常比精确域名或后缀规则更宽。较短或常见的字符串可能同时匹配无关域名,因此应先评估影响范围。已知完整服务域名时,优先使用范围更明确的条件,便于以后排查。
- IP-CIDR / IP-CIDR6
- 分别用于按 IPv4 与 IPv6 网段匹配目标地址,斜杠后的数字表示网络前缀长度。它们判断的是地址范围,不是域名拼写;域名连接在进入 IP 类规则判断时,可能涉及解析结果。只为 IPv4 配置规则,不代表相应 IPv6 连接也会命中。
- GEOIP
- 根据 IP 地理数据库中的地区归属匹配目标地址,例如 GEOIP,CN,DIRECT 表示将命中该地区归属的地址交给 DIRECT。数据库归属不是对服务器物理位置的实时测量,也不代表服务面向的语言或用户地区。结果与预期不一致时,应结合实际目标 IP 检查。
- FINAL
- 兜底规则,用于接收此前条件均未命中的连接,通常放在列表最后。FINAL,PROXY 表示剩余连接交给 PROXY,不表示前面的 DIRECT 规则失效。若将 FINAL 提前,后面的具体条件通常就没有机会参与匹配。
- PROXY / DIRECT / REJECT
- 规则内常见的三种处理策略,分别表示交给代理、直接连接和拒绝连接。它们是动作,不是匹配条件,也不是服务器协议;PROXY 最终使用哪个连接目标,还需结合当前选择检查。REJECT 可能影响依赖该请求的页面功能,添加前应确认匹配范围。
订阅与配置
profiles · 06以下说明以用户已有自己的订阅或服务器信息为前提。服务器条目回答“连接到哪里”,配置文件回答“连接如何处理”,购买记录则属于应用获取环节。
- Subscribe
- 用于获取和更新一组服务器条目的订阅类型,订阅地址由用户自己的服务商提供。更新通常是重新读取远端内容,不等于为账户续期,也不保证远端一定返回可用条目。订阅地址可能包含访问凭据,不应出现在公开截图、留言或共享诊断记录中。
- SERVER
- 服务器主机地址字段,通常填写域名或 IP 地址;这里的服务器条目也常被称为节点。端口通常有独立字段,不应把完整网页链接或订阅地址直接当作主机地址填写。应按已有服务信息逐项核对,尤其注意粘贴时夹带的空格与换行。
- 配置文件
- 保存规则、DNS 与相关处理设置的文件,与提供服务器列表的订阅承担不同职责。导入文件后仍需确认当前启用的是哪一份,以及 Global Routing 是否处于 Config 模式。更换配置可能改变大量请求的路径,操作前宜保留原文件,以便比较和恢复。
- Scan QR Code
- 通过二维码读取导入内容的入口,二维码可能承载单个服务器信息,也可能承载订阅地址。扫描只负责读入内容,不替代来源与字段核对;完成后应检查协议、地址和认证参数。二维码本身也可能包含访问凭据,保存和转发时应按敏感信息处理。
- iCloud 同步
- 在应用支持范围内利用 iCloud 同步相关资料的功能,实际同步项目以当前应用设置为准。它与 App Store 的购买记录、系统 VPN 授权和当前连接状态不是同一件事。换设备后即使资料已同步,也应重新核对所选配置、连接目标及必要的系统授权。
- 已购项目
- App Store 中查看相关 Apple ID 购买记录及重新下载应用的入口,换机时需先确认使用原购买账户。iPhone / iPad 版为 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。已购记录证明应用购买,不包含服务商的线路使用资格。
网络与诊断
diagnostics · 06区分解析、传输、安全握手与应用请求,有助于缩小故障范围。一次测试结果只能说明对应测试条件下的表现。
- DNS
- 将域名解析为 IP 地址的系统,是许多连接建立前的步骤。解析成功不代表目标端口可达,连接失败也不一定由 DNS 引起;还要检查路由、握手及服务状态。修改 DNS 后可能受到缓存影响,比较结果时应尽量保持其他条件不变。
- Connectivity Test
- 连接测试工具,用于检查当前网络条件下服务器或指定测试目标的可达性。测试通过不等于所有网站、所有协议或持续传输都正常,失败也可能仅针对测试目标。排查时应记录所用测试方式,并用实际出现问题的应用请求交叉验证。
- 延迟 / 吞吐量
- 延迟描述一次响应需要等待多久,吞吐量描述单位时间可传输多少数据,两者不能互相替代。较低延迟通常有利于交互,但不保证大文件传输更快;持续速度还受带宽、丢包与拥塞影响。比较时应使用相同本地网络、目标和测试方式。
- TLS / SNI
- TLS 是用于身份验证与传输保护的安全协议,SNI 是握手中声明目标服务器名称的扩展。SNI、服务器连接地址与证书中的名称有联系,但不总是同一个填写值。出现握手错误时,应按服务信息核对名称、证书有效性与设备时间,而不是只反复更换端口。
- TCP / UDP
- 两种传输层协议:TCP 提供可靠、有序的字节流,UDP 按数据报发送,本身不保证送达或顺序。应用可以在 UDP 之上实现可靠传输,因此不能简单把 UDP 理解成不稳定。某一网络中 TCP 测试通过,也不能直接证明依赖 UDP 的协议可用。
- URL Rewrite
- 按匹配条件改写请求 URL 或执行相应重定向的机制,与决定连接路径的路由规则不是同一层。是否生效取决于规则类型、请求是否可被处理及相关设置,不能假定所有加密请求都能直接改写。排查异常跳转时,可先停用相关改写规则做对照测试,再逐项定位。