OFFICIAL MANUAL / GLOSSARY

Shadowrocket 术语表

按界面名称查含义，按规则关键字查匹配范围。英文保留应用与配置中的写法，中文说明它解决什么问题，以及不能据此推断什么。

33 个术语条目
界面名称与配置语法分开理解

01 / INTERFACE

界面与开关

先看选项所在位置，再理解它作用于整段连接还是单个请求。

Home: 查看服务器条目、选择连接对象与控制连接的主要入口。选中某个条目只表示确定了连接对象，不等于已经建立可用连接。首次使用时，应在导入信息后核对选择状态，再进行连接与访问验证。

Global Routing: 决定整体流量处理方式的选项，常见姿态为 Config、Proxy、Direct，分别对应配置、代理、直连。排查时应先记录当前选择，避免把模式切换造成的变化误认为服务器故障。具体规则是否参与处理，取决于当前姿态。

Config: 在 Global Routing 中，Config 表示按当前配置的规则处理流量；在其他位置，它也可能指配置管理入口。启用该姿态前，需要确认使用的是预期配置，而不是仅导入了文件。规则顺序、策略名称和最终规则都会影响结果。

Proxy: 在 Global Routing 中，Proxy 表示以代理策略处理流量，通常用于临时对照连接路径。它不等于规则文本里的某一行，也不保证所有目标都可以访问。使用时仍需有可用的服务器信息，并留意 DNS 与连接环境。

Direct: 在 Global Routing 中，Direct 表示使用直连策略，不将请求交给代理服务器。它适合与其他姿态作对照，判断问题是否与代理路径有关。选择 Direct 不等同于删除或关闭系统中的 VPN 配置，两者应分别核对。

On Demand: 依据预设条件触发连接行为的按需连接设置，作用层次不同于域名分流规则。设置前应明确希望在什么网络条件下连接或断开。手动断开后若出现再次连接，应先检查 On Demand 的条件，而不是反复修改服务器参数。

Connectivity Test: 用于在当前测试条件下检查服务器可达性与响应时间。测试结果只反映当时的网络、测试方式与目标，不能直接当作下载速度或所有网站的访问表现。比较结果时应保持条件一致，并配合实际访问验证。

02 / PROTOCOLS

协议

协议名表示通信方式，不表示服务质量；参数须与已有服务器信息一致。

Shadowsocks: 一种代理协议，客户端与服务器需要使用相互匹配的地址、端口、密码和加密方法。只填对地址并不足以建立连接。手动录入时应逐项核对加密方法，不能根据名称相近而自行替换。

VMess: 通常使用 UUID 身份信息的代理协议，完整连接还可能依赖额外的传输层与安全层设置。UUID 正确不代表 Host、Path 或 TLS 参数也正确。导入后若连接失败，应对照原始信息检查整组字段，而非仅更换端口。

VLESS: 一种代理协议，需要将身份信息与所用传输、安全层参数配套理解。协议名本身并不描述全部连接条件。已有信息中若包含 Server Name、Path 等字段，应按原值核对，不宜凭经验补填或省略。

Trojan: 通常结合 TLS 与密码认证使用的代理协议。服务器地址、端口、密码及证书对应的名称都可能影响连接。遇到证书验证问题时，应先核对地址、Server Name 与系统时间，不应把关闭验证作为常规解决方式。

Hysteria2: 基于 QUIC 的代理协议，连接依赖当前网络对相应 UDP 流量的支持。网络环境变化可能导致同一组参数出现不同的可达结果。排查时应分别检查认证、TLS 参数和 UDP 连通条件，而不是仅观察域名是否能解析。

WireGuard: 通过公私钥建立加密隧道的协议，需要核对本地地址、对端公钥、Endpoint 与路由范围。私钥属于敏感凭据，不能放入公开截图或排查记录。握手成功只说明部分连接条件成立，还需继续验证路由与 DNS。

HTTP / SOCKS5: 两类常见代理协议名称，认证方式与可承载的请求类型应按服务器实际设置核对。不能仅凭协议名推断连接是否加密。添加时应明确 Type、地址、端口及认证字段，避免把一种协议的参数填到另一种类型中。

03 / RULES & POLICIES

规则关键字与策略

关键字负责判断是否匹配，策略负责决定命中后怎么处理。

规则: 通常由匹配类型、匹配内容和处理策略组成，按配置中的顺序参与判断。前面的宽泛规则可能先于后面的精确规则命中，因此不能只检查单行是否正确。规则生效还取决于当前 Global Routing 是否采用 Config。

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配指定域名及其子域名，DOMAIN-KEYWORD 按域名中的关键词匹配。三者的范围不同，关键词匹配尤其需要留意误伤。填写域名规则时不要混入 URL 的路径或查询参数。

GEOIP: 依据 IP 地理数据库中的归属信息匹配，而不是根据网页语言、域名后缀或用户所在位置判断。结果受数据库与实际解析地址影响。某个域名使用不同地址时，命中的规则也可能改变，因此需要结合连接记录核对。

IP-CIDR / IP-CIDR6: 分别用于匹配 IPv4 与 IPv6 网段，以地址和前缀长度描述范围。前缀长度改变会影响覆盖范围，不能将单个地址与整个网段混为一谈。配置时应确认目标实际使用的地址类型，避免只覆盖其中一种。

FINAL: 此前规则均未命中时采用的最终规则，通常置于规则列表末尾。它决定其余请求如何处理，但不会覆盖已经在前面命中的请求。排查时若所有目标都落到 FINAL，应优先检查前面的匹配内容与规则顺序。

PROXY / DIRECT / REJECT: 规则中的处理策略：PROXY 交给代理路径，DIRECT 使用直连路径，REJECT 拒绝请求。这里的大写策略名称与 Global Routing 中的 Proxy、Direct 不应混作同一个设置。REJECT 依赖可匹配的请求范围，不能选择性删除同一域名中的任意内容。

USER-AGENT: 依据可读取的请求 User-Agent 信息进行匹配，而不是按应用显示名称判断。加密请求中的相关信息未必直接可见，因此它不是对所有请求都适用的应用识别方式。命中异常时应先确认请求是否具备可用于匹配的信息。

规则语法示例，不是完整配置

以下内容仅展示匹配类型与策略的关系。example.com 是教学示例域名；使用前仍需核对当前配置的策略定义和顺序。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

04 / SUBSCRIPTION & CONFIG

订阅与配置

导入、更新、规则配置和数据同步是不同操作，不能相互替代。

Add Server: 按用户已有服务器信息手动创建条目的入口，通常先选择 Type，再填写 Address、Port 等对应字段。不同协议所需字段并不相同。保存前应对照原始资料核对，不能以填写完整作为参数正确的依据。

Scan QR Code: 通过二维码读取已有服务器或订阅信息的方式，本质上是导入编码后的内容。扫码完成后仍需核对类型、地址与名称。二维码可能包含完整凭据，因此分享图片前应确认接收范围，不要将它当作普通装饰图公开。

订阅更新: 重新读取远端订阅内容，并刷新本地对应的服务器条目，不是更新 Shadowrocket 应用。远端内容变化可能导致条目增加、移除或参数改变。更新前应记录自己的命名与整理方式，更新后再确认当前选择是否仍符合预期。

配置文件: 用于保存规则、策略关联及相关设置的文本配置，与仅提供服务器集合的订阅不是同一对象。导入配置后通常还需确认是否正在使用它。修改前宜留存可恢复副本，逐项变更后验证，避免同时改变多个因素。

DNS: 把域名解析为 IP 地址的机制，会影响请求后续连接的目标及部分规则判断。解析成功不代表端口可达，也不代表服务器认证通过。遇到仅域名访问异常时，应把 DNS 结果与实际连接失败分开检查。

URL Rewrite: 按条件改写请求地址或相关请求行为的配置功能，不等同于将流量交给某个代理策略。它能否作用于请求，受协议、加密与可读取信息限制。使用前应理解匹配范围，并保留回退配置以处理意外跳转或请求失败。

iCloud 同步: 在相应设置启用时，通过 iCloud 同步支持的数据，具体范围应以应用内说明为准。同步状态与 App Store 已购资格属于不同系统，重新获取应用不等于恢复所有配置。同步也不应替代修改前的独立备份。

需要连续操作步骤时，查阅订阅与服务器管理；首次使用可从入门指南开始。

05 / APP STORE & ACCOUNT

App Store 与账号

购买资格、应用数据与连接服务分别管理，恢复时也要分别核对。

App Store 正版核验: 同时核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。Shadowrocket 只在 Apple 平台通过 App Store 获取，以 iPhone / iPad 为主。设备兼容性和系统要求以 App Store 页面标注为准。

一次性买断: 指购买 Shadowrocket 客户端的付费方式，美区定价约 $2.99，实际价格以商店页面为准。客户端一次性买断 ≠ 线路套餐，使用连接功能仍需用户已有自己的订阅或服务器信息。其他设备的通用购买资格以 App Store 页面标注为准。

已购项目: 在 App Store 账号购买记录中查找并重新获取已购买应用的入口，适用于换机或重装后的核对。应先确认当前商店账号与原购买记录一致。重新获取客户端并不会自动重新生成原订阅凭据，应用数据恢复需另行检查。

商店地区: 决定账号访问的 App Store 店面，以及商品展示与结算条件，不等同于系统显示语言。搜索不到应用时，可先核对账号店面、年龄分级限制与账号状态。地区变更涉及付款方式及现有账号权益，应先阅读系统提示再操作。

购买、核验与已购恢复的完整顺序见App Store 下载指南。术语含义已明确但连接仍异常时，可继续查阅常见问题。