Shadowrocket
订阅导入与首次连接

01 添加服务器或导入已有订阅

先判断手中的资料属于哪一种：一条订阅链接、单个服务器的分享信息，或需要逐项填写的服务器参数。它们的导入方式不同，不必把同一份资料依次尝试所有入口。订阅通常用于获取和更新一组服务器条目；单个服务器信息则用于建立一项连接记录。订阅也不等同于规则配置文件，导入成功后仍需在下一步检查 Global Routing。

已有订阅链接：Add Server → Subscribe

打开 Shadowrocket，进入 Home，点击右上角的添加按钮进入 Add Server。在 Type 中选择 Subscribe，再把你已有的完整订阅链接粘贴到 URL 字段；可填写便于辨认的备注。链接应保持原样，尤其不要删掉问号后面的参数，也要检查首尾是否带入空格、换行或聊天消息的说明文字。确认后使用页面右上角的保存操作，返回 Home 等待获取结果。

导入完成后，应能在 Home 看到相应分组或服务器条目。此时先核对条目是否实际出现，而不是只看订阅名称是否已保存：保存了一个地址，并不代表远端内容已经成功读取。如果只有分组而没有可选条目，先检查当前网络能否读取该链接、链接是否仍有效，以及提供方返回的内容是否为可识别的订阅格式。不要为了让列表出现而随意改动链接参数。

已有单个服务器：按 Type 填写参数

如果拿到的是服务器地址、端口、密码及协议参数，在 Home 打开 Add Server，并先选对 Type。例如提供的信息是 Shadowsocks，就选择对应类型后再填写；不要只因为地址和端口相同，就改选另一个协议。不同 Type 会显示不同字段，应逐项对照你的资料，填写认证信息、加密方式以及适用的传输设置。没有提供的可选参数不要凭经验补入。

已有二维码时，可以通过 Scan QR Code 读取你自己的服务器分享信息，并按系统提示授予相机权限。导入后仍应打开条目核对 Type、地址与端口，不能把“扫码成功”直接等同于“服务器可用”。若使用手动填写，保存后回到 Home，确认新条目存在，点击其中一项作为当前使用的服务器。首次测试只选一项，避免在尚未记录结果时反复切换。

订阅链接与服务器认证信息可能包含访问凭据。排查时不要把完整链接、密码或二维码发到公开位置；记录问题可以保留错误提示与字段名称，隐藏实际值。完成导入后，接下来需要决定请求如何处理，而不是立即修改所有 Settings。关于订阅、服务器条目与配置文件的区别，可先查阅术语手册。

02 选择 Global Routing 姿态

回到 Home，打开 Global Routing。首次使用时先认清三种姿态：配置(Config)、代理(Proxy)、直连(Direct)。这项选择决定整体路由方式；Home 中选中了哪一项服务器，则决定需要使用服务器时采用哪一项连接信息。两个选择解决的是不同问题，不能用“服务器已经选中”来判断请求一定会经过它。

配置(Config)：先确认正在使用的规则文件

配置(Config)按当前配置文件中的规则处理请求。若你已有可信来源的规则配置，进入 Config，核对当前实际启用的文件，而不只是确认文件已经出现在列表中。随后回到 Global Routing 选择 Config。规则可能把不同请求交给 PROXY、DIRECT 或 REJECT，因此同一时刻不同目标出现不同结果，并不必然说明连接失效。

如果目前只有订阅链接，而没有明确准备规则文件，不要假定导入订阅后就已经配置好所需分流。先确认 Config 的当前内容及其来源，再决定是否使用这套规则。规则从上到下匹配，前面的命中结果会影响后续处理；初次连接阶段无需逐条编辑，先保留可追溯的原始配置。规则关键字与策略的具体含义见术语手册。

代理(Proxy)与直连(Direct)：用于区分处理路径

代理(Proxy)将一般请求交由当前所选服务器处理，适合在首次排查时暂时减少规则分流带来的变量。如果不确定 Config 是否影响目标访问，可以记录原来的姿态，临时选择 Proxy，然后用相同目标进行一次对照测试。这是检查所选服务器的一种方法，不表示所有日常使用都必须保持 Proxy，也不构成对任意目标可达性的保证。

直连(Direct)让一般请求直接连接目标，不经所选代理服务器。它可用于观察当前网络的直接访问情况，但不能据此验证服务器工作正常。测试时若停留在 Direct，即使 Home 已选中某个服务器，也不应把网页打开成功解释为该服务器已经生效。选定本次姿态后返回 Home，记下所选服务器与 Global Routing；下一步才打开连接开关。

03 打开连接开关并完成授权

在 Home 再确认一次当前服务器与 Global Routing，然后打开页面顶部的连接开关。首次建立连接时，系统可能弹出添加 VPN 配置的授权提示。这一步是允许 Shadowrocket 在系统中建立所需的网络配置，不是在添加另一份订阅，也不会替你补全服务器参数。确认提示对应刚刚发起的操作后允许添加，并按系统要求完成设备认证。

如果当时选择了不允许，连接通常无法继续。回到 Shadowrocket 再次尝试开启，并核对系统是否重新显示授权提示；也可以到系统 Settings 中查看 VPN 配置状态。不要为了尝试恢复而一次删除多份不明用途的配置，特别是受管理的设备，应先确认是否存在组织策略限制。应用没有拿到所需权限时，反复更换服务器并不能解决权限环节的问题。

完成授权后返回 Home，观察开关能否保持开启，并等待连接状态稳定。若开关刚打开就立即关闭，先保留当时的提示内容，检查所选条目是否完整、系统配置是否建立成功，以及是否有其他正在生效的 VPN 连接。若开关保持开启，也仍需继续验证；系统显示 VPN 状态只能说明系统连接配置处于相应状态，不能单独证明服务器认证、目标访问和规则匹配都正确。

这一轮先保持手动操作，不同时启用 On Demand 或更改多个 Settings 项。需要换服务器时，建议先关闭连接，选择另一项，再重新打开，保持每一轮测试的输入清楚。iPad 上也按 Home、服务器选择、Global Routing、连接开关的顺序检查；界面布局可能随设备与应用显示不同，但核对的对象不变。

当开关能够保持开启，接下来要检查真实请求。先不追求测试数值高低，优先确认“选中的条目、路由姿态、实际访问结果”能够对应起来。

04 验证连接是否按预期生效

先在 Home 使用 Connectivity Test 对已有服务器进行测试，并留意当前测试方式。测试有响应说明该测试条件下得到了结果，并不代表每个网站、每种协议或每条规则都会成功；测试超时也需要结合测试目标和当前网络判断。首次验证应同时保留测试结果与网页访问结果，而不是只凭某一个数值挑选结论。

按同一顺序完成三项核对

1. 确认 Home 当前选中的确实是刚才测试的服务器。订阅更新或手动切换后，应重新看一次选择状态，避免测试一项却连接另一项。
2. 打开一个平时可访问的页面，确认设备的基本网络请求可以完成；再访问本次需要验证处理路径的目标。可刷新页面或打开新的页面，避免只看到先前缓存的内容。
3. 回到 Shadowrocket，结合 Data 中可查看的连接记录，以及当前 Global Routing 与 Config 的规则判断处理结果。记录展示的细节可能不同，应以实际界面内容为准，不把某个字段缺失直接解释为异常。

若使用配置(Config)，两个目标可能分别命中 DIRECT 与 PROXY，结果应结合规则解释。需要比较时，只临时切换到代理(Proxy)，保持服务器和目标不变再试一次。如果 Proxy 可以访问、Config 不可以，下一步应优先检查规则与对应策略，而不是立即重填服务器密码。完成对照后恢复原先打算使用的姿态，以免把测试设置留作日常配置。

若 Connectivity Test 有响应，但网页持续加载失败，也不能简单归结为速度慢。认证、传输参数、DNS 解析、目标本身及规则都可能影响实际请求。先观察失败是所有目标一致发生，还是仅一个目标出现，再决定检查范围。单个页面失败不适合用来概括整个连接状态；同样，一个页面成功也不足以说明所有分流都符合预期。

验证通过后，记住一组可重复的检查条件：使用哪项服务器、哪种 Global Routing、哪个目标，以及连接时所处的网络。以后修改 Config 或开启 On Demand 时，可以用同一组条件回测。记录中不必保存密码与完整订阅链接，只需要能辨认条目和操作顺序的信息。

05 按失败环节检查常见问题

出现问题时先定位停在哪一步：资料没有导入、服务器测试没有结果、开关不能开启，还是开启后访问不符合预期。每次只改变一项，然后重复刚才的测试。把订阅、服务器参数、Global Routing 和 DNS 同时改动，往往会丢失原来的线索，也难以确认哪项调整真正起作用。

订阅已保存，但没有服务器条目

先检查 URL 是否为自己的完整订阅链接，再确认当前网络是否能读取它。登录页面、错误页面或格式不符的内容，即使能返回，也不等于可导入的订阅。如果此前有可用条目，不要在更新失败时立即全部清空；保留现有记录，核对链接有效性与服务状态。需要向原提供方询问时，可描述错误提示和发生环节，不公开完整链接。进一步说明见常见问题中的订阅导入分类。

条目存在，但 Connectivity Test 超时

打开该条目，按原始资料逐项核对 Type、服务器地址、端口、认证信息与传输参数，注意数字、大小写及复制时带入的空格。已有订阅管理的条目若被手动修改，后续更新还可能改变这些内容，应先确认当前值的来源。再使用你已有的另一项服务器做对照；若只有一项失败，优先检查该项信息与服务状态，若全部失败，则同时检查设备当前网络是否正常。

开关立即关闭，或授权没有完成

先检查系统添加 VPN 配置的提示是否已经允许，再看条目是否缺少必需字段。若设备正在使用另一项 VPN 连接，先确认其用途并结束不需要的连接，再尝试 Shadowrocket。受管理设备的限制应按其管理要求处理，不能通过改动服务器信息解决。不要把“开关无法保持开启”和“开关开启但网页失败”当作同一种故障；两者的优先检查顺序不同。

连接已开启，但所有页面失败

先关闭连接，确认当前 Wi-Fi 或蜂窝网络本身能完成基本访问，再重新连接并使用相同目标测试。如果 Direct 下可用、Proxy 下失败，优先回到所选服务器和认证参数检查；如果 Proxy 下可用、Config 下失败，则重点看配置文件、规则命中与相关策略。DNS 也可能影响结果，但不要一开始就改成不熟悉的地址；先保留当前设置，确认问题是否只出现在域名解析环节。

只有部分目标异常，或连接后又自动变化

部分目标异常时，记录目标和当前姿态，检查是否命中预期的 PROXY、DIRECT 或 REJECT。订阅更新后条目名称或可用项可能变化，也要重新确认当前所选项。若状态会随 Wi-Fi 切换、锁屏或打开应用变化，再检查 On Demand 的触发条件；先停用自动触发做一次手动对照，不要直接重置全部配置。涉及规则顺序、DNS、耗电或更新后异常的系统化检查，继续阅读故障排查手册。

本篇到此完成首次使用流程。后续不必每次重复添加服务器：日常使用先看当前条目和 Global Routing，出现变化再按本页对应步骤回查。遇到不熟悉的界面词可查术语手册，购买、恢复已购与安装相关问题则见正版下载说明。