Shadowrocket 使用教程

打开 Shadowrocket 后，先停留在 Home，不急着打开顶部开关。查看下方 SERVER 分组；首次使用时，需要先把自己的服务器信息加入这里。如果手中是一整条订阅链接，采用 Subscribe；如果是一组地址、端口、协议和认证信息，采用 Add Server 手动填写。不要把普通网页地址当作订阅，也不要把订阅地址直接填入服务器的 Host。

已有订阅链接：选择 Subscribe

在 Home 点击右上角添加入口或列表中的 Add Server，进入添加页面后，在 Type 中选择 Subscribe。找到用于填写订阅地址的 URL 字段，粘贴自己已有的完整链接，并为这组订阅填写便于辨认的名称。粘贴后检查开头、结尾是否带了空格或换行，尤其注意查询参数有没有在复制时被截断；不要自行删去不认识的参数。

保存后回到 Home，等待订阅内容读取完成，再检查 SERVER 中是否出现对应分组与服务器条目。看到订阅名称不等于已经读取到服务器，应展开分组确认内部确有条目。若列表为空，先停止后续连接步骤，核对链接是否仍有效、当前网络是否能读取该地址，以及自己的订阅状态。不要连续重复导入同一链接，否则相同分组会使后续选择更难辨认。

已有单个服务器信息：逐项填写

进入 Add Server 后，先选 Type，再按该协议显示的字段填写。Host 是服务器域名或地址，Port 是连接端口；例如 Shadowsocks 还需核对 Password 与 Method。不同 Type 的认证与传输字段并不相同，应完整照录已有资料，不要仅凭名称相似就更换协议，也不要根据其他服务器猜测加密方式。截图展示的是其中一种字段组合，不是所有协议都使用同一张表。

确认后保存，回到 Home 找到刚添加的条目。可以使用已有的二维码，通过 Scan QR Code 导入，并在系统询问时授予相机访问权限；导入后同样要检查 Type、Host 与 Port。Import from Cloud JSON 面向已有相应格式配置的情况，普通订阅无需为此转换格式。剪贴板、二维码和订阅链接可能包含认证资料，不要把完整内容贴到公开页面或交给他人排错。

完成本步的标志是：SERVER 中有能够选中的真实服务器条目，而不只是一个分组标题。订阅更新、多订阅整理与备份请继续查看节点管理手册；首次连接先保留一组清晰可辨的配置，进入下一步选择路由模式。

保存服务器后回到 Home，点击 Global Routing，查看当前选中的姿态。这里的三种常用选择是配置(Config)、代理(Proxy)、直连(Direct)。首次设置时先明确目标：是验证已有服务器是否能用，还是按现有规则分别处理不同网站。模式与服务器选择是两个独立条件，只改服务器而不检查模式，可能得到与预期不同的结果。

配置(Config)：按当前配置匹配

选择配置(Config)后，请求按当前启用配置中的规则与策略处理。随后打开底部 Config，确认已有可用配置，并核对当前启用的文件；仅把文件加入列表不等于它正在生效。进入配置编辑页时，可以看到 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 等分段。首次使用重点检查 Rule，不需要为了建立连接就修改所有分段，也不需要先开启 HTTPS Decryption。

规则通常按排列顺序检查，较明确的匹配应放在前面，最终策略放在末尾。以下片段用于理解“指定域名后缀走 PROXY，其余走 DIRECT”的结构，example.com 是教学域名，不是服务器地址。只有在自己的配置中相应策略有效、规则位置正确时，这种写法才符合预期；不要把示例整段覆盖到尚未备份的现用配置中。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

代理(Proxy)与直连(Direct)：用于明确路径

代理(Proxy)用于让经客户端处理的请求采用代理路径，适合短暂验证选中的服务器；它不表示逐项执行 Config 里的分流规则。直连(Direct)则采用直接连接路径，不能用来证明代理服务器已经工作。如果此前一直在 Direct 下测试，网站可以打开，也不能据此确认刚导入的服务器有效。

如果已有可信且明确用途的配置，选择 Config 并核对当前文件；若只是隔离“服务器能否连接”这一问题，可以临时选择 Proxy 测试，完成后再切回预期模式。修改前记住原来的选择，每次只改一个条件。更完整的规则策略与配置管理说明见功能与设置，本页接下来先完成系统连接。

回到 Home，在 SERVER 中点选准备使用的服务器，确认选中标记对应的是目标条目，而不是同名的另一条记录。订阅中有多个服务器时，首次测试先固定一条，避免在排错过程中同时改变服务器与模式。再看一遍 Global Routing 的当前值，确认它与上一步的选择一致。

点击 Home 顶部连接开关。首次建立连接时，系统会询问是否允许添加 VPN 配置；阅读提示后确认，并按设备要求完成密码或生物识别验证。这一步是允许客户端建立系统网络连接配置，不是订阅登录，也不会自动补齐缺少的服务器认证信息。系统提示中不应要求你另行提供订阅密码给本站。

完成系统确认后回到 Shadowrocket，观察顶部原先的 Not Connected 状态是否改变，以及开关是否保持开启。如果开关立即回落，先核对系统授权是否完成、选中的服务器字段是否齐全，再进入本页排错步骤。此前若取消了提示，可以重新尝试连接；仍有问题时，到设备“设置”中的 VPN 管理位置检查对应配置，具体入口名称可能随系统而变化。

顶部连接状态表示系统隧道是否已建立，并不是目标网站已经访问成功的证明。服务器认证、域名解析、规则选择与目标站点响应仍可能在后续请求时失败。因此，即使看到连接状态正常，也应继续进行 Connectivity Test 与实际网页验证，不要停在开关变色这一步。

首次测试期间，建议保持前台操作，先不要叠加 On Demand 等自动连接条件。需要暂停时，回到 Home 关闭连接开关；改完关键配置后，再按界面需要重新连接并复测。若系统中另有正在使用的 VPN 配置，先确认当前实际启用的是哪一个，避免把其他连接的状态误认为本次结果。

导入后没有服务器条目

回到 Subscribe 对应记录，核对完整 URL，检查是否复制了页面说明文字、缺少参数或多了换行。确认当前网络可以读取订阅，并向你已有服务的提供方核实订阅状态与内容格式。订阅更新只是重新读取远端内容，不会修复远端已经失效的认证资料。先保留原记录与必要备份，再做修正，不要靠反复删除和重建来掩盖失败原因。

列表有条目，但测试失败

先比较另一条自己已有的服务器，判断是单个条目失败还是全部失败。手动填写的配置重点核对 Type、Host、Port、Password、Method，以及该协议要求的传输和认证字段。区分数字端口与地址，不要把带协议前缀的整段分享链接填进 Host。若全部条目都失败，检查设备网络是否本来就能正常访问，再对比不同网络；不要直接批量修改所有服务器。

进入 Settings 查看 Test Method，确认正在使用哪种测试方式。测试方式的差异会改变结果含义，所以应结合实际请求判断，而不是反复切换测试方法直到出现数字。发现认证失败或连接超时一类信息时，记录具体错误与出现阶段，随后检查对应配置；不要只保留一句“连不上”。

连接开启，但部分网站或后台连接异常

确认 Global Routing 和当前 Config，再检查目标域名是否命中预期规则。如果临时改用 Proxy 后能够访问，而 Config 下失败，优先检查规则、策略与 DNS 相关设置。这样的对照用于缩小范围，不是要求长期保持 Proxy。不要通过随意启用 HTTPS Decryption 或批量改动 TCP、UDP 设置来尝试修复所有问题。

在 Settings 中，On Demand 用于配置按条件触发的连接行为，不负责提高服务器本身的可用性。首次手动连接稳定后再设置它；若出现自动重连、切换网络后的行为不符合预期，先检查现有 On Demand 条件，再复测。对于后台耗电，结合设备电池用量与实际使用时段观察，不以“开关开启多久”单独下结论。

需要进一步定位时，查看 Settings 中的 Diagnostics。保留错误发生时间、网络类型、模式与具体失败目标即可；分享诊断内容前，应遮去订阅 URL 中的认证参数、密码与个人地址信息。不要把完整配置公开。更多分类解答见常见问题，订阅更新、排序、删除与备份见节点管理手册。