Shadowrocket 使用教程
订阅导入与连接验证

STEP 01 / IMPORT

Add Server 与 Subscribe 导入

打开 Shadowrocket，进入 Home。先分清手中的资料：订阅链接通常用于一次获取并更新一组服务器；单个服务器的信息则包含协议、地址、端口及认证参数。两类资料走不同的填写路径，不要仅凭链接看起来很长，就认定它属于 Subscribe。若不清楚资料类型，应先查看提供方对该资料的说明。

已有订阅链接：选择 Subscribe

在 Home 点右上角加号，进入 Add Server，打开 Type 并选择 Subscribe。在 URL 中粘贴自己的完整订阅链接，再填写一个方便辨认的名称并保存。粘贴后核对开头、结尾以及查询参数，去掉聊天消息附带的引号、空格或换行，不要自行删去链接后半段。订阅地址可能带有访问凭据，应只在自己设备的应用中使用。

保存后返回 Home，等待首次获取完成，或对该订阅执行更新。订阅分组下出现服务器条目，才说明客户端取得并识别了内容；只看到一个订阅名称，不代表服务器已经导入成功。若列表为空，先停在这里检查链接和更新结果，不必继续尝试连接开关。

https://example.com/sub?token=xxxx

上方仅用于说明地址结构，不是可用订阅。实际操作应粘贴用户自己的链接，不要把示例填入应用。

已有服务器信息：按协议填写

如果拿到的是单个服务器的参数，同样从 Home 的加号进入 Add Server，但 Type 应选择资料指定的协议，而不是 Subscribe。随后逐项核对 Address、Port 及该协议要求的认证字段。Shadowsocks、VMess、VLESS、Trojan 等协议的字段并不完全相同，不能照着另一种协议的表单填写，更不能凭经验猜测加密方式或传输参数。

资料若包含 TLS、服务器名称或传输相关参数，应按原始资料填写；地址和证书校验使用的名称可能不同，不要随意合并成同一个值。使用自己的服务器分享链接或 Scan QR Code 导入后，也应打开条目检查关键字段。保存成功仅说明条目格式能够被接受，不代表远端一定可用。

回到 Home 后，点选准备使用的服务器，确认选中标记落在预期条目上。首次验证只使用一个明确的条目，不要连续切换多个服务器后再判断结果。至此，导入步骤的完成条件是：列表里有实际服务器、参数可查看、当前选择明确。接下来再决定这些服务器如何参与连接。

STEP 02 / GLOBAL ROUTING

Global Routing 三种姿态

在 Home 打开 Global Routing，选择本次验证所需的姿态。这里决定流量按什么方式处理，与“当前选中哪个服务器”是两件事。教程使用固定写法：配置(Config)、代理(Proxy)、直连(Direct)，括号内为界面中需要查找的英文名称。

首次导入后，如果只是想确认所选服务器能否承载实际请求，可以先选择代理(Proxy)，完成一次测试后再按需要切回配置(Config)。这是一种排查顺序，不表示日常使用必须保持 Proxy。切换姿态后返回 Home，重新核对显示值，避免以为已经切换，实际上仍停留在原来的选项。

准备使用配置(Config)时，进入 Config 页，检查当前选中的配置文件。订阅中的服务器列表与 Config 中的规则文件作用不同：前者提供连接条目，后者决定请求匹配哪些规则、采用哪些策略。更新订阅不等于更新规则，导入了服务器也不等于已经选好了规则配置。使用自己已有的配置前，应保留原文件，并确认其中引用的策略能够找到预期服务器或策略组。

不要为了首次连接就复制一整套不理解的规则。先把单个服务器的路径验证清楚，再处理分流。关于 DOMAIN-SUFFIX、PROXY、DIRECT 等关键字的含义，可查阅术语手册；本页不展开规则优先级与复杂策略组合。选好姿态后，继续完成系统连接授权。

STEP 03 / CONNECT

打开连接开关与系统授权

返回 Home，依次确认选中的服务器、Global Routing 的当前值，以及本地 Wi-Fi 或蜂窝网络本身可以使用，再打开顶部连接开关。首次连接时，系统可能提示允许 Shadowrocket 添加 VPN 配置；这是建立系统网络连接所需的授权步骤，不是订阅更新，也不是再次购买应用。核对应用名称后，按系统提示允许并完成设备验证。

完成授权后回到 Shadowrocket，查看开关是否保持开启。系统的 VPN 状态也可以作为连接状态参考，但它只表示系统连接已建立，不能证明每个目标都能访问，更不能证明每条请求都经过所选服务器。必须继续执行下一步的实际验证，不能停在“开关已打开”就结束。

如果拒绝过系统授权，或开关刚打开又关闭，不要立刻删除服务器。先再次触发连接，查看是否出现授权提示；再检查系统设置中的 VPN 配置状态，以及是否有其他 VPN 连接正在工作。排查期间先结束其他 VPN 连接，避免同时切换多个网络配置。设备受组织管理时，系统策略也可能限制添加配置，应向设备管理方确认允许的操作。

首次手动连接尚未稳定时，先不要配置 On Demand。它负责按条件触发连接，不会修复错误的订阅地址或服务器参数。先确认手动开启、关闭都符合预期，再单独设置自动触发条件。iPad 同样遵循这一顺序；界面排布可能因设备与应用更新而变化，以当前应用中的英文项目名称为定位依据。

STEP 04 / VERIFY

Connectivity Test 与实际验证

连接开启后，先对当前服务器运行 Connectivity Test，观察是否得到测试结果。测试用于提供连通性线索，不是完整的访问保证：测试目标、协议路径与实际网站请求可能不同，一次测试成功不代表所有请求都会成功；单次超时也不能直接判定服务器永久失效。先保留当前服务器和姿态，避免测试过程中引入新的变量。

接着打开浏览器，访问一个熟悉且有权访问的目标，重新加载页面，确认能否完成正常请求。尽量不要只看已经打开的旧页面，因为缓存可能掩盖连接状态。若需要比较，记录同一个目标在连接关闭、代理(Proxy)以及配置(Config)时的表现；每次改变状态后重新发起请求，不要同时更换网络和服务器。

能访问，还要确认走向

网站能够打开，不等于它经过了代理。在配置(Config)姿态下，某些请求本来就可能匹配 DIRECT。需要确认分流时，查看应用内相应的请求记录，结合目标域名、匹配规则与最终策略判断。Data 页的流量变化可以辅助观察，但后台活动也会产生流量，不能把某个数字变化直接归因于刚才那次网页访问。

如果 Proxy 可以访问、Config 不行，应优先检查当前配置中的匹配规则及策略指向；如果 Direct 可以访问、Proxy 不行，应回到所选服务器与远端连接路径检查。两者都不行时，先确认本地网络和目标本身是否正常。这个对照只用于缩小范围，不替代对具体错误记录的判断。

验证通过的标准应具体：所选服务器的测试有可解释的结果、目标请求能够完成、需要分流的请求走向符合预期。完成后切回日常需要的 Global Routing，再对同一目标检查一次。记录当前可用服务器和配置名称，后续发生异常时就有明确的对照，而不是重新从所有设置中猜测。

STEP 05 / CHECKPOINTS

按失败位置检查

遇到问题时，从最早没有完成的步骤开始。列表没有服务器，就先解决导入；开关不能保持开启，就先解决系统连接；只有某个目标失败，再检查该目标的规则和解析。不要把所有问题统一处理成重装应用，重装可能丢失本地配置，也无法修复远端失效的链接。

Subscribe 保存后没有条目

重新打开订阅设置，核对 URL 是否完整，是否混入空格、换行或消息中的标点。确认粘贴的是订阅地址，而不是账户网页地址。执行一次更新并观察结果；若内容为空、格式不能识别或链接已失效，应向自己的提供方核对链接状态及适用格式。不要将完整订阅地址贴到公开讨论区，因为其中可能包含个人访问凭据。

如果此前一直可更新、当前突然失败，先确认普通网络访问正常，再比较同一订阅在当前网络下是否能够获取。不要反复新增相同订阅来碰运气，重复分组会让后续选中条目更难辨认。订阅更新与应用更新也是不同操作：前者刷新服务器信息，后者通过 App Store 更新客户端。

开关已开启，但服务器测试超时

先检查服务器地址、端口和认证参数是否与原资料一致，再检查该协议附加的 TLS 或传输参数。尝试切换到自己可用的另一种本地网络，保持服务器不变进行对照；若换网络后恢复，优先检查原网络路径。若多个网络下均失败，再向自己的服务器管理方核对远端状态，而不是任意修改端口或关闭必要校验。

若只有导入后的某个条目失败，可选同一订阅中自己已有的另一个条目进行对照，但要记录切换前后的结果。一次只换服务器，不同时换 Config 和 DNS。测试偶尔成功但实际请求仍失败时，继续看具体目标和错误记录，不要仅凭测试结果反复开关连接。

Proxy 正常，Config 下部分目标失败

确认 Config 页选中的确实是预期文件，随后查看失败请求命中了什么规则。规则可能指定了 DIRECT、REJECT，或指向未正确设置的策略组；服务器本身可用，并不代表每条规则都引用了它。先定位相关规则再修改，保留原文件，避免用整份替换的方式掩盖真正原因。

如果域名访问异常而其他连接看起来正常，应把 DNS 纳入检查，但不要同时更换多个解析设置。先记录当前方案，在明确原配置含义后作单项对照；遇到证书提示时也不要直接忽略，应检查目标名称、设备时间和相关连接参数。DNS、TLS 与规则问题的完整流程见故障排查手册。

切换网络或回到应用后出现异常

先手动断开并重新连接，确认新网络本身可用，再检查服务器与 Global Routing 是否仍是刚才验证通过的组合。如果已经配置 On Demand，记录触发条件，必要时暂时关闭自动触发，只验证手动连接。不要在基础连接未稳定时叠加自动化设置，否则很难区分是触发条件问题，还是服务器连接问题。

完成本页后，应能在 Home 找到自己的服务器，说明当前姿态的含义，手动开启与关闭连接，并通过实际请求确认结果。日常只需按需要更新订阅、保留可用配置，并在调整后重复验证。购买与授权问题可继续查看常见问题；不熟悉的英文项目可查术语手册，持续性故障再按排查手册逐项深入。