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

打开 Shadowrocket 后，先停留在 Home，暂时不要打开连接开关。确认手中信息属于哪一种：订阅链接通常用于取得并更新一组服务器；单个分享链接只描述一个服务器；手动填写则需要完整的协议与连接参数。这三种资料的用途不同，不宜把单个服务器链接当作 Subscribe 地址使用，也不要把配置文件地址直接填进服务器地址栏。

已有订阅链接：选择 Subscribe

在 Home 点右上角的添加按钮，进入 Add Server。打开 Type，选择 Subscribe，再将自己的完整订阅链接粘贴到 URL。Remarks 可填写便于辨认的名称，例如“日常配置”，不要把访问凭据写进备注。检查链接前后是否多了空格或换行，再点 Done 保存。返回 Home 后等待订阅读取；若列表尚未出现服务器，可在对应订阅的操作菜单中执行更新。

读取成功后，Home 应出现订阅分组及其中的服务器条目。先确认有可选择的具体服务器，再进入下一步。只有订阅名称而没有服务器，并不等于导入完成：可能是请求尚未结束、返回内容为空，或订阅内容不能被识别。此时先检查更新结果，不要反复创建同名订阅，以免后续分不清正在使用哪一份。

订阅更新会重新取得远端内容。若需要保留手动调整，先记录修改项，再确认下一次更新是否会覆盖它们。订阅地址可能包含访问凭据，应只粘贴到客户端需要的位置；向他人描述故障时，不要直接发送完整地址或包含地址的画面。

已有单个服务器：按协议填写

如果拿到的是服务器地址、端口和认证信息，同样从 Add Server 开始，在 Type 选择资料指定的协议，再逐项填写。Shadowsocks、VMess、VLESS、Trojan 等协议的字段并不相同；密码、用户标识、加密方式与传输参数都应按原始资料填写。Address 应是服务器域名或 IP，不是订阅页面，也不是浏览器里打开的说明页面。

涉及 TLS 或特定传输方式时，还要核对服务器资料中的相关选项，不能只填地址与端口就结束。若资料提供的是二维码，可使用 Scan QR Code 读取，再核对识别出的 Type 与 Address。无论采用哪种方式，保存后都回到 Home，点选一个具体服务器；关于字段与分享链接的区别，可先查术语表，不必在首次连接时修改尚不理解的参数。

完成这一节的判断标准是：Home 中有明确的服务器条目，能够选中，且连接资料来源清楚。到这里还没有验证服务器可用，下一步先确定流量应按哪种方式处理。

02 · Global Routing：选择配置、代理或直连

在 Home 点 Global Routing，按当前目的选择配置(Config)/代理(Proxy)/直连(Direct)。三种姿态改变的是流量处理方式，不会补齐缺失的服务器参数，也不会把无法连接的服务器变成可用服务器。首次设置时应记住当前选项，以便验证时进行有条件的对照。

配置(Config)：按当前配置中的规则处理

如果已经有自己确认过的规则配置，通常从配置(Config)开始。在 Config 中查看当前启用的配置，确认它是准备使用的那一份。导入服务器与启用规则配置是两个动作：Home 里出现服务器，并不表示 Config 中已经切换到某份规则文件。规则决定目标请求采用 PROXY、DIRECT 或 REJECT 等策略，实际结果还取决于规则顺序与策略设置。

首次使用不必立即编辑整份规则。先保留已知配置，完成一次连接和访问测试。如果之后需要调整某个域名的处理方式，再备份配置并逐项修改。DOMAIN-SUFFIX、IP-CIDR、GEOIP 等关键字的含义见规则术语说明；规则命中异常的系统化检查见排查手册。

代理(Proxy)：对照所选服务器的连接路径

当目标是确认所选服务器能否正常处理请求时，可临时切到代理(Proxy)，减少普通分流规则对测试结论的干扰。保持服务器、网络和测试页面不变，只改变 Global Routing。如果 Proxy 下可访问，而 Config 下同一页面失败，应优先检查配置规则与策略指向，而不是马上重新导入订阅。测试结束后恢复原先需要的姿态。

直连(Direct)：检查当前网络的直接连接

直连(Direct)用于按当前网络直接建立连接，不能用它证明所选代理服务器可用。若要判断基础网络是否已经断开，更清楚的方法是先关闭 Shadowrocket 连接，再打开一个熟悉的页面；确认 Wi-Fi 或蜂窝网络能正常工作后，回到 Home 继续。路由姿态确定后，就可以进行首次连接授权。

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

回到 Home，再次确认已选中准备使用的服务器，同时检查 Global Routing 与上一节的选择一致。随后打开顶部连接开关。首次建立连接时，系统可能提示允许添加 VPN 配置；这是建立系统网络连接所需的授权。阅读提示后允许，并按设备要求完成密码或生物识别验证，再返回 Shadowrocket。

授权完成后，观察 Home 中的连接开关是否保持打开，以及系统是否显示相应连接状态。不要在授权尚未结束时连续反复点击开关；重复操作可能使连接与断开请求交错，也不利于辨认刚才哪一步失败。若点击后立即回到关闭状态，先看是否取消了系统提示，再检查是否存在设备管理限制。

如果设备同时启用了其他会接管网络连接的工具，先暂停它们，再单独测试 Shadowrocket，以减少连接配置争用。受管理的工作或学校设备可能限制 VPN 配置变更，这类限制需要按设备管理要求处理，不应通过反复删除设置来尝试绕过。

首次测试期间，先保持 On Demand 关闭，避免自动连接条件与手动操作同时影响结果。待手动连接、访问验证都正常之后，再考虑按网络条件启用 On Demand。它解决的是何时发起连接，不负责修复订阅内容、服务器参数或规则错误。

开关保持打开，只说明连接流程已进入相应状态，不代表每个目标页面都能访问。不要在这里结束检查；接下来需要把服务器测试、浏览器访问和路由结果结合起来看。

04 · Connectivity Test：验证连接与实际访问

先在 Home 使用 Connectivity Test 检查已有服务器的可达性，再选择其中一个进行访问测试。测试结果适合帮助判断某次请求是否得到响应，但延迟数字并不等于下载速度，也不保证所有应用和页面都能正常使用。不要只凭一个较小的数字就判定整套设置已经完成。

用同一网络、同一页面重复验证

保持当前 Wi-Fi 或蜂窝网络不变，打开浏览器，访问一个你熟悉且能够判断加载结果的页面。先看页面主体是否出现，再观察图片或其他资源是否加载。若只是部分内容失败，记录失败的具体范围；它与整个页面都无法打开的排查方向不同。旧页面可能直接显示缓存内容，验证时应重新加载，而不是只观察已经打开的标签页。

随后回到客户端查看连接记录，核对请求目标及对应策略。使用配置(Config)时，应关注目标请求是否按预期采用 PROXY 或 DIRECT，是否被 REJECT，以及策略是否指向当前可用的服务器。系统连接标识与浏览器中某一个页面的成功，都不能单独证明所有规则正确。

只改变一个条件，比较差异

若服务器测试有响应，但实际页面失败，可保持服务器不变，临时将 Global Routing 从 Config 切为 Proxy，再重复相同访问。若结果随姿态变化，优先检查规则与当前 Config；若两个姿态都失败，再核对服务器参数、网络条件及 DNS。每次只改变一项，才有办法把变化与结果对应起来。

验证结束后，恢复计划长期使用的姿态，并重新测试一次。建议简单记录“网络类型、所选服务器、Global Routing、失败页面、出现的错误”，不要记录或公开认证信息。这样的记录比“开关开了但不能用”更有利于下一步定位，也方便稍后判断修改是否真正有效。

05 · 常见失败点：从失败位置开始检查

出现异常时，先关闭连接，确认设备本身能接入网络；再沿着导入、授权、服务器连接、规则处理的顺序检查。不要一次删除全部服务器、替换 Config 并修改 DNS，否则即使暂时恢复，也无法知道是哪一项造成问题。下面只保留首次使用最常见的检查路径，详细分支可进入Shadowrocket 故障排查手册。

Subscribe 保存后没有服务器

回到订阅条目，核对 URL 是否完整，是否多复制了说明文字、空格或换行；确认拿到的是订阅地址，而不是账户页面或单个服务器分享链接。基础网络正常时再更新一次，并查看具体错误。若地址已失效、访问凭据变更或返回内容异常，需要向自己的服务商核实，不要凭猜测修改链接中的字符。

开关打不开，或打开后立即关闭

先确认首次系统授权已经允许，且设备验证完成。随后检查是否有其他网络连接工具占用、是否受设备管理策略限制，并记下客户端显示的提示。若近期才修改过系统网络设置，先恢复到能够解释的状态再测试。删除系统连接配置会触发重新授权，应在确认原因后进行，而不是把它当作每次故障的第一步。

Connectivity Test 超时

先对当前服务器重试一次，再从自己已有的列表中选择另一条进行对照。只有一个服务器持续失败时，优先核对它的地址、端口、认证及协议参数；多个服务器都失败时，再比较 Wi-Fi 与蜂窝网络，并检查基础网络。切换网络时保留其他条件不变。不要通过关闭 TLS 验证来代替参数核对，也不要把超时直接解释为应用安装失败。

Proxy 可用，Config 下部分页面失败

返回 Config 确认当前启用文件，检查失败目标的命中规则及策略。规则修改前先备份，修改后保存并重新加载同一页面。若某个策略需要选择服务器，确认它没有仍然指向已经失效的条目。规则按配置逻辑处理目标，只有检查实际命中结果，才能区分是路由选择错误还是服务器本身不可用。

连接正常，但出现域名解析错误

先确认设备日期与时间正常，再查看失败是否集中在域名解析阶段。记录当前 DNS 设置后一次只调整一项，不要同时更换解析方式和规则文件。直接用 IP 打开网站未必是有效对照，因为 HTTPS 还涉及域名与证书匹配。若错误持续，带着具体错误提示进入排查手册的 DNS 相关章节，而不是不断换填不明来源的地址。

iPad 上没有找到相同位置

iPad 在不同方向与窗口宽度下可能采用分栏布局，Home、Config 等入口的相对位置会变化，但操作对象仍以界面词为准。先找到同名页面，再执行对应步骤。浏览器记录、系统授权和设备网络设置应在当前 iPad 上重新验证，不能把另一台设备的成功结果直接当作本机已经配置完成。

Shadowrocket 使用教程订阅导入与首次连接