阅读与设置范围
本页按 iPhone / iPad 的 Home、Config、Data、Settings 组织说明。不同系统和应用版本的项目位置可能调整,应以当前界面实际显示的名称为准;没有显示的选项不需要通过其他相近名称猜测设置。
Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓与 Linux 版本。Mac 包含 Apple 芯片版和 Intel 版。需要获取客户端时,使用全平台下载指南选择对应设备。
OFFICIAL MANUAL · SETTINGS
先在 Home 确认所选服务器与 Global Routing,再检查 Config 和 Settings。连接开关、路由姿态、匹配规则是不同层次的设置,不能互相替代。
本页按 iPhone / iPad 的 Home、Config、Data、Settings 组织说明。不同系统和应用版本的项目位置可能调整,应以当前界面实际显示的名称为准;没有显示的选项不需要通过其他相近名称猜测设置。
Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓与 Linux 版本。Mac 包含 Apple 芯片版和 Intel 版。需要获取客户端时,使用全平台下载指南选择对应设备。
01 · GLOBAL ROUTING
Global Routing 决定连接采用哪一套处理方式。日常按规则使用选择 Config;临时判断代理路径是否可用选择 Proxy;需要对照当前网络的直连表现时选择 Direct。
| 姿态与界面词 | 连接处理方式 | 适用情况 | 注意事项 |
|---|---|---|---|
| 配置 · Config | 依据当前启用的配置文件匹配规则,并执行相应策略。 | 需要将不同目标分别交给 PROXY、DIRECT 或其他已定义策略。 | 先确认启用的是预期配置,再检查规则顺序与 FINAL。 |
| 代理 · Proxy | 通常将接管的连接交给当前所选代理服务器处理。 | 临时检查服务器及代理路径,排除规则分流的影响。 | 不是规则命中结果的验证方式,也不保证服务器可用。 |
| 直连 · Direct | 接管的连接采用直接连接方式,不经所选代理服务器转发。 | 对照本地网络、目标服务与代理路径的差异。 | 不等于关闭连接开关;系统中的 VPN 状态可能仍保持。 |
进入 Home,打开 Global Routing 后选择所需姿态,再返回查看当前显示值。切换后重新发起一次网页请求;已经建立的长连接可能继续沿用原来的连接状态,不能只看旧页面是否仍然显示,就判断新设置已经作用于所有请求。
如果 Proxy 下正常而 Config 下异常,优先检查配置、策略名称和规则匹配;如果两者都异常,先检查所选服务器和基础网络,不要立即重写整份配置。排查结束后恢复原本使用的姿态,避免临时的 Proxy 设置长期改变应用流量走向。
02 · CONFIG / RULE
在 Config 中检查当前配置。规则类型描述“匹配什么”,规则末尾的策略描述“匹配后怎么处理”;二者应分开理解。
Config 不只是保存文件的位置,还关系到当前正在使用哪份规则。导入或下载一份配置后,应确认它已经被选中启用,而不是仅出现在列表里。编辑前保存副本,并记录原来可正常连接的配置;每次只改一类规则,方便把变化与实际表现对应起来。
| 规则类型 | 匹配对象 | 设置依据与注意点 |
|---|---|---|
DOMAIN | 指定的完整域名。 | 适合只处理一个明确主机名,不能自动覆盖所有子域名。 |
DOMAIN-SUFFIX | 指定域名及其子域名。 | 适合按域名后缀归类,填写域名而不是完整网页地址。 |
DOMAIN-KEYWORD | 域名中包含的关键字符串。 | 匹配范围较宽,需注意误命中不相关域名。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址段。 | 适合明确的网络范围;核对地址族与前缀长度。 |
GEOIP | IP 地理归属数据库中的类别。 | 结果依赖数据库与解析地址,不能据此推断账号地区。 |
FINAL | 未命中前面规则的剩余连接。 | 作为末尾兜底,明确写出最终策略。 |
规则通常按顺序匹配,因此应把更具体的例外放在宽泛规则之前。PROXY 表示交给代理路径,DIRECT 表示直连,REJECT 表示拒绝连接;配置中的自定义策略名称还必须有对应定义。名称拼写不一致、策略引用失效,都可能让规则看起来正确却无法按预期工作。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
这段示例只用于解释语法,不是一份完整配置:example.com 及其子域名交给 PROXY,指定的本地地址段采用 DIRECT,其余连接由 FINAL 指定的 DIRECT 处理。实际使用前要结合自己的目标与现有配置决定策略,不应整段覆盖已有文件。
判断规则效果时,先确认 Global Routing 是 Config,再针对一个明确目标重新发起请求。若目标直接使用 IP 地址访问,域名规则不一定能参与匹配;若业务同时使用多个域名,也不能用首页的一次成功代表所有请求都走同一策略。
03 · HOME / ADD SERVER
订阅负责批量维护服务器条目,Home 中选中的服务器负责当前默认代理出口。导入成功、更新成功与实际连接可用,是三件不同的事。
在 Home 使用 Add Server,按已有资料选择对应类型;导入订阅时选择 Subscribe 并填写完整订阅地址。有二维码时可使用 Scan QR Code,但扫描后仍需核对条目类型和关键字段。不要把普通网站地址、账号管理页面或配置说明网页当作订阅地址。
手动添加服务器时,协议类型、服务器地址、端口、认证信息以及 TLS、传输相关字段应与用户已有资料一致。协议名保留原文,如 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2。不要为了让表单保存成功而随意补填字段;不确定的参数应返回原始资料核对,可继续阅读协议参考。
订阅更新后检查服务器列表是否发生变化,并在 Home 用圆点重新确认默认服务器。原来选中的条目可能已被移除或替换;列表中存在名称相似的服务器,也不代表它们具有相同地址和参数。可给手动条目使用便于辨认的备注,但备注本身不会改变连接方式。
删除订阅前先确认需要保留的条目和原始订阅地址。订阅管理的条目再次更新时可能被覆盖,直接修改其中一项不一定能长期保留。需要单独试验参数时,先保留原条目,再建立清晰区分的测试副本;测试结束后清理重复项,避免选错。
04 · ON DEMAND
On Demand 用于按系统网络条件触发连接,不负责选择某个域名的 PROXY 或 DIRECT 策略。先建立稳定的手动连接,再设置自动触发条件。
在 Settings 中找到 On Demand,检查当前开关及可用的网络条件。首次配置时,先在 Home 手动选中服务器并验证可用,再逐项设置按需行为;若系统请求允许添加 VPN 配置,应阅读提示并确认。具体条件以当前界面提供的项目为准,不需要把所有选项同时启用。
启用后,在实际使用的 Wi-Fi 与蜂窝网络之间切换,观察连接是否按预期建立或停止,再检查 Home 中的 Global Routing 是否仍为所需姿态。自动建立连接并不代表当前服务器可用,也不表示所有请求都会使用代理;最终处理方式仍由路由姿态和当前配置共同决定。
如果手动关闭后连接又恢复,应先检查 On Demand,再查看系统中的 VPN 设置,而不是反复删除订阅。进行连接排查或需要完全停止自动连接时,先暂时关闭 On Demand,再操作 Home 连接开关。记录原设置,测试结束后按实际需求恢复。
按需连接也不是持续传输数据的同义词。耗电与流量还受实际业务、协议、网络稳定性及重连频率影响,不能仅凭系统显示 VPN 图标就判断出现异常流量。需要核对时,应把 On Demand 的触发记录、Data 的观察区间与实际应用使用情况结合起来。
05 · DATA
Data 用于观察客户端记录的流量变化,不是服务商账单,也不是网络速度或线路质量的直接评分。
打开 Data,先辨认当前页面展示的统计范围、方向与单位,再对照实际发生的操作。上传和下载反映不同方向的数据;页面若提供不同区间或清除操作,应先确认所选范围。不要把一次会话的数字直接当作整月用量,也不要在清除后继续沿用原来的观察起点。
进行对照测试时,可先记下当前读数,暂停不相关的后台传输,然后只执行一个明确操作,再观察变化。流量增加只能说明出现了被记录的数据传输,不能单独证明某个域名命中 PROXY。需要判断策略时,还应结合 Global Routing、配置规则及可用的连接记录。
客户端与服务商的统计可能存在差异,原因包括统计起止时间、协议开销、重传以及计量口径。涉及账户剩余用量时,应查看用户已有服务的账户记录;不要用 Data 的一个数字倒推出账单结论。保留排查记录时,标明网络类型和测试操作,比只截取累计数字更有帮助。
06 · SETTINGS
保持可用设置作为基线,一次只改变一项。DNS、测试方法、快捷入口、同步与诊断分别解决不同问题,不应把全部开关同时修改作为排查步骤。
DNS 将域名解析为地址。先在 Settings 中查看 DNS 相关设置,并同时检查当前 Config 是否包含 DNS 配置;实际行为可能受配置文件影响。没有明确需求时先保持现有可用配置,有指定解析方案时再按原始资料填写,记录修改前的值。
域名打不开而直接访问地址有响应,可能与解析有关,但并非充分证据,HTTPS 站点还涉及证书与域名。更换 DNS 后应重新发起请求,避免把缓存结果当作新设置的效果。不要把 DNS 改动等同于服务器参数修复,也不要同时调整 IPv6、规则和服务器,否则难以定位原因。
Test Method 决定相关测试采用的检测方式,可在 Settings 中查看和选择当前可用选项。不同方法覆盖的连接阶段不同,因此测试结果只适合在相同方法、相近网络条件下比较;改变方法后,不能把新旧结果直接排列成服务器质量结论。
选择方法后回到 Home 执行 Connectivity Test,再尝试实际业务。测试成功不代表所有网站均可访问,测试失败也需要结合检测目标和当前网络判断。若只在某一种测试方式下异常,应先核对该方式的检测条件,不要立即删除全部服务器。
Today Widget 用于系统支持范围内的快捷查看与操作。先检查 Settings 中相关选项,再按系统当前提供的组件添加方式配置入口;如果系统或当前版本未显示此入口,不需要为了寻找组件而改动连接参数。
通过组件操作后,返回 Home 核对服务器、连接开关与 Global Routing。快捷入口显示的状态可能需要刷新,不能替代实际连接验证。涉及锁屏可见内容时,也应检查系统的显示权限,避免将不必要的服务器备注暴露在公共场合。
iCloud 同步用于当前版本支持的数据在个人设备间同步;它与向已有服务商刷新订阅列表是两项独立功能。在 Settings 中检查同步选项,并确认设备使用预期的 iCloud 账号、系统允许相关访问且网络可用。启用前先保存重要配置,核对本机与云端内容,避免误把旧内容当作新设置。
一台设备修改后,等待同步并在另一台设备实际检查结果,不要假定连接状态、系统授权和所有设置都能跨设备完整迁移。服务器密码、订阅地址与密钥属于敏感信息,应了解所同步的数据范围;不同设备上的系统 VPN 授权仍需要分别确认。
Diagnostics 用于收集和检查连接相关的诊断信息,可从 Settings 中的对应入口打开。先记录当前网络、所选服务器、Global Routing 和复现步骤,再运行可用的诊断工具。尽量只重现一次明确故障,避免大量无关请求淹没有效信息。
查看输出时关注发生问题的阶段:是无法建立连接、认证失败、域名解析异常,还是目标请求没有得到预期响应。诊断结果用于缩小范围,不代表对所有目标的长期结论。分享材料前遮盖订阅参数、认证信息、密钥以及不必要的个人访问记录,完成排查后再按实际需求关闭详细记录。
07 · CHECK ORDER
保留原状态,按“服务器 → 姿态 → 配置 → DNS → 诊断”逐层检查,比同时修改多个开关更容易定位问题。
如果尚未完成首次连接,先阅读首次连接教程,把导入、选择服务器、允许 VPN 配置和连接验证连起来操作。若只需要理解协议字段,转到协议参考,不要用切换 Global Routing 代替协议参数核对。
先检查 Config 中启用的文件、具体目标命中的规则及对应策略,再检查 FINAL。Proxy 对照只能说明当前代理路径在该次测试中可用,不代表 Config 中每个策略都有效;先不要修改已验证可用的服务器参数。
先检查 On Demand 和系统 VPN 设置。订阅更新负责刷新服务器信息,按需连接负责自动触发连接。排查时暂时关闭 On Demand,再观察手动开关是否能保持预期状态。
流量变化不能证明目标请求已经成功。后台活动、连接重试或部分请求都可能产生数据。请针对同一个目标检查服务器、Global Routing、规则与 DNS,并结合 Diagnostics 缩小范围。
通常不需要。路由姿态、DNS 与订阅内容是不同层次。只有订阅地址或已有服务器资料发生变化、条目确实缺失时,才需要更新或重新导入;删除前保留原始资料和必要的配置副本。