Shadowrocket 使用教程

步骤 01 / 先让服务器出现在列表中

Add Server / Subscribe：添加与导入

先判断手里的信息是什么：一条用于更新服务器列表的地址是订阅链接；包含 Type、Host、Port 与认证字段的一组信息，通常用于手动添加。两者入口不同，不要把订阅地址直接填进 Host，也不要仅凭链接开头就猜测协议。应以服务商提供的说明为准，保留原始信息，便于之后逐项核对。

使用 Subscribe 导入已有订阅

打开 Config，找到 Subscribe 入口并添加已有订阅，填写便于辨认的名称，将完整链接粘贴到对应地址栏后保存。粘贴时检查首尾是否带空格、换行或中文标点，尤其不要遗漏问号后面的参数。随后执行更新，等待返回结果，再回到 Home 查看 SERVER 分组中是否出现服务器条目。仅保存了地址，并不等于已经成功取回服务器列表。

如果更新后列表仍为空，先查看更新反馈，不要反复创建相同订阅。链接过期、认证参数缺失、当前网络无法访问订阅地址，都可能使更新失败。可以请服务商确认链接状态，但不要将完整链接贴进公开截图或讨论区；其中的参数可能代表个人访问权限。

使用 Add Server 手动填写

只有单台服务器信息时，在 Home 的 SERVER 分组进入 Add Server。先选择 Type，再填写对应字段，因为 Type 会影响后续需要的认证方式。以截图中展示的字段为例，Host 填服务器域名或地址，Port 填端口，Password 与 Method 按原始信息填写。Host 通常不是网页地址，不应附带页面路径；Port 应与服务端一致，不能把测试端口替代为连接端口。

不同协议的字段并不相同。选择 VMess、VLESS、Trojan 或 Hysteria2 后，如果出现额外认证或传输选项，应按该协议的信息填写，不能把所有认证值都当作 Password。服务器地址与 TLS 相关名称也可能不同，缺少字段时应先确认原始配置，而不是尝试关闭相关检查。

已有二维码时，可使用 Add Server 底部的 Scan QR Code，允许相机访问后扫描并核对导入结果。Import from Cloud JSON 用于相应 JSON 配置，不是普通订阅地址的替代入口。若系统提供剪贴板导入提示，确认剪贴板确实是自己的分享链接再继续；导入完成后同样检查 Type 与地址是否符合预期。

保存后返回 Home，确认新条目出现在 SERVER 列表，并设置容易辨认的名称。此时只完成了“添加”，尚未确认连接可用。下一步先选择 Global Routing，再选中服务器开启连接，避免把规则问题误判成导入失败。

步骤 02 / 决定请求怎样处理

Global Routing：选择三种姿态

回到 Home，点击 Global Routing，按当前目的选择配置(Config) / 代理(Proxy) / 直连(Direct)。这三项决定流量如何处理，不会替代服务器信息，也不会修复已失效的订阅。首次使用时应先弄清选中的模式，再判断一个页面是否应当经过代理。

配置(Config)：按当前规则分流

有明确配置文件时，选择配置(Config)，并到 Config 确认当前启用的是预期文件。配置中的 Rule 决定匹配到的请求交给哪种策略：DIRECT 表示直连，REJECT 表示拒绝，PROXY 表示交给相应代理策略。规则通常按顺序匹配，前面的命中结果会影响后续处理，因此不能只看某一条规则是否存在。

截图展示的是 Config 内的配置文件编辑页，可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。它不是 Subscribe 地址填写页。首次连接不需要逐段修改，更不需要开启 HTTPS Decryption；先使用已经确认用途的配置，后续再逐项学习。修改前保留原配置副本，便于恢复。

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

代理(Proxy)可用于检查所选服务器的代理路径是否工作，但系统保留流量或配置中的绕过项仍需单独考虑，不应理解为所有数据都必然经过同一路径。直连(Direct)用于不经过代理的访问，也适合对照基础网络表现；选中 Direct 后能打开普通网页，不代表服务器已连接成功。

不确定现有规则是否影响结果时，可以暂时用 Proxy 进行一次对照测试，记录结果后恢复原来的 Config。不要为了排错同时替换配置、切换服务器并修改 DNS，否则无法判断是哪一项起作用。现在确定好姿态，再进入下一步打开连接。

步骤 03 / 选服务器，再开开关

Home：建立连接

返回 Home，在 SERVER 分组中点选准备使用的服务器，确认当前选中标记对应的是刚才核对过的条目。如果订阅包含多台服务器，先选一台进行验证，不要在首次测试过程中频繁切换。随后检查 Global Routing 仍是预期姿态，再打开页面顶部的连接开关。

第一次使用时，系统可能提示允许添加 VPN 配置。确认操作由刚刚打开的 Shadowrocket 发起后，按系统提示允许，并使用设备密码或系统提供的验证方式完成确认。如果取消了这一步，客户端无法建立所需的系统连接；应回到 Home 重新打开开关，而不是重复导入服务器。

完成授权后回到 Home，观察顶部状态是否从 Not Connected 变为连接状态，开关是否保持开启。若立刻恢复关闭，先记下提示文字，再检查系统授权与服务器字段。状态维持开启只说明系统连接流程已启动，不能据此认定所有目标页面都已经可以访问，后面还需要 Connectivity Test 与实际请求验证。

测试期间尽量保持网络环境稳定，例如先在同一个 Wi-Fi 下完成验证。需要从 Wi-Fi 切到蜂窝网络时，等待网络稳定后再重试，避免把切换瞬间的失败当作配置错误。设备上其他 VPN 连接也可能改变当前状态，排查时先确认究竟是哪一个系统连接处于活动状态。

首次手动连接成功前，暂时保留 On Demand 的原有设置。它用于自动触发连接，不会补齐缺失的认证字段，也不适合用来掩盖手动连接失败。需要停止连接时，回到 Home 关闭顶部开关，并确认状态恢复为 Not Connected。

步骤 05 / 从外到内，每次只改一项

Settings / Diagnostics：常见失败点

完成前四步仍有问题时，按照“基础网络 → 导入结果 → 服务器字段 → 模式与规则 → 测试设置”的顺序检查。先处理最外层的条件，避免一开始就在 Settings 中尝试大量不相关的开关。任何修改前先记下原值，验证没有改善时恢复，保留清晰的排错路径。

订阅更新失败或没有服务器

回到 Config 的 Subscribe，检查地址是否完整、参数是否保留、是否误粘贴了说明文字。确认基础网络正常后重新更新一次，并读取返回提示。若服务商已更换订阅地址，应修改原订阅记录，而不是继续用旧地址重复尝试。更新结果为空时先确认服务状态，不要立即删除所有旧条目，以免失去对照信息。

开关可以开启，但访问失败

首先回 Home 确认 SERVER 中实际选中哪一台，然后打开对应编辑页核对 Type、Host、Port 与认证值。手动输入时尤其注意全角符号、首尾空格与字母大小写。若使用了额外传输或 TLS 设置，也应对照原始信息逐项检查，不要通过随意降低安全设置来碰运气。

字段一致后，用同一服务器在 Proxy 与 Config 下分别进行相同请求。如果仅 Config 失败，到 Config 检查当前文件与 Rule 的策略指向；如果两者都失败，再换一个自己已有的服务器作对照，并向服务商确认服务是否正常。更换服务器是诊断对照，不代表原配置应当全部重建。

Connectivity Test 与浏览器结果不一致

进入 Settings 查看 Test Method，确认测试所用方式与服务端环境相适应。某些探测方式失败，不意味着实际网页请求一定失败；反过来，探测通过也不能证明网页涉及的全部资源可用。应保留浏览器的实际错误，结合 Diagnostics 中与该次请求相关的信息判断，而不是只根据一个测试结果调整整套配置。

使用 Diagnostics 记录问题时，尽量只保留能复现问题的一次操作。对外提供记录前，遮盖订阅地址、认证字段和个人访问内容。不要公开完整配置文件；确需对照字段时，只展示字段名称与经过遮盖的值。

连接被自动打开，或切换网络后异常

在 Settings 检查 On Demand 是否启用，以及自动连接条件是否符合预期。排查时可以暂时关闭自动触发，回 Home 手动连接验证；确认正常后再恢复原设置。TCP、UDP 等项目并不是通用修复按钮，没有明确证据时保持原值。需要系统化整理更新策略、备份与删除流程，请继续阅读订阅与服务器管理手册，不必在首次使用时一次完成所有高级设置。