官方手册 · 按名称查阅
Shadowrocket 术语表
界面词、协议名与规则关键字保留英文原文。先辨认术语属于哪个层次，再判断应修改连接模式、服务器参数还是配置文件。
查找操作步骤可阅读快速上手；需要完整规则片段时，转到配置字段。获取 Shadowrocket 请先阅读App Store 下载指南。
Interface / Switches
界面与开关
这些名称描述操作入口或连接姿态，不是服务器协议，也不直接代表某条 Rule。
- Global Routing
- 这是选择整体连接方式的设置，常见三种姿态为配置 Config、代理 Proxy、直连 Direct。需要规则分流时先检查是否选中了 Config，再检查当前配置文件；仅编辑 Rule 而保持 Proxy，通常不能得到预期的逐条规则分流结果。排查时记录原模式，每次只改一个选项，避免把模式差异误判为服务器故障。
- Config
- Config 既是配置文件管理入口，也出现在 Global Routing 的模式选项中，含义取决于所在位置。作为管理入口时，用于查看、编辑和选择配置文件；作为连接模式时，表示按当前配置处理请求。文件已经导入，不代表它已经成为当前使用的配置，操作后需要再次核对选择状态。
- Proxy
- Proxy 是 Global Routing 中的代理姿态，主要按当前选定的代理处理请求，仍需留意系统流量与绕过设置。它不是 Shadowsocks、VLESS 等协议的统称字段，也不说明服务器是否可用。可在排查规则影响时临时使用这一姿态测试，完成后恢复原设置。
- Direct
- Direct 是 Global Routing 中的直连姿态，主要通过当前网络直接访问目标。它可以帮助对照同一目标在当前网络下的访问表现，但直连成功不代表代理服务器参数正确。界面中的 Direct 与规则文本中的 DIRECT 属于不同层次，修改其中一个并不会自动改写另一个。
- On Demand
- On Demand 根据预设网络条件请求系统建立 VPN 连接，例如针对不同网络环境应用连接条件。它处理的是何时连接，不是某个域名应该采用 PROXY 还是 DIRECT。启用后还需核对系统 VPN 配置与触发条件，手动关闭后的表现也应结合当前条件判断。
- Connectivity Test
- 这是检查服务器连接表现的测试入口，测试结果与测试方法、目标地址和当前网络有关。显示的延迟表示特定测试过程的耗时，不等于下载速度，也不保证所有目标都能访问。比较结果时保持测试方法一致；测试失败后仍需分别检查地址、端口、认证与实际请求。
Protocols
协议
协议决定连接如何建立。填写 Add Server 时，以已有服务器资料为准，不通过名称推断认证、传输或证书参数。
- Shadowsocks
- Shadowsocks 使用指定加密方法与凭据连接服务器，地址、端口、密码和加密方法需要配套一致。导入后若无法连接，应逐项核对这些字段，而不是只检查密码。已有资料若包含额外传输参数，也需按服务器实际配置填写，不能自行替换为看起来相近的选项。
- VMess
- VMess 使用用户标识等参数进行认证，常见资料还会指定传输方式与安全选项。UUID 正确并不足以证明配置完整，Host、路径或 TLS 设置不一致也可能使连接失败。分享链接导入后应对照原始资料检查字段，尤其不要把网页 URL 的路径直接当作传输路径。
- VLESS
- VLESS 使用用户标识进行认证，协议本身不负责载荷加密，连接安全取决于配套传输与安全配置。服务器资料中的传输类型、TLS 相关字段和其他选项需要一起核对，不能只填入 UUID。遇到缺失字段时应补齐已有资料，不宜凭协议名称猜测默认组合。
- Trojan
- Trojan 通常结合 TLS 与密码认证建立连接，服务器地址与证书对应的名称可能需要分别填写。连接失败时应检查密码、端口、服务器名称以及设备时间，证书验证问题不能简单等同于密码错误。优先修正名称或证书配置，不应把关闭验证作为常规配置步骤。
- Hysteria2
- Hysteria2 基于 QUIC，通常使用 UDP 承载连接，认证与相关参数应来自已有服务器资料。协议名称中的数字是名称的一部分，不是本页声明的 Shadowrocket 应用版本。当前网络对 UDP 的处理会影响连接表现，因此某个 TCP 测试成功并不能证明该连接也可正常建立。
- WireGuard
- WireGuard 通过公钥识别通信对端，配置通常涉及本地私钥、对端公钥、Endpoint、地址与 Allowed IPs。它的字段不能按普通地址加密码的服务器条目理解，密钥也不应放入公开截图或排查记录。Allowed IPs 涉及该隧道配置的流量范围，不能仅凭它推断 Shadowrocket 中其他规则的执行结果。
- SOCKS5
- SOCKS5 是代理请求协议，可转发 TCP 连接，并在客户端与服务器双方支持时处理 UDP。其名称本身不代表传输已加密，是否需要用户名和密码由服务器配置决定。检查条目时分别确认认证要求和 UDP 支持，不要把 HTTP 代理字段直接套入 SOCKS5。
Rule / Policy
规则关键字与策略
Rule 按顺序检查条件，命中后采用指定策略。条件回答“匹配什么”，策略回答“如何处理”。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT这里的 example.com 仅用于语法说明。具体条件置前，FINAL 置于末尾；示例中的 PROXY 仍需对应用户已有的可用服务器。
- DOMAIN
- DOMAIN 按完整域名匹配，例如
DOMAIN,example.com,DIRECT针对 example.com 本身。它不自动包含 www.example.com 等所有子域名，也不匹配网页路径。需要覆盖子域名时使用 DOMAIN-SUFFIX，而不是在完整域名后随意添加通配符。
- DOMAIN-SUFFIX
- DOMAIN-SUFFIX 匹配指定域名及其子域名，例如 example.com 与 www.example.com。条件中只填写域名，不包含 https://、端口或页面路径。若希望某个子域名采用不同策略，应把更具体的 DOMAIN 规则放在这一后缀规则之前。
- DOMAIN-KEYWORD
- DOMAIN-KEYWORD 按域名中出现的字符串匹配，例如关键词 example 可能命中多个不同域名。它的范围通常比指定后缀更宽，容易包含名称相近但用途不同的目标。编写时先确认需要覆盖的范围，能够精确描述目标时优先采用更具体的条件。
- GEOIP
- GEOIP 依据 IP 地理归属数据库匹配目标地址，例如
GEOIP,CN,DIRECT。结果描述的是目标 IP 的数据库归属，不是访问者的位置，也不能直接代表网站的运营主体。域名解析结果与数据库内容都会影响判断，因此它不适合替代所有精确域名规则。
- IP-CIDR
- IP-CIDR 按 IPv4 地址段匹配，例如
192.168.0.0/16表示一个网络范围，斜杠后的数字是前缀长度而不是端口。IPv6 地址段使用 IP-CIDR6，不应直接套入 IPv4 示例。需要在域名请求中匹配目标地址时，还应考虑解析过程及规则选项的影响。
- FINAL
- FINAL 为没有命中前面规则的请求指定最终策略，通常放在 Rule 段末尾。它不需要域名或地址条件，例如
FINAL,DIRECT。如果提前放置，后面的规则通常没有机会继续处理未匹配请求，因此排查规则顺序时先检查这一行的位置。
- PROXY
- PROXY 是规则文本中的代理策略，表示命中请求通过代理处理，实际服务器取决于当前选择与配置。它不是协议类型，也不包含地址、端口或认证资料。注意保留大写写法，并与 Global Routing 的界面词 Proxy 区分：一个是单条规则的结果，一个是整体连接姿态。
- DIRECT
- DIRECT 是规则文本中的直连策略，表示命中请求直接连接目标。它仍受当前网络、DNS 与目标服务状态影响，并不等于请求一定能够成功。局域网地址段常使用这一策略，但应根据实际网络范围填写条件，避免把过大的地址段误设为直连。
- REJECT
- REJECT 是拒绝策略，命中的请求不会继续建立正常的目标连接。它既不是 Proxy 的替代服务器，也不是网络故障的自动修复选项。若页面部分资源无法加载，应检查相关域名是否被拒绝规则命中，再判断条件是否过宽或顺序是否不合适。
Subscription / Configuration
订阅与配置文件
服务器列表解决“连接到哪里”，配置文件组织“请求怎么处理”。导入其中一类资料，不代表另一类也已准备好。
- Subscribe
- Subscribe 用于导入和更新用户已有的服务器列表，常见操作是在 Add Server 中选择相应类型并填写已有订阅地址。订阅返回的数据需要符合客户端可识别的格式，能够在浏览器打开并不代表内容可直接导入。地址可能包含认证信息，分享排查资料前应隐藏完整链接中的敏感部分。
- SERVER
- 服务器条目记录建立连接所需的资料，包括地址、端口、协议与认证参数，具体字段随协议变化。服务器可用性是建立连接的前提，而显示名称只是便于辨认的标签。单条分享链接和订阅都可能生成服务器条目，但两者的更新方式不同，手动编辑后也需留意订阅更新是否覆盖修改。
- 配置文件
- 配置文件是组织 General、Rule、Host 与 URL Rewrite 等设置的文本，各段落有不同作用。它不等于服务器订阅，文件中出现 PROXY 也不说明已包含可用的服务器资料。编辑前保留可恢复的副本，保存后在 Config 核对当前文件，并检查 Global Routing 是否采用 Config。
- General
- General 是配置文件中的通用设置段落，常见字段涉及 DNS 与绕过行为，例如
dns-server = system。字段值需要按各自语法填写，不能把 Rule 的逗号分隔格式套用到这里。修改一项后先验证影响，再继续调整其他字段，便于定位与回退。
- Host
- Host 段用于设置特定主机名与地址的映射，例如
localhost = 127.0.0.1。它处理的是名称与地址关系，不是指定 PROXY 或 DIRECT 的规则。固定映射可能在目标地址变化后失效，因此遇到某个域名持续访问异常时，也应检查是否存在旧映射。
- URL Rewrite
- URL Rewrite 按指定模式处理请求 URL，其作用不同于 Rule 的连接策略选择。规则通常需要同时说明匹配模式、目标和处理方式，正则表达式中的点号等字符也要正确转义。HTTPS 请求的可见性受到加密与相关设置限制，不能仅凭一条 Rewrite 假定所有地址都能被处理。
System / Account
系统与账号
区分应用购买、系统授权与网络资料。恢复应用不等于恢复服务器，系统显示已连接也不等于目标访问已经通过验证。
- DNS
- DNS 将域名解析为 IP 地址，解析失败可能表现为网页打不开或特定目标访问异常。DNS 与代理服务器认证是不同环节，调整解析设置不能修复错误密码或失效服务器。排查时先记录现有 DNS 设置，并结合连接模式与域名规则判断解析请求实际采用的路径。
- VPN 配置
- 首次打开连接开关时，系统可能请求允许添加 VPN 配置，用于保存和管理 Shadowrocket 的网络连接。这个系统条目不等于服务器资料，也不表示已经具备可用线路。若条目被删除，需要再次从应用发起连接并完成系统授权，然后另行验证服务器与目标访问。
- Apple ID
- Apple ID 用于 App Store 的购买和已购识别，当前商店地区会影响应用可见性与显示币种。购买前应核对 App Store 正在使用的账号，而不是仅凭设备上的 iCloud 登录状态判断。Shadowrocket 只通过 App Store 获取，系统要求与设备兼容性均以 App Store 页面标注为准。
- 已购项目
- 已购项目是 App Store 中查看历史购买并重新获取应用的入口，名称和所在位置可能随系统界面变化。换机或重装时应使用原购买账号核对记录；重新获取应用不等于自动恢复应用内的订阅与配置文件。正版核对还应检查开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。
- iCloud 同步
- iCloud 同步通过云端在设备间保存或传递应用资料，具体同步范围以 Shadowrocket 内显示的选项为准。它与 App Store 的购买记录是两套不同机制，启用同步也不代表每项资料都已完成备份。换机前应确认同步状态与必要资料是否可恢复，同时注意订阅地址和认证参数的保密。