Home
Home 用于查看已有服务器与订阅、选择连接对象,并操作连接开关。列表中出现条目,只能说明资料已经保存,不代表认证成功或隧道已经建立。排查时先确认当前选择,再观察连接状态,避免把“已导入”当成“已连通”。
界面与开关
同一个英文词可能出现在页面、模式或规则中。先找它所在的位置,再判断它是否影响当前请求。
Home 用于查看已有服务器与订阅、选择连接对象,并操作连接开关。列表中出现条目,只能说明资料已经保存,不代表认证成功或隧道已经建立。排查时先确认当前选择,再观察连接状态,避免把“已导入”当成“已连通”。
Global Routing 决定整体流量处理方式,三个姿态是配置、代理、直连,对应界面原文 Config、Proxy、Direct。Config 按当前配置规则处理,Proxy 使用代理路径,Direct 使用直连路径。分析某条规则为何未生效之前,应先确认当前是否处于 Config。
Config 在界面中可指配置管理页面,在 Global Routing 中则指按配置规则处理流量的模式。进入 Config 页面查看文件,不等于已经选中该文件,也不等于整体路由已切换到 Config。核对时应把“当前文件”和“当前模式”作为两个独立检查项。
Proxy 是 Global Routing 中使用代理路径的模式,可用于对照检查某个请求在代理路径下的表现。它不是规则文件中某条域名规则的名称,也不表示服务器参数必然正确。模式切换后的结果只能帮助缩小排查范围,测试结束应恢复原先需要的模式。
Direct 是 Global Routing 中使用直连路径的模式,适合与当前配置处理结果进行对照。直连仍受本地网络、域名解析与目标服务状态影响,不能理解为跳过一切网络设置。若直连与代理结果不同,应继续检查 DNS、目标地址及规则,而非只反复切换开关。
On Demand 按已经配置的条件触发连接,重点是“何时建立连接”,不是“某个域名走哪条路径”。后者由 Global Routing 和当前规则共同决定。若手动断开后又连接,应检查 On Demand 的触发条件与系统 VPN 设置,而不是立即删除服务器信息。
协议
以下是技术概念说明。实际填写以用户已有服务器资料为准,协议、传输、安全设置与认证信息需要相互匹配。
Shadowsocks 是使用约定加密方法与密码的代理协议,服务器地址、端口、加密方法和密码需要对应。只修改协议名称不能把另一种服务器配置转换为 Shadowsocks。若原有资料还包含附加参数,也应完整保留,不能仅凭备注名称判断参数是否一致。
VMess 是带身份认证的代理协议,身份信息只是完整配置的一部分。服务器使用的传输方式、路径、Host 与 TLS 等设置也可能影响连接,应按已有资料逐项核对。若系统时间明显错误,还应先校准时间,再区分认证失败与网络不可达。
VLESS 使用身份标识进行认证,协议本身不等同于加密层,连接安全还取决于所搭配的传输与安全设置。相同身份标识并不足以保证连接成功,服务器端口、TLS 名称及其他参数都应匹配。不要把 VMess 的条目只改一个类型就视为有效的 VLESS 配置。
Trojan 通常结合 TLS 与密码认证建立代理连接,密码正确并不代表 TLS 检查一定通过。应同时核对服务器地址、端口、TLS 名称和证书验证相关设置。遇到证书错误时,优先检查名称与系统时间,不应把关闭验证作为通用处理办法。
Hysteria2 是基于 QUIC 的代理协议,连接依赖认证信息、TLS 参数以及网络对 UDP 的支持情况。协议名称不能直接说明实际吞吐量或延迟,参数与网络条件同样重要。若在不同网络下结果不同,应先记录网络差异,再检查 UDP 可达性与服务器设置。
WireGuard 通过密钥对建立加密隧道,连接资料通常涉及对端公钥、Endpoint、地址与路由范围。公钥和私钥作用不同,不能交换填写,也不应把私钥贴入公开日志。隧道建立后仍需检查目标网段与 DNS,握手成功不等于所有目标都已可达。
规则关键字与策略
规则通常自上而下匹配,先命中的规则决定处理方式。下面的片段仅用于辨认语法,不是建议直接套用的完整配置。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
第一项说明如何匹配,末项说明匹配后如何处理;FINAL 是最终匹配项,因此没有域名或网段字段。示例中的 example.com 是教学域名。
DOMAIN 按完整域名匹配,例如 DOMAIN,example.com,DIRECT 只针对所写域名,不自动覆盖所有子域名。规则中填写域名而不是包含路径的完整 URL。网站若同时请求多个域名,需要结合请求记录判断实际命中的目标,不能只观察地址栏。
DOMAIN-SUFFIX 按域名后缀边界匹配,写入 example.com 时通常覆盖该域名本身及其子域名。它不是在整个 URL 中随意查找同名文字,也不负责匹配路径。若更靠前的规则已经命中,请求就不会继续落到这条规则,因此添加后还要核对顺序。
GEOIP 依据 IP 地理归属数据库匹配目标地址,例如 GEOIP,CN,DIRECT。归属结果取决于数据库与解析到的地址,不等同于网页所用语种、账户地区或运营主体所在地。使用 CDN 的域名可能返回不同地址,排查时应记录实际目标 IP。
IP-CIDR 用网段表示法匹配 IPv4 地址,斜杠后的数字表示网络前缀长度,例如 192.0.2.0/24 是文档示例网段。IPv6 网段使用 IP-CIDR6,二者不能混写。域名解析成不同地址后可能匹配不同规则,因此需要连同 DNS 结果一起检查。
FINAL 处理没有命中前面规则的请求,通常放在规则列表末尾。FINAL,PROXY 与 FINAL,DIRECT 分别指定不同的最终处理路径,并不存在通用于所有配置的固定答案。若大量请求意外走最终策略,应先检查前面规则的覆盖范围与顺序。
PROXY 是规则中用于选择代理处理路径的策略名称,实际出口仍需结合当前选择和配置定义理解。它不是服务器地址,也不是协议名。看到命中 PROXY,只能先确认处理方向;连接是否成功,还需核对被选中的服务器以及认证、传输和 DNS 状态。
DIRECT 让命中的请求采用直连路径,通常用于需要通过当前本地网络访问的目标。它不表示请求跳过全部 DNS 处理,也不保证目标服务可达。规则里的 DIRECT 作用于匹配请求,而 Global Routing 的 Direct 是整体模式,检查时应明确正在讨论哪一层。
REJECT 拒绝命中规则的请求,其能力边界取决于规则能够识别的域名、地址或其他条件。一个域名可能同时承载多种内容,过宽的拒绝规则也可能影响正常功能。出现局部页面缺失时,应查看命中记录并缩小规则范围,而不是继续扩大拒绝列表。
订阅与配置
服务器列表回答“连接到哪里”,配置文件回答“怎样处理请求”。二者可以一起使用,但导入其中一种不代表另一种也已配置。
Subscribe 通过用户已有的订阅链接获取并更新服务器条目,具体内容由链接返回的数据决定。订阅链接可能包含访问凭据,分享日志或截图前应隐藏完整地址。更新后列表为空时,要区分链接获取失败、返回内容异常与解析失败,不能直接认定服务器全部失效。
Server 是一条连接记录,通常包含地址、端口、协议和认证参数,可通过已有资料在 Add Server 中添加。列表备注只是便于辨认的名称,修改备注不会改变实际服务器。复制参数时应检查首尾空格和字段对应关系,避免把显示名称误填为主机地址。
配置文件用于集中保存规则、DNS、策略等设置,具体项目取决于文件内容。导入文件与选中并使用文件是不同操作,修改后还应确认当前生效的是哪一份。调整前保留可用副本,并一次只改一个相关项目,便于通过对照判断变化来自哪里。
iCloud 同步是在应用支持的范围内通过 iCloud 传递数据,依赖账户、系统权限、网络与应用内设置。它不等于 App Store 的已购记录,也不能仅凭重新下载应用就判断资料已恢复。更换设备后,应核对实际同步项目和当前选中的配置,并妥善保留重要资料。
DNS 与网络
一次测试只覆盖其中一部分条件。记录测试网络、目标和模式,才能比较结果,而不是只比较一个数值。
DNS 将域名解析为 IP 地址,路由选择与后续连接可能依赖解析结果。解析成功不代表目标端口可达,连接失败也不一定由 DNS 引起。排查时应分别记录域名、解析地址与请求路径,修改解析设置后还要考虑缓存影响,避免同时更换多个变量。
Connectivity Test 用来检查指定对象在测试条件下的可达性,测试结果应结合所用方法阅读。测试通过不代表每个网站、每种协议或长时间传输都正常。若测试与实际访问表现不同,应继续检查目标域名、Global Routing 和规则命中情况,而不是只重复测试。
延迟描述请求与响应之间的时间,TCP 建连、HTTP 请求等不同测试方法可能得到不同结果。较低的延迟不等于较高的持续传输速度,也不能单独代表稳定性。比较时应保持同一网络、同一测试方法与接近的时间条件,并结合实际业务访问观察。
URL Rewrite 根据匹配条件改写请求 URL,与选择代理或直连路径不是同一件事。能否改写取决于客户端可见的请求范围、规则条件及相关配置,HTTPS 请求还涉及额外的处理边界。排查改写问题时,应先确认请求是否可见,再检查匹配表达式与目标 URL。
第一次导入已有资料,可按使用教程逐步操作;已经连接但表现异常,应按症状进入排查手册。仅凭某个协议名或测试数字,不能确定故障原因。
Shadowrocket 是全平台闭源商业应用。iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费,安装包通过本站 /dl/ 获取。具体渠道与首次打开时的系统放行步骤见下载指南。