Shadowrocket
使用教程

打开 Shadowrocket 后先停留在 Home，不要急着打开顶部开关。先判断手中的资料是哪一种：订阅链接用于获取一组可更新的服务器条目；单条分享链接通常对应一个服务器；Host、Port、Password 等分开的文字则用于手动填写。三种资料应走各自入口，不能把订阅地址直接填进 Host，也不能把分享链接整体当作 Password。

已有订阅：使用 Subscribe

在 Home 点右上角添加按钮，进入 Add Server；在 Type 的类型选择中找到 Subscribe，填写自己的订阅链接和便于辨认的备注，再保存。不同界面布局可能将订阅列为独立入口，以实际显示的 Subscribe 为准。完整粘贴链接，尤其保留问号之后的参数，不要把聊天消息附带的说明、空格或换行一起复制进去。

保存后返回 Home，等待条目载入；若暂未出现服务器，使用该订阅的更新操作，再检查网络和链接是否有效。确认 SERVER 分组内出现可选择的条目，才算完成导入。订阅名称出现并不等于内容已成功获取；链接过期、内容格式不符或请求失败，都可能留下一个空分组。不要通过反复添加同一链接解决空分组问题，应先检查原条目的更新结果。

手动填写：逐项对应服务器资料

若只有独立参数，在 Add Server 的 Type 选择资料指定的协议，再填写 Host 与 Port。截图中的 Password、Method 对应当前类型；选择其他协议后，认证和传输字段会变化。Host 一般填写域名或 IP，不额外添加网页路径；Port 填服务器提供的端口。Password、Method 以及 TLS、传输相关参数都要按原资料填写，不因名称相似而自行替换。

若已有二维码，可从 Scan QR Code 读取；已有分享链接时，按应用出现的剪贴板导入提示确认内容，并核对解析后的类型与地址。Import from Cloud JSON 面向对应格式的配置内容，不是任意订阅链接的通用入口。导入后给服务器加上自己能辨认的备注，再返回 Home。此时先选中一个明确要测试的条目，不要同时整理大量分组。

检查点：SERVER 内已有条目，且选中了一个服务器。订阅更新、批量整理与备份请继续阅读服务器管理手册；当前先进入下一步选择流量模式。

有了服务器，还需要说明哪些流量使用它。回到 Home，点 Global Routing 查看当前模式。本次上手先区分三种姿态：配置(Config)、代理(Proxy)、直连(Direct)。界面如果还显示 Scene，可留待基础连接验证后再设置；不要在首次操作时同时修改模式、场景和自动连接条件，否则出现问题时难以确定是哪一项引起。

Config：按配置规则决定路径

配置(Config)按照当前配置中的规则处理请求，不意味着所有请求都经过选中的服务器。进入底部 Config 页面，确认要使用的配置已被选中；打开配置可以查看 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。旁边官方截图是配置编辑页，用于辨认这些分段，不是 Global Routing 的模式选择画面。

首次使用时，先查看 Rule 中的规则与最终处理方式，暂不批量修改。规则从上到下匹配，先命中的规则决定对应请求的路径；PROXY、DIRECT、REJECT 分别代表不同处理结果。Add Rule 用于增加规则，但“增加一条”不代表一定会生效，还要看它是否被前面的规则提前匹配。本文不要求开启 HTTPS Decryption，也不需要为基础连接另行设置解密功能。

Proxy 与 Direct：区分测试目的

代理(Proxy)将由客户端接管的流量交给所选代理路径，适合在排错时暂时缩小规则因素的影响，但不会修复服务器地址、认证或传输参数。直连(Direct)使用直接连接，适合确认本机网络和目标本身能否访问；在 Direct 下能打开网页，不能证明代理服务器可用。模式改变后，要重新发起访问，不要只观察已经打开的页面。

如果已有明确且理解用途的配置，可选择 Config 继续。若要先检查服务器基础连通，可以暂用 Proxy 完成后面的连接与访问测试，验证后再回到 Config。记下切换前的模式，避免排查结束后忘记恢复。规则关键字、DNS 与策略之间的详细关系可在术语表查阅，不需要在首次连接时一次掌握全部设置。

检查点：知道当前是 Config、Proxy 还是 Direct；使用 Config 时，知道当前选中了哪份配置。接下来再打开连接开关。

回到 Home，再核对一次选中的服务器和 Global Routing。顶部显示 Not Connected 时，说明当前尚未建立客户端的连接状态。点顶部开关开始连接，首次操作通常会出现系统添加 VPN 配置的提示。这个提示由系统显示，作用是允许 Shadowrocket 建立处理网络流量所需的 VPN 配置，不是在添加订阅，也不会替代前面填写的服务器资料。

确认提示中的应用后选择允许，并按系统要求完成设备密码或生物识别验证。随后回到 Shadowrocket，观察顶部状态是否变化。如果曾经拒绝授权，先返回应用重新尝试连接；若仍不能建立，可到系统设置的 VPN 管理位置检查是否存在 Shadowrocket 的配置。系统版本不同，设置层级和提示文字可能略有差异，以设备实际显示为准。

授权完成只是允许客户端接管相应流量，并不代表远端服务器已能正常转发。即使顶部开关保持打开，服务器认证失败、DNS 异常或规则拦截仍可能导致网页无法访问。因此不要在开关打开后就直接结束操作，下一步还要做实际验证。状态栏是否常驻显示 VPN 标识也受设备界面影响，不能只凭一个图标作判断。

如果开关立即回到关闭，或长时间停留在连接过程，先记录出现的完整提示。检查系统里是否有另一个 VPN 正在连接，避免两个连接反复争用状态；不要直接删除所有网络配置。需要重建 Shadowrocket 的系统 VPN 配置时，先停止连接，确认应用中的服务器资料仍在，再只处理对应配置，完成后回到应用重新授权。

第一次连接建议先保持当前 Wi-Fi 或蜂窝网络不变，也暂不启用 On Demand。这样可以分清是手动连接本身失败，还是网络切换后的自动连接条件影响了结果。若系统授权已完成、开关也能保持打开，就继续做 Connectivity Test 与实际访问，不必再重复安装应用。

检查点：完成系统授权，Home 的连接状态已改变。接下来验证“能连接”是否同时意味着“目标能访问”。

遇到失败时，保留当前服务器和配置，先不要一口气修改多个开关。最有效的顺序是从本机网络开始，再检查服务器、模式、规则和 DNS，最后检查系统连接状态。每改一项，就对同一个目标重新发起请求。这样一次变化对应一次结果，能判断问题是否真的被解决，也能在无效时恢复原设置。

导入后没有条目，或服务器始终失败

订阅为空时，先确认设备本身可以联网，再检查链接是否完整、是否仍有效、返回内容是否属于客户端可识别的格式。不要在公开截图中展示链接参数。手动添加的条目则重新对照 Type、Host、Port、Password、Method，以及资料指定的 TLS 与传输字段。超时、认证失败和内容解析失败不是同一类问题，应记录原始错误再决定下一步。

测试与网页访问结果不一致

打开 Settings，查看 Test Method。测试方式不同，实际检查的网络层次也不同；一个测试失败不能直接推出所有真实请求都会失败，反过来，有测试响应也不能保证目标可用。必要时使用 Diagnostics 查看相关诊断信息，结合失败时的网络和目标判断。测试参数调整后，应与前一次使用相同服务器比较，避免同时更换服务器造成混淆。

Proxy 可用，Config 不可用

先确认 Config 中选中的确实是预期配置，再检查目标是否命中了 DIRECT 或 REJECT，或者前面的规则覆盖了后续规则。若域名访问失败但其他请求正常，还应检查当前 DNS 设置与配置中的 Hosts 是否影响解析。不要把随意替换 DNS 当作通用修复；先保留原值，确认改动目的，再针对同一域名验证结果。

网络切换后断开，或开关反复变化

回到 Settings 查看 On Demand 是否已配置。首次排错可暂时停用自动连接条件，先在固定网络中手动连接验证；稳定后再分别设置 Wi-Fi 与蜂窝网络的行为。若系统另有 VPN 正在使用，先停止不需要的连接。仍然失败时，记录系统提示与 Diagnostics 中相关错误，不要通过反复删除全部配置扩大问题范围。

整理求助信息时，只保留设备系统、网络类型、模式、操作顺序和去除敏感信息后的错误文本。订阅完整链接、Password、二维码以及含认证信息的分享链接都应遮挡。更细的更新、删除和备份步骤请看服务器管理手册；常见授权与网络问题可到FAQ按现象查找。

排错结束后：恢复临时切换的模式，确认选中服务器与配置，再对同一目标复测一次。保留已经验证可用的设置，之后每次只增加一项新功能。