官方手册 · 术语索引
Shadowrocket 名词解释
按分类查阅界面词、协议与规则关键字。先确认名词所在的配置层级,再核对参数;英文原文与大小写保留,便于对照应用界面。
界面与开关
先看设置控制什么,再看当前状态说明什么。开关已开启、配置已保存与目标可访问,是三个不同的核对结果。
- Home
- 查看服务器列表、当前选择和连接开关的主要界面。列表中的记录可能来自手动添加,也可能来自已有订阅。出现记录只表示条目已保存;连接前还要确认所选服务器,连接后再验证实际访问结果。
- Global Routing
- 决定连接采用的整体路由方式,三种姿态为配置(Config)、代理(Proxy)、直连(Direct)。Config 按当前配置的规则分流,Proxy 以代理方式处理流量,Direct 以直连方式处理流量。排查时先记录当前姿态,避免把整体模式变化误认为单条规则生效。
- On Demand
- 按预设网络条件触发 VPN 连接行为的功能,具体条件以当前应用设置为准。它控制何时尝试连接,不等于决定每个请求走哪条规则。手动断开后若连接再次出现,应先核对 On Demand 条件,而不是反复删除服务器。
- Add Server
- 手动填写已有服务器信息的入口。先选协议类型,再按服务商提供的信息核对地址、端口、认证及传输参数。不同协议的字段不通用,不能只替换服务器地址就沿用另一种协议的全部设置。
- Connectivity Test
- 用于检查服务器连通表现,结果常以耗时或失败状态呈现。测试方式、测试目标与当前网络都会影响结果,因此延迟不是固定的服务器属性。较低延迟不直接代表较高下载速度,出现超时时应结合实际连接与日志继续判断。
- DNS
- 把域名解析为 IP 地址的机制,是访问域名时的重要环节。解析失败、解析结果不合适或 DNS 请求路径异常,都可能表现为页面打不开。核对时同时查看解析设置与规则命中,不要仅凭连接开关判断 DNS 正常。
- VPN 配置
- Apple 系统用于管理相关网络连接的配置,首次建立连接时可能要求确认添加。系统允许添加配置,只表示应用获得相应连接权限,不表示远端服务器认证成功。阅读提示后再操作,遇到配置冲突时先核对系统中已有的 VPN 设置。
协议
协议决定客户端与服务器如何通信,不代表某个服务器一定可用。填写已有信息时,认证、传输与加密设置需要作为一组核对。
- Shadowsocks
- 一种代理协议,常见必填信息包括服务器地址、端口、加密方法与密码。加密方法必须与服务端一致,不能凭名称相近进行替换。若已有配置还包含其他配套参数,也应按原始说明保留,避免导入后只核对密码。
- VMess
- 使用 UUID 等参数进行认证的代理协议,并可搭配不同传输方式。UUID 正确只是核对的一部分,传输路径、Host 与 TLS 等设置也可能影响连接。排查时逐项对照已有服务器信息,不要把传输方式当成协议名称本身。
- VLESS
- 使用 UUID 进行认证的轻量代理协议,协议本身不提供数据加密。实际连接的安全性与可用性取决于所搭配的传输、加密及服务端设置。它与 VMess 的字段含义和组合方式存在差异,不能只修改类型就假定完成转换。
- Trojan
- 通常结合 TLS 使用的代理协议,认证信息一般包含密码。除地址与端口外,还应核对服务器名称及证书验证相关设置。出现证书错误时先检查名称、设备时间与服务端证书,不应把关闭验证作为常规处理步骤。
- Hysteria2
- 基于 QUIC 的代理协议,通常依赖 UDP 通信。网络对 UDP 的限制、认证参数、TLS 或混淆设置不一致,都可能影响连接。仅看到服务器地址可解析并不足以确认协议可用,需要结合实际连接结果检查。
- WireGuard
- 基于密钥建立加密隧道的协议,涉及本地密钥、对端公钥、地址及 Endpoint 等信息。公钥与私钥用途不同,不能互换;路由范围也需要与已有配置对应。私钥属于敏感信息,排查截图和对外描述中应移除。
- HTTP / SOCKS5
- 两类代理协议,使用时需要分别核对地址、端口与认证要求。普通 HTTP 代理和 SOCKS5 本身不等于已建立加密隧道,是否使用额外加密需看实际配置。UDP 能力也不能仅凭协议名称推定,应按服务端支持情况核对。
规则关键字
读规则时依次看匹配类型、匹配内容与处理策略。以下片段只用于解释语法;不要在未核对现有 Config 的情况下整体替换配置。
- 规则
- 把请求的匹配条件与处理策略连接起来的配置条目。常规规则按顺序检查,先匹配到的条目会影响最终处理,因此调整位置也可能改变结果。分析异常时应查看实际命中,而不只是确认文件里是否存在目标规则。
- DOMAIN
- 精确匹配域名的规则关键字,例如
DOMAIN,example.com,DIRECT。这条规则针对指定域名,不自动覆盖它的全部子域名。若页面请求使用了其他资源域名,需要分别检查这些请求,而不是只看地址栏。
- DOMAIN-SUFFIX
- 匹配指定域名及其子域名,例如
DOMAIN-SUFFIX,example.com,PROXY。它适用于同一域名层级的统一策略,不等于匹配任意包含该文字的域名。核对时应确认请求域名及其层级关系,避免把关键词包含关系当成后缀关系。
- GEOIP
- 按 IP 地理归属数据库匹配目标地址,例如
GEOIP,CN,DIRECT。数据库记录不等于网站所属机构的位置,使用分布式服务时更应注意实际解析结果。规则未按预期命中时,同时检查 DNS 结果、规则顺序与数据库归属。
- IP-CIDR / IP-CIDR6
- 分别用于按 IPv4 与 IPv6 网段匹配目标地址,例如
IP-CIDR,192.0.2.0/24,DIRECT。斜杠后的前缀长度决定覆盖范围,不表示端口。设备同时使用两类地址时,只写其中一类规则可能无法覆盖全部连接。
- FINAL
- 前序规则未匹配时采用的兜底规则,例如
FINAL,PROXY。它说明剩余请求交给哪种策略,不表示当前连接已成功。通常放在常规规则末尾;修改前先确认未命中流量应该如何处理。
- PROXY / DIRECT / REJECT
- 规则中的处理策略,分别表示代理、直连与拒绝。它们与 Global Routing 的 Proxy、Direct 界面项属于不同层级:前者描述规则结果,后者决定整体路由姿态。写配置时保留关键字原样,并确认当前模式确实会使用该规则。
订阅与配置
区分服务器列表、配置文件与同步数据。导入成功只确认数据被读取,是否适用于当前网络与连接仍需另行验证。
- 订阅
- 通过链接读取并更新服务器条目的来源,使用用户已有的订阅信息。更新订阅主要刷新该来源的条目,不等于更新 Config 中的分流规则。链接可能含身份凭据,应妥善保管;更新失败时先检查原链接是否仍有效。
- 服务器
- 保存地址、端口、协议与认证信息的连接条目,日常也称节点。一个条目代表一组连接参数,并不等于远端服务当前可用。切换条目后应重新验证连接,不能仅凭名称、地区标签或上次测试结果判断。
- Config
- 承载规则、策略及相关设置的配置文件,也是对应的界面入口名称。保存或导入文件后,还需确认当前选用的是哪一个 Config,以及 Global Routing 是否采用 Config。修改前保留原文件,每次调整一项,便于失败时恢复并对照。
- Scan QR Code
- 通过二维码读取配置内容的入口,实际导入内容取决于二维码携带的数据。扫描前确认来源,扫描后核对协议、地址和认证字段,不把识别成功等同于连接成功。二维码可能包含完整凭据,不应直接放入公开截图。
- URL Rewrite
- 按配置匹配请求 URL 并执行改写或重定向等处理的功能,与选择代理或直连的规则分流不同。具体行为取决于匹配表达式、动作及请求能否被相应处理机制观察。排查页面跳转异常时先核对相关条目,不要同时大范围修改 DNS 与分流规则。
- iCloud 同步
- 在适用设置下借助 iCloud 同步部分应用数据的机制,具体范围以当前应用选项为准。它与 App Store 的购买记录不同,下载已购应用不代表全部配置自动出现。换机前确认同步状态,并妥善保留已有订阅、服务器信息及重要 Config。
App Store 与账号
购买记录解决客户端获取问题,连接配置解决实际使用问题。Shadowrocket 是 Apple 平台付费商业应用,以 iPhone 与 iPad 为主要使用设备。
- App Store
- Shadowrocket 唯一的购买与获取入口。打开产品页后核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118,系统要求与设备兼容性以 App Store 页面标注为准。安装及后续更新均通过 App Store 进行,入口与操作见正版核对说明。
- Apple ID
- 与 App Store 购买记录关联的账号。设备用于 iCloud 的账号和“媒体与购买项目”使用的账号可能不同,查找已购记录时应核对后者。商店地区会影响商品展示和付款信息,具体可购状态以当前账号看到的页面为准。
- 已购项目
- 在 App Store 中查找原账号购买记录的入口,名称与位置可能随系统界面调整。换机或重装时先确认使用原购买账号,再查找 Shadowrocket 的记录。恢复应用与恢复订阅、服务器及 Config 是不同操作,详细顺序见已购恢复说明。
- 一次性买断
- 指一次性购买客户端使用资格,当前售价以 App Store 页面显示为准。客户端一次性买断 ≠ 线路套餐,购买应用不会自动生成服务器或订阅。其他 Apple 设备的兼容性及是否通用购买,也以同一 App Store 页面标注为准。