官方手册 · 按类别查词
Shadowrocket 名词解释
先区分界面模式、协议与规则策略,再阅读配置。英文名称保持应用内原文,中文说明用于解释用途与边界。
- 界面词保留原文
- 按设置用途分类
- 示例不代表实际配置
- Home
- 连接操作的主要页面,可查看连接状态、Global Routing 与 SERVER 列表,并选择已有服务器。尚未连接时可见 Not Connected 等状态文字;开关开启表示连接流程已启动,不代表每一个目标请求都已经通过验证。
- Global Routing
- 整体流量处理方式的选择入口,常见选项为 Config、Proxy、Direct。它决定是否按配置分流、使用代理路径或使用直连路径;若修改了规则却看不到预期效果,应先核对这里是否为 Config。
- Config / Proxy / Direct
- 在 Global Routing 中,三者分别对应配置、代理、直连:Config 按当前配置规则处理请求,Proxy 使用代理路径,Direct 使用直连路径。它们是整体模式,不是协议类型,也不要与规则里的大写 PROXY、DIRECT 混为一谈。
- On Demand
- 按已设置的条件,由系统触发连接行为的功能,可用于减少重复手动操作。它回答“何时建立连接”,Rule 回答“请求走哪条路径”;排查意外自动连接时,应同时检查 On Demand 条件和当前系统连接状态。
- Add Server
- 手动填写用户已有服务器信息的入口,需按实际协议选择 Type,并核对地址、端口及认证参数。协议不同,字段要求也不同;不要把某种协议的密码、UUID 或 TLS 参数直接套用到另一种协议。
- Connectivity Test
- 按当前选定的测试方法检查服务器连通性,用于辅助判断条目是否可达。测试成功只说明该测试条件下得到响应,不等于所有网站都可访问;测试失败也需结合方法、目标和本地网络继续判断。
- 延迟
- 测试请求完成指定往返过程所需的时间,通常以毫秒表示,不是文件传输速率。比较结果前,应保持测试方法、测试目标和网络条件相近;单次数字较低不能直接证明长时间连接更稳定。
Type / Transport / TLS
协议
协议规定客户端与服务器如何通信。选择依据是用户已有服务器的实际配置,不是名称或测试数字;同一种协议也可能采用不同传输参数。
- Shadowsocks
- 一种加密代理协议,常用连接信息包括服务器地址、端口、密码与加密方法。加密方法必须与服务器端一致,不能仅凭地址和端口完成配置;导入后仍应核对字段是否齐全。
- VMess
- 带身份认证的代理协议,常见参数包含服务器地址、端口与 UUID。除认证信息外,还可能涉及传输方式、Host、Path 和 TLS;这些值由服务器配置决定,不能仅因为名称相同就互换。
- VLESS
- 一种轻量代理协议,通常使用 UUID 标识身份,并结合具体传输方式工作。协议名称本身不代表已经启用传输加密;需要分别核对传输层、安全参数及服务器要求。
- Trojan
- 通常结合 TLS 使用的代理协议,以密码完成认证。地址、端口、密码以及用于 TLS 校验的服务器名称都可能影响连接;遇到证书错误时,应先核对证书与名称,而不是直接跳过校验。
- Hysteria2
- 基于 QUIC 的代理协议,运行依赖 UDP 路径,并使用认证及 TLS 等连接参数。若当前网络限制 UDP,可能出现连接失败;应结合服务器配置与网络条件判断,不能只根据协议名推断连接效果。
- WireGuard
- 基于密钥对建立隧道的协议,涉及私钥、对端公钥、端点与地址等参数。私钥属于敏感信息,排查时不应公开发送完整配置;端点可达也不等于隧道内的地址与路由已经正确。
- HTTP / SOCKS5
- 两种不同的代理协议,应按已有服务器支持的类型选择,而不是按访问的网站类型选择。认证方式和可处理的流量范围可能不同;仅看到 HTTP 或 SOCKS5 名称,不能据此认定传输已加密。
- TLS
- 用于保护传输并校验对端身份的机制,不是单独的服务器条目类型。服务器名称、证书有效性与设备时间都可能影响握手;应按照已有服务器的要求设置,并保留合理的证书校验。
- Rule
- 配置中负责匹配请求并指定策略的规则集合。Global Routing 为 Config 时,通常从上到下检查规则,命中后采用对应策略;精确条件宜放在宽泛条件之前,避免被前面的规则提前匹配。
- DOMAIN
- 精确匹配完整域名,不包含 URL 的路径和查询参数。
DOMAIN,example.com,PROXY指定该域名采用 PROXY;它不等于同时匹配www.example.com等所有子域名。
- DOMAIN-SUFFIX
- 匹配指定域名及其子域名,适合按域名层级组织规则。
DOMAIN-SUFFIX,example.com,PROXY可覆盖example.com与其子域名,但不是任意包含这段文字的域名。
- DOMAIN-KEYWORD
- 匹配域名中包含指定文本的请求,范围通常比精确域名规则更宽。
DOMAIN-KEYWORD,ads,REJECT是语法示例,不代表所有包含该文本的域名都应拒绝;使用前应检查误匹配范围。
- GEOIP
- 按目标 IP 在地理数据库中的归属匹配请求,例如
GEOIP,CN,DIRECT。数据库归类不能说明内容所用语种、服务主体所在地或实际内容来源;判断结果还与解析出的地址及数据库内容有关。
- IP-CIDR / IP-CIDR6
- 分别用于匹配 IPv4 与 IPv6 地址段,斜杠后的数字表示网络前缀长度。
IP-CIDR,192.168.0.0/16,DIRECT可作为局域网地址段示例;IPv6 地址段应使用 IP-CIDR6,并核对前缀范围。
- USER-AGENT
- 依据可读取的请求 User-Agent 信息进行匹配的规则类型,不等于按任意应用名称识别所有流量。是否能匹配受协议、加密及请求信息可见性限制,不能假设每个连接都具有可读取的这一字段。
- FINAL
- 前面的规则均未命中时使用的兜底规则,通常放在 Rule 列表末尾。
FINAL,PROXY表示未被前面条件覆盖的请求采用 PROXY;若过早放置 FINAL,后面的规则就失去预期作用。
- PROXY / DIRECT / REJECT
- 规则中的常见策略,分别表示使用代理、直接连接与拒绝请求,书写时保留大写原文。策略说明“怎么处理”,DOMAIN 等条件说明“匹配什么”;PROXY 的实际出口还需结合当前服务器与策略设置核对。
- DNS
- 把域名解析为 IP 地址的机制,为后续连接提供目标地址,也可能影响 IP 类规则的判断。解析成功与连接成功是两个环节;排查时应区分域名解析失败、地址不可达和服务器连接失败。
Subscribe / Config
订阅与配置文件
服务器条目、订阅和规则配置是不同对象。以下说明以用户已有自己的订阅或服务器信息为前提,本站不提供、不销售、不推荐节点或订阅。
- Subscribe
- 通过用户已有订阅地址获取和更新服务器条目的管理方式,不等于客户端购买记录。订阅地址可能包含访问凭据,应妥善保管;更新后需核对条目变化,且服务器订阅更新不等于整份规则配置同步更新。
- SERVER
- Home 中展示已有服务器条目的区域,条目可能来自手动填写或订阅导入。名称只是便于辨认的标签,实际连接取决于协议、地址、端口及认证参数;更换选中条目后,应重新验证实际请求。
- .conf
- 承载配置文本的文件形式,常见段落有 General、Rule、Host 与 URL Rewrite,各段承担不同作用。Config 页面用于管理配置,而 Global Routing 中的 Config 是按配置运行的模式;导入配置后还需确认实际启用的是哪一份。
- Host
- 配置中用于指定域名映射关系的段落,可影响某个域名最终得到的目标地址。它不等于 HTTP 请求头中的 Host 字段,也不直接替代 PROXY 或 DIRECT 策略;固定地址后还应考虑目标地址变化与证书名称是否匹配。
- URL Rewrite
- 按条件对请求地址等内容进行改写的配置功能,与只选择流量策略的 Rule 不同。它可能改变请求行为,且适用性受请求信息可见性限制;导入前应读懂条件和结果,排查时可逐项停用以缩小范围。
App Store / Purchase
商店与账号
购买应用、恢复已购和导入连接信息分别处理。Shadowrocket 是 Apple 平台的闭源商业应用,以 iPhone 与 iPad 使用为主。
- App Store
- Shadowrocket 唯一的购买与下载入口,也是查询价格、系统要求和更新记录的来源。核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID
932747118后再购买;具体操作见正版核验说明。
- 一次性买断
- 指购买客户端使用资格的付费方式;美区价格约为 2.99 美元,实际金额与货币以 App Store 页面为准。客户端一次性买断 ≠ 线路套餐,客户端买断 ≠ 线路套餐;连接仍需用户已有自己的订阅或服务器信息。
- 已购项目
- App Store 中用于查找当前购买账号历史应用的入口,换机或重装时可先从这里查找 Shadowrocket。购买记录与本地配置是两件事,重新下载客户端不等于自动恢复所有服务器和规则;恢复步骤见已购恢复说明。
- 店面与兼容性
- 店面影响应用展示、结算货币与可购状态,设备兼容性则决定能否在当前设备使用。Mac、Apple TV 与 Apple Vision 的支持情况也可查看同一商店页;系统要求、设备兼容性及购买适用性一律以 App Store 页面标注为准。