Shadowrocket 术语表
按含义查找界面词、协议名与规则关键字。先区分匹配条件、处理策略与连接参数,再修改对应设置。
- 英文界面词原样保留
- 五类概念索引
- 每个词条可通过锚点引用
INTERFACE & SWITCHES
界面与开关
先判断开关控制的是整体连接、路由选择还是诊断行为。连接开关已打开,不代表每个请求都会采用同一条路径。
- Global Routing
- 决定整体路由姿态的选项,常见选择为 Config、Proxy、Direct,对应配置、代理、直连。Config 根据当前配置的规则处理请求,Proxy 与 Direct 则用于选择整体代理或直连姿态。排查自定义规则不生效时,先确认这里是否选择了 Config,再检查规则本身。
- Config / Proxy / Direct
- 这是 Global Routing 中的三个界面词,不是三个服务器名称。Config 表示依据配置分流,Proxy 表示采用代理路径,Direct 表示采用直连路径。它们与规则行中的大写
PROXY、DIRECT处于不同层级,记录问题时最好把所在页面一起写明。
- On Demand
- 根据预设条件由系统触发 VPN 连接的机制,适用于需要按网络环境管理连接的场景。它不等同于规则列表,也不是某个协议的名称。修改后应分别检查切换网络、锁屏恢复和手动断开后的行为,避免把条件触发的重新连接误认为开关失效。
- DNS
- 把域名解析为 IP 地址的机制,是访问域名时的重要环节。DNS 解析成功只说明取得了地址,之后的连接仍可能受路由、服务器状态或协议参数影响。遇到延迟测试正常但网页打不开时,应分别核对解析结果与实际连接记录,不要同时改动所有 DNS 字段。
- Connectivity Test
- 用于检查指定连接路径是否可达的测试入口,结果取决于测试方式与目标。测试成功不能直接证明所有网站、所有协议和所有规则均正常。比较多个记录时,应保持测试方式和当前网络一致;测试失败后,再结合 Log 判断失败发生在解析、建立连接还是后续请求阶段。
- Ping
- 通常用于描述探测响应耗时,但界面中的具体测量含义要结合当前测试方式理解。较低的数值不直接等于更高的下载速度,也不能保证长连接稳定。判断实际体验时,应结合应用访问结果、连续测试与网络切换情况,不要仅凭一次测试就修改整份配置。
- Log
- 查看连接与诊断记录的入口,可帮助定位解析失败、连接错误或规则命中问题。排查时先记下操作时间,再复现一次故障,便于把记录与具体请求对应起来。分享记录前应检查服务器地址、订阅链接、身份标识及其他敏感字段,只保留定位问题所需的部分。
PROTOCOLS
协议
协议名称说明连接采用的技术方式,不代表连接参数已经完整。类型、身份信息、传输与安全层设置应以你已有的服务器资料为依据。
- Shadowsocks
- 一种代理协议,常见连接参数包括服务器地址、端口、密码与加密方式。客户端与服务器两端需要使用相互匹配的参数,仅填对地址和密码仍可能连接失败。若服务商资料包含额外选项,应逐项核对,不要凭协议名称自行补入其他记录中的设置。
- VMess
- 一种使用身份标识并结合传输设置建立连接的代理协议。服务器地址、端口与身份标识之外,还可能涉及传输类型、路径、Host 和 TLS 相关参数。导入后出现连接失败时,应检查整组参数是否对应同一条服务器记录,而不是只检查身份标识。
- VLESS
- 一种需要结合传输层与安全层设置使用的代理协议,身份标识只是连接资料的一部分。它与 VMess 不是可以直接互换的协议选项,即使字段外观相似,也不应仅修改类型来复用记录。核对时应按服务商提供的完整信息确认传输、安全层和服务器名称等设置。
- Trojan
- 一种通常基于 TLS 建立连接的代理协议,常见资料包括服务器地址、端口、密码以及服务器名称等。证书相关错误与密码错误属于不同问题,应分别检查。遇到 TLS 失败时,优先核对系统时间、服务器名称和证书信息,不宜把跳过证书验证作为常规处理方式。
- Hysteria2
- 一种基于 QUIC 的代理协议,连接表现与当前网络的 UDP 可用性有关。认证、TLS 以及资料中明确提供的其他参数都需要与服务器匹配。某个网络下失败、换网络后成功时,应保留同一组参数比较网络条件,而不是先认定服务器记录填写错误。
- WireGuard
- 一种基于公私钥与 Peer 配置建立隧道的协议,常见概念包括接口地址、对端公钥、Endpoint 与 Allowed IPs。握手成功不代表所有目标地址的路由和 DNS 都已正确。私钥属于敏感信息,排查配置时不要把完整私钥或包含私钥的二维码发给他人。
- HTTP / SOCKS5
- 两类代理协议名称,具体使用哪一种必须与服务器提供的入口一致。协议名称本身不代表客户端到代理服务器之间已经加密,也不应因为网站使用 HTTPS 就混淆代理入口的类型。核对时需同时确认地址、端口、认证要求及服务端明确支持的能力。
RULE KEYWORDS
规则关键字
规则前半部分描述“匹配什么”,策略部分描述“匹配后怎样处理”。先检查匹配范围,再检查顺序,最后确认引用的策略是否存在。
- 规则
- 由匹配条件与处理策略组成的配置条目,通常按照从上到下的顺序检查,命中后停止继续匹配。例如
DOMAIN-SUFFIX,example.com,PROXY包含关键字、匹配值与策略。更具体的条件通常放在更宽泛的条件前面,避免被前面的规则提前命中。
- DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN匹配完整域名,DOMAIN-SUFFIX匹配指定域名及其子域名,DOMAIN-KEYWORD匹配域名中包含的关键字。三者的覆盖范围不同,不是同一写法的缩写。能准确确定目标时应优先采用清晰的匹配条件,避免过宽的关键字影响其他域名。
- IP-CIDR / IP-CIDR6
- 分别按 IPv4 与 IPv6 地址网段进行匹配,斜杠后的前缀长度决定网段范围。例如
192.168.0.0/16是一种 IPv4 网段表达。IP 规则与域名规则的判断依据不同,实际匹配还需结合目标地址、解析结果和前面已经命中的规则检查。
- GEOIP
- 依据 IP 地址归属数据库进行匹配的规则关键字,归属结果取决于数据库内容和更新情况。它不根据网页语言、域名后缀或使用者所在位置直接判断。使用 CDN 或共享基础设施的服务尤其需要结合实际目标 IP 检查,不能仅凭站点名称推断命中结果。
- FINAL
- 在前面规则均未命中时采用的兜底规则,通常放在规则列表末尾。例如
FINAL,DIRECT表示把尚未匹配的请求交给 DIRECT。它决定未覆盖流量的处理方式,因此修改前应先确认哪些请求会落到这里,而不是把 FINAL 当成修复所有连接问题的开关。
- PROXY / DIRECT / REJECT
PROXY表示使用代理策略,DIRECT表示直连,REJECT表示拒绝请求。它们是处理方式,不是域名、协议或服务器地址;PROXY 最终使用的路径还要结合当前配置与选择确认。自定义策略名称也需要在配置中有对应定义。
- USER-AGENT
- 依据请求中 User-Agent 信息进行匹配的规则关键字,前提是当前处理路径能够读取相关内容。加密流量中不可见的信息,不能仅靠写入一条规则就用于匹配。因此它不适合被当成所有应用都有效的识别方式,使用前应先确认实际请求与当前功能条件。
SUBSCRIPTION & CONFIG
订阅与配置
订阅负责取得与更新服务信息,配置负责组织规则和相关设置。导入成功、订阅更新成功与实际连接成功,是需要分别验证的三个结果。
- Subscribe
- 用于导入或更新订阅内容的入口,订阅链接应从你的服务商处获取。订阅通常可以包含多条服务器记录,与只描述一个服务器的链接不同,也不一定包含完整分流配置。订阅地址可能带有访问凭据,复制、截图或提交问题时应避免公开完整链接。
- Add Server / SERVER
- Add Server 用于添加单个服务器记录,SERVER 相关字段用于填写对应服务器信息。记录通常由协议类型、地址、端口与认证参数等组成,不是只有一个名称。手动填写适合已有完整参数的情况;只有订阅链接时,应先使用相应的订阅入口,而不是把整条链接填进服务器地址栏。
- Config
- 作为配置管理入口时,Config 用于组织当前使用的规则、策略引用与其他配置内容。这里保存了文件,不一定表示该文件已经被选中启用;配置存在与配置生效需要分别确认。它也与 Global Routing 中的 Config 选项不同,后者表示按照当前配置处理路由。
- Scan QR Code
- 读取二维码中配置内容的入口,二维码本身只是信息载体,不会自动补全缺失参数。同样的图形可能编码单条服务器链接、订阅地址或其他内容,导入前应核对识别结果与来源。不要因为能成功扫码就认定连接一定可用,也不要公开包含认证信息的二维码。
- URL Rewrite
- 根据匹配条件改写请求 URL 或执行相关重定向处理的功能,与决定请求采用哪条路径的路由规则不同。它不能直接代替 DOMAIN-SUFFIX 或 FINAL,也不是修复 DNS 失败的通用方法。使用前应了解匹配范围与流量可见性,并通过单项测试确认没有影响其他请求。
- iCloud 同步
- 通过 iCloud 在适用设备之间同步受支持的数据,实际同步范围应以当前应用选项为准。它与从服务商更新订阅是两个过程,也不等同于恢复商店购买记录。遇到数据未出现时,应分别检查 iCloud 账号、同步开关、网络状态与等待同步的具体内容。
PACKAGES & PLATFORMS
安装包与平台
先区分操作系统与处理器类型,再选择获取方式。本站安装包通过 /dl/shadowrocket/ 路径提供,具体入口集中在下载页。
- .deb / .rpm / .AppImage
- Linux 常见的软件包格式,应根据发行版、包管理器与系统环境选择,而不是按文件大小判断。.deb 常用于 Debian 系发行版,.rpm 常用于采用 RPM 包管理的发行版;.AppImage 通常需要先赋予可执行权限,再检查运行依赖。具体操作见安装放行说明,不要把不同格式的命令混用。
- Apple 芯片 / Intel
- 这是选择 Mac 安装包时需要核对的处理器类型,可从系统的“关于本机”查看。Shadowrocket 为两类处理器分别提供 .dmg 安装包,不能只根据电脑外观或购买年份判断。若首次打开出现“无法验证开发者”,核对来源后按安装放行说明在“隐私与安全性”中处理。
- App Store / 已购项目
- App Store 是 iPhone / iPad 获取 Shadowrocket 的商店渠道,重新下载时可在原购买账号的已购项目中查找。核对产品时,应同时查看开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118;系统要求以 App Store 页面标注为准。iPhone / iPad 版 App Store $2.99 一次性付费,Mac、Windows、安卓、Linux 版免费。
- 客户端与线路服务
- 客户端负责执行代理连接、规则分流与本地设置,线路服务提供可连接的服务器与认证资料,两者不是同一项内容。客户端一次性买断 ≠ 线路套餐,已有服务器或订阅仍需要单独确认有效性。订阅更新、账号状态或服务器维护方面的问题,应根据你已有服务商提供的信息核对。