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

先区分手里的资料是哪一种：一条订阅链接、一个服务器分享链接，还是逐项列出的服务器参数。订阅链接用于获取一组条目，手动参数只描述一个服务器；两者入口相近，但不能混填。打开 Shadowrocket，在 Home 的 SERVER 分组附近找到 Add Server，或使用页面上的添加入口。进入后先看 Type，不要直接把整条订阅链接粘进 Host。

已有订阅链接：选择 Subscribe

在 Add Server 中打开 Type，选择 Subscribe，再把用户已有的完整订阅链接填入相应 URL 字段。复制时保留问号后的参数，不要夹入聊天消息中的引号、空格或换行；如果链接已经被截断，应回到原始来源重新复制，而不是凭印象补全。备注只用于辨认来源，可以写容易区分的名称，不要把备注当作认证内容。

保存后回到 Home，对该订阅执行更新，等待列表加载。获取成功后应能看到实际服务器条目，而不只是一个订阅名称。若只有名称却没有展开的内容，先确认是否完成更新，再进入本页的失败点排查。以后更新订阅可能增删条目，因此更新后还要检查当前选中的服务器是否仍存在。

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

手动添加时，先按资料选择 Shadowsocks、VMess、VLESS、Trojan 等对应 Type，再逐项核对 Host、Port 及该类型显示的认证字段。官方截图展示的是其中一种字段组合；不是每种协议都同时出现 Password 与 Method，也不能把一种协议的参数照搬到另一种。涉及 TLS、传输方式或其他附加字段时，以已有服务器资料为准，不确定的字段不要随意切换。

已有二维码可使用 Scan QR Code 导入，识别后仍需核对 Type 与目标地址。Import from Cloud JSON 是另一类导入入口，只在已有兼容资料时使用，不应把它当作通用订阅输入框。服务器分享链接也应通过对应的导入方式处理，不要拆成猜测的参数。保存前再次核对端口、认证内容和空格，保存后回到 Home 选中准备使用的条目。

本步完成标志：Home 中已有可选服务器，且能够明确指出当前选中了哪一条。暂时不用打开连接开关；下一步先决定请求采用规则分流还是统一处理。订阅链接可能包含访问凭据，分享截图或诊断记录前要遮盖完整链接和认证字段。

返回 Home，打开 Global Routing。这里的三种姿态写作配置(Config) / 代理(Proxy) / 直连(Direct)。它们决定请求如何进入后续处理，不是三种服务器协议。选中服务器解决的是“使用哪条已有连接资料”，选择 Global Routing 解决的是“请求如何处理”，两项需要分别确认。

日常规则分流：配置(Config)

希望依据域名、IP 等规则决定路径时，选择配置(Config)，随后到 Config 确认当前启用的配置文件。订阅导入通常用于维护服务器列表，不能据此推断规则配置也已完成。打开正在使用的配置，查看 General、Rule 等分段；如果有多份文件，先确认当前选中的文件，再进入编辑，避免改了另一份却一直看不到变化。

Rule 中的条目按顺序参与匹配，先命中的规则决定后续策略；FINAL 用于前面的规则未命中时收尾。若规则引用 PROXY 或某个策略组，还要确认该名称在当前配置中有对应定义和可用选择。下面仅用一行说明结构，不是一份可直接替换当前文件的完整配置：

DOMAIN-SUFFIX,example.com,PROXY

其中 DOMAIN-SUFFIX 是规则关键字，example.com 是示例域名，PROXY 是策略引用。添加规则前先保留当前配置副本，不要为完成首次连接而同时修改 Hosts、URL Rewrite、HTTPS Decryption。首次上手只需确认已有配置正在使用、规则引用没有遗漏；具体关键字含义可查术语表，复杂匹配问题再看排查手册。

定位问题：代理(Proxy)与直连(Direct)

代理(Proxy)适合短时比较所选服务器能否处理实际请求；直连(Direct)让请求直接访问，可用来比较本地网络表现。切换姿态不会修复错误的服务器密码，也不会自动补齐缺少的配置。若 Proxy 可以访问而 Config 不行，应优先检查规则和策略引用，而不是立刻重新导入全部服务器。

本步完成标志：能够说清当前姿态，以及在 Config 下究竟使用哪份配置。完成测试后要回到原计划使用的姿态，避免把临时的 Proxy 或 Direct 当成长期设置而忘记恢复。

回到 Home，先看 SERVER 分组中的选中项，再看 Global Routing。第一次操作时建议固定一个服务器完成整个验证流程，不要在每次测试前换一条，否则无法判断变化来自服务器、模式还是本地网络。若刚更新过订阅，重新核对一次选中项，尤其注意同名条目或已被更新移除的条目。

顶部显示 Not Connected 时，打开连接开关。首次建立连接，系统可能要求允许添加 VPN 配置，并要求设备密码或生物认证。先确认操作是由刚刚打开的 Shadowrocket 发起，再按系统提示完成授权。若取消了授权，返回应用重新发起即可；不要在系统确认框尚未处理完时连续点按开关。

授权后等待状态更新。开关开启、应用显示连接状态变化，表示本地隧道已尝试建立；它不等于远端服务器已经能够访问所有目标，也不代表 Config 的每条规则都正确。看到状态改变后，保留当前服务器与模式，接着执行下一步测试。若开关立即回落到关闭状态，先记录系统提示，而不是继续修改 Rule。

设备同时启用其他 VPN 连接或网络扩展时，可能影响本次连接。先结束当前不需要的 VPN 会话，再回到 Shadowrocket 进行一次可重复的连接测试。受管理设备若限制添加 VPN，应查看设备管理政策或联系管理员，不要反复删除不清楚用途的描述文件。

要主动断开时，回到 Home 关闭开关；如果关闭后又自动连接，再去 Settings 检查 On Demand 是否启用及其触发条件。先理解自动连接来源，再决定是否暂时关闭该功能。本步完成标志：开关状态能够保持，且已记录当前服务器与 Global Routing，随后通过实际请求验证。

排错顺序是“订阅内容能否取得 → 服务器能否测试 → VPN 能否保持连接 → 实际请求能否完成”。先解决最早失败的一环，再继续往后。打开 Settings，可以看到 Test Method、On Demand、Diagnostics 等入口；本页只处理首次连接需要的检查，不要求修改 Proxy、TCP、UDP 的全部选项。

订阅更新失败或列表为空

先区分下载失败和解析后没有条目。下载失败时，检查本地网络能否正常访问普通页面、订阅链接是否完整，以及原有凭据是否仍有效。下载完成但列表为空时，确认链接返回的是兼容的订阅内容，而不是登录页面或错误说明。不要在公开页面粘贴完整链接求助；需要向原资料提供方核实时，只发送必要的错误提示和已隐藏凭据的截图。

Connectivity Test 超时

在 Settings 查看 Test Method，明确当前测试的条件，再回 Home 对同一条目复测。超时可能与测试方法、服务器地址、端口或所在网络有关，不能仅凭一次结果认定所有配置都失效。手动添加的条目应重新对照 Type、Host、Port 与认证字段；订阅条目则先更新，再确认选择没有改变。若改用另一个本地网络测试，应单独记录这个变化。

开关打不开或连接后不能访问

开关立即关闭时，先检查系统 VPN 授权、其他 VPN 会话以及设备管理限制。开关能够保持但访问失败时，按照上一节比较 Config、Proxy 与 Direct，再决定检查服务器、规则还是 DNS。不要因为域名打不开就立即修改所有 DNS 选项；先观察错误是否只发生于域名请求，以及是否存在某条规则或策略引用不一致。

自动重连、单个应用异常与诊断记录

关闭开关后自动重连，先查看 On Demand 的触发条件；单个应用异常，先确认该应用是否重新建立了连接，而不是沿用此前会话。确需诊断时打开 Diagnostics，记录失败发生时的操作、所选模式和错误信息。诊断记录可能包含目标域名、服务器地址或认证相关信息，分享前逐项检查并遮盖敏感内容。

每次只修改一个设置，复测同一目标；没有改善就恢复原值，避免把临时尝试积累成新的问题。成功后保留当前可用配置副本，再逐项添加进阶功能。更多症状对应流程见排查手册，购买与恢复问题见问答，协议和规则名词见术语表。首次上手到这里即可结束，不必同时配置所有功能。