Shadowrocket 使用教程

先判断已有信息的类型

打开 Shadowrocket，进入 Home，找到 SERVER 分组及 Add Server 入口。先检查手头资料：如果是一条用于更新服务器列表的链接，按 Subscribe 的方式处理；如果是 Host、Port、Password 等分开的参数，按单台服务器填写。不要把订阅链接整段放入 Host，也不要只凭链接外观猜测协议。无法判断时，先核对你已有服务的说明，再继续下一步。

已有订阅链接：选择 Subscribe

进入 Add Server，点开 Type，选择 Subscribe，再把自己的完整订阅链接填入该类型显示的地址栏。粘贴后检查首尾是否多出空格、换行或引号，尤其要保留链接中问号后面的参数。确认内容完整后保存，等待列表读取完成，再回到 Home 查看是否出现相应分组和服务器条目。保存订阅地址与成功读取列表不是同一件事；如果列表为空，应先处理读取失败，而不是立即打开连接开关。

订阅更新用于重新获取该地址返回的内容。首次导入成功后，后续可在对应订阅条目的操作菜单中执行更新，不需要每次都新增一份相同地址。若已有订阅仍可使用，调整前先保留原条目，避免误删后无法恢复。订阅链接可能含有访问凭据，截图或向他人描述问题时应遮盖完整链接与其中的识别参数。

已有服务器参数：逐项填写 Add Server

在 Type 中选择与资料一致的协议，再核对 Host、Port 以及该协议要求的身份或加密字段。官方截图展示的是含 Password 与 Method 的表单，这不表示所有协议都需要同一组字段。Shadowsocks、VMess、VLESS、Trojan 等类型应分别按已有参数填写；看到 TLS、传输方式或其他附加项时，也要与原资料一致，不能照着其他类型的截图补齐。

Host 通常填写服务器域名或地址，Port 填写对应端口；不要把网页路径附在 Host 后面。Password 与其他身份字段需要完整复制，并保留大小写。若你持有可识别的服务器二维码，可从 Scan QR Code 导入，导入后仍应检查 Type 与关键参数。Import from Cloud JSON 是另一类导入入口，不等于 Subscribe。保存后回到 Home，确认条目能够被选中，再进入模式选择。

完成添加后回到 Home，点开 Global Routing。这里需要区分三种姿态：配置(Config)、代理(Proxy)、直连(Direct)。切换姿态并不会替你修正服务器参数，也不会自动获得新的服务器。首次使用时，先记下当前选择，后续测试只改一项，才能判断变化来自服务器、模式还是规则。

配置(Config)：按当前配置处理请求

选择配置(Config)时，请求按照当前启用配置中的规则和策略处理。进入 Config，确认正在使用的是哪一份文件，再打开对应配置查看 Rule。截图里的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置编辑中的不同分段，Add Rule 用于增加规则；首次连接不需要为了“设置完整”而逐个修改这些分段，更不应开启与当前目标无关的设置。

规则通常按顺序匹配，较前的匹配可能先决定请求去向。DOMAIN-SUFFIX 用于域名后缀匹配，IP-CIDR 用于地址网段匹配，FINAL 用于前面规则未命中时的最终处理。PROXY、DIRECT、REJECT 表示不同处理策略，不能把三者当成不同服务器名称。排查某个页面时，要同时考虑它使用的域名、匹配顺序与最终策略，而不是只看一条规则是否存在。

代理(Proxy)：用于对照服务器连接

代理(Proxy)按该姿态处理流量，适合在确认参数后做一次简化的连接对照。若相同服务器在 Proxy 下可用，而切回 Config 后某个页面失败，排查重点应转向配置、规则和解析过程。这只是缩小检查范围的方法，并不表示 Proxy 一定适合所有日常使用场景；完成测试后应恢复自己需要的姿态。

直连(Direct)：不要误当成代理验证

直连(Direct)用于直接访问。处于 Direct 时页面能够打开，不足以证明刚添加的服务器可用。连接前再看一遍 Global Routing，避免把直连结果当成代理结果。已有配置文件也与 Subscribe 不同：Subscribe 主要读取服务器列表，Config 负责配置与规则；导入订阅不代表已经切换到某份规则文件。需要进一步理解匹配关系时，可阅读功能与设置说明，具体失败现象见疑难解答。

回到 Home，在 SERVER 列表中点选准备使用的服务器，确认当前选择落在预期条目上。列表里存在多个分组时，尤其要核对名称与来源，避免误用旧条目。然后再次检查 Global Routing：采用 Config 时确认配置已选定，采用 Proxy 做对照时确认选中的是本次测试的服务器。上述两项确定后，再打开 Home 顶部开关。

首次出现系统提示时怎么处理

首次连接可能出现允许添加 VPN 配置的系统提示。这是系统为应用建立网络连接配置的授权步骤，不是再次购买应用，也不是自动导入服务器。确认提示由正在操作的 Shadowrocket 发起后，按系统指引允许并完成设备验证。若此前取消了提示，返回 Home 再尝试打开开关，观察是否重新出现授权流程。

完成授权后回到应用，观察顶部状态是否由 Not Connected 转为连接状态，并留意是否马上回落。系统中的 VPN 状态可以作为连接配置正在运行的辅助信息，但不能单凭它判断服务器、DNS 或某个网页已经可用。连接开关表示客户端连接流程的状态，实际请求是否按预期完成，还需要下一步验证。

开关打开后先不要继续改设置

保持当前服务器、Global Routing 与配置不变，先进行一次 Connectivity Test 和实际访问。首次排查时，可暂时停止其他正在管理 VPN 连接的配置，再重新连接，避免系统连接被切换后误认为是当前条目失败。不要一边切换服务器，一边导入新配置，同时修改 DNS；多项变化叠加后，即使恢复可用，也难以知道真正原因。

如果开关立即关闭、反复回落，或系统提示未完成，先处理授权和连接状态，不必马上编辑 Rule。若需要改动关键连接参数，建议先关闭开关、保存修改，再重新连接并验证。已经建立的连接与新保存的参数可能不处于同一轮测试中，重新连接可以让观察对象更明确。完成这些检查后，继续确认实际请求结果。

列表为空：先检查导入与更新

如果 Subscribe 保存后没有服务器，先关闭连接，确认当前网络能完成基础访问，再检查链接是否完整、订阅是否仍有效，以及更新操作是否返回错误。列表为空时改 Global Routing 通常无法补回条目。不要反复添加相同链接制造重复分组；先保留一份待核对条目，向你已有服务的支持渠道确认返回内容与链接状态。

条目存在但连接失败：核对字段与授权

打开条目编辑页，对照原资料检查 Type、Host、Port、身份字段、Method，以及所需的 TLS 和传输参数。部分字段只在特定 Type 下显示，不能因为没有看到截图里的某一项就自行换协议。然后确认系统 VPN 授权已经完成，设备当前没有被其他连接配置切走。若只有某一条服务器失败，先核对该条目，不要马上替换整份 Config。

测试正常但网页失败：检查规则与解析

先确认当前不是 Direct，再用相同服务器对照 Proxy 与 Config 的访问结果。只有某个域名失败时，检查它是否命中 REJECT、是否被前面的规则提前匹配，以及最终策略是否符合预期。DNS 解析失败也可能表现为延迟正常但页面打不开；应检查当前配置使用的解析方式与可见错误，不要只因为看到超时就连续更换多组 DNS。更完整的场景说明放在疑难解答中。

连接自动变化：再看 On Demand

进入 Settings，核对 On Demand 是否启用及其条件。它与按需连接有关，可能影响何时建立连接；首次手动验证时，先确认它是否符合当前测试目标，避免自动连接行为干扰判断。Settings 中的 Test Method 会影响测试含义，改变后不要把新旧数值直接当成同一项对照。TCP、UDP 等分区也不需要在首次失败时全部修改，应由具体症状决定检查范围。

保留诊断信息，而不是清空配置

需要进一步定位时，进入 Settings 中的 Diagnostics 查看可用的诊断信息，记录错误文字、发生阶段和当时使用的模式。准备分享记录前，检查其中是否包含服务器地址、订阅链接或身份凭据，并做遮盖。保留原配置，记录每次修改，失败时恢复上一项再尝试下一项。关于 App Store 获取、已购恢复和购买范围，应转到App Store 指南处理；这些问题与服务器连接排查属于不同流程。

当同一服务器在同一模式下能够重复完成实际访问，就可以结束本轮排查。之后若需要配置 On Demand 或细化 Rule，先保存当前可用状态，再单独调整。这样后续出现问题时，可以回到已验证的基线，而不是从不确定的多项设置重新开始。