官方手册 / 首次使用
Shadowrocket 使用教程
订阅导入与连接验证
从哪里开始？先把已有连接信息放进应用，再选择 Global Routing、建立连接，最后用实际访问确认结果。本页只走一遍上手流程，规则细节另见规则手册。
截图如何对照？下文使用 App Store 官方截图说明界面位置；实际选项以设备内显示为准。截图中的服务器内容不是需要照填的参数。
STEP 01 / ADD SERVER
添加服务器或导入订阅
拿到连接信息后点哪里？先进入 Home，找到 Add Server。接下来按手中资料选择一种添加方式：完整订阅链接适合通过 Subscribe 导入；独立的服务器参数则按对应的 Type 手动填写。两种方式的目标都是让服务器出现在 Home 的 SERVER 分组中，不必为同一份资料反复添加。
已有订阅链接：选择 Subscribe
如何放入已有订阅？进入 Add Server 后，打开 Type 选择 Subscribe，在订阅地址输入处粘贴自己的完整链接，再保存并等待内容加载。请从原始资料直接复制，检查开头、末尾是否混入空格、换行或聊天消息的标点。链接里的查询参数通常属于地址的一部分，不能只保留域名，也不要自行删改看起来较长的字符。
保存后应该看到什么？返回 Home，检查订阅对应的服务器是否已出现在列表中。若只看到订阅条目而没有服务器，先检查导入或更新是否报错，再核对地址是否完整、当前网络能否访问订阅源，以及已有服务是否仍有效。订阅能成功加载，只说明已取回列表，不代表列表中的每个服务器都能建立连接，后面仍要进行 Connectivity Test。
已有服务器参数：先选 Type 再填写
手动添加时先填哪个字段？先选择与资料一致的 Type，再按界面填写 Host、Port 和该协议要求的认证信息。官方截图展示了 Password、Method 等字段，但不同 Type 的字段组合并不相同，不能把某一种协议的表单当成所有协议的通用表单。Host 通常填服务器域名或地址，Port 填对应端口；密码、UUID、TLS 与传输参数都应逐项对照已有资料。
有二维码时怎么处理？可使用页面底部的 Scan QR Code 读取自己已有的服务器二维码，导入后仍需检查 Type、Host 与 Port。Import from Cloud JSON 适用于对应格式的资料，不是粘贴任意订阅地址的替代入口。无法判断资料类型时，先核对原始说明，不要通过随意切换 Type 尝试匹配。
怎样确认这一步结束？保存后回到 Home，在 SERVER 中选中准备使用的服务器，确认当前选择指向它。订阅地址和二维码可能包含访问凭据，请勿公开分享。字段含义不清楚时可查阅术语表；有更新失败或内容为空的问题，可继续看疑难解答。列表准备好后，再进入下一步选择流量处理方式。
STEP 02 / GLOBAL ROUTING
选择 Global Routing 姿态
添加完成就能决定所有请求的去向吗？还不能。返回 Home，打开 Global Routing，核对当前使用的是配置(Config)/代理(Proxy)/直连(Direct)中的哪一种。服务器选择决定可用的代理连接对象，Global Routing 则决定整体采用哪种处理方式；两者需要一起检查，不能只看服务器是否被选中。
配置(Config)：按当前配置分流
什么时候选择 Config？需要按规则区分不同请求时使用。它会按照当前启用配置中的规则选择策略，例如 DIRECT、PROXY 或 REJECT。打开 Config 页面，先确认正在使用哪份配置，再查看其内容。官方截图展示了 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段，以及 Add Rule 入口；上手阶段重点核对 Rule，不必为了首次连接同时修改所有分段。
规则怎样影响结果？通常按排列顺序匹配，命中后执行该条指定的策略。下面仅用两个示例说明结构：example.com 及其子域名匹配第一条，其他未命中的请求落入 FINAL。这段示例不是适合所有人的完整配置，也不应直接替换已经能正常使用的规则。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT代理(Proxy)与直连(Direct)：用于明确路径
什么时候使用 Proxy？需要对照代理路径能否完成访问时，可以临时选择 Proxy 再测试。什么时候使用 Direct？需要确认当前网络直接访问的表现时，可切换为 Direct 对照。Direct 不会因为选中了某个服务器就自动改成代理访问；同样，切换到 Proxy 也不能修复错误密码或不可达的服务器。
初次使用应该保留哪一个？已有明确、可信的配置并希望按规则分流时，选择 Config；还在定位连接问题时，记下原来的选择，再临时切换做对照。测试结束后恢复符合用途的姿态。关于规则顺序、策略和 FINAL 的完整说明，请阅读规则手册，本页不展开配置文件的全部结构。确认模式后，回到 Home 准备打开连接。
STEP 03 / CONNECT
打开 Home 顶部连接开关
现在可以连接了吗？先在 Home 做最后一次核对：SERVER 中选中的是预期服务器，Global Routing 显示的是刚才决定的姿态。确认后打开页面顶部连接开关。官方截图中的 Not Connected 表示截图拍摄时尚未连接，不是要求用户寻找或输入的服务器名称；实际操作时应观察自己设备的状态变化。
首次出现系统弹窗怎么办？Shadowrocket 建立连接需要添加 VPN 配置，首次操作可能出现系统授权提示。确认提示对应 Shadowrocket 后，按系统界面允许添加，并完成设备要求的身份验证。这里是设备系统的网络配置授权，不是要求填写订阅密码；不要把服务器密码输入到用途不符的系统输入框中。
授权完成后看哪里？回到 Home，检查连接开关与状态文字是否已经变化。如果刚才取消了授权，可能仍处于未连接状态，需要重新打开开关并按提示完成。若开关随即关闭或反复失败，先记录界面给出的错误信息，不要连续反复触发授权，也不要在尚未明确原因时同时重设多个选项。
出现 VPN 状态就表示访问成功吗？不是。它说明系统中的 VPN 连接状态已经建立，但并不能单独证明远端认证、DNS 解析和目标请求全部成功。即使 Home 显示已连接，也要继续执行下一步的实际访问验证。反过来，某次网页失败也不一定代表授权有问题，可能只是服务器或目标请求的处理路径不符合预期。
iPad 需要另一套步骤吗？本页的顺序同样适用：添加信息、选择 Global Routing、打开开关、验证结果。界面排布可能随设备与应用内显示不同，按相同英文项目定位即可。测试过程中先保持网络环境稳定，避免刚打开开关就切换 Wi-Fi 与蜂窝网络，以免无法分辨失败来自配置还是网络变化。
STEP 04 / VERIFY
用测试与实际访问核对结果
怎样判断是否生效？采用两层检查：先确认服务器的基础连通性，再确认实际请求是否按预期完成。在 Home 使用 Connectivity Test 查看测试结果，然后打开自己需要使用的网页或应用。不要只凭一个测试数字判断全部功能正常，也不要仅凭网页从缓存中显示就断定新请求已经通过目标路径。
先看 Connectivity Test，再看目标请求
测试成功说明什么？它表示在当前测试方式下收到了相应反馈，适合用于初步筛查服务器。测试结果受 Settings 中的 Test Method、当前网络和远端响应影响，不能等同于所有业务请求的访问速度。若测试有结果但页面打不开，应继续核对协议认证、DNS 与规则，而不是直接认定服务器完全正常。
实际验证怎么做？选择一个自己明确需要访问的页面，重新发起请求并观察能否完成加载，再测试另一个常用目标。使用 Config 时，两个目标可能命中不同规则，因此结果不同并不必然是异常。若连接记录可查看，核对目标、命中的规则及最终策略：预期代理访问的请求是否走了 PROXY，预期直接连接的请求是否走了 DIRECT。
用单个变量做模式对照
Config 下失败时怎样继续？保留同一个服务器和同一个测试目标，临时切换为 Proxy 复测。如果 Proxy 可用而 Config 不符合预期，优先检查当前配置选择和规则命中，而不是马上改密码。如果 Direct 可用、Proxy 失败，则先检查代理路径及对应参数。对照只帮助缩小范围，不能仅靠一次结果就确定唯一原因。
这一步完成的标准是什么？连接状态稳定，实际所需页面能正常发起新请求，并且路由姿态符合用途。记住当前可用的服务器、配置和 Global Routing 组合，之后遇到问题可拿它作为对照。暂时不需要按条件自动连接时，先保留手动连接习惯；On Demand 可在基础流程验证通过后另行设置，避免把自动触发行为混进首次测试。
STEP 05 / DIAGNOSTICS
按失败位置逐项排查
没有达到预期时从哪里查？先确定失败发生在导入、测试、连接还是实际访问阶段，再沿着下面的顺序检查。打开 Settings 可以找到 Test Method、On Demand、Diagnostics 等项目。截图用于定位这些设置名称，不表示需要逐项更改；尤其不要为了排错一次改变 DNS、规则、服务器和测试方式，否则难以确认是哪一步起了作用。
导入失败：先核对资料与取回过程
订阅为空或更新失败怎么办？回到订阅编辑处检查地址完整性，确认资料确实是订阅地址而不是说明页面，核对是否仍在有效状态。重新取回内容前保留原有可用条目，避免在原因不明时删除全部记录。手动添加失败则返回 Add Server，检查 Type 与资料是否一致，尤其注意 Port、认证字段、TLS 和传输参数；字段齐全不等于内容正确。
测试失败：区分当前网络与服务器问题
Connectivity Test 没有响应怎么办？先确认设备在断开 Shadowrocket 后能完成普通网络访问，再测试自己已有的另一条服务器信息。如果只有一条失败，重点核对该条参数与远端状态；如果都失败，检查当前网络及测试方法。需要切换 Wi-Fi 与蜂窝网络时，每次切换后重新执行同一项测试，并记录网络条件，不要把不同条件下的结果混在一起比较。
已连接但访问失败：检查模式、DNS 与规则
开关已开却打不开页面怎么办？先回 Home 核对 Global Routing 和服务器选择，按上一节的方法对照 Proxy 与 Config。如果主要表现为域名无法解析，再检查自己是否改过 DNS，优先回看最近一次改动，而不是同时叠加多个解析设置。若只有部分目标失败，检查是否命中 REJECT、是否被更靠前的规则匹配，或是否使用了与预期不同的最终策略。
Diagnostics 应该怎么用？根据当前症状查看应用提供的诊断信息，把错误发生的阶段、目标以及当时的网络条件对应起来。某条错误记录只能说明当时那次请求的情况，不能自动代表之后所有连接。需要保存或向自己的服务方反馈时，先遮盖订阅地址、认证内容和可识别个人的信息，只保留定位所需的错误与相关字段。
反复自动连接：检查 On Demand
手动关闭后为何又连接？先去 Settings 检查 On Demand 是否已经启用，以及触发条件是否符合当前网络。排错阶段可暂时停用自动触发，再用手动开关复现；完成后按原用途恢复。若近期导入或修改过配置，也应记录修改前后的差别，尽量恢复到最近一次已验证可用的组合，再逐项加入变化。
仍然失败时下一步是什么？整理四项信息：失败发生的步骤、当前 Global Routing、Connectivity Test 表现，以及实际目标的错误现象。凭这四项再查疑难解答，比只描述“连不上”更容易找到对应问题。涉及规则优先级与配置结构时转到规则手册；只是不理解某个字段时使用术语表。不要在公开页面粘贴完整订阅或认证资料。
