Global Routing
这是请求总体处理方式的选择项，三种姿态为配置、代理、直连，对应界面词 Config、Proxy、Direct。要让 Rule 中的分流规则参与判断，应先确认选中了 Config。切换模式不等于修改服务器参数，也不能让失效的认证信息恢复有效。
官方手册 · 术语索引
Shadowrocket 概念速查
先区分界面选项、协议参数与规则策略，再检查配置。这里按使用场景整理术语；点击分类或术语链接，可直接定位到对应说明。
[General]
界面与开关
模式决定怎样处理请求，开关决定连接行为，测试用于核对结果。三者不能互相替代。
Config
在 Global Routing 中，Config 表示按当前配置处理请求，包括依据 Rule 选择策略。在页面导航中，Config 又是管理配置文件的入口，两处含义需要结合位置辨认。排查规则未生效时，既要确认模式，也要确认实际选用的配置文件。
Proxy
这是 Global Routing 的代理模式，用于让请求按该模式走代理处理，而不是逐条采用日常分流规则。它与规则行末的大写 PROXY 属于不同层级，不能只凭中文含义把两者混用。临时测试后若要恢复规则分流，应切回 Config 并重新核对访问结果。
Direct
这是 Global Routing 的直连模式，请求使用当前网络直接访问目标。它适合检查直连访问结果，但仍受当前网络、目标服务与 DNS 解析影响。界面里的 Direct 与规则关键字 DIRECT 大小写不同，前者是整体模式，后者是某条规则的处理策略。
On Demand
On Demand 按应用内设置的条件控制连接行为，具体条件与可用选项以当前应用界面为准。它回答何时建立连接，Rule 回答请求如何处理，两者解决的问题不同。出现自动连接或连接状态变化时，先核对这里的条件，再判断是否需要调整规则。
Add Server
这是录入用户已有服务器信息的入口，先选择协议类型，再按已有资料填写地址、端口与认证参数。不同协议需要的字段不同，不能只更换 Type 就认为配置已经转换完成。保存后应再次核对关键字段，避免复制时带入空格或漏掉传输设置。
Connectivity Test
该功能用于检查连接可达性，结果与选用的测试方法、测试目标和当前网络有关。显示的延迟不是可用带宽，也不代表所有网站均可正常访问。判断问题时应将测试结果与一次实际请求结合查看，区分服务器可达、认证成功与目标访问成功。
DNS
DNS 将域名解析为 IP 地址，是许多连接开始前需要完成的步骤。解析失败与代理连接失败不是同一个问题；修改路由策略也不必然修复解析。遇到域名无法访问时，先核对解析设置与返回地址，再检查后续请求命中了哪条规则。
[General]
代理协议
协议名描述连接机制，不表示线路质量。填写参数时，以用户已有服务器提供的信息为准。
Shadowsocks
Shadowsocks 使用服务器地址、端口、加密方法与密码等参数建立代理连接。加密方法必须与服务器端一致，名称相近的选项不能随意替换。如果已有信息还包含额外传输参数，也应逐项核对，而不是仅填写地址与密码就开始测试。
VMess
VMess 是带有用户认证机制的代理协议，用户标识与服务器认证设置需要对应。连接还可能涉及传输方式、TLS、路径和 Host 等参数，这些字段与认证信息各有作用。导入后能看到一条服务器记录，只说明信息已保存，不代表所有字段都正确。
VLESS
VLESS 使用用户标识进行认证，传输方式与连接安全设置需要另外核对。它与 VMess 是不同协议，不能因为都可能使用 UUID 就交换 Type。配置时应完整保留服务器要求的参数，并以应用内实际提供的字段判断如何录入。
Trojan
Trojan 通常使用 TLS 保护连接，并使用密码进行认证。除了地址、端口和密码，还应核对 TLS 所需的服务器名称与证书相关设置。认证信息正确但 TLS 校验失败时，连接仍可能无法建立，应分别检查这两个阶段。
Hysteria2
Hysteria2 基于 QUIC，使用 UDP 承载连接，需匹配服务器的认证与 TLS 等设置。当前网络能建立普通 TCP 连接，不等于对应的 UDP 路径一定可用。排查时应同时核对协议参数和网络可达性，不宜仅凭一个延迟数值判断故障原因。
WireGuard
WireGuard 使用密钥进行认证，常见配置涉及密钥、隧道地址、Endpoint 与允许的地址范围。这里的密钥和地址字段不是普通代理协议中的密码与服务器地址替代项。分享诊断材料时应隐藏私钥及其他认证内容，保留必要的字段名称即可。
HTTP · SOCKS5
HTTP 与 SOCKS5 是两种不同的代理协议，应按已有服务器的类型选择，而不是按准备访问的网站类型选择。服务器是否要求用户名和密码、是否提供受保护的连接，均需根据对应设置核对。相同的地址与端口并不意味着两种协议可以互换。
[Rule]
规则关键字
规则类型决定检查哪个字段，策略决定命中后怎样处理。以下域名仅用于说明语法。
DOMAIN
DOMAIN 精确匹配指定域名，不自动包含其子域名。例如 DOMAIN,example.com,PROXY 对应 example.com，不应据此假设 api.example.com 也会命中。需要覆盖整个域名后缀时，应理解 DOMAIN-SUFFIX 的匹配范围再选择写法。
DOMAIN-SUFFIX
DOMAIN-SUFFIX 匹配指定域名及其子域名，适合表达一组同属某个域名后缀的请求。DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 与 api.example.com。若某个子域名需要不同策略，应把更具体的规则放在这条宽范围规则之前。
DOMAIN-KEYWORD
DOMAIN-KEYWORD 根据域名中的关键词进行匹配，不等同于匹配某个完整域名后缀。关键词太短或太常见时，可能覆盖原本不打算处理的域名。添加前应考虑匹配范围，并通过实际请求核对命中结果，避免让宽泛规则抢先决定策略。
GEOIP
GEOIP 根据 IP 地理数据库的分类匹配目标地址，例如 GEOIP,CN,DIRECT。这种分类依赖地址数据库，并不直接判断网页内容、域名后缀或实际服务位置。使用时还应考虑 DNS 返回的地址，以及前面的域名规则是否已经命中。
IP-CIDR
IP-CIDR 匹配指定 IPv4 网段，斜杠后的数字表示网络前缀长度。IP-CIDR,192.168.0.0/16,DIRECT 表达对该地址范围使用直连策略。网段越宽，覆盖的目标越多；写规则时应先确认目标地址范围，再安排它在列表中的位置。
IP-CIDR6
IP-CIDR6 用于匹配 IPv6 网段，与 IPv4 的 IP-CIDR 分开书写。例如 IP-CIDR6,2001:db8::/32,DIRECT 是使用文档示例地址的语法说明。只设置 IPv4 规则不代表 IPv6 请求也会采用相同策略，应结合实际返回地址核对。
USER-AGENT
USER-AGENT 根据可读取请求中的 User-Agent 字段进行匹配，不是根据应用名称自动识别所有流量。加密请求的相关字段并不总能直接读取，因此不能假定这类规则适用于每次访问。添加前应确认应用能够取得所需字段，再判断匹配条件是否合适。
FINAL
FINAL 用于处理前面规则都没有命中的请求，通常放在 Rule 段末尾。它不需要域名或网段匹配值，常见写法为 FINAL,PROXY 或 FINAL,DIRECT。若把它放得过早，后面的规则就无法处理已经由这条兜底规则接管的请求。
[Rule]
策略与匹配顺序
英文大小写是辨认层级的线索：界面选项 Proxy 与规则关键字 PROXY 不应混为一谈。
Rule
配置文件中的 [Rule] 段组织匹配条件与处理策略，常见规则由类型、匹配值、策略构成。Rule 不是服务器列表，也不会补齐服务器缺少的认证字段。排查时先确认 Global Routing 使用 Config，再查看当前文件中的实际规则。
PROXY
PROXY 是规则中的代理策略关键字，表示命中的请求交由代理处理。实际连接仍依赖当前代理选择与有效的服务器参数，写上 PROXY 不等于已经建立可用连接。它只决定相应请求的策略，不是将 Global Routing 改成 Proxy 的另一种写法。
DIRECT
DIRECT 表示命中的请求采用直连策略，常用于明确指定某些域名或地址的处理方式。直连仍需要当前网络能够访问目标，并完成必要的域名解析。它对规则命中的请求生效，不等于把整个客户端切换到 Global Routing 的 Direct 模式。
REJECT
REJECT 表示拒绝命中的请求，用于明确阻止某个匹配范围的访问。若正常页面无法打开，应检查它依赖的域名是否被过宽的拒绝规则覆盖。修改时优先缩小匹配条件或添加更具体的例外，而不是在未核对原因时重写整份配置。
匹配顺序
在规则模式下，规则从上到下判断，先命中的规则决定请求策略；更具体的规则不会自动跳到前面获得优先权。通常先安排明确例外，再安排宽范围规则，最后写 FINAL。调整顺序后应重新发起请求，核对新的命中结果。
例外在前，兜底在后
下面的示例让 api.example.com 使用 DIRECT，同一域名后缀的其他请求使用 PROXY，其余请求由 FINAL 决定。仅用于理解顺序，应用前需结合自己的目标与已有连接信息检查。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT若把 DOMAIN-SUFFIX 移到第一行，api.example.com 会先命中该行；后面的 DOMAIN 不会覆盖已经作出的策略判断。完整字段与规则示例见配置字段参考。
[Host] / [URL Rewrite]
订阅与配置文件
服务器记录、规则文件与购买记录是三类不同内容，导入或恢复其中一类不会自动完成其他操作。
Subscribe
Subscribe 用于导入并更新用户已有的服务器列表，内容由对应订阅来源维护。更新订阅不等于切换当前配置文件，也不代表规则策略发生了改变。订阅地址可能包含访问凭据，截图、日志或求助材料中应隐藏完整地址及其中的认证参数。
服务器信息
服务器信息指建立连接所需的地址、端口、协议与认证等参数集合，日常也会称为节点信息。服务器显示名称只是便于辨认的标签，不决定实际连接方式。应按自己的已有资料录入并核对关键字段，导入步骤见快速上手。
配置文件
配置文件用于组织 General、Rule、Host、URL Rewrite 等设置段，各段承担不同作用。服务器订阅主要提供连接资料，而配置文件描述如何解析、匹配和处理请求，两者不能简单等同。编辑前保存原文件，切换后确认当前生效文件与 Global Routing 选项。
Host
[Host] 段为指定域名设置地址映射，改变的是域名对应地址，不是直接指定 PROXY 或 DIRECT。错误或过期的映射可能使请求指向不合适的目标，即使 Rule 写法正确也可能访问失败。排查解析异常时，应将这里的映射与 DNS 设置一起核对。
URL Rewrite
[URL Rewrite] 段依据匹配条件处理请求 URL，其作用与 Rule 的连接策略不同。重写后的目标可能改变请求路径或访问结果，不能把重写规则当作普通域名分流规则使用。调整前应明确原始 URL、匹配范围与预期结果，并确认所需请求内容可被处理。
iCloud 同步
iCloud 同步与应用中的相关设置配合使用，具体同步内容与开关以应用内显示为准。同步资料不等于恢复 App Store 购买记录，也不能代替迁移后的连接检查。换机后应核对服务器列表、当前配置、路由模式以及首次连接所需的系统授权。
已购项目
已购项目是 App Store 中查找原账号购买记录并重新获取应用的入口，不是恢复规则或服务器资料的功能。Shadowrocket 以 iPhone 与 iPad 为主，其他 Apple 设备兼容性、系统要求与是否通用购买均以 App Store 页面标注为准。换机操作见已购恢复说明。