Shadowrocket 使用教程

Step 01 / Add Server

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

先判断手里的资料属于哪一种：如果是一条用于获取服务器列表的订阅链接，使用 Subscribe；如果是独立服务器的地址、端口与认证资料，按对应 Type 手动填写。两种方式选一种即可，不必把订阅链接拆成 Host 和 Password，也不要把普通网站地址当作订阅地址。资料含义不明确时，先向你已有的服务商核对，再开始填写。

通过 Subscribe 导入

打开 Shadowrocket，在 Home 找到 Add Server，进入后点 Type，选择 Subscribe。回到添加页面，把自己已有的完整订阅链接填入 URL，并填写便于辨认的备注，再使用页面上的保存操作。复制时应保留链接中的查询参数，删除首尾意外带入的空格或换行；链接可能包含访问凭据，不应发布到评论、聊天截图或公开文档中。

保存并获取内容后，返回 Home 查看订阅分组及其服务器条目。只有分组名称而没有条目时，先检查订阅是否成功获取内容，不要立刻尝试打开连接。如果资料已更新，使用该订阅条目提供的更新操作重新获取，再核对是否出现预期条目。导入只是把连接参数放入客户端，并不表示服务器已经可用；连通性要在后面的步骤单独验证。

通过 Add Server 手动填写

在 Add Server 中先选择 Type，再对照自己的资料填写 Host、Port 与该类型需要的认证字段。例如 Shadowsocks 需要核对 Password 与 Method；其他类型可能使用不同的认证、传输或 TLS 字段。不要因为字段名称相近就相互替代，也不要把 Host 写成带路径的网页链接。服务器地址、端口、大小写和加密方式都应与原始资料一致。

已有对应二维码时，可以使用 Scan QR Code 读取资料；Import from Cloud JSON 仅适用于你确实持有相应格式资料的情况。导入后仍要打开条目检查 Type 与关键字段。保存后回到 Home，确认 SERVER 中能找到该条目，并用备注区分它与其他条目。现在先保留原始资料，下一步设置路由，再选择它进行连接。

Step 02 / Global Routing

选择 Global Routing 姿态

服务器资料保存好后，返回 Home，点 Global Routing。这里决定流量如何分配，不负责修正服务器参数。三种常用姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。先根据当前目的选择，再继续打开连接；“选了服务器”与“所有请求都会经过服务器”并不是一回事。

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

需要规则分流时选择 Config，再进入 Config 页面，确认当前实际使用的配置文件。打开配置后检查 Rule，并留意末尾的兜底规则。规则一般按顺序匹配，具体域名应放在更宽泛的规则之前；FINAL 用于接住前面未匹配的请求。修改未启用的配置文件，不会改变当前连接的路由结果，因此先核对文件，再编辑内容。

下面是用于理解匹配关系的规则片段：example.com 及其子域名匹配 PROXY，其余请求交给 FINAL,DIRECT。它只演示规则语法，不包含服务器资料，也不应直接替换你的完整配置。PROXY 对应的实际出站选择仍需在自己的配置和 Home 中核对，DIRECT 表示该规则要求直连。

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

代理(Proxy)与直连(Direct)：用于明确当前路径

Proxy 让当前路由按代理姿态处理，可用于临时隔离规则因素，检查所选服务器是否能完成实际访问。Direct 按直连姿态处理，不应拿它的访问成功来证明服务器可用。测试期间记录原来的姿态，测试结束后恢复；否则容易出现“刚才能用，改完规则却没有变化”的误判。

初次使用时，不必同时修改 DNS、HTTPS Decryption 与多条规则。先保留已有配置，完成一次连接与验证，再逐项调整。需要比较 Shadowsocks、VMess、VLESS、Trojan、WireGuard 或 Hysteria2 的字段差异时，转到协议参考阅读；本页继续沿用已导入且已核对的资料。

Step 03 / Home

选择服务器并打开连接

回到 Home，在 SERVER 分组中点选刚才核对过的服务器，确认选中标记落在目标条目上。订阅中的多个条目是不同的连接选择，并不意味着客户端会自动替你完成可用性判断。为便于复查，首次测试只选一个条目，并记住它的备注、当前网络和 Global Routing 姿态。

处理首次 VPN 配置授权

打开 Home 顶部的连接开关。首次建立连接时，系统会请求添加 VPN 配置；阅读系统提示，确认正在操作的是 Shadowrocket，再按提示允许并完成设备验证。该授权用于让应用建立系统网络通道，与购买状态、订阅内容是不同层面的事项。允许授权后返回应用，观察顶部状态是否从 Not Connected 发生变化。

如果刚才取消了系统提示，先返回应用重新触发连接并确认授权，不要连续重复点击开关。系统设置里的 VPN 配置也可用于核对授权是否已经建立，具体入口随系统界面而变化。设备受管理或已有其他 VPN 连接时，还需要先核对设备允许的配置及当前连接状态；不要直接删除不认识的系统配置。

连接状态不等于访问验证

顶部显示连接状态变化，只说明客户端的连接流程已进入相应状态，并不证明所有目标都能访问。服务器认证、目标站点、规则匹配和名称解析仍可能分别出错。因此打开开关后，先保留当前设置，不急着新增规则，继续做下一步 Connectivity Test 与实际访问验证。

如果开关打开后立即退回，记下当时的提示文字与发生位置：是在系统授权之前、授权之后，还是已有连接后才断开。这个顺序能帮助区分授权问题与连接参数问题。暂时不要开启 On Demand；先把手动连接验证完成，避免自动连接行为干扰观察。

Step 05 / Settings

按失败位置检查设置

排查从刚才停住的步骤开始，而不是重新做一遍所有设置。先保存现有配置，记下错误提示和复现条件；每次只改一项，改完重复同一个测试。进入 Settings 后，可以核对 Test Method、On Demand 与 Diagnostics 等项目，但这些设置不能替代服务器端的正确参数，也不应把所有开关一起调整。

订阅导入失败或条目没有出现

回到 Add Server 检查 Type 是否为 Subscribe，URL 是否完整，有没有复制进空格、换行或遗漏参数。再确认当前网络能完成订阅内容的获取，并核对服务商给出的资料是否仍然有效。订阅地址与其中服务器的连接地址是不同的对象：更新订阅失败，不等于每一个已保存服务器都不可用；已有条目能连接，也不能证明更新地址一定能访问。

开关退回或连接超时

开关退回先看系统 VPN 授权与当前 VPN 状态；连接超时则先确认设备的基础网络可用，再逐项核对 Type、Host、Port 和认证字段。启用 TLS 或特定传输方式的条目，还应对照原始资料检查相应字段，不能只核对密码。系统日期与时间应准确，避免时间偏差影响证书或认证判断。

在 Settings 检查 Test Method，了解当前测试采用的方法，再比较测试结果。某种测试失败而实际请求成功时，应先分析测试对象与方法，不要只凭一个结果删除资料。需要更多线索时进入 Diagnostics，围绕刚刚复现的操作检查诊断信息；如果只有一个服务器失败，再检查该条目的资料及服务端状态。

已经连接，但访问或分流不符合预期

先回到 Home 核对 Global Routing，避免停在 Direct 却期待请求经过代理。使用 Config 时，检查正在启用的文件、规则先后顺序及 FINAL 的策略，再结合 Data 里的记录定位。仅某个目标失败时，把目标地址与发生时间记录下来；所有目标都失败时，优先回到基础网络与服务器连接层，不要先堆叠域名规则。

如果手动开关行为与预期不一致，检查 On Demand 是否已启用，以及是否存在自动连接条件。首次排查可先回到手动连接方式，确认结果稳定后再按需要设置 On Demand。不要为了排错同时改 Proxy、TCP、UDP 等多个项目；这些项目影响的范围不同，改动越多，越难判断原因。

保留信息，再继续深入

需要向自己已有的服务商核对时，提供协议类型、错误现象、测试时间与已经完成的检查即可。分享截图或诊断内容前，应遮盖订阅链接、密码、认证标识及其他连接凭据。详细协议参数见协议参考；需要重新核对连接流程，可从添加与导入返回，但保留已经确认正确的部分，不必反复重建全部条目。