01 / 界面与开关
页面入口与路由方式
先确认名称出现在哪里。同一个 Config,在页面导航与 Global Routing 选项中承担不同作用。
- Home #
- 用于查看已有服务器、当前选择与连接入口的主要页面。列表出现服务器条目,只能说明信息已保存,不能说明连接已经建立;应再检查连接状态与实际访问结果。
- Global Routing #
- 决定当前连接采用哪种全局路由方式,常用选项是 Config、Proxy、Direct,分别对应配置、代理、直连。排查某条规则为什么没有生效时,应先核对这里的选择,而不是先修改规则内容。
- Config #
- 在 Global Routing 中,Config 表示按照当前配置处理流量,规则分流通常在这个方式下验证。在页面导航中,Config 则是管理配置文件的入口;仅进入该页面,不等于已经选中或启用了某份配置。
- Proxy / Direct #
- 在 Global Routing 中,Proxy 让客户端可接管的流量使用代理,Direct 则采用直接连接。它们是全局路由方式,不是服务器的协议类型,也不要与规则末尾的大写 PROXY、DIRECT 策略名混为一谈。
- On Demand #
- 依据预先设置的网络等条件触发按需连接,用于减少重复手动操作。它不负责判断已有订阅是否有效,也不能保证远端服务器可用;验证时应分别观察条件是否命中、连接是否建立和目标是否可访问。
- Add Server #
- 用于手动填写服务器信息,先选择正确的协议类型,再填写对应字段。地址、端口、认证信息和传输参数应以你已有的服务器资料为准;更换协议类型并不会让原参数自动兼容。
- Connectivity Test #
- 用于检查指定测试目标的连通情况,结果受测试方式、网络环境与目标自身状态影响。测试通过不代表所有网站都能访问,测试失败也不应直接等同于订阅失效;应配合实际请求和连接记录判断。
02 / 协议
连接类型与参数边界
协议是客户端与服务器约定的通信方式。优先匹配已有服务的类型与参数,不按名称推断速度、耗电或稳定性。
- Shadowsocks #
- 一种基于代理转发的加密协议,基础参数包括服务器地址、端口、加密方法与密码。客户端与服务器两端的加密方法必须对应;遇到认证或连接问题时,应先核对字段,而不是仅凭测试耗时判断原因。
- VMess #
- 一种带有身份验证与加密机制的代理协议,配置中通常包含用户标识等认证信息。传输方式及其附加字段同样需要与服务器一致;地址和用户标识正确,并不代表传输层设置已经完整。
- VLESS #
- 侧重精简认证与转发的代理协议,通常与额外的传输或安全机制组合使用。VLESS 这个名称本身不代表自动包含 TLS 保护;填写时需要分别核对认证、传输方式及安全相关字段。
- Trojan #
- 通常配合 TLS 使用的代理协议,密码与 TLS 连接条件共同影响连接是否成功。服务器名称、证书有效性和系统时间都值得核对;不宜把关闭证书验证当作常规排障步骤。
- HTTP / SOCKS5 #
- 两类常见代理协议,均需要明确服务器地址、端口及可能存在的认证要求。HTTP 代理不能因名称就被视为已加密的连接;SOCKS5 的 UDP 能力也取决于服务端与具体使用条件,不能仅凭类型判断。
- WireGuard #
- 一种基于密钥的隧道协议,常见参数包括接口地址、对端公钥、Endpoint 与 AllowedIPs。AllowedIPs 涉及隧道内的地址范围选择,不应直接当作域名规则;私钥属于敏感数据,排查时不要公开。
- Hysteria2 #
- 一种基于 QUIC 的代理协议,连接依赖 UDP 通路以及匹配的认证与 TLS 参数。实际表现会受到丢包、服务器资源和网络条件影响;带宽相关字段应依据服务资料与实际环境填写,而不是任意调大。
需要比较参数与使用场景时,继续阅读协议参考。系统要求以 App Store 页面标注为准。
03 / 规则关键字与策略
匹配条件与处理结果
关键字回答“匹配什么”,策略回答“如何处理”。以下规则仅用于解释语法,example.com 为示例域名,不代表任何实际服务。
- 规则 #
- 将匹配条件关联到处理策略的配置条目,例如将某个域名交给 PROXY。规则通常自上而下匹配,前面的宽泛条件可能先覆盖后面的精确条件;保存后应查看新建连接的实际匹配结果。
- DOMAIN #
- 按完整域名匹配,例如
DOMAIN,example.com,DIRECT只针对该域名。它不会自动覆盖www.example.com等子域名,也不按网页路径或页面内容进行匹配。
- DOMAIN-SUFFIX #
- 按域名后缀边界匹配,
example.com可覆盖自身与其子域名。它不等于任意字符串包含关系,例如notexample.com不属于这个域名后缀;适合按网站域名范围组织规则。
- DOMAIN-KEYWORD #
- 检查域名中是否包含指定字符串,例如关键字
example可能匹配多个不同的域名。它的范围通常比 DOMAIN 或 DOMAIN-SUFFIX 更宽;使用前需要评估误匹配,不能把它当作同一网站的精确集合。
- GEOIP #
- 依据 IP 数据库中的地区归属匹配目标 IP,而不是识别页面内容或运营者所在地。结果受数据库与目标地址变化影响;当域名解析到不同地址时,同一网站的匹配结果也可能变化。
- IP-CIDR / IP-CIDR6 #
- 分别用于匹配 IPv4 与 IPv6 地址网段,斜杠后的前缀长度决定覆盖范围。例如
192.168.0.0/16是一个 IPv4 网段,不是单台设备;填写前应确认目标范围,避免把更大网段交给错误策略。
- FINAL #
- 当前面规则均未命中时,指定最终处理策略,例如
FINAL,DIRECT。通常将它放在规则末尾;调整兜底策略会影响所有未被前面规则覆盖的连接,不应只验证一个已被精确规则命中的网站。
- PROXY / DIRECT / REJECT #
- 规则中的策略名,分别表示交给代理路径、直接连接与拒绝连接。PROXY 的具体去向需要结合当前服务器选择或配置判断;REJECT 拒绝匹配连接,不是删除网页元素,无法保证清除所有页面内容。
- DNS #
- 将域名解析为 IP 地址的机制,解析结果与解析路径可能影响规则判断及连接表现。修改 DNS 不会自动修复认证错误或服务器故障;排查时应把解析失败、连接失败与策略不符合预期分开观察。
04 / 订阅与配置
导入、更新与测试
服务器信息、订阅地址和配置文件用途不同。先确定拿到的资料属于哪一种,再选择对应入口。
- Subscribe #
- 通过你已有的订阅地址获取或更新服务器条目的功能,地址应从自己的服务商处获取。订阅地址可能带有账户标识或访问凭据,不宜公开;导入服务器条目也不意味着同时获得了完整的规则配置。
- 服务器 #
- 客户端连接的远端端点信息,通常包括地址、端口、协议与认证参数,也常被称为节点。列表中的显示名称只是便于识别的标签,不能证明位置、速度或可用性;应核对参数并进行实际连接测试。
- 配置文件 #
- 承载规则、DNS 等处理设置的文本配置,与主要提供服务器条目的订阅用途不同。导入前应检查内容与来源,导入后确认当前选中的文件;仅保存文件,不等于其中的规则已经参与当前连接。
- 订阅更新 #
- 重新请求已有订阅地址,以刷新其中的服务器条目或参数。它不等于通过 App Store 更新应用,也不等于重新购买客户端;失败时应先检查地址是否仍有效、请求是否成功,以及返回内容能否被识别。
- 延迟 #
- 特定测试条件下测得的响应耗时,具体含义取决于测试目标与测试方式。延迟较低不等于带宽较高,也不能证明所有网站均可访问;比较时应尽量使用相同网络、目标与方法,避免混用不同条件的结果。
- Scan QR Code #
- 读取二维码中连接信息的导入入口,二维码也可能包含普通文本或不适用的内容。扫描后应核对识别出的协议类型、地址与参数是否完整;成功识别并保存,不代表远端连接已经验证通过。
05 / 系统权限与账号
授权、购买与数据恢复
系统连接权限、App Store 购买记录与 iCloud 数据同步是三个不同环节。换机时应分别确认,不用其中一个状态代替另一个。
- VPN 配置 #
- 首次连接时,系统可能请求允许添加 VPN 配置,用于网络扩展建立连接。允许后只表示系统授权已完成,不代表服务器认证和实际访问都成功;拒绝或删除后,可回到客户端重新发起连接并检查系统提示。
- Apple 账户 #
- App Store 购买与已购记录关联的账户,应与 iCloud 同步所使用的账户用途区分。恢复应用时先确认商店当前登录的是原购买账户;系统要求、账户地区相关可用性与购买适用范围,以 App Store 页面标注为准。
- 已购项目 #
- 在 App Store 中查找原账户购买记录并重新下载应用的入口,具体入口名称可能随系统界面变化。换机或重装时,先使用原购买账户查找 Shadowrocket;恢复应用本身不会自动还原所有本地服务器信息。
- iCloud 同步 #
- 在满足账户、系统授权与应用设置条件时,同步受支持的数据。同步不等于完整备份,也不等于恢复 App Store 购买记录;换机前应确认所需数据确实可恢复,涉及凭据的导出内容应妥善保存。
- 一次性买断 #
- 指应用本身的购买方式,价格与购买适用范围以 App Store 页面标注为准。客户端一次性买断 ≠ 线路套餐,后续连接仍需用户已有的订阅或服务器信息;购买记录恢复与连接参数恢复应分别处理。