OFFICIAL MANUAL / GLOSSARY

Shadowrocket 术语表

界面与开关、协议、规则关键字、订阅与配置、商店与正版。

按名称查含义,再按所在位置判断作用。这里保留界面词与规则关键字的英文原文;每张卡片都可通过地址栏中的锚点单独引用。首次配置可先阅读使用教程,查阅时不必按顺序读完。

01 / CONTROLS

界面与开关

先看词语出现的位置。同一个 Config,在路由模式中与在文件管理页面中承担不同作用。

界面与开关 / 路由入口

Global Routing

全局路由模式入口,常用三种姿态为配置、代理、直连,对应界面词 Config、Proxy、Direct。Config 根据配置中的规则处理请求,Proxy 与 Direct 用于明确整体路由方向。这里的选择与连接开关是两项操作;选好模式后,还要核对默认服务器和实际连接状态。

继续区分 Config
界面与开关 / 配置模式

Config

出现在 Global Routing 中时,Config 表示依据当前配置进行分流,而不是让所有请求固定走同一个方向。出现在页面名称中时,Config 用于管理配置文件。排查时应同时确认选择了 Config 模式、启用了预期文件,并检查该文件的规则顺序,不能仅凭这个名称判断分流已经生效。

界面与开关 / 路由模式

Proxy / Direct

这两个首字母大写的界面词分别对应代理与直连模式,可用于对照不同路由方式下的访问表现。它们与规则中的全大写 PROXY、DIRECT 不是同一层级。切换为 Proxy 不会自动修正密码、端口或 TLS 参数;切换为 Direct 后能访问,也不能直接证明规则文件有错误。

界面与开关 / 自动触发

On Demand

按需连接功能,用于依据网络环境等条件触发连接行为,例如针对特定 Wi-Fi 设置不同处理。它解决何时连接的问题,并不负责替换服务器认证信息。设置前先确认手动连接可用,再逐条添加条件;多条条件并存时,要检查匹配顺序与当前网络是否符合预期。

界面与开关 / 参数录入

Add Server

添加服务器条目的入口,通常先选协议类型,再填写地址、端口及相应认证字段。字段应以你的服务商提供的信息为准,不同协议不能套用同一组表单含义。保存后只是建立了一条记录,还需要在 Home 选择默认服务器、打开连接开关,并检查连接是否实际成功。

界面与开关 / 诊断

Connectivity Test

用于检查连接可达性与响应情况,适合在首次连接后或更换服务器后运行。延迟数值只反映特定测试条件下的响应,不等同于下载速度,也不能证明所有域名都按预期分流。测试失败时,应记录测试方式和错误信息,再分别核对服务器参数、当前网络与 DNS。

02 / PROTOCOLS

协议

协议规定客户端与服务器如何交换数据。名称相同只是第一步,认证、传输与 TLS 等参数仍需逐项一致。

协议 / 加密方法与密码

Shadowsocks

使用约定的加密方法与密码传输代理流量的协议。录入时除服务器地址和端口外,还要让加密方法与服务端要求一致,不能把其他协议的认证字段直接移用。若服务商给出了额外参数,应完整核对;地址可达但认证失败,仍可能无法正常转发请求。

协议 / 身份与传输

VMess

具有身份认证机制的代理协议,配置中通常会出现 UUID,并可能附带传输方式、路径及 TLS 相关参数。UUID 是识别认证信息的重要字段,但不是配置的全部。导入后若无法连接,应对照原始资料检查传输层与证书条件,而不是只反复修改服务器名称。

协议 / 参数组合

VLESS

以用户标识参与认证的代理协议,不能仅凭名称推断实际连接采用了哪种传输安全组合。UUID、传输方式、TLS 与服务端要求的其他选项应共同核对。导入成功表示文本已经被解析为条目,不代表这些参数必然兼容,也不代表当前网络已能到达服务端。

协议 / TLS

Trojan

借助 TLS 承载代理流量,通常使用密码认证。SNI 用于 TLS 握手中的服务器名称指示,可能与连接地址不同,应遵照服务端资料填写。遇到证书错误时,先检查域名、设备时间和证书条件;Allow Insecure 会降低证书验证要求,不应把它作为常规修复步骤。

协议 / QUIC 与 UDP

Hysteria2

基于 QUIC 的代理协议,运行依赖相应的 UDP 通信条件。除认证信息与 TLS 设置外,网络是否允许相关 UDP 通信也是排查重点。普通网页能够直连,不代表这条协议链路一定可用;应结合服务端地址、端口与当前网络条件判断,避免只按延迟数值下结论。

协议 / Peer 与地址范围

WireGuard

通过公私钥与 Peer 配置建立隧道的协议,涉及 Private Key、公钥、Endpoint、本端地址及 Allowed IPs 等信息。Private Key 属于本端敏感信息,不应随诊断截图公开。Allowed IPs 描述隧道相关的 IP 地址范围,不是域名分流列表,也不能用域名后缀代替。

03 / MATCH → POLICY

规则关键字

一条规则通常包含匹配类型、匹配值和策略。先区分“匹配什么”,再判断“命中后怎样处理”。

规则关键字 / 完整域名

DOMAIN

按照完整域名进行匹配,例如 DOMAIN,example.com,DIRECT。它不表示把所有子域名一并纳入,若要覆盖子域名应检查是否需要 DOMAIN-SUFFIX。域名字段不填写协议前缀、端口或网页路径;将完整 URL 粘贴到这里,不能获得按页面路径匹配的效果。

规则关键字 / 域名后缀

DOMAIN-SUFFIX

按照域名后缀匹配目标域名及其子域名,适合为同一域名体系指定策略。示例 DOMAIN-SUFFIX,example.com,PROXY 可表达这一类条件。更具体的例外通常应放在宽泛规则之前;修改后要结合请求记录确认命中,而不是仅凭页面能否打开判断结果。

规则关键字 / IP 归属

GEOIP

按照 IP 地理归属数据库匹配请求的目标地址,例如 GEOIP,CN,DIRECT。数据库记录不等于网站界面语言、运营主体所在地或访问者位置,目标使用分布式服务时尤其需要注意。结果不符合预期时,应检查实际目标 IP、解析结果及数据库条件,而非只看网站名称。

规则关键字 / 地址范围

IP-CIDR / IP-CIDR6

分别用于匹配 IPv4 与 IPv6 地址范围,斜杠后的前缀长度决定覆盖范围大小。192.168.0.0/16 是地址网段写法,不是某台服务器的端口信息。只写 IPv4 条件不会自动覆盖 IPv6;如果目标同时提供两类地址,应分别检查实际连接使用了哪一类。

规则关键字 / 最终策略

FINAL

当前面的规则都未匹配时,指定剩余请求采用的策略,通常位于规则列表末尾。FINAL,DIRECT 与 FINAL,PROXY 的区别在于剩余流量的路由方向,不在于是否启用规则。若大量请求都落到 FINAL,应回查前面规则的匹配字段、顺序和实际请求域名。

规则策略 / 代理处理

PROXY

全大写 PROXY 是规则策略,表示将命中的请求交由代理处理,不是一个服务器协议名称。规则命中与服务器连接成功是不同阶段;即使策略正确,服务器参数或网络条件异常也会导致失败。排查时应同时查看命中规则、所用服务器和连接错误信息。

规则策略 / 直接连接

DIRECT

表示直接连接目标,不通过代理服务器转发该请求。DIRECT 并不跳过当前网络、DNS 或目标服务本身的限制,也不等于关闭整个客户端。若某个域名直连失败,应先核对它实际解析到的地址及本地网络状态,再考虑是否需要调整对应规则。

规则策略 / 拒绝请求

REJECT

表示拒绝匹配到的请求,可用于对明确目标进行访问控制。条件过宽可能影响登录、资源加载或其他正常功能,因此应先确认具体请求,再添加拒绝规则。出现局部功能异常时,优先查找命中 REJECT 的记录,不要直接删除整份配置来替代定位。

04 / SUBSCRIBE & CONFIG

订阅与配置

订阅负责更新连接资料,配置文件负责组织行为;导入其中一种,不代表另一种也已准备完成。

订阅与配置 / 批量导入

Subscribe

通过订阅地址导入并更新一组服务器条目,订阅从你的服务商处获取。链接可能包含与账户相关的凭据,分享日志或截图前应遮盖完整地址。更新失败不一定表示已有服务器全部失效;需要分别检查订阅地址是否有效、更新请求是否可达,以及已有条目能否连接。

订阅与配置 / 连接条目

Server

保存服务器地址、端口、协议与认证参数的连接条目,中文也常称节点。显示名称只是便于识别的标签,不决定连接方式,也不能据此判断实际位置或性能。条目已导入、已选为默认与连接已建立是三个不同状态,应按这个顺序逐项确认。

订阅与配置 / 行为组织

Config 配置文件

用于组织规则、DNS 与相关行为设置的文件,并不等同于服务器订阅。更换配置前应保留当前文件,并确认新文件的规则顺序和最终策略;启用后再核对 Global Routing 是否为 Config。不同来源的内容不能不加区分地反复覆盖,否则很难判断哪一次修改改变了行为。

订阅与配置 / 域名解析

DNS

把域名解析为 IP 地址的基础机制,解析结果会影响实际连接目标,也可能影响依赖目标 IP 的规则判断。服务器能够连接但某个域名打不开时,DNS 是需要独立检查的一环。修改前记录现有设置,修改后用同一目标复测,避免一次改变多个条件而无法比较。

订阅与配置 / 请求处理

URL Rewrite

按条件对 URL 进行重写等处理的功能,与选择服务器或按域名分流不是同一件事。HTTPS 场景还受到加密、证书与应用自身行为的限制,不能假设所有请求内容都可直接处理。只有明确了解匹配范围和处理结果时才调整相关条目,异常时可先停用对应项进行对照。

05 / STORE & IDENTITY

商店与正版

Shadowrocket 支持 iPhone、iPad、Mac、Windows、安卓与 Linux。获取渠道、购买记录与客户端配置需要分别理解。

商店与正版 / 获取渠道

App Store

iPhone / iPad 版在 App Store $2.99 一次性付费,具体当地货币显示以商店为准;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费,从本站下载页获取。iPhone / iPad 系统要求以 App Store 页面标注为准;商店地区会影响条目可见性,不应仅凭搜索结果判断应用身份。

查看全平台获取方式
商店与正版 / 购买记录

已购项目

App Store 中查找此前购买应用的记录入口,换机或重装时应先核对是否使用原购买账户,并确认当前商店的可用性。恢复下载应用与恢复服务器、规则文件是两件事,不能把购买记录当作配置备份。电脑与安卓用户的重新获取方式见下载页,不使用这项商店记录。

阅读已购恢复说明
商店与正版 / 身份核对

正版核验

iPhone / iPad 版需要同时核对官方图标、开发者 Shadow Launch Technology Limited 与应用 ID 932747118,不能仅凭名称相同作判断。Mac、Windows、安卓与 Linux 的获取入口在本站下载页,安装包使用本站 /dl/shadowrocket/ 路径。涉及首次打开时的系统提示,请按下载页对应平台的安装放行步骤处理。

查阅安装放行说明