Shadowrocket 使用教程
订阅导入与连接验证

STEP 01 / ADD SERVER

添加服务器或导入已有订阅

先判断手中的资料是哪一种：包含 Host、Port、Password 等字段的是单条服务器信息；能够更新一组服务器的地址是订阅链接。两者不能仅凭链接长短区分，也不要把服务商的登录页面地址当作订阅地址。应从你已有服务商提供的配置说明中确认导入类型，再进入 Shadowrocket 操作。

单条服务器：核对 Type 与字段

打开 Home，点右上角的添加入口或列表中的 Add Server。进入后先点 Type，选择与已有服务器一致的协议，再逐项填写 Host、Port 和所需认证字段。右侧官方截图展示的是包含 Password 与 Method 的表单；选择不同 Type 后，字段会有所变化，不要为了对齐截图而改变协议。

Host 通常只填写服务器域名或 IP 地址，不附带网页路径；Port 填服务商给出的端口数字。密码大小写、Method，以及协议要求的 TLS、服务器名称等参数都需要保持一致。某个字段没有提供时，先查看服务商说明，不根据别人的配置猜填。填写完成后使用页面的保存或完成按钮，返回 Home，检查 SERVER 分组内是否出现新条目。

订阅：选择 Subscribe 后再保存

如果已有的是订阅链接，在 Add Server 的 Type 中选择 Subscribe，将完整地址粘贴到对应的 URL 字段，再保存。复制时要包含地址尾部的全部参数，清除首尾空格与意外换行，但不要擅自删除问号后的内容。订阅地址可能携带身份凭据，不要把完整地址贴到公开截图或排错记录中。

保存后回到 Home，等待订阅内容载入；需要更新时，使用该订阅条目的更新操作。确认订阅分组下确实出现了服务器，而不是只保存了一个分组名称。若列表仍为空，先跳到常见失败点检查地址，不必反复打开连接开关：没有可选服务器时，切换模式不能补齐订阅内容。

已有配置以二维码形式提供时，可在 Add Server 使用 Scan QR Code，按系统提示允许相机访问，并在识别后检查内容再保存。Import from Cloud JSON 适用于对应格式的配置，不应当作任意订阅地址的通用入口。完成后选定一个条目，继续下一步设置 Global Routing。

STEP 02 / GLOBAL ROUTING

选择 Global Routing 姿态

服务器决定连接到哪里，Global Routing 决定请求如何被处理，两者需要分别确认。回到 Home，点 Global Routing，查看当前选择。三种姿态为配置(Config) / 代理(Proxy) / 直连(Direct)。这里是在选择路由方式，不是在执行服务器连通性测试，也不会因为选择某个模式就自动修复服务器参数。

配置(Config)：使用当前规则

日常按规则分流时选择 Config。客户端会按照当前配置中的规则处理请求；规则中的 PROXY、DIRECT 与 REJECT 分别表示对应的代理、直连与拒绝策略。打开底部 Config，确认当前实际选中的配置文件；进入文件可看到官方截图中的 General、Rule、Hosts 等分段。导入订阅主要更新服务器条目，并不意味着已经切换了这里的配置文件。

如果服务商提供了与你使用场景相符的完整配置，先按其说明核对并选用，不要在首次连接前同时改动 DNS、Rule 和其他高级设置。配置中具体规则通常应排在兜底规则之前；例如下面的片段只用于说明匹配顺序，不是需要整段粘贴的完整配置文件。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

代理(Proxy)与直连(Direct)：用于对照

Proxy 用于让通常受该模式处理的请求走所选代理，适合临时判断问题是否与 Config 的规则有关。Direct 则使用直连路径，适合比较本地网络本身是否可用。它们都不是“更快”的固定选项；访问结果还与目标服务、服务器状态和当前网络有关。不要把 Direct 下页面能打开误认为代理服务器已经工作。

本教程建议先保留一份明确的现有配置，以 Config 为日常起点。如果之后需要比较 Proxy 与 Config，只改变这一项并重复同一个测试，测试完恢复原模式。规则匹配、FINAL 与 DNS 的深入检查见故障排查手册。现在回到 Home，准备选择服务器并连接。

STEP 03 / CONNECT

选择条目并打开连接开关

回到 Home，在 SERVER 分组中点选准备使用的服务器，确认选中标记落在目标条目上。订阅下可能有多个服务器，新增或更新后应再检查一次实际选中项。首次操作只选一个进行验证，不要在测试过程中连续更换多个条目，否则很难分清是服务器切换还是设置变化影响了结果。

确认 Global Routing 是刚才选择的模式，再打开 Home 顶部的连接开关。官方截图展示了连接前的 Not Connected 状态。首次连接时，系统可能询问是否允许添加 VPN 配置；核对发起请求的应用确为 Shadowrocket，再按系统提示确认，并在需要时使用设备密码或系统认证完成授权。若取消授权，客户端无法依照该配置建立系统连接。

授权完成后返回 Home，观察开关和连接状态是否保持。系统状态区域中的 VPN 标识可以辅助确认系统连接情况，但不同设备、显示区域和系统版本的呈现方式可能不同，不能仅凭某处有没有图标判断所有请求的路径。VPN 配置已启用，也不代表远端服务器必然能够访问，因此接下来仍然要做实际验证。

如果开关刚打开就恢复关闭，先记录是否出现系统提示，查看系统 VPN 设置中是否存在当前配置，以及是否有其他 VPN 连接正在占用。不要连续重复授权或立即删除全部配置。由组织管理的设备可能限制 VPN 配置，应遵循设备管理要求处理，不尝试绕过限制。

首次测试建议暂时保持网络环境不变，不在连接过程中同时切换 Wi-Fi 与蜂窝网络，也先不调整 On Demand。需要停止连接时，回到 Home 关闭开关；如果之后发现连接被重新触发，再到 Settings 核对 On Demand 的条件。保持“同一网络、同一条目、同一模式”的基线后，下一步的检查才有可比性。

STEP 05 / SETTINGS

按症状检查常见失败点

排错顺序是先看本地网络，再看导入内容与服务器，最后看规则和附加设置。每次只改变一项，重复同一个实际请求。进入 Settings 后，可以看到官方截图中的 Test Method、On Demand 与 Diagnostics 等入口；不要因为测试失败就同时重置 Proxy、TCP、UDP 等设置，这会丢失原先可比较的基线。

订阅保存成功，但列表为空

先回到订阅编辑位置，核对 Type 是否为 Subscribe、链接是否完整、是否多了空格。再确认该地址仍然有效，返回的内容确实是客户端可识别的订阅，而不是登录页面或错误提示。避免短时间内连续更新；如果服务商设置了更新频率限制，应按其说明等待。关于地址有效性、权限或内容的问题，向你已有的服务商核对即可，不要把完整订阅链接公开。

服务器出现，但 Connectivity Test 超时

确认普通直连页面能够打开，再检查选中服务器的 Host、Port 与认证信息。订阅条目先正常更新一次，手动条目则逐项对照原始资料。Settings 中的 Test Method 会影响测试行为与结果的可比性，因此比较不同服务器时保持测试方式一致。若某种测试没有响应，还要结合浏览器实际访问判断，不能把一个测试值当作线路整体状态。

开关正常，但部分页面打不开

先确认当前模式并未停留在 Direct，再按上一节的方法比较 Proxy 与 Config。如果只有 Config 失败，检查是否选错了配置文件、目标域名是否命中了 REJECT 或不合适的 DIRECT 规则。域名解析异常需要继续核对 DNS，而不是仅修改规则顺序。暂时不要启用或改动 HTTPS Decryption、URL Rewrite 来解决普通连接问题，它们不是首次连接的必要步骤。

开关反复变化，或切换网络后异常

检查系统 VPN 权限与其他连接占用，再到 Settings 查看 On Demand 是否配置了自动连接条件。若问题只在 Wi-Fi 或蜂窝网络其中一种环境出现，分别记录结果，避免同时修改服务器和网络。iPad 使用相同检查顺序；横屏时布局位置可能变化，但仍以 Home、Config、Settings 的入口名称为准。

需要进一步分析时，使用 Diagnostics 查看可用记录。分享记录前删除订阅地址中的凭据、服务器认证信息及其他个人数据，只保留错误现象、发生条件与已经尝试过的步骤。系统性的 DNS、耗电、更新后异常和 iPad 专项流程见Shadowrocket 故障排查；若只是忘记首次操作顺序，可回到添加与导入重新逐步核对，不必先清空全部设置。