Shadowrocket 使用说明

打开 Shadowrocket 后，先停留在 Home，不必立刻打开连接开关。在 SERVER 区域找到 Add Server 并进入。添加前先分清手中的信息：订阅链接用于获取一组服务器；单条服务器信息则包含协议类型、服务器地址、端口及认证参数。两种资料的填写位置不同，把订阅链接直接填进服务器 Host，通常不能得到有效条目。

手动添加单条服务器

进入 Add Server，先点 Type，按已有资料选择对应协议，再填写该类型所需的字段。以出现 Host、Port、Password、Method 的页面为例，Host 填服务器地址，Port 填端口，Password 和 Method 按原始信息逐项核对。不同 Type 会显示不同参数，不能因为字段名称相似，就沿用另一种协议的设置。涉及 TLS 或其他传输选项时，同样应以已有服务器资料为准。

输入完成后先复查首尾空格、端口数字及认证内容的大小写，再使用页面的保存操作返回 Home。如果手中已有兼容的二维码，可以使用 Scan QR Code，按系统提示允许相机访问后扫描自己的资料。二维码只是输入方式，扫描后仍要检查 Type 与关键参数是否完整。Import from Cloud JSON 是另一种导入入口，仅在你确实持有相应格式资料时使用，不应把普通网页或任意文本当作该格式导入。

通过 Subscribe 导入已有订阅

如果持有的是订阅链接，在 Add Server 的 Type 中选择 Subscribe，在对应地址栏粘贴自己的完整链接，并填写便于辨认的备注后保存。复制时要保留链接中的完整路径和查询参数，避免将聊天文字、换行或末尾标点一起带入。订阅地址通常具有访问权限，应按密码一样保管；本页不展示可用地址，也不要求上传你的订阅。

保存后返回 Home，等待订阅读取结束，检查 SERVER 是否出现对应分组和服务器条目。订阅名称出现但条目为空，不等于导入已经成功；应检查读取提示、当前网络以及链接是否完整。已有订阅内容发生变化时，使用对应订阅的更新操作重新获取，更新后再次检查当前选中的服务器，避免继续使用已移除的旧条目。

完成添加后先不要反复修改参数。下一步检查 Global Routing，确定连接建立后哪些请求会使用这项服务器，避免把分流方式与服务器可用性混为一谈。

回到 Home，点开 Global Routing，按本次目的选择配置(Config)、代理(Proxy)或直连(Direct)。这里决定请求采用怎样的分流方式，不负责补全服务器参数，也不能替代服务器本身。初次设置时，应先理解三种姿态，再决定长期使用哪一种；不要仅凭某个网站能否打开，就连续切换全部选项。

配置(Config)：按当前配置匹配

配置(Config)会依据当前启用配置中的规则处理请求。进入 Config，确认启用的是你打算使用的配置，而不是仅仅打开了某个文件的编辑页面。在配置编辑页中，General、Rule、Hosts、URL Rewrite、HTTPS Decryption 各有不同作用。首次连接不需要逐项修改；本步重点是确认配置来源、启用状态以及 Rule 中与目标相关的策略。

规则通常自上而下检查，较早命中的规则决定对应处理方式。DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配域名后缀，IP-CIDR 匹配地址范围，FINAL 用作最后的兜底。PROXY、DIRECT、REJECT 是不同策略，不能把 REJECT 当成“换一个服务器重试”。下面只展示规则语法，不是建议覆盖当前配置的完整文件。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

这个示例中，api.example.com先命中第一行并使用 DIRECT；其他符合后缀的域名再按第二行处理。如果把宽泛规则放在精确规则前面，后面的条目可能不再有机会命中。修改前保留原配置，只改确实理解的一条规则，并重新确认当前配置已经启用。截图中的 Add Rule 用于添加规则，不是添加服务器。

代理(Proxy)与直连(Direct)：用于分开检查路径

代理(Proxy)以代理路径处理请求，可用于初步检查所选服务器的连接情况；它不表示远端所有目标都必然可达。直连(Direct)使用本地直连路径，可用于确认基础网络是否正常，但此时网站能打开不能证明代理路径已生效。排查时可以临时切换，测试结束后应回到你原本计划使用的姿态。

一般需要按规则区分请求时，使用配置(Config)并检查对应规则；需要隔离服务器与规则问题时，再做短暂对照。对新手而言，先保留已有配置的结构，比同时修改 Hosts、URL Rewrite 与 HTTPS Decryption 更容易定位结果。完成本步后，记住当前姿态和启用配置的名称，再继续连接。

规则关键字的进一步说明可见规则语法说明；商店地区、购买与已购恢复属于另一条流程，见App Store 指南，无需在首次连接时同时处理。

返回 Home，依次确认三件事：SERVER 中选中了本次要使用的服务器，Global Routing 与上一步的决定一致，当前设备本身已经可以正常联网。顶部显示 Not Connected 时，表示连接尚未建立。此时打开顶部开关，观察系统提示和应用状态变化，不要在等待过程中连续开关或同时更新订阅。

识别添加 VPN 配置的系统请求

首次启用连接，系统可能请求允许添加 VPN 配置。这个请求用于让 Shadowrocket 建立由系统管理的网络连接配置，不是购买提示，也不是服务器信息输入框。阅读弹窗中的应用名称与说明后，按系统提示确认；系统可能继续要求设备认证。完成后回到 Shadowrocket，检查顶部状态是否已从 Not Connected 发生变化。

如果先前取消了授权，当前连接可能无法继续建立。再次打开连接开关并按实际提示处理，不要为了绕过提示而任意删除其他用途的系统配置。若设备受组织管理，系统策略也可能限制配置操作，应先确认设备允许进行该操作。授权只解决本机配置权限，不会校正错误的 Host、Port 或认证参数。

连接状态与实际可用性分开看

系统显示 VPN 状态或应用开关保持打开，说明本地连接状态发生了变化，但不能单独证明所选服务器和目标网站均正常。相反，开关立即回退或状态一直未建立，应先查看当前提示，再检查是否完成授权、服务器是否仍被选中，以及配置是否有效。把状态文字记下来，比只记录“连不上”更有助于后续排查。

首次连接期间，先保持一个明确的测试条件：使用同一网络、同一服务器和同一分流姿态。需要切换 Wi-Fi 或蜂窝网络时，先停止当前测试，再在新网络下重新连接并观察结果。多个变量一起变化，会让一次偶然成功难以复现，也会掩盖真实问题。

出现问题时，先停止反复重建配置，按“本地网络 → 输入资料 → 服务器参数 → 系统时间 → 规则与测试设置”的顺序检查。Settings 中的 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 涉及不同层面，不应作为一组同时开启或关闭。先确定失败发生在导入、连接还是实际访问阶段，才能选择对应检查项。

导入后没有服务器，或更新失败

先确认设备能够访问正常网络，再核对订阅链接是否完整、是否带入空格、是否仍具有访问权限。订阅内容不能读取时，反复切换 Global Routing 通常不能修复地址本身。查看更新结果与提示，必要时向你已有服务的提供方核实链接状态。重新获取有效资料后，再更新对应 Subscribe，确认服务器条目确实出现，不要只检查分组名称。

测试超时，或连接后目标打不开

核对 Type、Host、Port 与该协议的认证字段，尤其留意手动输入造成的漏字、大小写变化和错误端口。涉及 TLS 的连接，还应检查已有资料中的相关名称与选项，并确认设备日期、时间及时区正确；时间偏差可能影响证书校验。参数以已有资料为准，不要凭尝试随意关闭校验或改成另一个协议。

然后进入 Settings 查看 Test Method，确认当前测试方式，再回到 Home 用相同条件重试。某种测试方式失败，只能说明该项测试未得到预期结果，还要结合实际访问判断。若仅配置(Config)下失败，回查启用配置、规则顺序和最终策略；若同一服务器在不同网络下表现不同，记录网络差异，再逐项缩小范围。

开关自动变化，或只有部分应用异常

先确认是否启用了 On Demand，以及其触发条件是否与你预期一致。它与手动开关的使用场景不同，首次排查应避免让自动触发干扰对照，但不要在不理解用途时批量清除已有设置。部分应用异常时，还应区分域名匹配、DNS 解析与 TCP、UDP 路径问题；不要因为看到 Settings 中有对应项目，就直接修改所有选项。

需要进一步查看时，使用 Diagnostics 中实际提供的诊断项目，记录错误发生的动作与提示。分享记录前，删除订阅链接、密码、认证标识及其他敏感信息，只保留足以说明问题的状态、字段名称和操作顺序。完整订阅地址并不是排查说明的必要组成部分。

修正一项后，按本页顺序重新验证：回到 Add Server / Subscribe 核对资料，再确认 Global Routing，随后连接并进行 Connectivity Test 与实际访问检查。保存有效结果后再处理下一项，避免在已经恢复的情况下继续改动。节点超时的专门检查见连接超时排查顺序。