官方手册 · 首次使用
Shadowrocket 使用教程
已有订阅导入 → Global Routing → 连接授权 → 实际验证
按五个步骤完成一次基础连接，再根据验证结果调整配置。建议先保留默认设置，只改当前步骤需要的项目，避免同时修改多个选项后难以定位原因。
- 订阅或单服务器信息，准备其一
- 连接前确认本地网络可用
- 每次只改一项，再重新验证
步骤 01 · 导入连接资料
Add Server 添加与订阅导入
订阅链接和单个服务器参数是两种资料形式。先确认手中是哪一种，再选择对应入口，不需要两种方式都做。
使用已有订阅链接
打开 Shadowrocket，进入 Home，点 Add Server；部分界面也可通过顶部添加按钮进入。在 Add Server 中点 Type，选择 Subscribe，再把已有订阅链接完整粘贴到对应的 URL 字段。链接请从你的服务商处获取，不要把服务商网站的登录页、订单页或说明页地址当成订阅地址。
粘贴后检查开头和结尾，尤其留意复制时带入的空格、换行、引号和省略号。订阅地址中问号之后的内容可能用于认证，不能凭外观自行删减。填写便于辨认的备注并保存，等待客户端读取订阅。随后返回 Home，确认列表中出现服务器条目，再点选其中一个作为本次测试对象。
首次导入完成后，先不要连续重复添加同一个链接。若列表没有变化，应先查看是否出现读取失败提示；若已经出现条目，只需选择服务器并继续下一步。订阅刷新是重新获取服务器资料，不等于已经建立代理连接，也不等于配置文件里的规则已经启用。
使用单个服务器信息
如果拿到的是地址、端口、认证信息与协议参数，在 Add Server 的 Type 中选择资料注明的协议，再逐项填写。Host 填服务器域名或 IP 地址，Port 填连接端口。所选协议需要 Password、Method 或其他认证字段时，按原资料填写；不同协议出现的字段不同，不要把一种协议的参数硬套到另一种协议。
截图中的 Password 与 Method 是该页面所示类型的字段示例，不代表每一种类型都需要它们。资料还给出 TLS、SNI、传输方式或路径时，应一并核对，不能仅凭地址和端口尝试猜测。缺少参数时，向你的服务商确认完整信息，比反复更改客户端选项更容易定位问题。
如果资料是二维码，可使用 Scan QR Code 读取，并按系统提示授予所需权限；Import from Cloud JSON 则用于相应的 JSON 资料，不是普通订阅链接的通用替代入口。无论采用哪种导入方式，保存前都应检查识别出来的类型、地址和端口。完成后返回 Home，确认 SERVER 列表中已有目标条目，再进入模式选择。
步骤 02 · 确定请求处理方式
Global Routing 三种姿态
选择模式之前，先分清“用哪个服务器”和“哪些请求使用代理”。前者由服务器选择决定，后者由模式及配置决定。
在 Home 点 Global Routing，查看当前选中的姿态。这里按配置(Config)／代理(Proxy)／直连(Direct)理解：它们控制请求的处理方式，并不是三组不同的服务器。切换姿态后返回 Home，再次确认显示的选项，避免以为已经修改，实际上仍停留在原来的设置。
配置(Config)：按当前规则处理
日常需要规则分流时使用 Config。客户端根据当前启用配置中的规则，将不同请求交给对应策略。因此，选择 Config 之前，要进入 Config 页面确认要使用的配置文件已经启用。仅有服务器列表不代表已经有适合自己的规则文件；订阅与配置的职责不同，导入订阅也不必然替换当前规则。
官方截图展示的是配置文件编辑页，可看到 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 等分段。初次连接不需要逐段修改，更不需要为了普通连接开启额外的解密功能。如果打开 Rule 或使用 Add Rule，应先了解规则条件与顺序，避免一条宽泛规则覆盖后面的精确规则。
例如 DOMAIN-SUFFIX,example.com,PROXY 表示按域名后缀匹配并交给指定策略；它只是语法说明，不是需要照抄的完整配置。看到请求走 DIRECT，不一定是连接失败，也可能正是当前规则的结果。规则类型、策略引用与匹配顺序的进一步说明见代理模式与规则说明。
代理(Proxy)与直连(Direct)：用于对照
Proxy 可用于检查所选服务器的代理连接，减少规则分流对本次测试的影响；它仍不能替代真实访问验证，也不表示设备上所有类型的流量都能被一概处理。Direct 用于直连对照，帮助判断本地网络本来是否可用，不应把它当成代理已生效的证据。
如果暂时不确定配置是否正确，可先选择 Proxy 做基础连接测试，确认服务器可用后再切回 Config。每次切换都记录当前选择，并使用相同的访问目标比较结果。接下来保留本次要测试的姿态，返回 Home 打开连接开关。
步骤 03 · 建立连接
Home 开关与首次授权
导入完成和连接建立是两个阶段。先选服务器，再确认 Global Routing，最后才打开顶部开关。
返回 Home，在 SERVER 分组中点选本次要使用的服务器。若列表里有多个条目，不要只看订阅分组名称，要确认实际选中了一个服务器。随后检查 Global Routing 是否仍为上一步确定的选项，再点顶部处于 Not Connected 状态的连接开关。
首次建立连接时，系统会请求允许添加 VPN 配置。确认操作来自正在使用的 Shadowrocket 后，按系统提示允许，并完成设备密码或其他身份验证。授权属于系统流程，不是在应用内新增一条服务器，也不要求重新粘贴订阅。完成后返回 Shadowrocket，观察连接状态是否保持，而不是立刻连续开关多次。
如果首次提示被取消，可以回到应用重新打开开关，按出现的提示完成授权。如果设备由学校或单位管理，系统策略可能限制 VPN 配置，应先确认设备允许使用此类连接；不要反复删除不认识的设备管理项目。已经存在其他 VPN 连接时，先断开当前其他连接再测试，以免系统切换连接时造成判断混乱。
开关保持开启，说明客户端连接流程已经启动或建立，但这还不能证明目标网站一定可达。服务器失效、认证参数错误、DNS 解析异常或配置策略不符合预期，都可能表现为“开关开着，页面却打不开”。因此完成授权后，下一步必须做实际访问验证。
首次测试先保持当前 Wi-Fi 或蜂窝网络不变，暂时不要同时更换网络、服务器和模式。需要测试另一个服务器时，先记录原来的结果，再切换并重复同一组检查。这样才能知道变化来自哪一项，而不是只得到“有时能用”的模糊结论。
步骤 04 · 核对实际请求
Connectivity Test 与访问验证
验证要同时看连接测试、实际页面与规则结果，不能只凭一个数值或顶部状态下结论。
先测试，再访问同一个目标
在 Home 执行 Connectivity Test，观察当前服务器是否能完成所选测试。测试结果反映的是相应测试方式下的响应，不等于网页下载速度，也不保证所有网站或应用都能正常访问。出现超时时，先记录测试方式与当前网络，不要立即把所有服务器都判断为失效。
随后打开浏览器，访问一个已知可用的 HTTPS 页面，检查是否能完成加载，而不是只看是否出现标题或缓存内容。可重新加载页面，或使用新的浏览器标签页减少旧缓存造成的干扰。若只有某个应用异常，先用浏览器访问同类目标作对照，不要直接重置全部配置。
Config 下再确认规则去向
使用 Config 时，进入 Data 查看可用的请求记录，结合目标域名、命中规则与策略信息核对结果；不同版本的展示位置可能略有区别，以当前界面为准。预期直连的请求走 DIRECT 是正常情况；预期代理的请求却命中直连策略，才需要检查当前配置是否启用、规则是否被更早的条目覆盖。
如果切到 Proxy 后同一目标可以访问，而 Config 下失败，应优先检查配置与规则，不必重新导入已经可用的服务器。反过来，如果两种姿态均失败，就先检查服务器参数、本地网络及服务端状态。比较时保持服务器与网络相同，一次只切换模式，结果才有参考价值。
完成一轮验证后，把日常需要的姿态恢复为 Config，再访问一次目标确认结果。只记录“网络类型、服务器备注、模式、现象”即可，不要为了记录问题而公开完整订阅链接、认证字段或包含这些内容的截图。若结果不符合预期，继续按下面的现象分支检查。
步骤 05 · 保留有效设置再排错
常见失败点检查顺序
先判断失败发生在导入、授权、服务器连接还是规则处理阶段，再处理对应的一层。
订阅保存后没有服务器
回到该订阅条目，检查 Type 是否为 Subscribe，链接是否完整，以及当前网络能否访问订阅服务。普通网页链接不能当成订阅读取，认证参数缺失也可能导致返回内容不正确。不要把完整链接粘贴到公共交流页面；需要确认有效性时，从你的服务商处核实链接状态与返回格式。
若以前可以更新、现在突然失败，先在相同网络重试一次，再使用另一种可用网络对照。保留原条目有助于比较，不建议在原因未明时反复删除和重建。导入成功后仍需选择服务器并打开连接，刷新动作本身不会完成后续步骤。
开关打不开或打开后回落
先确认系统授权是否完成，再检查设备是否存在连接限制或正在使用其他 VPN。出现明确系统提示时，记录提示原文比反复点开关更有用。不要在尚未完成首次授权时修改 DNS 或规则，因为这些改动通常不能解决授权阶段的问题。
开关开启但测试超时
按顺序核对服务器类型、地址、端口和认证字段，再检查 TLS 或传输参数。使用同一网络测试另一个已有服务器，可以帮助区分单个服务器问题与本地网络问题。若切换网络后结果不同，应进一步检查网络环境；若同一服务器在不同网络均失败，再向你的服务商确认服务器状态。
Settings 中只检查相关项目
进入 Settings，查看 Test Method，理解当前 Connectivity Test 使用的测试方式；某种测试超时而实际网页能打开，不能仅凭测试结果判定连接不可用。Diagnostics 可用于进一步查看诊断信息，分享记录前应遮盖服务器地址、认证信息和订阅内容。
初次手动连接尚未稳定时，先不要配置复杂的 On Demand 条件。如果已经启用，排错时可暂时关闭以减少自动触发干扰，连接稳定后再恢复并单独验证。截图中的 Proxy、TCP 与 UDP 是设置分组，不代表排错时需要全部调整；盲目改动会增加新的变量。
能够连接，但部分请求仍失败
先比较 Proxy 与 Config 对同一目标的结果。如果只在 Config 下异常，检查命中规则与策略；如果两种模式都异常，再检查 DNS、协议和目标服务。不要因为一个目标失败就删除全部服务器或重装应用。涉及 DNS、速度、耗电和更新后异常的分层流程，继续阅读排查手册，基础步骤需要复查时可返回本教程的添加与导入步骤。
到这里，一轮可复查的上手流程应包含：保存资料、选定服务器、确认姿态、完成授权、测试并实际访问。以后更换订阅或服务器时，沿用这套顺序即可；只有验证结果明确指向某个设置，才继续深入修改对应项目。
