Shadowrocket 功能介绍
与常用设置核对
先确认流量走哪条路径，再调整连接条件与诊断选项。每次只改一项，用相同目标验证结果。
本页以 iPhone / iPad 的操作为主。Shadowrocket 是 Apple 平台付费客户端，唯一获取入口是 App Store。系统要求以 App Store 页面标注为准。
查看首次连接步骤 →Global Routing：配置、代理与直连
Global Routing 位于 Home，用于决定连接按配置文件处理，还是统一采用某种路径。三个选项是 Config、Proxy、Direct。它们是路由模式，不是服务器协议，也不是网络质量档位。切换前先确认 Home 中已选择的服务器，再核对 Config 中当前使用的配置文件。
| 模式 | 处理方式 | 适用场景 | 核对重点 |
|---|---|---|---|
| Config（配置） | 依照当前配置文件中的规则选择策略。 | 需要按域名或目标地址分流。 | 当前配置、规则顺序、最终策略。 |
| Proxy（代理） | 将通常受该模式控制的连接交给代理路径。 | 临时检查已选服务器能否承载目标连接。 | 服务器可用性、目标访问与日志。 |
| Direct（直连） | 让连接采用本地网络的直连路径。 | 对照本地网络是否可以访问同一目标。 | 本地网络状态；不等于关闭系统 VPN 配置。 |
日常使用规则分流时，选择 Config。若某个网站无法访问，可以记录当前模式，临时切到 Proxy，用同一网站复测；若 Proxy 正常而 Config 异常，再查命中的规则与策略。需要判断本地网络本身是否异常时，可用 Direct 做对照。对照结束后恢复原模式，不要把一次临时测试当作长期设置。
模式切换不会补齐错误的服务器字段，也不能修复过期的连接信息。开关显示已连接，只能说明连接状态已建立到相应阶段，不代表所有目标都能访问。验证时同时观察网页、请求记录与错误提示，避免只看开关颜色。
规则分流：匹配条件与执行策略
规则分流将“访问什么目标”与“采用什么路径”分开。进入 Config，确认当前选中的文件，再查看或编辑其中的 [Rule]。Global Routing 使用 Config 时，这些规则才是排查分流行为的主要依据。修改前保存原文件副本，避免将订阅、服务器与配置文件混为同一种内容。
DOMAIN 用于完整域名匹配；DOMAIN-SUFFIX 用于域名后缀及其子域名；DOMAIN-KEYWORD 按域名中的关键字匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址段；GEOIP 使用地址归属数据。USER-AGENT 依赖可获得的请求信息，不宜假定它能覆盖所有加密连接。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-SUFFIX,ads.example.net,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY以上是语法示例，不是适合所有网络的完整配置。PROXY 指向代理处理，DIRECT 指向直连，REJECT 用于拒绝匹配连接。配置也可能引用自定义策略组；此时还需核对组名是否存在、组内选中了什么。规则中的策略名称与 Global Routing 的选项处于不同层级，不能只凭拼写相近就视为同一设置。
规则通常按顺序匹配，应将更具体的条件放在宽泛条件之前，并将兜底的 FINAL 放在末尾。新增一条规则后，只测试对应目标，检查实际命中项。如果修改后大量网站同时异常，先恢复副本，再检查是否误改了兜底策略或引用名称。需要查询关键字时，可查看概念速查。
订阅与服务器管理
Home 的 SERVER 列表用于选择已有服务器。单条服务器保存协议与连接字段；订阅则用于批量导入及更新服务器信息。订阅更新成功只表示列表获取与解析完成，不代表列表中的每一项都已通过连通性验证，也不代表规则文件会随之正确选中。
Add Server 与已有信息导入
从 Home 的添加入口进入 Add Server，先选 Type，再按自己的服务器资料填写地址、端口与认证字段。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的字段含义并不相同。若资料包含传输方式、TLS、服务器名称或路径，应逐项保持一致，不按其他协议的经验补填。
使用 Scan QR Code 或剪贴板导入时，完成后仍需打开条目检查类型、地址和端口。二维码可能包含敏感认证信息，不要将其作为公开截图发送。导入成功的判断是列表出现预期条目且字段完整；能否访问目标，还要另做连接测试。
Subscribe 更新与列表整理
已有订阅可在 Add Server 中选择 Subscribe，并填写自己的订阅地址。更新前核对地址是否完整，尤其注意复制时带入的空格、换行和失效参数。更新后检查分组与条目是否符合预期，再选中需要使用的服务器。删除订阅分组前先确认是否保留了原地址及必要的手动条目。
服务器测试有数值，并不等于实际访问速度或所有目标的可达性。优先用相同网络、相同 Test Method 做比较，再以实际访问验证。订阅地址往往具有访问权限，不应放入公开日志或求助文本。若出现订阅失败，应先查看错误提示与本地网络，再检查用户已有服务的地址状态。
On Demand：按需连接
On Demand 用于按照设定的网络条件触发 VPN 连接行为。它与 Global Routing 分工不同：前者决定何时连接，后者决定连接启用后如何处理流量。可从 Settings 中查找 On Demand，先检查总开关，再检查当前可用的网络条件与规则。
首次设置时，先关闭自动触发并完成一次手动连接测试。确认服务器和配置可用后，再启用所需条件。若按 Wi-Fi 网络区分行为，应核对网络名称是否准确；若涉及蜂窝网络，也要分别测试。具体可选条件以当前应用界面为准，不将某一种网络下的测试结果直接推到其他网络。
设定后先断开，再切换到预期触发的网络，观察 Home 的状态是否符合预期；然后切换到不应触发的网络复测。如果手动关闭后又自动连接，先查 On Demand 与系统 VPN 设置中的按需行为，不要反复删除配置。按需连接只能执行已有条件，不能判断服务器资料是否仍然有效。
Data：流量统计与观察范围
Data 用于查看客户端记录的流量情况。进入 Data 后，先识别页面显示的统计时间范围、上传与下载方向，以及是否按服务器或其他维度归类。不同统计项目的起点与口径可能不同，应按界面标注理解，不能直接把总量当作某次网页访问的消耗。
需要观察某个操作时，先记下现有读数，再执行一次明确操作，例如打开一个已知页面，然后返回 Data 比较变化。后台同步、媒体预加载和其他应用请求也可能同时产生流量。因此，读数变化适合辅助判断是否存在持续传输，不适合单独证明某个应用的准确用量。
若准备清理或重置统计，先记录需要保留的数据，并确认操作范围。客户端统计与用户已有服务的计费统计可能因统计时段、传输开销和计算口径不同而不一致。服务额度应以用户已有服务的记录为准。Data 也不是速度测试：累计流量较大，不代表当前连接较快。
Settings：DNS、测试与同步
Settings 集中放置应用级选项，但并非所有网络参数都只在这里生效。部分参数由 Config 中的文件控制。检查时先确定设置来自哪个位置，再判断作用范围；切换配置文件后，也要重新核对相关参数，避免以为之前的修改仍然生效。
DNS：先检查解析，再检查路径
DNS 将域名解析为目标地址。若服务器测试正常而网页打不开，可先在当前配置中检查 DNS 相关条目，再结合 Settings 中实际提供的 DNS 选项核对。重点是解析服务器是否能通过当前网络访问，以及是否同时存在配置覆盖。不要为了测试一次性替换所有解析设置，否则难以确定故障来自哪一项。
保存原设置后，选择一个出现问题的域名复测，并查看是否仍出现解析错误。DNS 正常不等于后续连接正常；若已获得地址却连接超时，应继续查服务器路径与规则。涉及 IPv6 时，应同时考虑本地网络支持情况，不把所有域名故障都归结为同一个开关。
Test Method：明确测试测量什么
在 Settings 中查看 Test Method，确认当前选用的测试方式及界面显示的相关参数。不同方法测量的环节不同，同一服务器在不同方法下的结果不能直接排序比较。更换方法后，回到 Home 的 Connectivity Test 重新测试，并记录当时网络条件。
测试结果主要用于定位连接阶段。一次测试成功，不代表认证、DNS、目标网站和持续传输都正常；一次超时，也可能与测试目标自身有关。需要比较多个服务器时，保持方法和网络一致，再用实际访问补充验证。
Today Widget：检查展示与可用入口
Today Widget 用于与系统小组件相关的展示或快捷操作设置。先在 Settings 核对应用提供的选项，再到系统的小组件管理位置检查是否可以添加及展示。可用形式取决于设备系统与当前应用支持，具体以实际界面为准。
如果组件状态没有及时变化，先打开应用检查 Home 的真实状态，再检查系统侧的组件配置。不要只凭组件上的文字判断连接已经建立，也不要把组件未刷新直接视为服务器故障。
iCloud 同步：先辨认同步范围
在 Settings 查看 iCloud 相关选项，同时确认设备已启用对应的系统 iCloud 权限。启用前先保存本地配置，并逐项阅读界面说明，确认哪些资料参与同步。不要把同步开关理解为所有服务器认证、历史统计和系统 VPN 授权都会自动迁移。
另一台设备打开应用后，检查实际出现的条目、当前选中配置与服务器，再做一次手动连接。遇到资料不一致时，先停止在多台设备上同时编辑，分别保留需要的内容，再判断同步状态。订阅中的敏感地址与认证字段仍应按私密资料管理。
Diagnostics：记录现象与复测结果
Diagnostics 用于检查诊断信息。进入 Settings 中相应入口后，按当前界面提供的工具查看或记录故障。诊断的起点是一个可复现的问题，而不是同时更改大量选项。先写清当前网络、Global Routing 模式、选中的服务器、当前配置，以及失败发生在哪个目标。
- 固定复现条件。保持同一网络与同一目标，记录错误是解析失败、连接超时，还是连接后传输中断。
- 缩小问题范围。检查 Connectivity Test，再看解析与规则命中情况。仅一个目标异常时，优先排查该目标对应的规则与路径。
- 一次修改一项。修改后重复原操作，对照结果；没有改善就恢复原值，再检查下一项。
- 整理必要证据。记录失败时间、相关错误与修改前后的差异，不提交整份含认证信息的配置。
分享诊断文本之前，应删除订阅地址中的访问参数、密码、UUID、密钥以及其他可识别的私密信息。日志里出现一次错误不代表整个连接不可用，应结合错误发生时间与实际症状判断。问题稳定复现后，可按故障排查手册继续检查，而不是反复重装或覆盖全部设置。