1. 添加服务器或导入订阅

先判断手中的资料是什么，再选择对应入口。订阅地址通常用于取得并更新一组服务器信息；单个服务器分享链接只描述一项连接；地址、端口、密码等分散字段则需要手动填写。网页地址的外观相似，不代表用途相同，账号管理页面、说明页面与订阅地址不能互相替代。

已有订阅：使用 Subscribe

打开 Shadowrocket，进入 Config 页，找到 Subscribe，在订阅相关操作中填入你已有的订阅地址，并按界面提示确认导入。复制地址时保留完整内容，尤其是问号后面的查询参数；同时检查开头和末尾是否多出空格、换行或中文标点。地址中的访问凭据属于敏感信息，不要发到公开评论区，也不要为了展示问题而公开完整链接。

提交后先观察是否出现错误提示，再返回 Home 查看 SERVER 区块。以列表中实际出现可选服务器为导入完成的依据，不要只凭关闭了输入窗口判断成功。若已有订阅支持更新，后续更新会重新取得远端内容；服务器名称、数量和参数可能随订阅内容变化，手动修改的项目也应留意更新后的结果。

订阅地址与完整配置文件地址并非同一种资料。前者主要用于管理服务器信息，后者可能包含规则、域名映射等设置。若导入后只看到配置条目却没有服务器，先核对资料用途，不要反复往不同入口粘贴同一个地址。

已有服务器字段：使用 Add Server

回到 Home，点击用于添加项目的加号，进入 Add Server。先选择与你已有资料一致的协议类型，再填写服务器地址、端口与身份校验信息。选择协议后，表单字段会相应变化；不能因为两种协议都包含密码或 UUID，就把它们当成同一类配置。

例如，Shadowsocks 需要核对加密方式与密码；VMess、VLESS 需要按资料核对 UUID 及对应字段；Trojan 则要同时关注密码和 TLS 相关设置。传输方式、TLS、服务器名称、路径等附加参数也要逐项一致。资料没有给出的字段不要凭经验补写，更不要将关闭证书校验当作通用解决办法。确认后保存，再返回 SERVER 选择这一项。

已有分享链接或二维码

若资料是一条服务器分享链接，可使用应用提供的剪贴板导入入口；若是二维码，则使用 Scan QR Code 并按系统提示允许相机访问。扫描或识别后仍需检查协议、地址与端口，导入成功只代表应用识别了内容，不代表远端服务已经通过验证。二维码同样可能包含密码与访问凭据，保管方式应与原始链接一致。

这一阶段的检查结果应当是：Home 中已经有明确的服务器项目，并且准备使用的一项处于选中状态。完成后再设置流量如何处理。入口和格式的进一步区别见订阅导入入口说明，字段含义见名词解释。

2. 选择 Global Routing

在 Home 点击 Global Routing。这里决定流量采用哪种处理方式，与上一步“选择哪台服务器”是两个独立操作。列表里选中了服务器，不代表所有连接都会经过它；反过来，选择了代理模式，也不能使错误的服务器参数自动变得有效。

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

配置(Config)适用于已有规则配置的日常使用。应用按照当前配置中的规则判断连接去向，可能采用 PROXY、DIRECT 或 REJECT 等策略。因此，同一次连接会话里，不同域名出现不同处理结果可以是规则的预期行为。选择此模式前，应到 Config 确认当前生效的是哪份配置，而不是只确认某份文件已经存在于列表中。

本页不要求首次操作时编写规则。若当前配置来源和内容尚不明确，先完成服务器可用性验证，再决定是否使用这份配置。规则匹配顺序、兜底策略与具体语法集中在规则与配置参考，不必在第一次连接时同时修改。

代理(Proxy)：先隔离规则因素

代理(Proxy)可用于首次验证或对照排查：通常由应用接管的连接交给代理处理，有助于区分“服务器本身不能连接”和“某条规则改变了去向”。它不是服务器质量测试的替代品，也不保证所有目标都能访问。系统层面的流量例外及应用自身连接行为，仍可能影响实际结果。

直连(Direct)：直接连接目标

直连(Direct)用于直接连接目标，不通过所选代理服务器转发。若正在检查服务器是否生效，却一直保持此模式，就不能用网页打开成功来证明代理链路可用。切换到该模式也不等于关闭 Home 的连接开关；路由选择和系统连接状态应分开理解。

首次设置可先选代理(Proxy)，用同一台服务器完成后面的验证；确认可用后，再切换配置(Config)检查日常规则表现。每次切换后重新发起访问，避免浏览器已有连接影响判断。

3. 打开开关并完成授权

回到 Home，再次核对 SERVER 中选中的项目与 Global Routing 的当前模式，然后打开连接开关。尚未连接时可以看到 Not Connected 等状态文字；操作后应关注状态是否改变，以及是否立即回到断开状态。不要在系统确认窗口尚未处理时连续切换开关。

首次使用时，系统可能提示 Shadowrocket 请求添加 VPN 配置。该提示用于允许应用创建系统网络配置，不是要求重新购买应用，也不会替你填写服务器参数。确认提示由刚刚打开的 Shadowrocket 发起后，按系统要求允许，并完成设备密码或身份验证。请在设备的系统界面中完成验证，不要把设备密码填入服务器表单或网页。

如果之前取消了提示，先返回应用再次尝试连接，按实际出现的提示处理；也可在系统设置中搜索 VPN，查看 Shadowrocket 的配置状态。操作前确认当前设备是否受组织管理，以及是否有相关限制。遇到明确的管理限制时，应依据设备管理要求处理，不要不断删除不认识的系统配置。

授权完成后回到 Home，检查连接状态。系统显示 VPN 已建立，表示本地网络接管已经启动，并不证明远端服务器、DNS 和目标网站全部正常。下一步仍需做实际访问验证。如果开关刚打开就关闭，优先记录系统提示与应用错误信息，而不是立即重装。

首次验证期间先保持 On Demand 的原有设置，避免把自动连接条件与手动开关混在一起排查。若关闭开关后又自动建立连接，应检查 On Demand 是否启用及其触发条件。稳定完成手动连接后，再按自己的使用需求设置自动连接行为。

4. 验证连接是否实际生效

验证分为三个层次：服务器是否能通过测试、系统连接是否保持、目标请求是否按预期完成。这三项互有关联，但不能互相替代。把每层结果分开记录，后面定位故障会比笼统描述“连不上”更有效。

先看 Connectivity Test

在 Home 使用 Connectivity Test，观察当前服务器的测试结果。测试方式和测试目标会影响结果，因此某次成功不代表所有网站都正常，某次超时也不能单独证明全部连接都不可用。若列表中有多个已有服务器，注意测试结果对应的是哪一项，实际选中的又是哪一项。

不要仅按测试数字作结论。测试请求的路径、目标和真实业务请求可能不同；持续失败时才进一步核对参数、当前网络与远端状态。也不要为改善一次测试结果而同时改变 DNS、TLS、协议和路由模式，这会使后续比较失去依据。

再发起一次新的实际请求

保持连接开启，切到浏览器，重新访问你平时使用且已知可正常响应的 HTTPS 页面。刷新旧标签页时可能读到缓存，建议重新发起请求，并检查页面中的实际内容是否载入。选择少量不同目标交叉验证即可，不要用单一网站的失败来判断整个连接。

如果浏览器可访问而某个应用异常，先考虑该应用是否保留旧连接，或自身存在登录、权限、服务状态等问题。尝试重新打开相关应用，再对照测试。不要在未核实前把账号错误、目标维护或网页自身报错归因于 Shadowrocket。

最后检查规则处理结果

完成代理(Proxy)验证后，切换配置(Config)，重新访问同一目标。需要进一步核对时，可在 Data 中查看可用的连接信息，结合目标域名、匹配规则与策略判断去向；只看到流量增加，不能单独证明请求经过了所选服务器。若当前记录不足以判断，就保留“尚未确认”的结论，不要把猜测当作验证结果。

当代理(Proxy)正常而配置(Config)异常时，排查重点已经从服务器参数转向当前配置、规则及 DNS。此时保留能正常工作的服务器设置，转到规则参考检查具体匹配，避免从头重做所有步骤。

5. 按失败阶段逐项检查

先找到流程停在哪一步：没有导入内容、已有服务器但测试失败、系统授权失败，还是连接保持但目标打不开。每次只修改一个变量，测试后记录结果；确认没有改善时恢复原值，再检查下一项。这样能够保留已验证的设置，也方便继续阅读对应的问题说明。

导入后没有出现服务器

重新检查输入的是订阅地址、单项分享链接还是配置文件地址，确认入口与资料类型一致。检查链接是否被聊天软件截断，查询参数是否完整，访问凭据是否仍有效。如果更新返回的是登录页面或错误说明，即使地址本身可以打开，也不等于返回了应用能够识别的订阅内容。

再检查当前网络是否能够取得订阅内容，以及已有订阅是否需要在原管理页面更新状态。优先核对返回错误，不要连续重复添加同一条地址，以免留下多个难以分辨的项目。对外说明问题时只保留错误类型，隐藏完整订阅地址与身份校验字段。

服务器存在，但测试持续失败

从地址、端口与协议类型开始核对，再看密码、UUID、加密方式等身份校验字段，最后检查 TLS、服务器名称和传输相关参数。尤其注意数字端口是否输错、密码是否带入空格、路径是否遗漏。字段必须与你已有的服务器信息一致，不能只核对名称。

也可在另一种自己可用的网络环境下重复同一测试，判断是否与当前 Wi-Fi 或蜂窝网络有关。切换网络前留意设备的数据使用设置。若同一项目在不同网络中都失败，保留测试结果并向原有服务方核实服务器状态与参数，不要依赖反复切换模式解决身份校验错误。

连接已开启，但页面打不开

先确认没有停留在直连(Direct)，再用代理(Proxy)与配置(Config)对照同一目标。如果仅配置(Config)失败，检查当前生效配置是否包含意外的 REJECT、不适用的 DIRECT 或错误的兜底策略。若两种模式均失败，则继续检查服务器、DNS 与目标自身状态，不要只围绕规则修改。

遇到证书错误时，先核对设备时间、服务器名称及 TLS 参数，不把跳过证书校验作为默认操作。只有部分域名失败时，记录具体域名和发生时间，再查看相关连接信息；不必清空全部配置。DNS 变化可能影响域名解析结果，但应基于错误证据调整，而不是盲目叠加多个设置。

为下一次排查保留有效信息

建议记录四项：失败发生在哪一步、当时的 Global Routing 模式、应用显示的错误原文、切换网络或模式后的变化。记录中不要包含密码、UUID、完整订阅链接或含凭据的二维码。请求进一步帮助前，先确认自己能够描述“哪里成功、哪里失败”，而不只是描述开关颜色。

完成首次连接后，日常使用主要是维护已有订阅、确认当前服务器与配置、观察异常变化。关于连接和导入的更多情形，继续阅读常见问题；需要理解 On Demand、FINAL 等术语时，查看名词解释。系统化配置细节留在规则参考中处理，本页的完成标准是已有服务器可以连接、实际请求能够验证，并且知道出现问题时从哪一步开始检查。

Shadowrocket 使用说明