Shadowrocket 使用教程

通过 Subscribe 导入

打开 Shadowrocket，进入 Home，点 Add Server。在添加页面先点 Type，选择 Subscribe，再返回填写页面。把从你的服务商处获取的完整订阅链接粘贴到 URL 对应的地址栏，核对开头、结尾以及查询参数是否完整，然后保存。不要把服务商说明页的网址误填为订阅地址，也不要在复制时带入说明文字、引号或换行。

保存后返回 Home，等待订阅内容获取完成。看到订阅分组和其中的服务器条目，才说明列表内容已进入客户端；只出现一个分组名称，不足以确认导入完整。展开对应分组，检查是否有可选择的条目，再选择其中一项作为本次测试对象。初次核对时保留一份明确的来源即可，避免相同链接重复导入后难以分辨。

如果列表为空，先确认设备原本能够访问网络，再检查链接是否完整、是否仍有效。订阅更新只会重新获取来源中的内容，不会替你补齐失效的服务权限。需要确认链接状态时，应从你的服务商处核对；不要反复新建相同订阅来尝试修复。

通过 Add Server 手动填写

如果已有的是 Host、Port、认证信息等独立参数，在 Home 点 Add Server，先把 Type 改成资料中明确写出的协议，再逐项填写。Host 填服务器域名或地址，Port 填连接端口；Password、Method 等字段是否出现，由所选 Type 决定。官方截图展示的是其中一种字段组合，不代表所有协议都使用同样的认证方式。

逐项对照原始资料，尤其留意认证值中的大小写、端口数字以及复制产生的首尾空格。涉及 TLS、传输方式或其他附加字段时，按已有资料填写，不要依据协议名称猜测。字段不明确时先查术语表；协议参数之间的关系可继续阅读协议手册，本页只完成首次连接所需的核对。

已有对应二维码时，可以在 Add Server 使用 Scan QR Code；Import from Cloud JSON 则用于相应格式的资料，不应当作通用订阅输入框。保存之后返回 Home，确认新条目存在且已选中。此时只是完成了资料录入，尚未建立连接，下一步需要选择 Global Routing。

区分三种姿态

在 Home 点 Global Routing，按这次操作的目的选择配置(Config)、代理(Proxy)或直连(Direct)。配置(Config)根据当前启用的配置文件判断连接策略，适合已有明确分流规则时使用；代理(Proxy)让通常由该模式接管的连接走代理路径，可用于隔离规则因素；直连(Direct)直接连接目标，不适合用来判断代理服务器是否工作。

第一次测试服务器时，如果尚未确认 Config 内容，可以暂时选择代理(Proxy)，先验证服务器路径；验证结束后，再按实际需要切回配置(Config)。这只是缩小排查范围的方法，不意味着代理(Proxy)适合所有日常使用场景。测试前后要记下原本的选择，避免忘记恢复后误以为规则失效。

使用 Config 前核对文件

如果准备使用配置(Config)，进入 Config，先确认哪一个文件处于当前启用状态，再打开该文件查看内容。订阅通常负责提供服务器列表，Config 负责规则等配置；成功更新订阅，不代表当前 Config 已被替换，也不代表某个远程配置已经启用。文件出现在列表中与文件正在生效，需要分别核对。

官方截图展示了 Config 编辑页中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次上手重点查看 Rule，不需要为了建立普通连接就逐一修改其他分段。打开文件查看内容，也不等于自动切换了当前使用的文件；编辑后还应返回列表确认保存结果及启用状态。

Rule 中的规则通常自上而下匹配，首个命中项决定策略；未命中前面的规则时，再由 FINAL 兜底。PROXY、DIRECT、REJECT 是策略关键字，与 Global Routing 中的 Proxy、Direct 不是同一层设置。前者用于规则结果，后者是整体模式，大小写与使用位置都应按界面和配置原文区分。

确认模式之后返回 Home。需要理解三种模式与规则的配合时，查看代理模式说明；只想辨认某个关键字时，查看术语表即可，不必在首次连接时展开全部配置知识。

在 Home 发起连接

回到 Home，先核对 SERVER 分组中选中的条目，再看 Global Routing 是否仍是刚才确定的模式。确认 Wi-Fi 或蜂窝网络本身可用后，打开页面顶部的连接开关。官方截图中的 Not Connected 是未连接时的状态示例；实际操作中应观察开关与状态文字的变化，不要把截图文字当成已经连接成功的提示。

首次建立连接时，系统可能要求允许添加 VPN 配置。阅读提示，确认这是刚才在 Shadowrocket 中主动发起的操作，再继续并按设备要求完成认证。这个步骤允许客户端通过系统网络扩展处理连接，并不会生成服务器信息，也不会代替上一节的订阅导入。

完成系统确认后回到 Home，等待状态稳定。如果之前取消了授权，开关可能回到关闭状态；可以再次主动发起连接并处理系统提示。如果设备受管理而无法添加 VPN 配置，应先确认设备的管理限制，不要把无法授权误判为服务器参数错误。

连接后先保持条件不变

开关开启并出现已连接状态，只能说明本机连接流程已经推进到相应阶段，不能单独证明所选服务器能访问每一个目标。先保持当前服务器和 Global Routing 不变，按下一节做测试；不要刚看到状态变化就连续切换多个条目，否则后续记录很难对应到同一组条件。

如果系统里还有其他正在工作的 VPN 配置，先确认当前实际生效的是哪一项；必要时停止其他连接后再测试。首次手动验证期间，也应留意 On Demand 是否会按既有条件重新触发连接。临时调整前记下原设置，完成后再恢复。

iPad 的操作顺序与 iPhone 一致，部分页面的展示宽度可能不同。无论使用哪一种设备，都以实际看到的 Home、Global Routing 和系统授权提示为依据。需要结束本次测试时，回到 Home 关闭连接开关，并确认状态已变化。

导入为空或连接立即失败

订阅导入后为空，回到第一步检查链接和更新结果，确认设备原始网络能够工作，并从你的服务商处核对订阅状态。服务器列表已经出现但连接失败，则逐项对照 Type、Host、Port 和认证字段；若使用域名，也要留意是否存在解析失败的记录。导入成功与服务器可用是两个不同判断，不应混在一起处理。

开关无法保持开启时，先看系统 VPN 授权是否完成、是否有设备限制或其他连接配置干扰。若本机连接状态已经正常，而 Connectivity Test 与实际访问都失败，再检查服务器参数和网络条件。先停止连接确认原始网络，再重连复测，可帮助判断故障是否只出现在代理路径中。

测试通过但目标仍打不开

进入 Settings 核对 Test Method，确认测试结果究竟说明了什么。测试方法不一定覆盖目标使用的实际传输；页面打开失败、应用登录失败或部分功能失败，可能对应不同请求。保留一个固定目标与固定服务器测试，不要为了获得某个测试数值就同时修改 TCP、UDP 等多项设置。

可以在记录原模式后短暂对照代理(Proxy)与配置(Config)。如果同一目标在代理(Proxy)下可用，在配置(Config)下失败，优先查当前 Config、命中规则与策略；如果两种模式都失败，再检查参数、服务器状态与当前网络。测试完成后恢复原本需要的模式，直连(Direct)的结果也不能替代代理路径验证。

检查 On Demand 与 Diagnostics

Settings 中的 On Demand 可能根据已有条件触发连接。如果手动关闭后又出现连接，先查看这里是否配置了相应条件，再判断是否异常。首次排错可记录并暂时停用相关条件，让手动开关的结果更容易观察；验证结束后，再按实际需要恢复，而不是长期保留测试时的临时状态。

需要更多线索时进入 Diagnostics，记录出错环节以及可用的诊断信息。有效描述应包含“导入是否成功、开关是否开启、Global Routing 是什么、哪些目标失败、换网络后是否复现”，而不只是“连不上”。记录时间点后再复现一次，有助于从较多日志中找到对应请求。

仍无法确定时，按具体表现进入疑难解答继续排查；不确定字段含义时转到术语表。本页到此完成首次连接的基本闭环：资料进入 Home、模式明确、系统授权完成、实际请求经过验证，并且可以说明失败发生在哪一步。