Shadowrocket 使用教程

步骤 01 · 准备连接条目

Add Server：添加服务器与导入订阅

先判断手中的信息是哪一种：一整条订阅链接，还是单个服务器的协议、地址、端口与认证参数。两种方式的入口可能相邻，但填写逻辑不同。订阅用于获取并管理一组条目，单个服务器则需要按对应协议逐项填写；不要把订阅地址中的域名直接当作服务器的 Host。

已有订阅链接：选择 Subscribe

打开 Shadowrocket 的 Home，在 SERVER 分组找到 Add Server 并进入。若使用已有订阅，在 Type 中选择 Subscribe，再把完整链接粘贴到对应的 URL 字段。检查复制时是否带入空格、换行或引号，尤其不要删去链接问号之后的内容，那部分可能用于识别订阅访问权限。填写便于自己辨认的备注，保存并等待获取完成。

返回 Home 后，应能在列表中看到导入的分组或服务器条目，而不只是留下一条没有内容的订阅记录。获取过程中需要当前网络能够访问订阅地址；如果提示请求失败，先核对链接本身是否仍有效，再检查网络条件。反复点击更新不能修复失效凭据，也不能替代链接核对。

已有服务器信息：先核对 Type

如果拿到的是单个服务器信息，在 Add Server 中先选择正确的 Type，再按提供方给出的内容填写 Host、Port 以及该类型需要的认证字段。截图中的 Password、Method 对应特定协议字段，不代表每一种类型都需要相同参数。Shadowsocks、VMess、VLESS、Trojan 等类型应与服务器端配置一致，不能仅凭名称相似就互换。

Host 一般填写服务器地址或域名；若已有资料单独给出传输路径、TLS 名称或其他扩展字段，应填入对应位置，不要拼进 Host。二维码也可以通过 Scan QR Code 读取，但读取后仍需核对 Type 与关键字段。Import from Cloud JSON 对应特定输入格式，不应拿来打开任意订阅链接。

保存后回到 Home，确认条目存在，再点选准备使用的服务器。此时只完成了信息导入，尚不能据此判断连接成功。若订阅更新后条目变化，先重新确认当前选中项，再进入下一步。订阅链接与二维码可能包含认证信息，不要放进公开截图或公开讨论内容。

步骤 02 · 明确流量处理方式

Global Routing：选择连接姿态

服务器条目保存后，返回 Home，打开 Global Routing。这里选择的是请求如何被处理，而不是选择服务器协议。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。先弄清当前选项，再打开连接，能避免把模式不符合预期误判成服务器失效。

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

选择配置(Config)时，请求依据当前启用配置中的规则决定处理方式。进入 Config，核对实际使用的配置文件，而不是只确认列表里“有一个文件”。打开编辑内容后，可以看到 General、Rule、Hosts、URL Rewrite 等分段；截图用于识别这些位置，首次连接不要求逐项编辑所有分段。

Rule 中的匹配顺序会影响结果。前面的规则命中后，后面的规则通常不再参与该请求的策略选择，FINAL 用于接住此前未匹配的请求。DIRECT 表示直连，REJECT 表示拒绝；指向代理或策略组的规则还需要具备可用的目标。看到 PROXY 字样，并不意味着应用会自动补齐服务器或策略组。

如果已有一份明确用途的配置，先保留其内容，检查当前是否启用、策略是否有对应条目。不要为了首次连接同时修改 DNS、Rule 与 URL Rewrite，否则出现异常时很难确定是哪一次改动造成的。订阅和配置文件也不是同一个概念：前者可以更新服务器条目，后者主要决定请求如何处理。

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

代理(Proxy)使通常受该模式处理的请求使用所选代理，适合临时核对“服务器本身能否工作”。它不等于所有系统流量都必然通过代理，系统保留流量及相关设置仍可能影响路径。如果 Proxy 下能访问、Config 下不能访问，应优先检查配置规则与策略映射，而不是立刻重填服务器参数。

直连(Direct)让相关请求直接连接，不通过所选代理服务器。它可用于比较当前网络的直接访问情况，但切换到 Direct 不等于关闭 Home 顶部连接开关。若目标是结束客户端连接，应回到 Home 关闭开关，并核对状态，而不是仅更换 Global Routing。

首次验证时先固定一种模式，记录选择结果，再执行连接。规则细节需要展开时，查看技术参考；常见模式误判可查看常见问题。本教程只要求明确“当前选了什么、为什么选它”，不要求一次写好整套规则。

步骤 03 · 建立系统连接

Home：打开开关并确认授权

回到 Home，先在 SERVER 分组确认已选中准备使用的服务器，再核对 Global Routing 显示的模式。选中服务器、选择模式和打开连接是三件独立的操作：列表里存在服务器，不代表它已经被选中；服务器被选中，也不代表系统连接已经开启。

打开 Home 顶部的连接开关。首次连接时，系统可能要求允许 Shadowrocket 添加 VPN 配置。阅读提示，确认发起操作的是刚刚打开的 Shadowrocket，再按系统流程允许并完成设备验证。该授权用于建立系统网络配置，不会替代订阅认证，也不表示服务器信息已经通过验证。

完成系统提示后返回 Home，观察顶部状态是否从 Not Connected 变为已连接状态，并检查开关是否保持开启。系统状态区可能因设备与当前界面不同而使用不同的连接标识，因此以应用状态与实际访问共同判断，不只依赖状态栏是否出现图标。

如果此前取消了授权，先回到应用重新尝试连接，按实际出现的系统提示操作。若设备受组织管理，系统可能限制新增 VPN 配置；这类限制不能靠更改服务器密码解决。先确认设备是否允许该操作，再继续排查应用内参数。

连接开关刚打开便立即关闭，通常应先记录状态变化和提示，再区分系统授权问题与服务器连接问题。不要在未记录现象时连续切换多个条目。保留当前服务器与模式，只重试一次连接，观察错误是否一致，随后进入后面的失败点排查。

iPad 可按同一操作顺序执行；布局可能随窗口大小变化。只要先确认 Home、SERVER、Global Routing 与顶部连接开关，就不必为了对齐图片而改变设备显示设置。现在保持连接，继续使用 Connectivity Test 和实际目标核对结果。

步骤 05 · 按发生位置处理

Settings：常见失败点排查

排查时先描述失败发生在哪一步：订阅没有导入、开关无法保持开启，还是连接已开启但目标访问失败。三者涉及的条件不同。先回到最近完成的步骤，确认其完成标志仍成立，再继续向后检查，比同时重置所有设置更容易找到原因。

导入失败：先检查输入与订阅响应

订阅更新报错时，核对完整链接、当前网络以及订阅是否仍有效。若链接能够请求但没有导入条目，检查返回内容是否属于应用支持的订阅格式；登录页面、错误页面或仅供浏览的说明页面，不等于服务器配置数据。单个服务器保存失败，则重新检查 Type 对应的必填字段和 Port 是否填写正确。

已有订阅中的服务器发生变化时，更新完成后再次确认当前选中项，避免仍在使用旧条目。更新订阅和更新 Config 文件应分别核对，不能用其中一个成功来证明另一个已经同步。需要确认信息有效性时，联系自己已有服务的提供方，并只提交必要的错误描述。

连接失败：检查授权、认证与设备时间

开关无法开启时，先看系统授权是否完成，以及设备是否存在管理限制。开关能够开启但服务器无法使用时，再核对 Host、Port、认证信息、传输方式与 TLS 相关字段。协议要求的名称或路径不一致，也可能导致连接失败。不要通过随意关闭证书验证来掩盖字段错误。

涉及证书或认证时间判断时，检查设备日期与时间是否正常。若同时启用了其他网络连接配置，先确认实际由哪一个配置工作，再做对照测试。首次排查阶段尽量保持网络条件固定，以免连接切换和参数变化混在一起。

访问失败：检查 Test Method 与 On Demand

进入 Settings，找到 Test Method，确认当前测试方式。不同方法对应的检查目标不同，因此延迟数字不能直接当作网页加载速度，也不适合跨测试方法机械比较。若只有测试异常而实际目标正常，优先检查测试条件；若实际目标也失败，再回到规则与服务器路径。

如果手动关闭后又自动连接，或切换 Wi-Fi 后连接状态改变，检查 On Demand 是否启用及其触发条件。首次连接尚未稳定时，可先暂时停用自动触发，再按 Home 的手动流程验证；确认基础流程正常后，再逐条加入需要的条件。不要把自动重连现象当作开关失效而反复修改服务器。

仍无法定位时，查看 Settings 中的 Diagnostics，保留与本次失败时间对应的必要信息。分享前遮盖订阅链接、认证字段、二维码与可识别个人网络的信息。描述中写清所选模式、网络类型、失败步骤和已做过的单项对照即可，不需要公开整份配置。