Home
Home 是连接与服务器选择的主要页面,可从连接状态、Global Routing 和 SERVER 等区域判断当前准备使用的设置。操作连接开关前,先确认选中的服务器确实是要测试的条目。显示已连接只说明连接机制已经启动,仍需通过实际访问与连接记录检查目标是否可达。
先辨认界面词,再判断它属于连接参数、路由选择还是诊断结果。本页是官方手册的术语索引;每条可通过标题对应的锚点直接定位,英文名称与配置关键字保留原样。
这一组回答“在哪里操作”和“开关控制什么”。系统授权、整体路由与连接状态是三个不同层次,不应互相替代判断。
Home 是连接与服务器选择的主要页面,可从连接状态、Global Routing 和 SERVER 等区域判断当前准备使用的设置。操作连接开关前,先确认选中的服务器确实是要测试的条目。显示已连接只说明连接机制已经启动,仍需通过实际访问与连接记录检查目标是否可达。
Global Routing 控制整体路由方式,三种姿态为配置、代理、直连,对应界面词 Config、Proxy、Direct。排查某条规则未生效时,先确认是否处于 Config,而不是直接修改规则内容。它决定采用哪一类路由逻辑,具体规则策略则是下一层判断。
在 Global Routing 中,Config 按当前配置的规则决定连接路径,Proxy 以代理路径处理连接,Direct 以直接连接目标的方式处理连接。这里的 Config 是路由姿态;阅读教程时,还要根据上下文区分它是否指配置管理页面。切换姿态后应重新发起测试连接,已有连接未必能反映新选择的结果。
On Demand 根据已设条件触发 VPN 连接,处理的是“何时建立连接”,而不是“某个域名走哪条路径”。它不替代 Rule 段,也不会修正填写错误的服务器参数。手动断开后又出现连接时,应先检查 On Demand 条件,再判断是否存在其他连接问题。
Add Server 是填写服务器信息的入口,先选择协议类型,再按已有信息填写地址、端口和身份凭据。TLS、传输方式及附加字段也需要逐项对应,不能仅凭服务器备注推断。完整操作顺序可查阅使用说明,修改前宜保留原条目便于对照。
首次建立连接时,Apple 系统可能要求允许添加 VPN 配置,并通过设备的系统验证确认操作。授权让 Shadowrocket 能够建立系统层面的连接,不代表订阅有效或服务器已经通过测试。应在主动使用应用时确认系统提示,随后回到 Home 检查状态;系统要求以 App Store 页面标注为准。
协议定义两端如何交换数据与校验身份,不是连接质量的等级。服务器使用什么协议,就填写对应类型与参数;名称相近也不能混用身份字段。
Shadowsocks 使用密码、加密方法等参数建立代理连接,地址与端口用于定位服务器。密码正确但加密方法不一致,仍可能无法完成连接。应从已有服务器信息逐项核对,不要把其他协议的 UUID 填进密码字段,也不要凭名称猜测加密方法。
VMess 包含身份校验机制,常见身份字段是 UUID,另外还可能涉及 alterId、传输方式和 TLS 设置。alterId 的值应按已有服务器信息填写,不应把旧教程中的示例当成通用值。UUID 一致但传输参数不一致,同样可能连接失败;设备时间异常也值得纳入身份校验排查。
VLESS 使用 UUID 标识身份,协议本身不提供数据加密,传输保护需要结合实际部署设置理解。TLS、flow 以及传输方式必须与服务器端相互配套,不能看到同一个 UUID 就直接沿用 VMess 配置。具体字段差异可继续阅读VMess 与 VLESS 字段说明。
Trojan 通常结合 TLS 使用,并以密码进行身份校验。除地址、端口与密码外,还需要核对服务器名称和证书验证所依赖的信息。遇到 TLS 报错时,应先检查名称、时间与证书链,不应把关闭证书验证当成常规修复方法。
Hysteria2 基于 QUIC,连接依赖 UDP 网络路径,认证与 TLS 参数需要和服务器端保持一致。即使域名能够解析,UDP 路径受限时也可能无法建立连接。若已有信息包含混淆设置,应同时核对对应参数;协议名称本身不能保证更低延迟或更高吞吐。
WireGuard 使用密钥建立加密隧道,需要配套的本地密钥、隧道地址和对端信息。公钥用于标识对应一端,私钥属于敏感凭据,不应出现在公开截图或排查材料中。它的参数组织方式不同于密码或 UUID 类协议,应使用已有的完整配置,而不是只复制一个服务器地址。
规则左侧判断“匹配什么”,末尾策略决定“如何处理”。先检查 Global Routing,再检查匹配顺序;更具体的规则通常应放在范围更宽的规则之前。
规则把匹配条件和执行策略放在同一条记录中,例如 DOMAIN-SUFFIX,example.com,PROXY。Rule 段通常自上而下检查,先命中的有效规则决定处理方式,后续条目不再替这次匹配作决定。编辑时既要看某条内容是否正确,也要看它是否已被前面的宽范围规则覆盖。
DOMAIN 按完整域名匹配,例如 DOMAIN,example.com,DIRECT 只针对对应域名。它不会因为名称中有 example.com 就自动覆盖 api.example.com。需要处理整个域及其子域时,应结合 DOMAIN-SUFFIX 判断范围,而不是重复猜测完整域名的行为。
DOMAIN-SUFFIX 按域名后缀边界匹配,填写 example.com 时可覆盖它自身及 api.example.com 等子域名。它不是任意字符串包含匹配,因此 notexample.com 不属于同一后缀范围。示例 DOMAIN-SUFFIX,example.com,PROXY 只演示语法,不代表可用的服务器配置。
DOMAIN-KEYWORD 根据域名中是否含有指定关键字进行匹配,覆盖范围通常比 DOMAIN 或 DOMAIN-SUFFIX 更宽。关键字过短时,可能把不相关的域名也纳入同一策略。只有确实需要这种宽范围时才使用,并通过连接记录检查是否出现误匹配。
GEOIP 依据 IP 地理数据库中的分类结果匹配,而不是依据网页所用的文字或用户所在位置。域名解析到不同地址时,判断结果也可能变化,数据库分类同样可能存在偏差。遇到与预期不符的连接,应先核对实际目标 IP 与命中规则,不宜仅从网站名称推断结果。
IP-CIDR 用于 IPv4 网段,IP-CIDR6 用于 IPv6 网段,斜杠后的前缀长度决定匹配范围。例如 IP-CIDR,192.0.2.0/24,DIRECT 演示一个 IPv4 网段条目,其中地址属于文档示例。写错前缀长度可能扩大处理范围,检查时应同时确认地址族、网络地址与执行策略。
USER-AGENT 依据 HTTP 请求中的 User-Agent 信息匹配,它并不是设备上所有应用的通用识别方式。请求信息是否可见,会受到协议、加密与相关处理设置的限制。无法命中时,应先确认记录中能否获得这一信息,而不是简单增加更多关键字。
FINAL 是兜底规则,用于处理此前条目都未命中的连接,通常放在 Rule 段末尾。例如 FINAL,PROXY 表示把剩余连接交给 PROXY 策略。修改 FINAL 会影响所有剩余连接,不是只影响一个网站;应先确认已有精确规则是否覆盖了需要例外处理的目标。
PROXY 表示使用代理策略,DIRECT 表示直接连接目标,REJECT 表示拒绝连接;它们写在规则中,作用于命中该条规则的连接。规则里的大写策略关键字,不等于 Global Routing 中的 Proxy、Direct 界面选项。若目标命中了 REJECT,应先检查规则意图,而不是把拒绝结果直接归因于服务器故障。
服务器条目提供连接所需参数,订阅负责获取或更新条目,配置文件组织路由及相关设置。导入成功后,仍要确认内容类型与当前启用状态。
在日常操作中,节点通常指一组能用于建立连接的服务器参数,包括协议、地址、端口、身份凭据及传输选项。显示的备注只是名称,改名不会改变服务器实际位置或连接方式。排查时应核对参数本身,分享材料时则应遮盖密码、UUID 和其他认证信息。
订阅通常通过一个地址获取服务器列表,并在更新时同步相应条目;Subscribe 是订阅相关操作的界面词。请使用你已经拥有的订阅,更新成功只表示本次获取与解析完成,不保证每个服务器都能连接。订阅地址可能带有访问凭据,不应公开粘贴;导入入口见订阅导入入口说明。
分享链接把服务器参数编码为一段文本,常见前缀包括 ss://、vmess://、vless:// 与 trojan://。一个服务器的分享链接,与可以更新服务器列表的订阅地址用途不同,导入前要先识别内容类型。编码不等于加密,链接中包含的凭据仍需保密,格式区别见分享链接与订阅地址说明。
配置文件以分段文本组织路由与相关设置,常见段名包括 [General]、[Rule]、[Host] 和 [URL Rewrite]。它不等同于服务器订阅:拥有规则文件并不表示已经具备连接所需的服务器信息。导入后应确认选用的是目标配置,并先阅读其中的 DNS、兜底策略与重写内容。
Host 段用于定义特定域名与地址之间的映射,例如 example.com = 192.0.2.1 是文档示例写法。它影响域名对应到哪个地址,不直接表示这次连接走 PROXY 还是 DIRECT。若目标地址发生变化,保留过时映射可能使连接仍指向旧地址,因此应与普通 DNS 查询结果分开检查。
URL Rewrite 根据匹配条件对 URL 进行重写等处理,与 Rule 段决定连接路径的用途不同。规则能否生效,还受到请求信息可见性、匹配表达式及相关设置的限制,并非写入任意 URL 就一定有效。导入含重写内容的配置前,应先理解匹配范围与处理结果,避免把内容处理问题和路由问题混在一起。
把“解析目标”“建立连接”“校验身份”“匹配规则”拆开检查。每次只调整一类参数,并记录调整前后的结果,才能判断真正的失败环节。
Connectivity Test 按所选测试方式检查服务器的连通性,结果只覆盖该次测试涉及的路径和目标。测试成功不等于所有网站、所有协议或所有规则路径都能正常工作。应结合实际目标访问、当前 Global Routing 与连接记录判断,不要把单次测试当成完整连接证明。
延迟是特定测试条件下请求与响应耗时的度量,不直接等于带宽或下载速度。不同测试方式、目标与网络状态产生的数字不能简单横向比较,超时也不一定表示服务器在所有条件下都不可用。需要比较时,应保持测试方式和网络环境一致,并观察多次结果与真实访问表现。
DNS 将域名查询为地址等记录,连接前通常需要先获得目标地址。解析失败和已经得到地址但连接失败属于不同环节,修改服务器密码不能修复前者。排查时先看查询是否返回结果,再看获得的是 IPv4 还是 IPv6 地址,以及后续实际命中了哪条路由规则。
TLS 提供传输加密与证书身份校验,SNI 则在握手中表达请求的服务器名称。用于连接的地址和用于名称校验的域名可能不同,应分别按已有信息填写。握手失败时要核对名称、设备时间、证书链与服务器端设置,保留证书验证并查明错误原因。
连接记录帮助核对目标域名或地址、命中规则、实际策略以及错误线索,比单看连接开关更接近具体问题。复现故障时,先记下时间与目标,再查找对应连接,区分被规则拒绝、解析失败和连接超时。对外分享记录前,应遮盖订阅地址、身份凭据以及不需要公开的访问内容。