Shadowrocket 订阅导入与首次连接

步骤 01 · 先确认信息类型

Add Server：添加服务器与 Subscribe

打开 Shadowrocket 后进入 Home，在 SERVER 分组附近找到 Add Server，也可使用页面上的添加按钮进入。先辨认手里的内容：一条用于批量更新节点的地址属于订阅；一组地址、端口、协议及认证参数属于单个服务器信息。这两种输入方式不要混用，尤其不要把订阅地址整段填进 Host。

已有订阅链接时

进入 Add Server 后，打开 Type 并选择 Subscribe，把自己的订阅链接粘贴到对应的地址输入项；如果界面提供备注字段，可写一个便于辨认的来源名称，然后保存。返回 Home 后对该订阅执行更新，等待解析完成，再检查 SERVER 中是否出现实际服务器条目。保存订阅地址与成功取得节点是两件事，只有一个订阅名称而没有可选服务器时，不应直接进入连接步骤。

粘贴前检查链接开头与结尾，避免复制进空格、换行、聊天说明或中文标点。链接中的参数通常属于认证信息，不要随意删改，也不要公开发送。若更新后显示错误或列表为空，先保留原地址并查看错误提示，不要连续重复添加相同订阅。订阅是否到期、是否允许当前请求，需要向用户已有的服务商核实；这些状态不由客户端的安装或购买结果决定。

已有单个服务器信息时

在 Type 中选择实际协议，再按原始资料填写 Host、Port 以及该协议要求的认证字段。以 Shadowsocks 为例，需要核对 Password 与 Method；切换到其他协议后，字段可能不同，不能照抄截图中的字段组合。Host 通常填写服务器域名或 IP 地址，Port 填端口数字，密码及其他认证值保持原样，大小写也要一致。

若持有可供导入的二维码，可使用 Scan QR Code；Import from Cloud JSON 则面向对应的 JSON 数据来源，不是任意订阅链接的通用替代入口。导入后仍应打开条目检查协议和地址，确认它与已有资料一致。最后保存并回到 Home，确认 SERVER 分组内已有可选条目，再继续选择 Global Routing。协议字段的差异可查阅术语手册，本步骤不需要改动暂不理解的高级参数。

步骤 02 · 决定流量怎样处理

Global Routing：选择三种姿态

已经导入服务器后，先不要急着打开连接开关。在 Home 点开 Global Routing，确认当前使用配置(Config)、代理(Proxy)还是直连(Direct)。服务器条目回答的是“使用哪台服务器”，Global Routing 回答的是“请求按什么方式处理”；只选了服务器，却选错全局姿态，访问结果仍可能与预期不同。

1. 配置(Config)：按照当前配置文件中的规则决定请求使用 PROXY、DIRECT 或 REJECT。适合需要规则分流的日常使用，但前提是已选中正确配置，规则本身也符合目标。
2. 代理(Proxy)：以全局代理姿态处理请求，可作为短时排查手段，帮助区分问题来自服务器还是 Config 规则。它不是为某个网站自动生成规则的功能。
3. 直连(Direct)：以直连姿态处理请求，不应用来证明代理服务器已经可用。需要比较原网络访问表现时可以临时使用，测试后再恢复预期姿态。

准备使用 Config 时，打开底部 Config 页面，确认当前选中的是预期配置文件。服务器订阅与配置文件并非同一种内容：前者主要维护可连接条目，后者包含规则及其他设置。更新订阅后节点变多，不代表 Config 中的分流规则也已经更新。进入配置编辑页可以看到 General、Rule、Hosts、URL Rewrite 等分段；首次上手只需确认 Rule 的实际内容，不必同时修改多个分段。

下面片段用于理解规则的顺序，不要求新用户立即替换现有配置。它表达的是：example.com 及其子域名走 PROXY，其余请求交给 DIRECT。示例域名仅用于展示语法，不代表实际测试目标；在真正配置前应换成自己的目标，并保留原配置副本。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

Rule 通常从上往下匹配，FINAL 应放在用于兜底的位置；如果提前匹配，后面的目标规则就不会处理该请求。需要添加规则时使用 Add Rule，并检查保存后的排列顺序。更完整的规则类型、策略与优先级说明见规则与配置参考。确认模式与配置后返回 Home，下一步再建立连接，避免把配置编辑与连接故障混在一起排查。

步骤 03 · 选择条目后再连接

Home：打开连接与系统授权

回到 Home，在 SERVER 分组中点选准备使用的服务器，确认选中标记落在预期条目上。如果列表中有多个相近名称，可先打开条目核对 Host 与 Port，再返回选择。一次只测试一个服务器，不要在打开开关的同时反复切换条目，否则失败时难以判断实际使用了哪组参数。

检查 Global Routing 显示为刚才选择的姿态，然后打开顶部 Not Connected 附近的连接开关。首次连接时，iPhone / iPad 会请求允许添加 VPN 配置；确认操作来自 Shadowrocket 后，按系统提示允许，并完成设备密码或生物识别验证。若取消了这次请求，应用没有取得相应授权，应返回 Home 重新触发连接，而不是重新导入所有服务器。

完成授权后返回应用，观察顶部状态是否变化、开关能否保持开启。系统状态区域是否显示 VPN 标识会受设备与当前界面影响，不要只靠标识判断结果。连接已建立只说明系统层面的连接流程已进行，并不等于目标网站、DNS 和分流规则都已验证通过。因此本步骤结束后，还需要实际访问与测试。

若开关立即回落，先记录出现的系统提示或应用错误文字。检查设备上是否还有正在工作的其他 VPN 配置或管理策略，避免多个连接设置互相影响；受管理的设备应遵循组织要求，不要擅自删除管理配置。对自己能够管理的其他连接，先停止再重新尝试。若系统授权已经完成但持续失败，进入最后一步按失败阶段处理。

需要停止时，返回 Home 关闭顶部开关即可。首次排查可以先做一次“关闭 → 确认状态 → 重新开启”的完整操作，让当前配置重新应用；不要连续快速点击开关。待连接状态稳定后，保留当前服务器和 Global Routing 选择，继续下一步验证，这样每次测试都有清楚的起点。

步骤 05 · 从失败发生的位置回查

Settings：按失败点检查

导入后没有可选服务器

先回到订阅条目，确认 Type 使用 Subscribe，地址没有复制缺失，并且已经执行过更新。若列表为空，检查返回内容是否是登录页、错误页或与客户端不匹配的数据，而非反复点击保存。已有服务商侧的有效期、访问限制或链接更换，也会影响更新结果。重新导入前先保留原设置；大量重复条目会让后续选择与排查更困难。

服务器存在，但开关无法保持开启

先核对系统授权是否完成，再检查选中的服务器是否就是刚才填写的条目。手动添加的信息应逐项与原资料比较，特别是端口、认证值、Method，以及协议所需的 TLS 或其他字段。不要用“看起来相近”的值替代缺失参数。订阅导入的条目则先尝试更新，再向用户已有的服务商确认服务器状态。

连接已开启，但部分目标访问失败

先核对 Global Routing 与当前 Config，再检查目标是否被较早的规则分配到 DIRECT 或 REJECT。如果域名解析失败，应检查正在使用的 DNS 设置与网络环境，不要直接更换整份配置。网站登录、目标服务维护、应用缓存和既有连接也可能影响结果；同一个目标在浏览器与其他应用中的差异，需要分别记录，不能用一次成功或失败概括所有请求。

使用 Settings 辅助定位

打开底部 Settings，先查看 Test Method 是否符合当前测试目的，再按需使用 Diagnostics 收集错误信息。On Demand 是按条件触发连接的设置，不是修复订阅或认证错误的开关；首次验证建议先手动建立与停止连接，确认基础路径可用后再安排自动连接条件。

Settings 中还可以看到 Proxy、TCP、UDP 等相关设置。不要因为某个目标打不开就逐项修改这些选项；先记录原值，只改与现象直接相关的一项，并在没有改善时恢复。向已有服务商描述问题时，说明网络类型、Global Routing 姿态、错误文字与复现步骤即可；分享截图或 Diagnostics 内容前，移除订阅地址、密码、认证参数和其他私人信息。

如果仍未解决，按“导入失败、连接失败、连接后访问失败”归类后阅读FAQ 故障排查。涉及规则匹配、DNS 或配置字段的进一步修改，再进入配置字段参考。先确定故障发生在哪一步，比同时重置所有选项更容易保留有效信息。