官方手册 · 概念查阅

Shadowrocket 术语表

按界面位置和配置用途查词。先区分 Global Routing 的模式、Rule 的策略和服务器参数,再阅读对应操作步骤;英文名称保留应用与配置中的原样写法。

界面与开关

连接状态、路由模式和测试结果分别回答不同问题,不能互相替代。

主要页面

Home

Home 是查看连接状态、Global Routing 和服务器列表的主要页面。列表中已有条目,只说明连接信息已保存,并不表示隧道已经建立。首次操作时,先确认服务器和模式,再启用连接开关。

路由入口

Global Routing

Global Routing 决定连接整体按哪种方式处理,可选 Config、Proxy、Direct。它不是服务器选择器,切换模式不会自动修正服务器地址或认证信息。排查问题时应记录当前模式,避免在不同模式下直接比较结果。

三种模式

Config / Proxy / Direct

Config(配置)按当前配置中的规则决定连接去向;Proxy(代理)将一般连接交由所选代理处理;Direct(直连)使用直接连接。这里的名称指整体模式,不是某条 Rule 的策略值。实际连接还可能受系统网络、应用设置及连接状态影响。

连接触发

On Demand

On Demand 允许系统依据设定条件触发 VPN 连接,不等同于定时执行一次测速。启用后,即使手动断开,满足条件时也可能重新连接。需要暂时停止连接时,应同时检查 On Demand 的状态与触发条件。

诊断入口

Connectivity Test

Connectivity Test 用于检查服务器在当前网络下的响应情况,结果含义取决于所选测试方法。出现响应不代表认证、DNS 和目标站点访问都正常。完成测试后,仍需建立连接并访问预期目标进行验证。

流量观察

Data

Data 用于查看应用记录的流量信息,适合观察一段使用过程中的收发变化。应用与服务商的统计范围、重置时间和计量方式可能不同,因此不能直接把页面数值当作剩余额度。核对使用限制时,应查看你的服务商提供的信息。

设置入口

Settings

Settings 汇集应用设置,与存放规则的 Config 页面用途不同。排查连接问题时,先记录设置原值,一次只更改一项,再重复相同验证步骤。不要为了尝试恢复连接而同时修改 DNS、路由与连接触发设置。

协议

协议描述客户端与服务器如何通信。类型和参数应与服务端一致,不能只更改名称就完成转换。

代理协议

Shadowsocks

Shadowsocks 使用服务器地址、端口、加密方法和密码等参数建立代理连接。加密方法必须与服务端一致,地址正确但方法不符仍可能失败。填写所需信息从你的服务商处获取,不要凭其他服务器的设置推测。

代理协议

VMess

VMess 使用用户标识等参数进行认证,实际连接还涉及传输方式及相关选项。导入条目后,应保留链接中携带的完整设置,而不是只核对地址和端口。认证失败时,可检查参数是否完整以及设备时间是否准确。

代理协议

VLESS

VLESS 将用户认证与传输层安全分开配置,名称本身并不说明连接采用何种加密传输。除用户标识外,还应检查 TLS、传输方式等服务端要求。不要将 VMess 条目仅通过更改类型改为 VLESS。

代理协议

Trojan

Trojan 通常结合 TLS 与密码认证使用。服务器地址、端口、密码和 TLS 相关名称需要相互匹配,证书验证错误也可能导致连接失败。遇到错误时先核对服务端参数,不应直接关闭验证作为常规处理方式。

基于 QUIC

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,连接依赖 UDP 以及匹配的认证与 TLS 设置。当前网络对 UDP 的可用性会影响连接结果。协议名称相似不表示不同代际的服务端参数可以混用,应按提供的信息导入。

隧道协议

WireGuard

WireGuard 使用密钥认证,并通过地址与路由范围等参数定义隧道通信。私钥属于敏感信息,不能与一般服务器名称一起公开分享。即使完成握手,DNS 或路由范围不正确仍可能导致预期目标无法访问。

代理接入

HTTP / SOCKS5

HTTP 与 SOCKS5 是不同的代理接入协议,不能把同一端口默认视作两者通用。是否需要用户名、密码及安全传输,取决于服务器配置。协议名本身不保证整段通信已经加密,应单独确认传输安全要求。

规则关键字

先看匹配条件,再看末尾策略。以下域名与网段仅用于语法说明,不是可用服务器信息。

规则基础

Rule

Rule 根据域名、IP 地址等条件匹配连接,并指定后续处理策略。规则通常按排列顺序判断,前面已有匹配时,后面的规则可能不再生效。新增规则前应先保存配置副本,并检查是否被更靠前的宽泛条件覆盖。

完整域名

DOMAIN

DOMAIN 匹配指定的完整域名,例如 DOMAIN,example.com,DIRECT。它不会仅因名称相关就自动覆盖所有子域名。需要同时处理子域名时,应考虑 DOMAIN-SUFFIX,而不是堆叠含义不明确的关键词。

域名后缀

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY。它按域名边界匹配,不是任意字符串包含判断。一个服务可能使用多个域名,因此一条后缀规则未必覆盖其全部请求。

域名关键词

DOMAIN-KEYWORD

DOMAIN-KEYWORD 匹配域名中包含指定关键词的连接,例如 DOMAIN-KEYWORD,example,PROXY。它的覆盖范围通常比完整域名或后缀匹配更宽。关键词过短容易影响无关域名,使用前应明确希望覆盖的范围。

地址段

IP-CIDR / IP-CIDR6

IP-CIDR 用于 IPv4 网段,IP-CIDR6 用于 IPv6 网段;斜杠后的前缀长度决定地址范围。例子 IP-CIDR,192.168.0.0/16,DIRECT 表示将该私有地址段交给 DIRECT。只设置 IPv4 规则并不意味着同时覆盖 IPv6。

IP 归属

GEOIP

GEOIP 依据 IP 地理归属数据库进行匹配,而不是按网页语言或域名后缀判断。数据库可能存在更新滞后,同一域名也可能解析到不同地区的地址。结果不符预期时,应核对实际解析 IP,而不是只看网站名称。

兜底规则

FINAL

FINAL 为前面规则未匹配的连接指定兜底策略,例如 FINAL,DIRECT。它通常位于规则末尾,否则可能使后续条件失去作用。排查意外直连或代理时,既要检查具体匹配项,也要检查 FINAL 的策略。

处理策略

PROXY / DIRECT / REJECT

PROXY 表示使用代理,DIRECT 表示直接连接,REJECT 表示拒绝连接;这些大写名称是规则中的策略值。它们与 Global Routing 的 Proxy、Direct 模式处于不同层级。只有当前模式采用相关规则时,修改规则策略才会影响相应连接。

订阅与配置

服务器条目负责连接参数,订阅负责更新条目,配置文件负责规则等设置。导入其中一种,不代表另外两种也已准备完成。

连接条目

服务器 / SERVER

服务器条目保存地址、端口、协议及认证信息,常显示在 Home 的 SERVER 区域。选中条目与启用连接是两个独立动作,名称也只是便于辨认的标签。手动填写可从 Add Server 开始,所需参数从你的服务商处获取。

批量更新

Subscribe / 订阅

Subscribe 通过订阅地址获取并更新一组服务器条目,地址从你的服务商处获取。这里的订阅是信息更新方式,不是客户端购买记录。完整地址可能含访问凭据,分享截图或日志前应隐藏相关内容。

配置管理

Config / 配置文件

配置文件可包含 General 设置、Rule、Host 与 URL Rewrite 等内容,具体以文件实际章节为准。Config 既可能指页面名称,也可能指 Global Routing 中按配置处理的模式,应结合上下文辨认。导入后还要确认已选用对应文件,仅保存在列表中不代表生效。

域名解析

DNS

DNS 将域名解析为 IP 地址,是建立多数域名连接前的一个环节。DNS 服务器的可达性、缓存与解析结果都可能影响访问,以及依赖 IP 的规则判断。修改后应使用相同目标重新验证,不要把所有访问失败都归因于服务器延迟。

请求处理

URL Rewrite

URL Rewrite 根据匹配条件重写请求 URL 等内容,作用不同于为连接选择出口的 Rule。能否处理某个请求,还取决于请求是否可见及相关设置是否满足条件。修改范围过宽可能影响正常请求,应从可复现的单个目标开始检查。

测试结果

延迟

延迟表示某种测试方法下的响应耗时,不等于下载速度,也不能代表长时间连接稳定性。不同测试方法、目标和网络环境得到的数值不宜直接比较。判断实际使用情况,应同时检查认证、DNS、目标访问和持续传输结果。

安装与平台

Shadowrocket 覆盖 iPhone、iPad、Mac、Windows、安卓与 Linux。获取渠道、系统权限和线路信息是三个独立概念。

系统权限

VPN 配置

首次连接时,iPhone / iPad 可能提示允许添加 VPN 配置,这是系统为应用建立网络隧道所需的授权。它不是服务器订阅,授权成功也不代表服务器认证通过。拒绝后可重新发起连接并按系统提示处理,清理系统条目前先确认其对应应用。

处理器架构

Apple 芯片 / Intel

Mac 提供 Apple 芯片与 Intel 两种架构的安装包,应先在「关于本机」查看芯片或处理器信息。首次打开若提示无法验证开发者,可核对来源后到「隐私与安全性」选择「仍要打开」。如出现其他拦截提示,按安装放行说明逐项处理,不要反复更换架构尝试。

购买记录

已购项目

已购项目是通过对应 Apple ID 的 App Store 购买记录查找应用的入口,适用于已完成购买后的换机或重新下载。若未找到记录,应先核对购买时使用的账号与店面,而不是立即重复购买。iPhone / iPad 的系统要求以 App Store 页面标注为准。

获取渠道

2 档获取

iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。前者核对开发者 Shadow Launch Technology Limited 与应用 ID 932747118;后者通过全平台下载页获取本站 /dl/shadowrocket/ 下的安装包。Shadowrocket 是闭源商业应用,购买记录与服务商提供的线路信息分别管理。

仍有具体问题?前往常见问题按问题查找,或返回术语表顶部。