Shadowrocket 使用教程
订阅导入与首次连接
按添加、模式、连接、验证、排错的顺序操作。先确认一条已有服务器能够正常使用，再逐步调整规则与自动连接设置。
页面中的图片均为 App Store 官方截图，用于识别入口与字段，不代表设备当前的连接状态。需要管理多个订阅、设置更新策略或整理服务器时，转到订阅与服务器管理手册。
添加服务器或导入已有订阅
打开 Shadowrocket 的 Home，先看 SERVER 分组。首次使用时，列表中可能还没有可选服务器；这时进入 Add Server。已有订阅链接与单台服务器参数是两类不同输入，不要把整条订阅地址填进 Host，也不要把普通网页地址当成订阅。先确认自己持有哪一类信息，再选择对应入口。
已有订阅链接：选择 Subscribe
在 Add Server 中点开 Type，选择 Subscribe，再把已有的完整订阅链接填入 URL 字段。检查粘贴结果是否包含多余空格、换行或聊天软件附带的说明文字；地址中问号之后的内容可能属于访问凭据，不应随意删改。为订阅填写容易辨认的备注，保存后返回 Home，等待内容读取完成。
成功的判断依据是列表出现可选服务器，而不仅是订阅名称已经保存。如果只看到分组却没有条目，先执行该订阅的更新操作，再检查链接是否仍有效、当前网络能否取得返回内容。订阅更新与连接服务器是两个阶段：能更新不代表每个服务器都能连接，更新失败也不一定说明此前保存的服务器已经失效。
已有服务器参数：按 Type 填写字段
如果持有的是单台服务器信息，在 Type 中选择信息所对应的协议。以官方截图中的 Shadowsocks 字段为例，Host 是服务器地址，Port 是端口，Password 是该服务器的密码，Method 必须与服务器配置一致。不同 Type 的字段会变化；VMess、VLESS、Trojan、Hysteria2 等不能直接套用同一组填写方法，也不要仅凭端口猜测协议。
逐项核对已有资料后保存，回到 Home 检查该服务器是否出现在 SERVER 分组。服务器名称只是便于识别的备注，并不会改变实际连接地址。遇到不熟悉的协议或字段，先查阅概念速查，再根据已有信息填写，不要用尝试随机值的方式排查。
二维码与分享链接：先核对，再导入
已有二维码时，可使用 Scan QR Code，并按系统提示允许相机访问；已有服务器分享链接时，可使用应用提供的剪贴板导入入口。导入完成后仍要打开条目检查 Type、地址与端口。Import from Cloud JSON 用于对应格式的云端 JSON 内容，不应把它当成任意订阅链接的通用入口。
订阅链接、二维码及分享内容可能包含凭据，不要发到公开页面。需要记录问题时，只保留字段名称和错误现象。完成本步后，至少应有一条可选服务器；下一步先确定 Global Routing 的处理方式，再打开连接开关。
选择配置(Config)、代理(Proxy)或直连(Direct)
回到 Home，点 Global Routing 查看当前模式。这项设置决定连接如何被处理，与服务器列表中的选中项不是同一件事：选中了某条服务器，不代表所有连接都会使用它。先理解模式，再判断结果，能够避免把规则造成的流量差异误认为服务器故障。
配置(Config)：按当前配置处理
配置(Config)按当前启用配置中的规则决定流量去向。有适用且已核对的配置时，可将它作为日常模式。进入 Config 查看当前配置，确认实际启用的是哪一份；官方截图展示的编辑页包含 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 等分段。首次上手主要确认配置选择与 Rule，不必为完成连接而逐项修改所有分段。
Rule 中的规则通常按顺序匹配，匹配后采用对应策略，FINAL 处理此前未命中的连接。例如，一条规则将目标交给 DIRECT 时，即使已经选好代理服务器，该目标也可能直接连接。规则里的 PROXY、DIRECT、REJECT 是处理策略，与 Global Routing 菜单里的 Proxy、Direct 需要按各自所在位置理解。
代理(Proxy)：临时检查已选服务器
代理(Proxy)使通常受客户端处理的连接使用代理路径，适合临时判断已有服务器是否可用。第一次排查时，可以记录原来的模式，再切到 Proxy，用同一个目标重复测试。若 Proxy 可以访问，而 Config 下出现差异，应优先检查配置、规则命中和解析设置，不要立即删除服务器或反复重新导入订阅。
直连(Direct)：不用于验证代理可用性
直连(Direct)让连接采用直连路径。它可以用来比较基础网络是否正常，但不能证明所选代理服务器工作正常。切到 Direct 后某个网页能打开，只能说明该次访问的直连路径可用。完成对照后，恢复计划使用的模式，再进入下一步连接。
如果尚不理解规则的先后顺序，先保持配置内容不变。Add Rule 是增加规则的入口，并不是连接前必须执行的步骤。更完整的关键词说明见规则关键字与 Global Routing 概念速查。
选中服务器，打开 Home 连接开关
返回 Home，在 SERVER 分组中点选准备使用的服务器，确认选中标记对应的是目标条目，而不是仅打开了该条目的编辑页。随后再次看一眼 Global Routing，确保它与上一步的计划一致。首次验证建议固定一条服务器和一种模式，避免在连接过程中同时切换多个条件。
点开 Home 顶部的连接开关。首次连接时，系统可能弹出添加 VPN 配置的确认窗口；这是应用建立系统网络连接所需的授权流程。阅读弹窗中的应用名称与说明，再按设备提示确认，必要时完成设备身份验证。此处应在设备的系统窗口中操作，不需要把设备密码填写到服务器的 Password 字段。
授权完成后回到 Shadowrocket，观察顶部状态是否从 Not Connected 发生变化。若此前取消了授权，连接不会因此自动完成，可以重新发起连接并按系统提示处理。设备存在管理限制或其他正在工作的 VPN 配置时，也可能影响建立连接；应先确认设备允许更改，再继续操作。
状态发生变化表示客户端连接流程取得了进展，但不等于所有目标都能访问。服务器不可用、域名解析失败或规则选择不合适，都可能在连接已建立之后才表现出来。因此不要停在“开关已经打开”这一步，接下来还要验证测试结果与实际访问。
需要修改服务器的关键参数或切换配置时，可以先关闭连接，保存修改后再重新打开。这样更容易确认新设置是否被采用，也方便记录每次变化。iPad 上即使内容区域布局不同，操作顺序仍是 Home 选服务器、确认 Global Routing、打开顶部连接开关。
用 Connectivity Test 与实际访问共同验证
先在 Home 执行 Connectivity Test，观察当前测试是否得到响应。测试行为与 Settings 中的 Test Method 有关，不同测试方法检查的链路并不完全相同。比较两条已有服务器时，应保持相同网络和测试方法；一次测试失败不能直接断定服务器永久失效，一次较低的测试数值也不代表大文件传输一定更快。
随后打开浏览器或需要使用的应用，访问一个明确允许访问且便于重复检查的目标。确认页面正文或所需功能真正加载完成，而不是只看到先前缓存的首页。若只凭已经打开的页面判断，可能把缓存内容误认为新连接已经成功。必要时发起一次新的访问请求，并记录目标、模式与选中的服务器。
再回到 Shadowrocket 查看 Data 中可用的流量统计或连接记录。出现数据变化可以辅助判断是否有流量经过客户端，但统计增长本身不能证明某一条连接一定采用了代理：在 Config 模式下，一部分连接可能按规则采用 DIRECT。应把目标访问结果、模式与规则放在一起判断，不把单个计数当成全部结论。
- 连接状态正常、实际访问也正常：保留当前服务器和模式，结束首次验证，再根据日常需要调整规则。
- 测试有响应、实际访问失败：检查该目标的规则、DNS 与目标本身，测试链路可能不同于实际访问链路。
- 测试失败、实际访问正常：先检查 Test Method 与测试目标的适用性，不要只因测试结果就删除可用配置。
- 所有验证都失败：进入下一步，按导入、连接、路由的顺序缩小范围。
如果需要比较 Config 与 Proxy，使用同一目标、同一服务器和同一基础网络，每次只更换模式。对照结束后恢复日常配置。不要通过一次性更改模式、DNS、协议参数和服务器来“碰运气”，否则即使恢复可用，也很难知道原因。
按失败阶段检查，暂缓自动连接设置
排错先确定问题发生在哪一步：导入后没有服务器、开关无法保持开启、连接后所有访问失败，还是只有部分目标失败。不同现象对应不同检查方向。先记录原来的配置与模式，一次只改一个项目；不要把删除全部内容、重新导入作为每次失败后的第一步。
没有服务器：回到导入与更新阶段
订阅保存后列表为空，优先检查 Subscribe 类型、URL 完整性与更新结果。若已经有条目却连接失败，再检查具体条目的 Type、Host、Port 及协议要求的认证字段。订阅更新会重新获取服务器信息，手动修改的条目可能受后续更新影响；需要长期保留的整理与备份方法见订阅与服务器管理手册。
无法建立连接：检查授权与基础网络
开关打开后很快恢复，先确认系统 VPN 配置授权是否完成，再检查设备当前网络是否能正常使用。可以关闭连接，验证基础网络，恢复后再连接同一条服务器。已有另一条已知可用服务器时，可在相同条件下进行对照；单条失败应先核对该条目的参数与可用状态，不必立即改动整个配置。
仅部分目标失败：检查模式、规则与 DNS
先确认 Global Routing 是否仍为计划中的模式，再比较 Config 与 Proxy 的行为。若差异只在 Config 出现，查看适用规则及其顺序；若两个模式下都失败，再结合服务器与解析情况检查。DNS 调整会影响域名解析，不应把临时填写一个地址当作通用修复方法。不了解相关字段时，先阅读DNS 与规则术语说明。
Settings：先观察，再调整
打开 Settings，可对照官方截图识别 Test Method、On Demand 与 Diagnostics。Test Method 影响测试方式，不是提高服务器实际速度的开关。需要进一步查看诊断信息时进入 Diagnostics，结合失败时间与现象定位；记录或分享诊断内容前，检查其中是否包含订阅地址、服务器认证信息及不宜公开的访问记录。
On Demand 用于按条件触发连接，建议在手动连接和实际访问都验证成功后再设置。排错期间如果连接反复自动恢复，应同时检查它是否正在按已设条件工作。先建立可重复的手动测试结果，再增加自动化条件，能够区分基础连接问题与触发条件问题。
