官方手册 · 概念速查

Shadowrocket 术语与设置索引

按界面所在位置理解英文名称,再区分协议、规则和配置。这里保留应用中的英文原文;每个条目都有独立锚点,便于从操作说明返回核对。

32 个术语 5 个分类 界面词保留英文

Shadowrocket 是全平台规则代理客户端。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费。客户端一次性买断 ≠ 线路套餐;以下导入说明均以用户已有自己的订阅或服务器信息为前提。获取方式见全平台获取应用。

界面与开关

Global Routing 与连接入口

先辨认页面、模式和开关。相同名称出现在不同位置时,含义可能不同;以下按常见界面上下文说明。

整体路由方式

Global Routing

决定请求整体按哪一种方式处理,常见选项为配置(Config)、代理(Proxy)和直连(Direct)。希望按配置文件中的规则分流时,应选择 Config,并确认已选用正确配置。更换此设置会改变规则的使用前提,因此排查分流结果时应先核对这里,而不是先修改服务器参数。

页面名称 / 路由模式

Config

作为页面名称时,Config 用于管理配置文件及相关操作;出现在 Global Routing 中时,它表示按配置处理请求。已经导入一个文件,并不等于该文件正在被使用。核对时应同时查看当前选用的配置,以及 Global Routing 是否处于 Config。

路由模式

Proxy

这里指 Global Routing 中的代理模式,使请求按该模式使用代理路径,而不是按配置中的逐条规则分流。它不是 Shadowsocks 或 Trojan 这样的协议名称,也不表示服务器一定可用。注意区分界面中的 Proxy 与规则行中大写的 PROXY:前者是模式,后者是策略标识。

路由模式

Direct

这里指 Global Routing 中的直连模式,请求使用当前网络的直连路径。直连仍然需要正常的网络和 DNS,也仍可能遇到目标服务不可达的情况。它与规则中的 DIRECT 含义相关,但作用范围不同:模式影响整体处理方式,规则策略只处理命中该规则的请求。

按条件触发连接

On Demand

根据预设条件触发连接,适合需要按网络环境安排连接行为的情况。它回答的是“何时连接”,而规则分流回答的是“请求怎样处理”,两者不属于同一个开关。设置后应分别切换 Wi-Fi 与蜂窝网络验证结果;修改相关条件前,先记录原来的触发方式。

服务器添加入口

Add Server

用于添加用户已有的服务器资料,通常需要选择类型并填写地址、端口和认证参数。应按资料逐项对应填写,而不是仅凭端口或名称猜测协议。保存条目表示资料已写入客户端,并不表示远端服务已通过连接验证;完整操作可参阅使用说明。

主要操作页面

Home

用于查看服务器条目、当前选择与连接开关等主要信息。排查问题时,先确认当前选中的是预期条目,再检查连接状态,避免把另一条目的测试结果混在一起。开关显示已连接,只能说明连接流程达到相应状态,实际访问仍需单独验证。

协议

协议类型与参数边界

协议类型必须与已有服务器资料一致。速度、电量和稳定性还取决于传输方式、服务器负载与网络条件,不能只按协议名称排序。

代理协议

Shadowsocks

使用加密方式、密码等参数建立代理连接,客户端与服务器需要采用相互兼容的设置。核对资料时,除地址与端口外,还要检查加密方式是否完全一致。若资料包含额外传输参数,也需要按原始说明填写,不能认为输入密码就已完成全部配置。

代理协议

VMess

通过用户标识等信息完成认证,并可配合不同传输方式使用。除认证字段外,传输类型、路径与 TLS 设置都可能影响连接,设备时间明显异常也可能干扰认证。导入链接后仍应核对关键参数,尤其不要把其他协议的资料直接改名为 VMess。

代理协议

VLESS

将认证与传输安全分开设计,用户标识用于认证,并不等于业务数据已经加密。使用时需要同时理解服务器指定的传输方式与安全层设置。资料要求的 TLS、服务器名称或其他相关参数应配套保留,不能仅根据用户标识相同就判断两份配置等价。

代理协议

Trojan

通常依托 TLS 建立连接,再使用密码完成认证,因此密码正确并不是唯一条件。地址、端口、用于 TLS 校验的服务器名称以及证书状态,都可能影响握手。遇到证书错误时应核对服务器资料和设备时间,不应把关闭证书验证作为常规处理步骤。

基于 QUIC 的协议

Hysteria2

基于 QUIC 传输,实际表现与 UDP 可用性、链路丢包及带宽设置有关。在不同网络之间切换时,结果可能与采用 TCP 传输的条目不同。带宽参数应依据真实链路能力填写,过高的估计不一定提高吞吐;持续高速传输的电量消耗也需要单独观察。

隧道协议

WireGuard

使用密钥对与虚拟网络接口建立隧道,配置通常包含密钥、端点、接口地址及允许路由的地址范围。私钥属于敏感资料,不能放进公开截图、文章或问题描述。隧道建立后能否访问目标,还取决于路由范围、DNS 和远端网络配置,不能只看握手状态。

代理类型

HTTP

在服务器类型的语境中,HTTP 指 HTTP 代理,而不是说只能访问普通网页。访问 HTTPS 目标时可使用 CONNECT 建立隧道,但这并不自动意味着客户端到代理服务器之间也采用 TLS。是否加密代理连接,需要查看条目的实际安全设置与服务器能力。

通用代理协议

SOCKS5

可承载 TCP 连接,并在客户端与服务器均支持且设置允许时处理 UDP。SOCKS5 本身不提供传输加密,填写用户名和密码也不等于连接内容经过加密。还应关注域名由哪一端解析,以及目标业务是否需要 UDP,这些差异都会影响使用结果。

需要比较传输方式、字段含义和适用场景时,继续阅读协议详解;已有资料指定了协议时,应先按资料配置,再做连接验证。

规则关键字

匹配条件与处理策略

常见规则行由类型、匹配内容和策略组成。一般按列表顺序判断,前面的宽范围规则可能遮住后面的具体规则,FINAL 通常置于末尾。

精确域名匹配

DOMAIN

匹配一个指定的完整域名,例如 DOMAIN,example.com,DIRECT。该条不会自动覆盖所有子域名,api.example.com 需要另行考虑。若只想处理一个明确的主机名,精确匹配比包含范围更广的规则容易核对。

域名后缀匹配

DOMAIN-SUFFIX

匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 与其下的子域名。它不是任意字符串包含匹配,域名层级边界仍然重要。用于一组相关服务时,应先确认这些服务确实属于同一个域名体系。

域名字符串匹配

DOMAIN-KEYWORD

根据域名中是否包含指定字符串进行匹配,例如 DOMAIN-KEYWORD,example,PROXY。其范围可能比预期更广,因为名称包含相同字符的其他域名也可能命中。定位明确服务时宜先考虑 DOMAIN 或 DOMAIN-SUFFIX,再判断是否确实需要关键词匹配。

目标 IP 归属匹配

GEOIP

根据目标 IP 在地理数据库中的归属判断是否匹配,例如 GEOIP,CN,DIRECT。它不按网页语言、网站品牌或用户当前位置判断,数据库归属也不一定等于实际服务器位置。域名解析出不同 IP 后,匹配结果可能随之变化。

IPv4 网段匹配

IP-CIDR

通过 IPv4 地址与前缀长度描述一个网段,例如 IP-CIDR,192.168.0.0/16,DIRECT。斜杠后的数字表示网络前缀长度,不是端口号,数字越大通常匹配范围越小。对局域网设置规则时,还需确认实际网段,避免将不相关地址一并纳入。

IPv6 网段匹配

IP-CIDR6

用于匹配 IPv6 地址范围,例如 IP-CIDR6,2001:db8::/32,DIRECT 中的地址是文档示例地址。IPv4 规则不会自动覆盖 IPv6,同一域名可能同时返回两类地址。若访问结果与预期不符,应分别检查两类地址的实际路由,而不是只查看 IPv4 配置。

末尾处理策略

FINAL

为未被前面规则匹配的请求指定最终处理方式,例如 FINAL,PROXY。它通常位于规则列表末尾,用于让未分类请求有明确去向。若某个请求总是落到 FINAL,应先检查前面规则的类型、域名和顺序,而不是直接断定服务器异常。

规则动作

PROXY / DIRECT / REJECT

PROXY 表示代理处理,DIRECT 表示直连处理,REJECT 表示拒绝该请求;具体代理出口还需结合当前选择与配置判断。这些是规则策略,不是通信协议,也不是带宽或连通性的测试结果。规则中也可能引用自定义策略组名称,使用前应确认该名称已在配置中定义。

订阅与配置

资料导入与配置生效

服务器条目、订阅和配置文件各有用途。导入成功、更新成功与连接成功分别代表不同阶段,不应只看其中一个提示。

订阅操作项

Subscribe

用于获取或更新用户已有订阅内容,具体作用要结合所在页面与资料类型判断。更新通常意味着重新读取远端内容,因此条目数量、名称或参数可能发生变化。更新前应留意本地手动修改是否会被覆盖;更新后再检查当前选择,而不是默认仍在使用原来的条目。

可更新的资料来源

订阅

通过一个地址获取可更新的服务器资料或配置内容,链接应从你已有的服务商处获取。不同地址可能返回不同格式,服务器订阅并不必然包含完整的规则与 DNS 设置。链接中的认证参数属于敏感信息,排查时应隐藏完整地址,不要将它发布到公开页面。

连接参数集合

服务器

在客户端中通常指一组可连接的远端服务参数,包括协议、地址、端口以及相应认证资料。条目显示名称只是便于辨认的标签,不能据此判断真实位置、速度或可用性。多个条目即使地址相同,也可能因为协议、端口或认证设置不同而具有不同连接结果。

规则与设置的组织方式

配置文件

用于组织规则、DNS 及其他相关设置,其内容范围取决于文件本身。文件已导入、文件被选用以及设置实际生效,是需要分别核对的环节。使用外部配置前应阅读关键内容,尤其是最终策略、远程资源与改写项,并保存一份可恢复的原配置。

设备间数据同步

iCloud 同步

在相关开关与账号条件允许时,通过 iCloud 同步支持的数据,具体范围应以应用中的设置为准。同步受系统权限、网络状态和云端可用性影响,不应把它视为即时完成的操作。它与 App Store 的已购项目不同:同步处理应用数据,已购项目处理购买记录,换机时应分别核对。

本站不提供、不销售、不推荐节点或订阅。已有资料的导入流程见使用说明;格式不匹配、更新失败等情况见疑难解答。

连接与诊断

解析、测试与访问结果

测试值是特定条件下的观察结果。排查时一次只改变一个设置,并记录网络环境、当前条目和目标地址,才能比较前后差异。

域名解析

DNS

将域名解析为 IP 地址,解析成功之后才进入后续连接环节。DNS 请求采用的路径,与业务请求最终采用的路径不一定相同;解析结果也可能影响 IP 类规则的命中。更换解析设置后,应考虑缓存影响,分别确认“能否解析”和“能否连接”,不要把两类故障混为一谈。

连接检查工具

Connectivity Test

按当前测试方法检查条目的连接情况,其结果取决于测试目标、网络状态和所用参数。一次测试成功不代表所有网站都可访问,测试失败也需要结合方法判断原因。比较多个条目时应保持测试条件一致,再通过实际目标访问确认,不宜只依据单次数字做结论。

响应时间指标

延迟

表示某种测试条件下请求与响应所需的时间,通常以毫秒呈现。不同测试方法可能包含不同环节,因此结果不能直接混在一起比较。延迟低并不等于带宽大或持续下载快,还需观察丢包、抖动、服务器负载与实际业务表现。

请求地址处理

URL Rewrite

根据条件改写或重定向请求 URL,解决的是请求地址怎样处理的问题,而不是选择哪条连接路径。它与规则分流属于不同功能,不能用 URL Rewrite 代替 DOMAIN-SUFFIX 等路由规则。对加密请求的可见范围与处理能力还受相关设置约束,不应为排查普通连接问题随意启用未知改写内容。

从术语返回操作步骤

首次使用时,按“导入已有资料 → 核对 Global Routing → 开启连接 → 验证访问”的顺序操作。已经可以连接但访问结果不符时,优先核对规则命中、DNS 和当前选择,避免同时改动多个参数。