Home
Home 是查看服务器列表、选择连接记录和操作连接开关的主要页面。列表中出现名称,只说明客户端保存了记录,不代表地址、认证信息或远端状态已经验证成功。首次连接后应继续用实际请求检查结果,不能只凭开关状态判断。
先区分界面入口、连接协议与规则策略,再核对具体参数。以下术语以 iPhone 与 iPad 上的使用语境解释;英文名称保持应用与配置中的原写法,可通过每张卡片的标题链接定位。
页面、模式和开关分别承担不同职责。服务器已经导入、开关已经打开与请求已经成功,是需要分别核对的三个状态。
Home 是查看服务器列表、选择连接记录和操作连接开关的主要页面。列表中出现名称,只说明客户端保存了记录,不代表地址、认证信息或远端状态已经验证成功。首次连接后应继续用实际请求检查结果,不能只凭开关状态判断。
Global Routing 决定整体访问采用哪种处理方式:配置对应 Config,代理对应 Proxy,直连对应 Direct。Config 按当前配置中的规则分流,Proxy 使用代理模式,Direct 使用直连模式。排查规则未生效时,先核对这里是否处于 Config,再检查具体规则。
Config 既可能指管理配置文件的页面,也可能指 Global Routing 中的一种模式。进入 Config 页面查看文件,不等于当前已经启用该文件,更不等于整体模式已经切换。核对时依次确认文件内容、选中状态与 Global Routing,避免把三个操作当成同一件事。
On Demand 根据设置的网络条件触发 VPN 连接,具体行为取决于已配置的条件与系统状态。它不承担订阅更新、服务器筛选或参数修复的职责。建议先手动完成一次连接和访问验证,再设置自动触发条件,便于判断问题来自连接参数还是触发规则。
Add Server 用于手动建立服务器记录,选择的协议会影响后续显示的参数字段。地址、端口、认证信息、传输方式与 TLS 设置应逐项对应用户已有的服务器资料。保存后应重新打开记录检查字段,尤其不要把备注名称当作服务器地址填写。
协议决定客户端如何与服务器通信,不决定哪些目标应该走代理。以下仅解释技术组成,具体字段以应用内可选项和用户已有服务器资料为准。
Shadowsocks 使用服务器地址、端口、加密方式与密码等参数建立代理连接。加密方式与密码必须和服务端设置一致,仅地址可达并不能说明认证正确。若资料还列出插件或其他扩展参数,应确认应用中相应选项的支持情况,不能省略后直接假定等效。
VMess 是需要核对用户标识及相关认证参数的代理协议,用户标识常以 UUID 形式出现。传输方式、路径、Host 与 TLS 等属于连接的其他层次,不能只核对协议名。遇到认证失败时,应同时检查完整参数和设备时间,避免只反复更改端口。
VLESS 使用用户标识进行认证,具体连接还可能涉及传输方式与安全层设置。协议名称本身不能说明连接具备怎样的加密保护,需要结合实际 TLS 等配置判断。导入后应核对应用识别出的字段,不能把其他协议的选项机械套用到该记录。
Trojan 通常结合 TLS 使用,以密码等信息完成认证。服务器地址、端口、密码以及证书校验涉及的名称都需要与服务端对应,地址和证书名称不一定相同。证书错误应先检查名称、设备时间和服务端证书状态,不应把关闭校验当作常规修复步骤。
Hysteria2 是基于 QUIC 的代理协议,底层通信依赖 UDP。即使同一地址的其他连接方式能够工作,也不能据此确认当前网络允许所需的 UDP 通信。排查时先核对协议类型、认证与 TLS 参数,再检查本地网络及远端的 UDP 通路。
WireGuard 使用密钥建立隧道,配置通常涉及接口地址、对端公钥、Endpoint 与允许的地址范围。公钥和私钥承担不同作用,不能互换,也不应公开包含私钥的配置。连接后的可达范围还受路由与 DNS 设置影响,不能只检查密钥格式。
HTTP 代理类型通常使用地址和端口定位代理入口,也可能要求用户名与密码。访问 HTTPS 目标时通常通过 CONNECT 建立隧道,但这不等于客户端与代理入口之间必然使用 TLS。填写时应区分代理入口的安全设置与目标网站使用的协议。
SOCKS5 是一种代理协议,可处理不同类型的连接请求,并可按服务端要求进行认证。UDP 转发是否可用取决于客户端配置、服务端能力与中间网络,不能从协议名称直接推断。它本身也不代表连接具备加密保护,需要结合实际链路判断。
通常先按规则顺序寻找匹配项,再使用该行指定的策略。示例中的 example.com 仅用于说明语法;PROXY、DIRECT 与 REJECT 是策略词,不是服务器地址。
DOMAIN 按完整目标域名进行匹配,适合只处理一个明确的主机名。例如 DOMAIN,example.com,DIRECT 指定该域名使用 DIRECT,不会因此自动覆盖所有子域名。条件部分填写域名,而不是包含协议、端口与路径的完整 URL。
DOMAIN-SUFFIX 按域名后缀匹配,适合把根域名和其子域名放入同一策略。例如 DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 及其子域名。若部分子域名需要例外处理,应把更具体的规则放在这条宽范围规则之前。
DOMAIN-KEYWORD 检查目标域名中是否包含指定字符串,覆盖面通常比完整域名匹配更宽。短关键词可能同时命中多个没有业务关系的域名,因此需要检查实际匹配结果。只有明确需要字符串匹配时才使用,已知固定域名时优先考虑更精确的条件。
GEOIP 依据目标 IP 在地址数据库中的地区归属匹配,而不是依据设备的位置或网页语言。数据库记录、DNS 解析结果和目标使用的分布式服务都可能影响命中。出现与预期不同的策略时,应先确认实际目标 IP,再检查数据库和规则顺序。
IP-CIDR 用于 IPv4 地址范围,IP-CIDR6 用于 IPv6 地址范围,斜杠后的前缀长度决定范围大小。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示对应的 IPv4 网段使用 DIRECT。只写 IPv4 条件不会自动覆盖 IPv6,双栈环境需要分别核对。
FINAL 是此前条件都没有命中时使用的兜底规则,通常放在规则序列末尾。例如 FINAL,PROXY 将其余请求交给 PROXY 处理,不表示前面的请求都会使用代理。排查个别目标走向时,应先找最早命中的具体规则,再看是否落到 FINAL。
PROXY 表示代理处理,DIRECT 表示直接连接,REJECT 表示拒绝请求;规则也可以引用配置中定义的策略组名称。大写策略词与 Global Routing 中的 Proxy、Direct 属于不同语境,前者可作为单条规则的结果。DIRECT 仍可能在 VPN 已连接时处理部分请求,不能据此判断开关状态。
订阅描述内容如何获取,服务器记录描述如何连接,配置文件描述如何处理请求。链接能被打开,不等于其返回内容适用于当前导入入口。
Subscribe 表示订阅相关入口,具体接收服务器列表还是远程配置,需要结合所在页面与链接内容判断。用户应使用自己已有的订阅信息,并先确认资料说明的内容类型,再选择对应入口。订阅 URL 可能带有访问凭据,不应直接发布或放入公开截图。
服务器记录是客户端保存的一组连接参数,可能由手填、分享链接、二维码或订阅生成。备注用于辨认记录,地址、端口和认证信息才参与实际连接,修改备注不会修复远端故障。多条记录还可能指向相同地址,应结合协议和端口辨认,而不是只按名称去重。
配置文件组织规则、策略引用与相关网络设置,内容作用不同于仅包含服务器列表的订阅。导入后应检查策略名称是否存在、规则是否完整,以及当前是否选中了该文件。若使用 Config 模式却仍未按预期分流,应把模式、文件选择和规则命中分开核对。
订阅更新会重新请求已有链接,并根据返回内容同步记录,不是更新 Shadowrocket 应用本身。更新可能改变记录名称、数量或参数,因此完成后应确认当前选择仍指向预期服务器。手动编辑订阅生成的内容前,先了解后续更新是否会覆盖修改,并保留必要的私人备份。
一次访问包含多个环节。测试有响应不等于目标网站可访问,域名能够解析也不等于后续连接一定成功。
DNS 将域名解析为 IP 地址,解析结果随后参与连接,并可能影响基于 IP 的规则判断。出现域名访问失败时,应区分没有得到结果、得到不合适的结果和结果正确但连接失败。检查时记录所用解析设置与实际结果,每次只调整一个变量,避免同时改变规则和服务器。
延迟是在指定测试方法下测得的往返或响应耗时,数值受测试目标、协议、本地网络与瞬时拥塞影响。它不等于可用带宽,也不能单独证明网页、视频或其他请求的表现。比较记录时应尽量保持测试方法和网络环境一致,并结合实际访问结果判断。
Connectivity Test 用于检查服务器的连接状况,具体结果取决于应用内选择的测试方式与目标。某种测试失败,可能来自目标响应、协议通路或网络限制,并不自动说明所有访问都失败。建议先重复测试,再对同一服务器进行实际请求验证,保留两类结果以便定位问题。
URL Rewrite 按条件对请求 URL 进行改写或重定向,与决定请求走向的分流规则不同。匹配表达式与替换目标需要一起检查,过宽的条件可能影响非预期请求。涉及 HTTPS 内容时还受加密和相关配置条件约束,不能只添加一条表达式就假定能够处理所有请求。
若尚未完成第一次连接,按操作顺序阅读使用说明;若已经导入但记录不完整,先检查订阅类型与字段。术语只说明各部分的职责,实际诊断仍需结合当前配置和应用内结果。