Home
查看服务器条目、当前选择与连接开关的主要页面。列表里已有条目，只说明信息已被保存，不代表连接已成功建立。首次使用应先核对所选服务器，再操作连接开关，并留意系统提示与实际访问结果。
官方手册 / 概念速查
Shadowrocket 术语与规则关键字
按使用场景查找界面词、协议与配置概念。先分清正在调整的是整体模式、匹配条件还是执行策略，再回到对应页面操作；同样含有 Proxy 的名称，不一定处于同一层。
界面词保留英文
规则自上而下匹配
以已有订阅或服务器信息为前提
界面与开关
页面入口与整体模式
模式决定是否按配置分流，连接开关决定是否建立连接，两者需要分别确认。
Global Routing
决定整体连接处理方式的模式选择，配置、代理、直连分别对应 Config / Proxy / Direct。排查规则不生效时，先确认这里是否选择 Config，再检查规则文本。改变模式并不会自动修正服务器参数，也不能代替连通性验证。
Config
作为 Global Routing 的模式时，表示按当前启用配置中的规则选择策略。它与用于管理配置文件的 Config 页面名称相同，但语境不同。选择这个模式后，仍需确认启用的是哪份配置，以及其中是否包含预期的 Rule。
Proxy
Global Routing 中的代理模式，主要通过当前代理选择处理连接，适合与 Config 模式作对照排查。它不是某个协议，也不保证当前服务器可用。若 Proxy 可访问而 Config 下失败，应继续检查命中规则和策略选择，而不是立即重填全部服务器参数。
Direct
Global Routing 中的直连模式，用于通过当前网络直接连接目标。它与规则里大写的 DIRECT 属于不同层次：前者是整体模式，后者是某条规则的执行策略。对照测试时保持目标与本地网络不变，才能更清楚地判断差异来自哪一层。
On Demand
根据已配置的网络条件触发连接行为的功能，可用于 Wi-Fi 或蜂窝网络切换等场景。它决定何时连接，不负责替每个域名选择 PROXY 或 DIRECT。若手动断开后连接又出现，应核对 On Demand 条件与系统当前网络，而不是只反复操作开关。
Connectivity Test
用于检查连通性的诊断入口，结果会随测试方法、目标与当前网络改变。延迟反映一次测试的响应耗时，不等同于持续传输速度；测试成功也不代表每个网站都能访问。遇到超时，应结合协议参数、系统时间与实际连接结果继续排查。
协议
服务器如何建立连接
协议是客户端与服务器共同遵守的通信方式。使用已有服务器信息时，应成套核对协议、认证与传输参数，不能只比较地址和端口。
Shadowsocks
使用共享密钥与加密方法的代理协议，连接两端必须使用兼容的设置。填写时重点核对服务器地址、端口、密码和加密方法；若使用附加传输设置，也需要与原始信息一致。不要仅凭名称相近就替换加密方法，参数不匹配可能直接导致连接失败。
VMess
使用用户标识等参数进行身份校验的代理协议，可与不同传输方式组合使用。除了地址与端口，还需核对用户标识、传输类型及 TLS 相关设置。若已有订阅能正常导入，应先比对导入结果与原始参数，避免因手动修改遗漏 Host 或路径等关联字段。
VLESS
采用较精简认证结构的代理协议，认证方式与传输安全需要分开理解。VLESS 本身不提供完整的传输加密保障，实际连接还依赖配套的安全与传输设置。不能直接把 VMess 条目的类型改成 VLESS 后沿用全部字段，应以用户已有的服务器信息为准。
Trojan
通常在 TLS 连接内传输代理数据，并使用密码进行认证。核对时应区分连接地址、用于 TLS 校验的服务器名称与密码，三者承担不同作用。证书校验失败时，优先检查名称、系统时间与服务器证书，不应把关闭校验当作常规修复步骤。
Hysteria2
基于 QUIC 的代理协议，连接表现会受到网络对 UDP 的支持情况影响。认证信息、TLS 参数以及服务器提供的相关选项都需要配套填写。若切换本地网络后结果明显不同，应先记录网络差异再排查，不能只根据协议名称推断速度或稳定性。
WireGuard
通过公私钥与对端配置建立加密隧道的协议，其参数组织方式不同于只填写密码的服务器条目。需要成套核对密钥、端点与隧道相关设置，不能将某个公钥填作普通密码。私钥属于敏感信息，排查时应隐藏后再分享配置片段或诊断记录。
规则关键字
匹配条件与兜底规则
规则类型回答“按什么匹配”，末尾策略回答“命中后怎么处理”。下面的地址与域名只用于说明语法，不是服务器或订阅来源。
DOMAIN
精确匹配一个域名，例如 DOMAIN,example.com,PROXY。这条规则匹配 example.com，不会因为域名存在从属关系就自动包含所有子域名。需要覆盖整个域名范围时，应考虑 DOMAIN-SUFFIX，并检查是否已有更靠前的规则提前命中。
DOMAIN-SUFFIX
匹配指定域名及其子域名，例如 DOMAIN-SUFFIX,example.com,PROXY。它按域名层级边界匹配，而不是查找任意一段相似字符串。适合为同一域名范围统一指定策略；若其中一个子域名需要例外，应将更精确的规则放在它前面。
DOMAIN-KEYWORD
根据域名中是否包含指定字符串进行匹配，例如 DOMAIN-KEYWORD,ads,REJECT。它不要求关键词构成完整域名层级，因此可能同时命中本来不想处理的域名。使用较短关键词时尤其要核对命中记录，避免将字符串相似误当作业务相关。
GEOIP
依据 IP 地理数据库中的地区归类进行匹配，例如 GEOIP,CN,DIRECT。数据库归类并不等于设备实际位置，也不说明网站运营者位于哪里。目标使用 CDN 或解析结果变化时，命中情况可能随之改变，因此排查时需要核对实际目标 IP。
IP-CIDR
用 IPv4 地址与前缀长度表示一个网段，并按目标地址匹配，例如 IP-CIDR,192.168.0.0/16,DIRECT。斜杠后的数字决定网段范围，不是服务器端口。编写局域网规则前应确认实际网段，避免将范围写得过宽而覆盖原本希望走其他策略的连接。
IP-CIDR6
针对 IPv6 地址段的匹配关键字，例如 IP-CIDR6,2001:db8::/32,DIRECT，其中地址是文档示例。IPv4 与 IPv6 应分别核对，已有 IPv4 规则不代表 IPv6 连接也会命中。若同一域名的处理结果不一致，应查看实际使用的地址类型。
USER-AGENT
在能够获取 User-Agent 信息时，按其内容判断是否匹配的规则关键字。它不是对所有应用都有效的识别方式，尤其不能假定加密请求中的相关信息总是可见。排查未命中时，先确认请求是否具备可用信息，再判断规则条件是否正确。
FINAL
为前面规则均未命中的连接指定兜底策略，例如 FINAL,PROXY。它通常放在 Rule 列表末尾，不需要额外填写域名或网段条件。若把 FINAL 放在具体规则之前，后面的规则就可能失去匹配机会，因此顺序是检查配置时的重要项目。
策略与匹配顺序
命中之后如何处理
大写 PROXY、DIRECT、REJECT 是规则策略，不应与 Global Routing 中的界面模式混为一谈。
PROXY
规则命中后使用代理处理该连接，实际出口取决于当前代理选择及配置。PROXY 只是执行方向，不包含服务器地址、认证信息或可用性保证。若日志显示已命中 PROXY 但访问仍失败，应转而核对所选服务器、协议参数和连通性。
DIRECT
规则命中后直接连接目标，不通过代理服务器转发该连接。它不代表跳过 DNS，也不意味着目标一定能被当前本地网络访问。若直连失败而代理路径正常，应结合本地网络、解析结果与目标状态判断，不能仅靠改变规则顺序解释全部问题。
REJECT
规则命中后拒绝该连接，常用于阻止明确不需要的请求。它与服务器超时不同：前者是策略主动决定，后者可能是网络或参数异常。若正常功能受到影响，应先找出命中的拒绝规则，缩小条件或调整例外，而不是一次删除全部规则。
首条命中
规则按自上而下顺序检查，第一条满足条件的规则通常就决定连接策略，后续规则不再参与选择。具体规则并不会仅因“更精确”就自动获得更高优先级，位置同样重要。实践中可先放明确例外，再放范围规则，最后用 FINAL 兜底。
订阅与配置文件
来源、配置与解析
服务器信息回答“连接到哪里”，配置回答“按什么方式处理”。导入成功之后，还需要核对当前选择、启用配置与实际连接状态。
订阅
通过一个 URL 获取并更新用户已有服务器条目的方式，链接从用户自己的服务商处获取。订阅地址可能包含访问凭据，应视作敏感信息，不宜出现在公开截图中。更新服务器列表不等于同步更新 Config 中的分流规则，两者应分别确认。
Subscribe
添加订阅来源时使用的类型，URL 字段应填写用户已有的完整订阅地址，而不是账户管理网页。示例 https://example.com/sub?token=xxxx 只说明格式，不能用于连接。保存后应检查是否生成预期的服务器条目，并留意复制时是否带入空格或截断查询参数。
Config 配置文件
组织连接行为与规则的配置文本，常见分段包括 [General]、[Rule]、[Host] 与 [URL Rewrite]。各段承担不同职责，规则应放入对应位置，而不是任意追加到文件末尾。导入后还要确认当前启用项，修改前保留原配置便于对照恢复。
DNS
把域名解析为 IP 地址的机制，是建立许多网络连接前需要完成的环节。解析是否成功、返回什么地址，会影响连接目标，也可能影响基于 IP 的规则判断。域名访问失败时，应将解析故障与代理连接故障分开检查，避免一次同时更改多项设置。
URL Rewrite
用于按条件处理请求 URL 的配置部分，其作用不同于 Rule 中选择连接出口的规则。改写是否生效还取决于请求是否满足条件以及相关信息是否可被处理，不能假定所有加密请求都可直接改写。仅需调整直连或代理方向时，应优先检查 Rule，而不是添加改写规则。
需要按顺序完成操作，可从使用说明继续；遇到规则结果与预期不一致时，先保留当前配置和命中记录，再逐项调整。