界面与开关
Home
管理已有服务器与订阅、选择连接对象并查看连接状态的入口。列表中出现服务器，只说明资料已经保存，不代表 VPN 已建立或目标服务可用。首次使用时，先核对选中的项目，再检查连接开关和系统显示的 VPN 状态。
界面与开关
连接入口与路由模式
Home 管理连接对象，Global Routing 决定处理方式，On Demand 决定触发时机。这三个层次分别检查，比反复切换所有开关更容易定位问题。
界面与开关
Global Routing
选择整体路由方式，三种姿态为配置（Config）、代理（Proxy）和直连（Direct）。Config 按当前配置规则处理连接，Proxy 让可被接管的连接使用代理策略，Direct 使用直连方式。它不负责提供服务器，也不等同于连接开关；排查规则未生效时，应先确认是否处于 Config。
界面与开关
On Demand
按照已设定的网络条件触发 VPN 连接的功能，适合在明确条件下自动建立连接。它解决“何时连接”，规则分流解决“连接后如何处理请求”。发现手动断开后又连接时，先检查 On Demand 的条件；测试手动连接前可暂时关闭该功能，减少变量。
界面与开关
Add Server
手动添加用户已有服务器信息的入口，需要按实际协议填写地址、端口及认证参数。不同协议的必填项不同，不能把一种协议的密码或用户标识直接套入另一种协议。保存后应重新核对 Type、地址、端口与 TLS 等信息，再进行连接测试。
界面与开关
Connectivity Test
对列表项目执行连通性测试的功能，结果受测试目标、测试方法和当时网络状态影响。测试耗时通常以毫秒显示，但不能直接当作下载速度或持续传输能力。对比结果时保持测试方法一致；单次失败后，还应结合实际访问与连接日志判断。
界面与开关
DNS
把域名解析为 IP 地址的机制，是按域名访问服务时的重要环节。DNS 查询成功只说明取得了地址，不代表后续连接一定成功；解析结果也可能影响基于 IP 的规则判断。排查时分别检查解析、规则命中与连接出口，不要仅凭网页打不开就更换 DNS。
代理协议
协议名称与参数关系
协议规定客户端与服务器如何通信，不代表固定速度或质量。以下只解释技术含义；填写时以用户已有服务器的实际参数为准，不根据名称猜测认证方式或传输设置。
代理协议
Shadowsocks
一种代理协议，常见参数包括服务器地址、端口、加密方法和密码。客户端与服务器的加密方法必须一致，仅核对密码仍不足以保证连接成功。若已有配置还包含其他相关参数，应完整保留，并逐项对照服务端说明。
代理协议
VMess
使用用户标识等参数进行认证的代理协议，UUID 是常见的身份字段。传输方式、路径、Host 与 TLS 等设置需要与服务器端对应，UUID 正确并不代表整套参数都正确。导入后若连接失败，应核对传输层设置，而不是只反复更改用户标识。
代理协议
VLESS
一种使用用户标识进行认证的代理协议，协议名称本身不代表已经启用传输加密。实际连接还取决于所用传输方式及 TLS 等安全设置。不能仅把 VMess 项目的 Type 改成 VLESS 就视为完成转换，应使用服务器明确提供的对应参数。
代理协议
Trojan
通常结合 TLS 使用的代理协议，密码用于认证，服务器名称与证书验证影响 TLS 握手。连接地址与用于验证证书的名称可能不同，需要按已有配置分别填写。出现证书错误时，应检查名称、证书有效性与设备时间，不应直接跳过证书验证。
代理协议
HTTP / SOCKS5
两类通用代理协议，均可能使用地址、端口和账号密码，但通信机制不同。不能仅凭名称认定连接已经加密，是否使用 TLS 以及 UDP 能力应分别确认。添加时选择与实际服务一致的 Type，不要把普通网站地址当作代理端点。
代理协议
WireGuard
基于密钥对的隧道协议，配置涉及本地密钥、对端公钥、端点地址与地址范围等信息。私钥属于敏感资料，应仅保存在用户自己控制的环境中，分享排查截图前必须移除。导入后还要核对地址范围与路由安排，不能只看端点是否填写完整。
代理协议
Hysteria2
基于 QUIC 的代理协议，依赖 UDP 通路，常见核对项包括端口、认证信息、TLS 服务器名称及可能存在的混淆参数。仅能建立 TCP 连接不足以证明该协议可用。若切换本地网络后表现不同，应检查 UDP 可达性；带宽相关设置也应依据实际情况填写。
阅读协议概览 →规则关键字
匹配对象与执行策略
规则通常按列表自上而下检查，先命中的规则决定处理方式。先确定要匹配域名还是 IP，再选择关键字；修改后在 Global Routing 的 Config 模式下检查实际命中结果。
规则关键字
DOMAIN
匹配完整域名，例如 DOMAIN,example.com,PROXY 只指定该域名，不自动覆盖它的子域名。域名字段不包含 https://、端口或网页路径。若实际请求来自另一个子域名，应增加对应规则或采用合适的后缀匹配。
规则关键字
DOMAIN-SUFFIX
匹配指定域名及其子域名，例如 DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 与 www.example.com。字段中不需要添加 *.，也不应填写完整网址。它按域名边界匹配，不是对任意字符串执行包含判断。
规则关键字
DOMAIN-KEYWORD
匹配域名中出现的指定字符串，例如 DOMAIN-KEYWORD,example,PROXY。它的范围通常比完整域名或后缀匹配更宽，可能命中原本未计划处理的域名。用于精确控制时优先考虑 DOMAIN 或 DOMAIN-SUFFIX，并检查规则顺序是否造成提前命中。
规则关键字
IP-CIDR
按 IPv4 地址范围匹配，写法由网络地址与前缀长度组成，例如 IP-CIDR,192.168.0.0/16,DIRECT。斜杠后面的数字表示网络前缀长度，不是端口号。规则处理的是目标 IP；如果访问始于域名，还需要考虑解析结果以及当前配置的解析行为。
规则关键字
IP-CIDR6
用于匹配 IPv6 地址范围，例如 IP-CIDR6,2001:db8::/32,DIRECT，其中地址仅作语法说明。IPv4 网段规则不能替代 IPv6 规则；同一域名可能同时解析出两类地址。排查某条 IP 规则未命中时，应先确认实际连接使用的地址类型。
规则关键字
GEOIP
根据 IP 地理数据库记录的归属匹配目标地址，例如 GEOIP,CN,DIRECT。它不依据网页语言、域名后缀或用户所在位置判断，数据库记录也可能与服务实际部署位置存在差异。需要精确控制某个域名时，可在它之前放置更具体的域名规则。
规则关键字
FINAL
前面规则都没有匹配时采用的兜底规则，例如 FINAL,PROXY。通常将它放在规则列表末尾；过早出现会使后面的规则失去被检查的机会。排查访问去向不符合预期时，应同时检查前面的具体规则与最终策略，而不是只修改 FINAL。
规则关键字
PROXY / DIRECT / REJECT
规则命中后采取的策略：PROXY 使用代理策略，DIRECT 使用直连，REJECT 拒绝连接。这里的大写关键字与 Global Routing 中的 Proxy、Direct 属于不同层次，不能混作同一个开关。策略应放在规则要求的位置；连接被 REJECT 拒绝时，重复测试服务器通常不能解决问题。
订阅与配置文件
服务器列表与配置内容
订阅主要维护连接对象，配置文件主要描述处理方式，两者不应仅凭链接外观区分。导入前先确认内容用途，并妥善保存原始资料；订阅地址中的认证信息不应出现在公开截图中。
订阅与配置文件
Subscribe
通过用户已有订阅地址获取并维护服务器列表的方式，地址从用户自己的服务商处获取。它不等同于单个服务器，也不必然包含完整路由规则或 DNS 设置。导入后应检查返回的列表与分组是否符合预期，不要将网页说明地址直接作为订阅地址填写。
订阅与配置文件
服务器
指一组连接端点信息，通常包含协议、地址、端口与认证参数，也常被称为节点。显示名称只是便于辨认的标签，不能证明实际位置、速度或可用状态。用户已有多个项目时，应按来源整理，并通过一致的测试方法确认可用性，而不是只根据名称选择。
订阅与配置文件
Config
在配置管理中指配置文件入口，文件可以包含规则、DNS 与其他处理设置；在 Global Routing 中则表示按配置规则运行的模式。导入配置文件不等于已经选中它，也不代表当前路由模式已切换为 Config。修改前保留原配置，修改后核对当前使用的文件及实际访问结果。
查看 Config 设置说明 →订阅与配置文件
订阅更新
重新请求已有订阅地址并刷新服务器信息的过程，与通过 App Store 更新 Shadowrocket 应用不同。更新可能改变列表内容或覆盖来源字段，因此本地手动修改不一定长期保留。更新失败时先核对地址、有效状态与网络连通性，再查看返回错误；盲目重复添加可能造成列表重复。
查看订阅失败问答 →订阅与配置文件
URL Rewrite
按照条件对请求 URL 进行重写或重定向的配置能力，与选择直连或代理的路由规则解决不同问题。匹配表达式范围过宽可能影响原本正常的请求，因此应先理解规则内容再启用。HTTPS 内容处理还涉及相应的解密条件，并非添加一条重写规则就会自动生效。
App Store 与账号
App Store
Shadowrocket 的唯一购买与获取入口，应用以 iPhone 和 iPad 使用为主，Mac、Apple TV 与 Apple Vision 的适用情况可在同一商店页兼容性栏核对。系统要求、兼容性与购买适用范围以 App Store 页面标注为准。产品页链接所指店面不等于账号当前的商店地区，购买前应检查实际显示信息。
查看 App Store 获取指南 →App Store 与账号
一次性买断
一次性购买客户端的付费方式，美区价格约为 2.99 美元，各店面按当地货币显示，实际金额以商店页面为准。客户端一次性买断 ≠ 线路套餐，购买应用并不会自动获得服务器或订阅。后续连接仍以用户已有自己的服务器信息为前提。
查看价格与购买范围 →App Store 与账号
正版核验
结合官方图标、开发者名 Shadow Launch Technology Limited 和应用 ID 932747118 核对产品，不能只凭“Shadowrocket”名称判断。应用 ID 可从产品页地址中的 id932747118 确认，图标应与本站使用的官方图标一致。Shadowrocket 是闭源商业应用，购买与更新信息以 App Store 为准。
App Store 与账号
已购项目
App Store 中查找原账号购买记录的入口，换机或重装时应使用原购买账号检查记录。恢复应用与恢复应用内配置是两个独立步骤，重新获取客户端不表示服务器资料已同步。iPhone 与 iPad 的购买适用范围、家人共享条件均以 App Store 页面标注为准。
查看换机与重装说明 →