Shadowrocket 快速上手
按五个步骤完成已有信息导入、Global Routing 选择与连接检查。首次操作可按约十分钟安排；实际耗时取决于资料是否齐全和当前网络状态。
建议按顺序完成，不要同时修改服务器、规则与 DNS。每一步先确认结果，再进入下一步；遇到异常时，记录停在哪个界面和具体错误文字。
Add Server：添加服务器或导入订阅
打开 Shadowrocket，进入 Home。先分清手里的资料是什么：如果是一条用于更新服务器列表的网址，使用 Subscribe；如果是单台服务器的地址、端口、协议及认证信息，使用手动添加。两种方式任选与你的资料相符的一种即可，不需要为了完成教程各添加一次。订阅地址可能包含访问凭据，应当像密码一样保管，不要贴到公开页面或随意转发。
已有订阅链接时
在 Home 点击右上角添加按钮，进入 Add Server。点击 Type，选择 Subscribe，再将完整的订阅链接填写到 URL，确认后保存。粘贴时检查开头与结尾，尤其留意复制过程中带入的空格、换行和文字说明；不要删除地址中问号后面的参数，也不要把服务账户的登录页面当成订阅地址。
返回 Home 后，等待订阅内容载入。正常情况下，列表中会出现相应分组及服务器条目。若只看到订阅名称，却没有可选择的服务器，先确认当前设备能访问订阅地址，再检查订阅是否仍有效、返回内容是否适用于客户端。此时先解决导入问题，不要提前调整 Global Routing，因为模式切换不会修复一个无法读取的订阅地址。
已有单台服务器信息时
同样从 Home 打开 Add Server，在 Type 中选择资料上标明的协议，例如 Shadowsocks、VMess、VLESS 或 Trojan，再逐项填写地址、端口及认证字段。不同协议需要的字段不相同，密码、UUID、加密方式和 TLS 设置不能互相代替。不要根据名称相似来猜协议，也不要把带协议前缀的整条分享信息直接填进服务器地址栏。
如果资料附有二维码，可在应用提供的 Scan QR Code 入口读取，并按系统提示允许相机访问。读取后仍要检查识别出的协议与地址是否对应原资料，再保存。手动填写时，TLS 的服务器名称等字段可能与连接地址不同，应以原资料为准，不要为了让它们看起来一致而自行修改。
本步完成标志：Home 中已经出现可选择的服务器，并选中了接下来要测试的一项。列表名称只是备注，不能证明服务器当前可用。保留原始资料，后面若连接失败，便能逐项比对。字段含义不清楚时先查概念速查；协议的设计与参数解释见协议手册。
Global Routing：区分三种处理姿态
服务器保存后，先不要急着打开连接。在 Home 点击 Global Routing，确认准备使用的处理方式。这里的三种姿态是配置(Config)/代理(Proxy)/直连(Direct)。它们决定连接如何被处理，不负责修正服务器参数，也不代表服务器本身的协议类型。切换模式之前，先记住当前选中的值，便于测试后恢复。
| 模式 | 处理方式 | 首次操作时检查 |
|---|---|---|
| 配置(Config) | 按当前配置中的规则决定策略。 | Config 中是否已选中自己的配置。 |
| 代理(Proxy) | 以代理方式处理流量，适合临时检查代理路径。 | Home 中选择的服务器是否正确。 |
| 直连(Direct) | 直接访问目标，不以当前服务器承担代理转发。 | 不要将直连访问成功误认为代理验证成功。 |
准备按规则使用时，先进入 Config，确认当前选中了自己的配置文件，再回到 Global Routing 选择配置(Config)。服务器订阅与配置文件不是同一件事：前者主要提供服务器列表，后者决定域名、地址等条件应当匹配什么策略。导入订阅后，不应直接假定规则配置也已经设置完毕。
如果目前只有服务器信息，还没有准备规则配置，可以先用代理(Proxy)做一次短暂的连通性检查。这样能先观察服务器路径是否工作，避免把连接问题和规则问题混在一起。测试完成后，再根据自己的配置安排切回配置(Config)；本教程不替你决定哪些网站应当使用什么线路。
直连(Direct)可以作为基础网络的对照，但它不是代理连接成功的证据。某个网页在直连状态能打开，只能说明该网页在当前直接访问路径上可用。接下来验证时，应把“模式是什么”“选中哪个服务器”和“访问哪个页面”一起记录，而不是仅记录能否打开。
本步完成标志：已经知道当前选的是哪一种姿态；如果使用配置(Config)，也已确认 Config 中的活动配置。规则顺序、PROXY / DIRECT / REJECT 与 FINAL 的详细含义可查概念速查，无需在首次连接时一次改完所有设置。
Home：连接开关与系统授权
回到 Home，再核对一次当前选中的服务器与 Global Routing。确认资料与模式后，打开 Home 顶部的连接开关。首次建立连接时，iPhone / iPad 可能出现添加 VPN 配置的系统提示。确认提示来自刚刚进行的操作后，选择允许，并按系统要求完成设备密码或生物识别验证。
这里的系统授权用于让应用建立设备上的 VPN 配置，不是订阅账户登录，也不是服务器认证。设备密码应在系统提供的验证界面中输入，不要把它填写到 Add Server 的 Password 字段。反过来，服务器密码也不用于解锁设备；遇到输入框时先看清它属于系统提示还是应用内的服务器表单。
授权完成后返回 Shadowrocket，观察开关是否保持开启。如果系统状态区域显示 VPN 标记，可以把它作为连接状态的一项参考，但不要据此认定目标网页一定能够访问。系统配置已建立、服务器能否到达和规则是否符合预期，是三个不同层次，下一步还需要做实际访问检查。
如果刚打开就立即关闭，先停止反复点击，查看是否有授权未完成或明确的错误提示。再检查 Home 中是否真的选中了服务器，以及此前填写的端口、密码等字段是否完整。设备上若还有其他 VPN 连接处于活动状态，先结束其他连接，再重新尝试，避免同时操作导致无法判断当前由哪一项接管网络。
首次手动验证期间，先保持 On Demand 设置不变。On Demand 用于按条件触发连接，并不是每次手动连接都必须开启的前置条件。如果开关关闭后又自动连接，才进一步检查已有的按需连接条件；不要为了排查一个问题，同时改动多个自动化设置。
本步完成标志：系统授权已结束，Home 的连接开关保持开启，且没有尚待处理的提示。若需要编辑当前服务器，先关闭连接，保存修改后再开启。这样可以明确每轮测试使用的是哪一套参数，也便于在失败时恢复上一步的状态。
Connectivity Test：测试与实际访问交叉确认
连接开启后，先使用 Connectivity Test 检查当前服务器，再进行实际访问。测试结果是一次特定探测的结果，受测试方式、目标和网络状态影响；出现响应不代表所有网页与应用都能正常工作，显示超时也需要结合真实访问判断。不要只根据一个数值决定是否完成配置。
- 确认基础网络。如果当前完全无法访问，先关闭 Shadowrocket 连接，用浏览器打开一个自己已知正常的普通网页。基础网络也失败时，先检查 Wi-Fi 或蜂窝网络，不要继续在客户端里更换协议字段。
- 检查服务器路径。重新开启连接，确认服务器选择没有改变，再执行 Connectivity Test。将是否有响应与测试时的网络环境记下来，随后打开同一网页，观察是否能加载新的内容，而不只是显示之前缓存的页面。
- 检查配置效果。使用配置(Config)时，根据自己配置中的已知规则，分别检查一个预期走 PROXY 和一个预期走 DIRECT 的目标。仅仅两者都能打开，还不足以证明命中了预期策略；必要时结合应用内可用的连接记录核对。
如果代理(Proxy)下可以访问，而配置(Config)下不符合预期，优先检查活动配置和规则，而不是立即删除服务器。相反，如果两种模式下同一服务器都无法完成访问，应先检查连接路径与服务器参数。通过模式对照可以缩小范围，但对照测试期间不要同时换服务器和网络，否则结果很难解释。
Wi-Fi 下正常而蜂窝网络下异常，也属于有价值的线索。切换网络后，在新的环境中重新连接并复测，不要把旧的 Connectivity Test 结果直接用于判断新网络。某些协议依赖的传输条件在不同网络中可能不同，具体问题应结合已有服务器资料核对，不能凭一次失败就认定客户端配置全部失效。
本步完成标志：至少完成一次真实网页访问，并且能够说明测试所用服务器、Global Routing 模式和网络环境。确认正常后保留这组可用设置；后续再修改规则或 DNS 时，以这组设置作为对照。仅有连接开关开启，却没有做访问验证，不算完成本步。
按导入、连接、规则三个环节排查
遇到失败时，回到最早没有完成的步骤。不要一开始就重装应用：重装不能修复过期订阅、错误的服务器密码或不匹配的规则，还可能让已有配置难以找回。先记录错误文字和最近改动，再按下面的顺序检查。每次只调整一项，保存后使用相同目标复测。
导入后没有服务器条目
先核对 Subscribe 中保存的是完整订阅地址，而不是账户首页、说明页面或单台服务器的备注。检查链接是否被截断、是否包含多余字符，订阅是否有效。返回内容若是登录提示或网页，不能当作服务器列表使用。资料本身有疑问时，向你已有服务的提供方确认正确地址及适用格式，不要将完整链接发到公开讨论区。
条目存在，但测试或连接失败
对照原始资料检查 Type、服务器地址、端口与认证字段，再检查 TLS 相关参数是否被意外改动。设备日期和时间也应准确，时间偏差可能影响证书验证。不要为了消除报错随意关闭证书验证；应先核对服务器名称与证书要求。若保留了另一项自己已有且确认可用的服务器，可以在同一网络中对照测试，但不必为测试反复导入陌生资料。
测试有响应，网页却无法打开
先确定只是某个页面异常，还是多个已知正常目标都异常。单个目标失败可能与目标服务、解析或匹配策略有关，不足以说明所有连接都失败。检查 Global Routing 是否误留在直连(Direct)，或者 Config 中选中了另一份配置。若只有域名访问异常，再查看 DNS 设置，避免把多组不理解的设置叠加到一起。
只有配置(Config)下的结果异常
确认活动配置后，检查规则由上到下的匹配顺序，以及兜底规则 FINAL 的策略。更靠前的宽泛规则可能先匹配请求，使后面的精确规则没有机会生效。订阅更新成功也不意味着配置规则同步变化。先恢复自己已知可用的配置进行对照，再逐条调整；具体规则关键字见概念速查，协议与传输字段问题见协议手册。
排查完成后，把临时使用的代理(Proxy)切回自己计划使用的姿态，并重新执行一次验证。若仍需进一步定位，保留设备系统、网络类型、协议类型、出错步骤和去除敏感内容后的错误描述；不要公开密码、完整订阅链接或含认证内容的二维码。这样既能保留诊断线索，也不会把连接凭据混入问题说明。
完成首次连接后，日常使用可以保留三个检查点：Home 选中了什么、Global Routing 使用什么姿态、当前 Config 是哪一份。后续更新已有订阅或调整配置后，再按本页第四步复测即可。