Shadowrocket 使用教程

打开 Shadowrocket，进入 Home，找到 SERVER 分组下的 Add Server；也可以使用页面顶部的添加入口。进入 Add Server 后，先看 Type，而不是直接填写 Host。Type 决定后续需要哪些字段，订阅导入与手动添加也从这里分开。导入期间可以先保持顶部连接开关关闭，避免把“资料能否读入”和“服务器能否连接”混在一起判断。

已有订阅链接：使用 Subscribe

在 Type 中选择 Subscribe，再把自己持有的订阅链接粘贴到 URL 字段，并设置便于辨认的名称。名称只用于本地识别，不会改变链接内容。保存前检查首尾是否夹入空格、换行或聊天软件附带的说明文字；不要将介绍页面的地址当作订阅链接。订阅地址可能含个人访问凭据，应完整保留参数，但不要公开展示。

保存后返回 Home，等待订阅内容获取完成，展开相应分组查看服务器列表。出现一个订阅名称，不一定代表其中的服务器已经成功加载；应进一步确认分组内有实际条目。如果列表为空，先检查网络是否能访问订阅地址、链接是否仍然有效，以及返回内容是否为客户端能够识别的订阅数据。需要重新获取时，在该订阅对应的操作菜单中执行更新；不同界面布局的入口位置可能不同，以当前应用显示为准。

已有服务器信息：逐项填写

如果持有的是单个服务器参数，在 Add Server 中按提供的信息选择 Type，再核对 Host 与 Port。Host 一般是服务器域名或 IP 地址，不应额外拼上网页路径；Port 必须与服务器配置一致。截图中的 Password、Method 是相应类型下的字段，换成其他 Type 后，认证与传输选项也会变化。不要因为某项暂时看不到，就把它填进名称或密码字段。

密码、UUID、TLS、传输方式等内容应逐项与自己的服务器资料对应，不能从其他条目随意复制。若资料提供的是受支持的二维码，可在 Add Server 中使用 Scan QR Code，按系统提示授予所需权限。Import from Cloud JSON 面向相应格式的配置内容，不等于通用的订阅入口；已有普通订阅链接时，仍应按 Subscribe 路径操作。

保存后回到 Home，确认条目出现，并点选本次准备使用的一项。订阅分组里可能包含多个条目，本教程只需选定一个进行后续验证。此时先不要反复修改多个服务器的参数；若有疑问，记录缺失的字段，再查阅名词解释。完成选择后，下一步确认 Global Routing，决定请求如何使用这些资料。

回到 Home，点开 Global Routing。这里需要区分配置(Config)/代理(Proxy)/直连(Direct)。选择之后返回 Home，确认这一行显示的是刚刚选中的姿态。切换模式本身不会补全服务器资料，也不会修复失效的认证信息，因此应在完成第一步以后再进行。

配置(Config)：按当前配置文件处理

配置(Config)依照当前启用的配置文件进行规则匹配。进入 Config，查看实际选中的文件；打开文件后，可见 General、Rule 等分段。Rule 中的具体规则通常应放在兜底规则之前，匹配结果决定请求采用 PROXY、DIRECT 或其他已定义策略。若配置引用了策略组，还需要确认组内的选择，不能仅凭 Home 中选过服务器就推断所有策略都已经正确指向。

下面是用于理解顺序的配置语法片段，不是完整配置文件，也不包含服务器信息。示例中，匹配 example.com 的域名请求使用 PROXY，其余未命中的请求由 FINAL,DIRECT 兜底。实际测试前，应查看自己的文件，而不是把这个教学片段直接覆盖进去。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

订阅列表与规则文件需要分别核对：Subscribe 通常用于获取服务器条目，并不代表已经启用了适合当前需求的规则。首次使用时，先确认当前文件来自自己了解的配置来源，再检查要测试的目标会命中哪条规则。不要一次导入大量不熟悉的规则，否则实际访问失败时，很难判断问题出在服务器还是匹配结果。

代理(Proxy)与直连(Direct)：区分检查目的

代理(Proxy)用于让进入代理处理范围的请求采用代理路径，可辅助检查所选服务器的可用性；系统流量范围和其他设置仍可能影响结果，不能理解成所有请求必定采用同一路径。直连(Direct)则按直连路径处理，不应期待它验证代理服务器是否可用。比较两种姿态时，使用同一个目标、同一网络，并保持其他条件不变。

如果目标是日常按规则分流，确认配置后可使用配置(Config)继续下一步；如果正在隔离规则影响，可临时用代理(Proxy)做对照，检查结束后再恢复预定姿态。配置文件的 DNS、规则和策略组细节不必在首次连接时全部调整，需要深入核对时进入Settings 与配置设置详解。

返回 Home，先做一次小范围复核：SERVER 中选中的是准备测试的服务器，Global Routing 显示的是上一步确定的姿态；使用配置(Config)时，当前配置文件也已确认。官方截图中顶部的 Not Connected 表示尚未连接，不能将下方服务器列表已出现理解为连接已经建立。

打开 Home 顶部的连接开关。首次建立连接时，系统可能提示允许 Shadowrocket 添加 VPN 配置；这是设备将相关网络请求交给客户端处理所需的系统授权。确认弹窗所指向的应用后，按提示继续，并完成设备要求的身份验证。系统验证内容应在系统界面输入，不要填进 Add Server 的 Password 字段。

授权完成后返回 Shadowrocket，观察顶部连接状态是否发生变化。如果弹窗被取消，开关可能回到关闭状态；这种情况应先重新处理授权，而不是修改订阅地址。若没有出现弹窗，也不一定是异常，设备可能已有对应配置。应结合当前状态与系统中的 VPN 设置判断，不要为等待弹窗而反复删除配置。

开始测试前，还应确认设备没有另一个正在接管同类网络连接的配置。若切换配置会影响当前连接，先记录现状，再在系统设置中确认实际生效的项目。单位或学校管理的设备可能对 VPN 配置有额外限制，应遵循设备管理要求；不能把系统限制当作服务器密码错误处理。

看到连接状态改变后，先保持应用中的选择不动，进入下一步验证。连接开关保持开启，说明本地连接流程已经推进，但并不能单独证明远端认证、域名解析与所有目标访问都正常。只有把客户端状态与实际请求结合起来，才能判断这次配置是否达到了预期。

导入后没有服务器条目

回到第一步，检查 Subscribe 中的 URL 是否完整，是否误粘贴了说明文字，订阅是否实际返回有效内容。获取订阅数据和连接服务器是不同的网络动作：无法更新列表，不一定说明已保存的服务器都不可用；反过来，列表能够更新，也不代表其中每一项都能连接。确认链接有效性时，只向自己现有服务的信息提供方核对，不要公开含凭据的完整地址。

有条目，但 Connectivity Test 失败

手动添加的条目应逐项核对 Type、Host、Port 与认证字段，再检查 TLS 和传输相关参数。订阅条目则先更新一次，确认仍在有效使用范围内，不要直接改写自己不了解的字段。进入 Settings 查看 Test Method 时，应先记录当前选择；不同测试方法可能得到不同结果，改变方法只是改变检查方式，不会自动修复服务器配置。

开关无法保持开启，或实际访问不符合预期

开关立即回落时，先检查系统是否完成 VPN 配置授权，以及设备当前是否允许启用该配置。若开关能够保持开启，而部分目标失败，再按第二步检查 Global Routing 与当前规则；直连(Direct)下的访问结果不适合用于判断代理服务器是否正常。只有某一目标异常时，还应排除目标服务自身的限制或故障，不要直接重置全部设置。

如果连接会在特定网络条件下自动变化，查看 Settings 中的 On Demand。它涉及按条件触发连接，首次手动验证时应了解现有条件是否会干扰观察，而不是把它当成提升连接效果的通用选项。Proxy、TCP、UDP 等设置也不宜在首次排错时成批调整；每次修改前保存原值，并在同一目标上复测，确认没有改善后再恢复。

使用 Diagnostics 时保留必要上下文

需要进一步定位时，在 Settings 中查看 Diagnostics 提供的诊断入口，结合失败时刻和具体目标阅读结果。记录当前网络、Global Routing、所选条目类型以及可见错误文字；日志若包含域名、地址、认证信息或订阅凭据，应先处理敏感内容再分享。不要为了求助而发送完整订阅链接或整份未经检查的配置。

完成基础验证后，可把日常需要的 Global Routing 姿态恢复，并再次确认一次实际访问。后续调整 DNS、On Demand、日志或同步时，沿用“记录原值、只改一项、验证结果”的方法。更完整的设置解释在设置详解，按现象检索问题可进入常见问题。本篇到此完成首次操作链路，不要求在一次上手中启用所有功能。