官方手册 / 首次操作
Shadowrocket 订阅导入
与首次连接步骤
按“添加 → 选择模式 → 连接 → 验证 → 排错”的顺序操作。先让一条已有连接信息可供测试，再逐项了解规则与设置。
下文保留英文界面词，并用括号补充中文含义。配图来自 App Store 官方截图，用于辨认所在页面；具体字段与排列可能随协议、设备和应用界面变化，以当前应用中显示的内容为准。
步骤 01 / 准备连接条目
Add Server / Subscribe：添加服务器或导入已有订阅
先区分手中的资料是订阅 URL，还是一组服务器参数。两者的录入位置不同，不要把订阅地址填入 Host。
有订阅链接：选择 Subscribe
从 Home（首页）进入 Add Server（添加服务器），通常可点击右上角添加按钮，也可使用列表中的 Add Server 入口。打开 Type（类型）选择列表，选择 Subscribe（订阅）。此时表单应切换为订阅所需的字段，而不是手动服务器的 Host、Port 等字段；确认类型后，再把你已有的完整订阅链接填入 URL。
- 从你的服务商处复制已有订阅的原始链接，检查开头和结尾是否完整，避免夹带空格、换行或聊天消息中的说明文字。
- 在 Subscribe 表单填写 URL，需要时添加便于辨认的备注，然后使用页面右上角的完成或保存按钮。
- 返回 Home，等待订阅获取完成，检查对应分组内是否出现服务器条目。若只出现分组但没有条目，先确认是否有错误提示，不要立即重复添加相同地址。
订阅链接往往包含身份凭据，应当像密码一样保管。不要把完整链接贴到公开页面、截图或诊断记录中。本页也不需要你提交链接。若复制的是某个网页地址，而不是可供客户端读取的订阅 URL，即使它能在 Safari 中打开，也不代表可以在 Subscribe 中导入。
有服务器参数：按 Type 逐项录入
如果手中是主机、端口和认证资料，在 Add Server 中先选择与资料一致的 Type。不同协议显示的字段不同，不能只凭一个密码猜测类型。以官方截图中的表单为例，Host（主机）填写服务器地址，Port（端口）填写端口号，Password（密码）与 Method（加密方法）须和原始资料一致；其他类型可能需要另外的身份、传输或 TLS 字段。
主机示例可写作 example.com，它只是域名格式示意，不是可连接的服务器。不要把带有网页路径的整段 URL 填入只接受主机名的字段，也不要把订阅链接中的参数拆出来当作服务器认证资料。未提供的选项应先保留当前值，确实需要某项参数时，再向你已有服务的资料来源核实。
若已有二维码，可在 Add Server 使用 Scan QR Code（扫描二维码），扫描后仍要核对 Type 与服务器信息。Import from Cloud JSON（从云端 JSON 导入）适用于相应格式的资料，不是任意订阅地址的通用替代入口。保存后回到 Home，确认刚才的条目已经出现，再继续选择路由模式；“保存成功”只说明信息已录入，还没有完成连通性验证。
步骤 02 / 决定流量处理方式
Global Routing：配置(Config) / 代理(Proxy) / 直连(Direct)
服务器条目回答“连接到哪里”，Global Routing 回答“哪些连接采用什么处理方式”。两者需要分别确认。
返回 Home，点击 Global Routing（全局路由）查看当前模式。先记下原来的选择，再根据测试目的调整。不要把“已经导入订阅”和“已经配置分流规则”看成同一件事：订阅通常用于更新服务器条目，Config 中的配置文件则可包含规则等设置，二者承担不同职责。
- 配置(Config)：按当前选用配置中的规则决定处理方式。准备日常分流时使用这一姿态，但前提是先知道当前选用的是哪份配置，以及它对目标连接的预期行为。
- 代理(Proxy)：以所选代理处理受客户端接管的连接。首次排查服务器是否可用时，可临时用这一姿态减少规则分流带来的变量，但它不能替代服务器参数和网络检查。
- 直连(Direct)：采用直连处理，不经远端代理。它适合对照原始网络表现，不应用来判断远端服务器是否连接成功。
使用 Config 前，先认清当前配置
打开 Config（配置）页面，查看配置文件列表以及当前选用状态。进入某份配置的编辑页，可看到 General（通用）、Rule（规则）、Hosts（主机映射）等分段。右侧官方截图展示的是配置编辑页，并不是 Home 中的 Global Routing 选择菜单。仅打开或编辑某个文件，不等于已经把它设为当前使用的配置，返回列表后还要核对选用状态。
首次操作不必立即进入 Add Rule（添加规则）。如果已有配置来自你自己的可信资料来源，先阅读其说明并保留原文件。规则通常按顺序匹配，前面的命中结果可能决定流量去向；不能只看末尾一条规则，就断定所有网站都会经过同一个服务器。
例如 DOMAIN-SUFFIX,example.com,PROXY 表示针对相应域名后缀采用 PROXY 策略；FINAL,PROXY 则用于处理前面尚未匹配的连接。这些只是规则语义示例，并不是要求你替换整个配置。更完整的规则关键字解释见术语表，配置与 Settings 的细节见选项手册。
完成这一步后，应当能说清楚当前选择的姿态及预期结果。若此刻只是检查刚添加的服务器，可以先记录 Config 状态，再临时选择 Proxy；验证结束后，根据实际需要恢复 Config。每次只改变一个条件，后续才容易分辨是服务器问题还是规则问题。
步骤 03 / 建立系统连接
Home：选择服务器，再打开连接开关
先核对所选条目和路由模式，再处理系统 VPN 配置授权。授权、建立连接和实际访问是三个不同环节。
回到 Home，在 SERVER（服务器）或订阅分组中点选准备测试的条目，确认当前选中标记落在目标条目上。列表里“有这个服务器”不等于“正在使用这个服务器”。如果刚导入多个分组，先只选择其中一个，暂时不要在测试过程中反复切换，以免无法对应结果。
- 核对 Global Routing 是否与上一步的测试计划一致，然后打开 Home 顶部连接开关。未连接时，顶部可见 Not Connected（未连接）等状态提示。
- 首次请求连接时，系统可能弹出添加 VPN 配置的提示。确认提示来自刚打开的 Shadowrocket 操作，阅读说明后选择允许，并按系统要求完成设备验证。
- 返回应用，观察顶部状态与开关是否保持开启。若开关很快回到关闭状态，先保留当时的错误信息，转到本页设置与排错，不要连续重复授权。
VPN 配置授权使应用能够通过系统的网络扩展处理连接，不代表系统已经验证了你填写的服务器，也不表示某个目标网站一定可访问。如果此前选择了不允许，重新打开连接开关时按实际提示处理；必要时到系统“设置 → 通用 → VPN 与设备管理”核对相关 VPN 条目。不同系统版本的显示名称可能有差异，以设备当前界面为准。
检查系统设置时，不要随意删除其他用途的管理配置。对于单位或学校管理的设备，若系统限制添加 VPN 配置，应先确认设备管理要求，而不是反复修改应用中的服务器字段。能否添加配置与远端服务是否可用，是两个独立问题。
连接开关保持开启后，继续下一步做实际验证。系统 VPN 标识只能说明相应连接状态，不能单独证明规则命中了哪条策略。若同时有其他 VPN 连接正在工作，先明确当前由哪一项连接接管网络，再判断 Shadowrocket 的状态；不要仅凭状态栏图标作结论。
步骤 04 / 核对实际结果
Connectivity Test：测试结果与实际访问一起看
连接开启之后，先确认当前 Wi-Fi 或蜂窝网络本身能够正常联网。如果网络需要网页登录认证，应先完成该网络的认证，再回到 Shadowrocket 操作。否则，订阅获取失败、测试失败和网页打不开可能只是同一个基础网络问题，并不一定是服务器参数错误。
先做应用内测试，再打开目标页面
- 在 Home 点击 Connectivity Test（连通性测试），等待当前测试完成，观察所选条目的结果。测试期间不要同时切换服务器或修改 Global Routing。
- 若不清楚结果代表什么，打开 Settings（设置）查看 Test Method（测试方法）。不同方法检测的层级不同，应按当前方法理解结果，而不是把所有数字都当作实际网页速度。
- 打开 Safari，访问一个你明确知道应当如何处理的目标页面，并尝试刷新页面或打开一个新页面。结合当前模式判断结果，不以已经加载好的缓存页面作为唯一依据。
有测试结果只代表对应测试条件下收到了响应，不等于整个代理会话、域名解析以及所有网站请求都能完成。反过来，某种测试失败也不能单独证明服务器在所有使用场景下都不可用。先确认测试方法，再结合实际访问和错误记录判断，通常比不断运行同一种测试更有帮助。
Config 下还要核对策略命中
如果当前使用配置(Config)，应分别选一个预期走 DIRECT 的目标和一个预期走 PROXY 的目标进行检查。两者都能打开，不代表它们经过相同路径。需要进一步确认时，查看应用可用的连接记录或 Log（日志），结合目标域名、匹配规则和策略结果判断；记录里包含的字段以当前应用实际提供的内容为准。
若 Proxy 下目标可以访问，而切回 Config 后失败，优先检查当前配置、规则顺序和 DNS 相关设置，不必立即重新录入全部服务器资料。如果 Proxy 下也失败，先保持模式不变，回头检查所选服务器、参数和基础网络。这样可以把“远端连接失败”与“分流没有按预期执行”分开处理。
步骤 05 / 按失败位置回查
Settings：保留原值，一次排查一个变量
先判断失败发生在导入、授权、连接还是访问阶段，再决定是否需要调整设置。不要把所有开关一起打开。
订阅没有条目，先检查获取过程
如果 Subscribe 保存后没有生成服务器，先核对 URL 是否完整、当前网络是否可访问订阅地址，以及已有订阅是否仍然有效。网页可打开而导入失败时，还要确认拿到的是订阅内容入口，不是账户管理页面。服务器条目尚未获取成功时，修改 Global Routing 通常不能解决订阅格式或认证问题。
不要靠反复新增同一个 URL 尝试修复，这会产生难以辨认的重复分组。保留一份原始资料，记录界面提示的错误类型；需要核实有效期或链接格式时，向你已有服务的资料来源确认。订阅删除和重新添加之前，先确认其中是否包含自己手动修改过的信息。
条目存在但连接失败，回查参数与授权
手动添加的条目应逐项对照 Type、Host、Port 和认证字段，尤其留意复制时混入的空格、大小写差异，以及遗漏的传输或 TLS 参数。协议类型不同，所需信息也不同；不要把其他类型表单中的默认值当作当前服务的必需值。若使用订阅生成的条目，先尝试按原订阅更新并核对，而不是直接覆盖多个字段。
若连接开关无法保持开启，先区分系统 VPN 配置授权是否完成，以及应用是否报告连接错误。授权被拒绝与服务器拒绝连接不是同一种失败。曾误删相关 VPN 条目时，可回到 Shadowrocket 再次尝试连接，按系统实际提示重新授权；设备受管理限制的情况则按设备管理要求处理。
连接已开启但访问失败，检查规则与 DNS
首先确认当前不是直连(Direct)，并再次核对 Home 中所选服务器。若只有部分域名失败，记录目标与失败表现，例如无法解析、连接超时或页面部分资源加载失败，然后对照 Config 的规则路径。不要仅因一个网页打不开就更换所有 DNS 选项，更不要为排错随意启用 HTTPS Decryption（HTTPS 解密）。
DNS 决定域名如何解析，路由规则决定连接如何处理，二者会共同影响结果。若需要比较 Config 与 Proxy，先记下原模式，在同一网络和同一目标下测试，再恢复原值。测试过程中尽量只保留一个变化，才能判断是哪项调整产生了影响。更详细的 DNS、规则与日志说明可继续阅读选项手册。
Settings 中先看含义，再改数值
官方截图中的 Settings 包含 Test Method、Today Widget（今日小组件）、On Demand（按需连接）、Diagnostics（诊断）、Proxy、TCP 与 UDP 等入口。Test Method 会影响连通性测试的解释；On Demand 用于按条件触发连接，建议在手动连接已经验证后再设置。Today Widget 属于快捷访问相关设置，并不是修复服务器连接的步骤。
Diagnostics 可用于收集排查线索，但记录应围绕一次明确的失败操作来查看。先记下操作顺序，再重现问题，避免连续切换多个服务器后只保留最后一段提示。分享记录前移除完整订阅链接、密码、身份凭据和其他私人信息；本教程不要求公开提交这些资料。
当一条已有服务器能够按预期访问后，先保持这套可复现的设置，再逐步启用按需连接或其他便利选项。重新测试时沿用本页的验证顺序，不必反复删除应用或全部重建配置。其他购买、授权与订阅更新问题见常见问题；需要查清 Subscribe、Config、PROXY 与 DIRECT 的区别时，使用术语表逐项对照。
