官方手册 · 术语查阅

Shadowrocket 术语手册

界面词、协议名称与规则关键字

先确认名称所在的位置,再判断它的作用。相近的拼写可能分别表示页面、路由模式或规则策略;本页保留英文原文,按使用场景说明区别。

  • 5 类术语
  • 33 个条目
  • 英文原文对照

界面与开关

区分“在哪里操作”和“连接怎样处理”。尤其注意 Config、Proxy、Direct 与大写规则策略的上下文。

Home
Home 是查看服务器记录、选择连接对象并操作主连接开关的主要页面。先确认列表中已有可用记录,再检查 Global Routing,最后开启连接;只在列表里看到一条记录,并不代表 VPN 已经连接。连接后的访问结果还取决于所选服务器、当前配置和网络状态。
Global Routing
Global Routing 决定连接采用哪一种全局处理模式,常见选项为配置(Config)、代理(Proxy)和直连(Direct)。Config 依据当前配置的规则处理,Proxy 主要使用所选代理,Direct 主要直接访问目标。排查分流结果前先核对这里,避免修改规则后却仍在其他模式下测试。
Config
Config 有两个常见语境:作为页面名称时管理配置文件,作为 Global Routing 选项时表示按配置处理连接。导入一个文件与选用它是两个动作,保存后还应确认当前生效的配置。阅读教程时先看它描述的是页面入口还是模式选项,不要仅凭同名判断操作位置。
Proxy
Proxy 是 Global Routing 中的模式名称,主要将连接交给当前选定的代理处理。它不是服务器协议类型,也不表示当前服务器已经通过连通性检查。与规则里的 PROXY 相比,前者控制整体模式,后者是某条规则命中后的处理策略。
Direct
Direct 是 Global Routing 中主要让连接直接访问目标的模式,适合用来比较当前网络的直接访问表现。选中它不等同于从系统中移除 VPN 配置,也不能仅凭此判断主连接开关是否关闭。需要暂停客户端连接时,应单独检查 Home 的开关状态。
On Demand
On Demand 是按已设条件触发 VPN 连接的机制,不是另一个服务器协议。启用后,符合条件的网络请求可能再次触发连接,因此手动停止后又连接时,应先检查相关条件。调整它之前先明确希望在哪些场景连接,再逐项验证,不要同时改动多项网络设置。
Add Server
Add Server 是手动添加服务器信息的入口,需要依据已有资料选择类型并填写地址、端口及认证参数。不同协议的必填项不同,不能把一组参数直接套入另一种类型。资料不完整时应先核对原始信息;服务器地址、密码与其他认证数据也不宜出现在公开截图中。
Data
Data 用于观察客户端记录的流量,具体统计维度应以应用当前页面为准。这里的数字反映客户端的统计口径,不等同于服务商侧的额度或计费账单。对照读数时应确认统计时间范围、是否清零及连接期间的实际流量,不能只凭一次读数判断扣费异常。
Settings
Settings 集中管理应用偏好及相关行为设置,它与 Config 中的配置内容不是同一层级。修改前先记下原值,并确认改动影响的是应用整体还是当前配置。排查时每次只调整一项,再使用相同目标复测,便于识别究竟是哪项设置改变了结果。

协议

协议描述客户端与服务器之间的通信方式。支持某个协议,不代表任意地址与认证信息都能组合使用。

Shadowsocks
Shadowsocks 是一种加密代理协议,常见参数包括服务器地址、端口、加密方法和密码。加密方法必须与服务器端一致,仅地址正确仍可能连接失败。导入已有记录后应核对参数是否完整,尤其不要把密码、加密方法与其他协议的认证字段混用。
VMess
VMess 是一种代理协议,通常使用 UUID 作为认证信息的一部分,并配合具体的传输设置。地址与端口之外,还可能需要核对 TLS、传输路径和 Host 等参数。UUID 正确不代表其余字段可留空,应以用户已有的完整服务器资料为依据。
VLESS
VLESS 是一种代理协议,认证标识、传输方式和安全层设置需要分别匹配。协议名称本身不能完整说明连接是否加密,也不能代替 TLS 等安全参数的核对。出现连接失败时,先比较原始资料与导入字段,再检查网络,不要只反复更换 UUID。
Trojan
Trojan 是通常结合 TLS 使用的代理协议,需要匹配服务器密码与证书验证相关参数。服务器地址和用于证书验证的名称可能承担不同作用,填写时应遵循原始资料。遇到证书错误应检查名称、设备时间及证书状态,而不是把关闭验证作为常规解决步骤。
Hysteria2
Hysteria2 是基于 QUIC 的代理协议,连接依赖网络对 UDP 的支持。认证信息正确但连接超时,也可能与当前网络或服务器端的 UDP 可达性有关。它与其他协议的同名字段并不一定具有相同含义,导入和核对时应使用对应类型的参数。
WireGuard
WireGuard 是基于密钥的隧道协议,需要正确配对本地与对端的密钥、地址及端点信息。私钥属于敏感信息,不应与用于核对的公钥混淆,也不应公开分享。导入配置后仍需检查地址、路由范围与 DNS 设置;只有握手成功,并不足以说明全部目标均可访问。

规则关键字

规则先描述匹配条件,再指定处理策略。一般按顺序判断,较宽泛的条件放得过早,可能让后面的精确规则失去作用。

DOMAIN
DOMAIN 按完整域名精确匹配,例如 DOMAIN,example.com,DIRECT 只针对指定的域名。它不会自动涵盖 www.example.com 等子域名,也不匹配网址里的路径。需要覆盖整组子域名时,应进一步了解 DOMAIN-SUFFIX 的范围。
DOMAIN-SUFFIX
DOMAIN-SUFFIX 按域名后缀匹配,填写 example.com 时可覆盖该域名及其子域名。这里填写的是域名部分,不应加上网址的协议前缀或页面路径。检查规则范围时要考虑整个域名下的业务,避免为了一个页面改变所有子域名的处理方式。
DOMAIN-KEYWORD
DOMAIN-KEYWORD 检查域名是否包含指定字符串,匹配范围通常比精确域名规则更宽。相同字符串可能出现在多个不相关域名中,因此不能把它当作归属某个网站的可靠证明。只想处理一个确定域名时,优先考虑范围更明确的条件。
GEOIP
GEOIP 依据 IP 地理信息数据库判断目标 IP 的地区,例如 GEOIP,CN,DIRECT。它判断的不是网页语言、账号地区或网站运营者所在地。数据库记录、DNS 返回结果与内容分发网络都会影响实际匹配,应结合连接记录检查,不能仅凭网站名称推断。
IP-CIDR
IP-CIDR 用 CIDR 网段表示法匹配目标 IPv4 地址,例如 IP-CIDR,192.0.2.0/24,DIRECT,其中地址用于文档示例。斜杠后的前缀长度决定覆盖范围,不是端口号。IPv6 地址使用对应的 IP-CIDR6 规则,编辑前应先确认地址类型与网段边界。
FINAL
FINAL 是前面规则均未命中时的兜底规则,例如 FINAL,PROXY。它通常放在规则列表末尾,因为过早兜底会让后续条件失去匹配机会。大量连接落到 FINAL 时,应检查前面的匹配条件是否过窄、是否写错,以及当前是否处于 Config 模式。
PROXY
PROXY 是规则策略关键字,表示命中后交给代理路径处理,具体出口与当前选择和配置有关。它本身不包含服务器地址、认证信息或可用性保证。这个大写关键字不要与 Global Routing 的 Proxy 模式混淆:规则策略只在对应规则参与判断并命中时起作用。
DIRECT
DIRECT 是命中规则后直接访问目标的策略关键字,不使用代理服务器作为这条连接的出口。直连能否成功仍受当前网络、DNS 结果和目标服务状态影响。它也不代表关闭整个客户端;同一份配置里,其他连接仍可能根据其他规则使用不同策略。
REJECT
REJECT 表示拒绝命中规则的连接,它不是“换一条线路重试”。如果条件写得过宽,可能连带阻止登录、图片或应用接口等正常请求。遇到某项功能单独失败时,应先检查是否命中拒绝规则,再缩小范围,不宜直接删除整份配置。

订阅与配置

订阅负责更新服务器记录,配置负责描述连接行为。先判断缺少哪一类资料,再选择对应的导入与排查步骤。

Subscribe
Subscribe 用于通过订阅地址导入及更新服务器记录,订阅从你的服务商处获取。更新通常会刷新该订阅管理的记录,不代表已经选中新服务器,也不代表已经建立连接。订阅地址可能含有个人凭据,应妥善保管;更新失败时先检查地址有效性、网络和返回内容格式。
服务器记录
服务器记录是客户端保存的一组地址、端口、协议与认证参数,也常被称为节点。列表中的名称只是便于辨认的标签,不能据此判断真实位置、速度或是否可用。修改参数前先确认记录来自手动填写还是订阅,因为后续订阅更新可能覆盖由订阅管理的内容。
配置文件
配置文件描述规则、DNS 与相关连接行为,不等同于包含服务器记录的订阅。导入配置并不必然得到可用服务器,导入订阅也不等于完成了规则设置。使用前应确认配置来源、内容与当前需求,并在 Config 中核对生效文件,避免只保存了文件却未选用。
DNS
DNS 将域名解析为 IP 地址,是访问目标前的重要环节,但解析成功不代表连接一定成功。解析使用的路径与业务连接最终采用的路径需要分别检查,不能仅凭一个 IP 结果推断流量出口。排查时先区分域名无法解析、解析结果异常和连接目标超时,再调整相应设置。
Connectivity Test
Connectivity Test 按当前测试方式检查服务器连通性,显示的时间只对应这一测试过程。较低的延迟不等于较高的下载速度,单次测试成功也不表示所有网站与服务都能正常访问。比较结果时保持测试方式和网络一致,并结合实际目标访问验证,避免只看一个数字。

App Store 与购买

购买记录决定应用的获取资格,服务器与订阅信息则属于另一类资料。换机时应分别检查这两部分。

App Store
App Store 是 Shadowrocket 唯一的购买与获取入口,iPhone 与 iPad 用户应在产品页核对应用信息。可见性与当前账号所在商店地区有关,搜索结果里出现相似名称时也应逐项确认。兼容设备及系统要求以 App Store 页面标注为准,获取前可阅读正版下载说明。
应用 ID
Shadowrocket 的应用 ID 为 932747118,产品页地址中写作 id932747118。正版核对还应同时检查开发者 Shadow Launch Technology Limited 与官方图标,不能仅凭相似名称判断。应用 ID 是产品标识,不是账号标识,也不是订阅认证信息。
一次性买断
一次性买断指购买客户端使用资格,美区价格约为 2.99 美元,各店面按当地货币显示,实际金额以 App Store 页面为准。客户端一次性买断 ≠ 线路套餐,购买应用不会自动获得服务器或订阅。已有订阅仍应从你的服务商处获取,并按使用说明单独导入。
已购项目
已购项目指 App Store 中与购买账号关联的应用记录,可用于换机或重装时重新获取应用。先确认登录的是购买时使用的 Apple ID,再在账号的应用或购买记录中查找;具体入口名称以设备界面为准。重新获取应用与恢复订阅、配置是不同事项,详见已购项目恢复说明。

按操作继续查阅

已确认术语后,回到对应步骤核对设置。涉及规则时,先检查 Global Routing 与当前配置,再比较规则顺序和命中结果。