Shadowrocket 使用说明

01 · Add Server：添加服务器或导入订阅

先确定手中的内容属于哪一种：包含多个服务器并能更新的订阅链接，还是单个服务器的地址、端口和认证信息。两种内容进入应用的方式不同，不要把订阅 URL 当成服务器地址填入。打开 Shadowrocket，进入 Home，点击右上角的添加入口，进入 Add Server。保存前先检查 Type，它决定接下来显示哪些字段。

已有订阅：使用 Subscribe

在 Add Server 的 Type 中选择 Subscribe，将完整订阅链接填入 URL，再添加一个便于自己辨认的名称。粘贴后检查开头、结尾以及查询参数是否完整，尤其注意聊天软件复制时带入的空格、换行或说明文字。订阅链接常带访问凭据，应完整保留，但不要公开到讨论区或截图中。

完成填写后保存，等待应用获取并解析订阅内容，再返回 Home 查看结果。能看到订阅分组以及其中的服务器，才说明这一步已产生可选择的连接条目；仅仅保存了订阅名称，并不代表内容已成功获取。如果分组没有服务器，先检查订阅响应与有效性，不要直接进入后面的连接步骤。订阅更新只是刷新连接信息，不会替代服务商侧的权限或有效期。

已有单个服务器：按 Type 填写

如果收到的是单个服务器参数，在 Add Server 中选择对应协议的 Type，然后逐项填写地址、端口和认证信息。不同协议需要的字段不同：例如 Shadowsocks 需要核对加密方法与密码，VMess、VLESS 常需核对 UUID，Trojan 需核对密码及 TLS 相关参数。字段名称相似不等于可以互换，也不要把一类协议的信息填入另一类协议表单。

服务商信息中如果还包含传输方式、路径、Host 或 SNI，应按其原始说明填写。服务器地址与用于 TLS 校验的名称可能不同，不要为了让表单看起来一致而自行修改；也不要用关闭证书校验来代替参数核对。保存后回到 Home，确认新服务器出现，再点选准备使用的条目。此时只是完成了信息录入，还没有证明连接可用。

已有分享链接或二维码的用户，也可使用对应的剪贴板导入或 Scan QR Code 入口；导入后仍应打开条目核对协议与地址。扫码操作与字段逐项解释见扫码与导入管理，协议概念见术语手册。准备好一个明确选中的服务器后，再继续选择流量处理方式。

02 · Global Routing：选择流量处理姿态

在 Home 打开 Global Routing，根据当前目的选择配置(Config)、代理(Proxy)或直连(Direct)。这三个选项决定请求如何处理，不是三种协议，也不是速度等级。选中了服务器，不代表所有请求都会经过它；如果姿态与预期不同，可能出现连接开关已打开、目标请求却走了其他路径的情况。

配置(Config)：按配置文件中的规则处理

日常需要规则分流时使用配置(Config)。先进入 Config，确认当前选中的配置文件是自己准备使用的文件，再回到 Global Routing 选择 Config。这里有两个不同层次：Config 页面管理配置文件，Global Routing 中的 Config 选项表示按所选配置处理请求。导入服务器订阅，并不自动等于已经导入或启用了某份规则配置。

规则通常按顺序匹配，最终由命中的规则决定使用 PROXY、DIRECT 或 REJECT。如果一项请求匹配到 DIRECT，即使连接开关开启，它也可能直接访问；如果命中 REJECT，请求会被拒绝。不要只看最后一条规则就判断全部请求的走向。规则示例与关键字解释可继续查看规则分流说明。

代理(Proxy)：用于检查所选代理路径

首次排查服务器是否能工作时，可临时选择代理(Proxy)，使适用请求按该姿态走代理路径，减少规则分流对观察结果的干扰。选择后仍要在 Home 确认目标服务器已选中。Proxy 不会修复错误密码、失效的服务器或受限的传输条件；它只改变流量处理方式，不能作为服务器可用性的保证。

直连(Direct)：用于直接访问

直连(Direct)用于直接访问，不适合用来证明代理服务器已生效。若当前是 Direct，目标页面打开成功，只能说明直接访问路径在该条件下可用。需要比较本地网络与代理路径时，可以把它作为对照，但应记下每次选择的姿态，避免把不同条件下的测试结果混在一起。

完成选择后返回 Home，再读一次 Global Routing 的当前值。接下来的连接与验证都应在这一已知条件下进行；若只是临时使用 Proxy 排查，确认后记得恢复自己需要的 Config，并重新验证分流结果。

03 · Home：打开连接并完成系统授权

返回 Home 后，先点选刚才核对过的服务器，再打开顶部连接开关。如果订阅里有多个名称相近的条目，应确认选择标记所在的位置，而不是仅看屏幕上最近出现的名称。订阅更新后也应重新核对当前选择，避免把另一个服务器的表现当成刚才测试条目的表现。

首次建立连接时，系统可能显示添加 VPN 配置的授权提示。这是系统允许应用建立相应网络连接的确认环节，与购买应用或导入订阅不是同一个操作。阅读提示，确认由 Shadowrocket 发起，再按系统要求完成确认或身份验证。没有完成授权时，返回应用看到开关关闭，并不能直接推断为服务器参数错误。

授权结束后回到应用，观察连接开关是否保持开启。系统显示的 VPN 状态与应用中的开启状态，可以用来确认连接机制已经启动，但不能单独证明目标服务能够访问。服务器认证失败、DNS 解析异常或规则命中不符，都可能发生在开关已经开启之后，因此下一步仍需要实际验证。

如果开关立即回到关闭状态，先检查系统授权是否完成，以及设备上是否存在其他正在使用的 VPN 连接。不同 VPN 配置可能争用连接状态，排查时应先明确当前正在运行的是哪一个。受管理设备还可能有组织设置的限制；遇到系统提示时按其内容处理，不要反复删除应用来尝试绕过设备策略。

初次验证期间，先保持其他设置不变，暂不调整 On Demand 等自动连接条件。按需触发属于后续使用习惯设置，不是手动连接成功的前提。手动开关、服务器选择与姿态都确认后，再进入验证步骤；这样出现问题时，能够知道是哪个环节开始偏离预期。

04 · Connectivity Test：验证测试与实际请求

连接开启后，在 Home 使用 Connectivity Test 检查服务器。先测试当前选中的条目，再按需要比较其他条目，避免一开始批量测试后忘记实际选择了哪一个。测试结果应与所用测试方式一起理解：不同方式涉及的连接阶段可能不同，因此不能把任意一个返回数值都解释为完整业务访问已经成功。

得到响应，说明对应测试在当时条件下完成了相应环节；它不直接代表下载速度，也不能保证所有目标服务可用。超时则表示该测试未在等待范围内完成，但原因可能在服务器、本地网络或测试目标本身。一次结果适合作为线索，不适合作为对整条线路的永久结论。测试方法与排序的进一步说明见延迟测试与服务器整理。

接着打开自己需要访问的网页或应用，执行一个容易重复的操作，例如刷新同一个页面。记录是否能打开、是否只有部分资源失败，以及问题发生时的网络环境。不要只凭应用里的开关或系统 VPN 标识判断成功；真正需要验证的是目标请求是否按预期完成，以及请求采用的路径是否符合当前姿态。

使用配置(Config)时，还需要检查实际请求记录中的规则命中与处理结果。目标请求命中 DIRECT，不代表代理失效，而可能正是配置要求；命中 REJECT 时，先核对规则意图。若怀疑是规则影响，可临时切到代理(Proxy)，在同一服务器、同一本地网络下重复相同请求，再恢复 Config 对照结果。对照期间不要同时更换服务器和修改 DNS，否则结果难以解释。

可以把本次验证结果记成简短的文字：所选服务器名称、Global Routing 值、本地网络、目标操作与成功或失败现象。记录中不需要完整订阅 URL、密码或 UUID。确认实际请求正常后，再逐项恢复日常设置；每恢复一项做一次相同验证，才能把后续异常与具体改动对应起来。

05 · 常见失败点：从发生问题的环节检查

排查先分层，不要同时修改所有参数。按“导入内容是否完整 → 系统是否建立连接 → 服务器测试是否响应 → 实际请求是否符合规则”的顺序，找到第一个失败环节。保留原来的可用配置，每次只更改一项，然后重复第四步中的同一个验证操作。下面的顺序适合首次使用，也适合在订阅更新或切换本地网络后重新检查。

订阅保存了，却没有服务器

返回订阅条目，确认 Type 为 Subscribe，URL 是完整订阅地址而不是服务商管理页面地址。检查是否混入引号、空格或缺失查询参数，并查看应用给出的获取或解析提示。能够在浏览器打开一个网页，并不意味着该响应就是可导入的订阅内容；若内容为空或权限失效，应从你的服务商处核对原链接，不要通过修改随机参数尝试修复。

开关无法保持开启

先检查系统 VPN 配置授权与设备管理限制，再确认其他 VPN 连接的状态。如果应用给出了配置错误提示，回到最近修改的配置查看具体问题。此时连系统连接都没有建立，批量更换服务器通常不能解释原因。只有开关能够正常开启后，才继续检查服务器的认证与传输参数。

Connectivity Test 超时，实际访问也失败

先确认设备本身能正常使用当前网络，再核对服务器地址、端口、密码或 UUID、TLS 与传输设置。输入内容中的一个多余字符，就可能使认证或握手失败。对照服务商原始信息逐项检查，不要只看服务器名称。可以在 Wi-Fi 与蜂窝网络之间做一次对照；如果结果只随本地网络变化，应进一步关注该网络的访问条件，而不是立即改写整份配置。

测试有响应，但只有部分服务异常

这种情况要把“服务器测试可达”与“目标业务可用”分开。先确认 Global Routing，再检查对应请求的规则结果和 DNS 相关现象。若 Proxy 下正常、Config 下失败，优先核对当前配置文件、规则顺序和策略指向；若两种姿态都失败，再看目标服务状态、服务器出口条件与协议参数。不要把所有局部失败都归因于延迟高。

刚更新订阅或切换网络后出现异常

更新后先检查所选服务器是否仍然存在、参数是否发生变化，以及分组里是否新增了名称相近的条目。切换网络后则重新测试同一个服务器，避免把旧网络中的测试值继续用于当前判断。暂时停止反复更新与批量切换，固定一组条件观察一次完整请求，更容易判断问题来自连接信息变化还是本地环境变化。

完成基础连接后，订阅更新、多订阅整理、服务器删除与备份等操作可继续阅读节点管理手册；遇到不熟悉的协议或规则关键字，先查阅术语手册再修改参数。教程到这里的完成标准是：能说明自己选中了什么、请求按什么方式处理，并能用一次可重复的实际访问确认结果。