Shadowrocket 使用教程

打开 Shadowrocket，进入 Home，找到 SERVER 分组下的 Add Server。先辨认手中资料的类型：只有一台服务器的地址、端口和认证参数时，使用手动添加；持有可以更新服务器列表的订阅链接时，使用 Subscribe；持有单条服务器二维码时，可以使用 Scan QR Code。三种资料不能仅凭外观相似就互换入口，尤其不要把配置文件地址当成服务器地址填写。

手动填写已有服务器信息

点击 Add Server 后，先设置 Type，再按照该协议显示的字段填写 Host、Port 以及认证信息。官方截图展示的是包含 Password、Method 的一种表单；选择其他 Type 后，字段可能改变。Type 应与已有信息中的协议一致，不能因为表单较短就换成另一种。Host 填服务器主机名或 IP 地址，Port 填端口；除非字段明确要求 URL，不要把整条链接连同路径一起粘贴进 Host。

如果资料使用 Password、Method，就逐项核对大小写与取值；如果使用 VLESS、VMess 或 Trojan 等 Type，则按相应表单填写已有的标识、认证与传输参数。TLS、服务器名称和传输路径也需要与服务端一致。首次操作不必自行尝试一组“常见参数”：缺失的信息应先向自己的服务商确认，留空或猜测可能让条目保存成功却无法连接。

填写完毕，使用页面上的保存操作返回 Home。检查 SERVER 中是否出现刚添加的条目，并给条目使用便于辨认的备注。备注只用于区分记录，不会改变连接能力。此时先不要同时创建很多条目；以一条已确认信息完整的记录作为后面连接和排错的基准，更容易判断问题发生在哪一步。

Subscribe、扫码与配置文件订阅

导入已有服务器订阅时，在 Add Server 的 Type 中选择 Subscribe，按表单填写订阅地址并保存。粘贴前检查链接是否完整，有没有前后空格、换行或遗漏的查询参数。保存或执行更新后，回到 Home 查看订阅分组是否产生服务器条目；只有订阅名称、分组为空时，还不能进入连接验证，应先检查链接内容与更新结果。

使用 Scan QR Code 时，只扫描用户已有的服务器资料，识别后仍需检查 Type、Host 与 Port。Import from Cloud JSON 是另一种导入入口，所需内容格式与普通订阅链接不同，不应把任意链接反复放进不同入口尝试。二维码和订阅链接可能包含认证信息，导入时不要公开展示，也不要把它们当作普通截图分享。

还要区分 Config 中的 Subscribe：它面向配置文件订阅，用于取得规则与相关配置，不等于 Home 中的服务器列表导入。成功取得一个配置文件，不能证明已经有可连接的服务器。先确认 Home 的 SERVER 中已有可选条目，再按下一步选择 Global Routing；如果导入后仍为空，查看疑难解答中的订阅与服务器导入说明。

完成导入后回到 Home，点击 Global Routing，辨认当前选择的是配置(Config)、代理(Proxy)还是直连(Direct)。这三个姿态不是三组服务器，也不是三个连接质量等级。切换姿态不会自动修复错误的端口或密码，测试前应记下当前选择，避免将不同路径下的访问结果混在一起比较。

配置(Config)：按当前规则处理

配置(Config)按当前配置文件中的规则决定请求使用 PROXY、DIRECT 或 REJECT 等策略。若需要规则分流，先进入 Config，确认正在使用的配置文件，再打开该文件检查内容。编辑页能看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段；这些分段承担不同用途，不需要为了完成首次连接而逐一修改。

在 Rule 中，规则通常从上到下检查，具体域名规则应位于更宽泛的规则之前，FINAL 用于处理没有命中前面规则的请求。下面的片段只说明顺序：访问 example.com 及其子域名时采用 DIRECT，其余请求交给 FINAL 指定的 PROXY。示例域名不是服务地址，也不是本教程建议直接替换当前配置的完整文件。

[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY

通过 Add Rule 添加规则前，先确认要修改的是当前正在使用的文件。编辑后保存，并在 Config 确认选择状态；只把文件导入列表、没有选为当前配置，不一定会改变请求路径。首次验证只需知道哪条规则可能命中、策略是否符合预期。不要一次加入大量规则，也不要为普通连接验证开启 HTTPS Decryption。

代理(Proxy)与直连(Direct)

代理(Proxy)用于让通常可代理的流量使用代理路径，适合在排查时临时减少规则分流带来的变量；系统流量与部分排除项仍可能有各自处理条件，不能理解成所有数据都必然经过服务器。直连(Direct)使用直连路径，适合对照基础网络是否正常，但它不是“代理服务器连接成功”的证据。两种姿态都不需要另建一份服务器条目。

如果暂时没有明确的分流需求，可以先记录现有设置，在代理(Proxy)下验证已有服务器，再返回配置(Config)检查规则差异。如果已有可确认的配置文件，则直接使用配置(Config)，并在验证步骤观察目标请求是否走预期策略。每次只改变一个条件；详细的规则类型、策略名称与优先级参见规则与配置参考大全，本篇继续完成连接。

返回 Home，在 SERVER 分组中点击准备使用的服务器。根据列表中的选中标记确认当前条目；打开条目详情进行编辑，与在列表中选择用于连接的条目，是两个不同操作。订阅中如果有多条记录，先固定其中一条进行测试，不要在每次失败后同时切换服务器、规则与网络，否则很难判断是哪项改变影响了结果。

再次核对 Global Routing，然后打开 Home 顶部的连接开关。未连接时可以看到 Not Connected。首次建立连接时，系统可能提示允许 Shadowrocket 添加 VPN 配置；确认是本次主动连接操作触发的提示后，选择允许，并按设备要求完成密码或生物识别认证。这里的认证用于设备授权，不是服务器 Password，不要把服务器凭据填到系统认证界面。

如果此前关闭了授权提示，连接可能无法继续。重新发起连接并查看系统提示；若仍未出现，可到设备的系统设置中检查 VPN 配置是否存在、是否受设备管理限制。受管理的设备应遵循其管理要求，不应通过反复修改服务器字段来解决授权问题。授权完成后返回 Shadowrocket，观察顶部状态和开关是否保持连接。

开关打开只说明连接流程已发起，VPN 状态出现也不等于所有目标请求都可访问。此时先等待当前连接状态稳定，再进行下一步 Connectivity Test 与实际访问检查。如果开关立即回落，记录提示内容和触发时间，再进入排错步骤；如果能够保持连接但网页打不开，应保留当前条目与模式，继续检查请求路径。

测试期间，避免让其他 VPN 配置同时抢占当前连接，也不要提前启用复杂的 On Demand 条件。网络从 Wi-Fi 切换到蜂窝数据后，原有连接可能需要重新建立，所以要记清当时使用的网络。需要主动断开时，回到 Home 关闭顶部开关，并确认状态恢复；若随后自动重连，再检查 Settings 中的 On Demand 条件，而不是反复删除服务器记录。

导入没有产生可用条目

先确认设备自身可以正常联网，再检查使用的是服务器订阅还是配置文件订阅。Home 中的订阅分组为空时，核对地址是否完整、是否仍在有效期内、更新时是否有提示。不要在公开讨论中粘贴完整订阅链接；链接中的查询参数可能就是访问凭据。如果手动记录能够保存但无法连接，则重新核对 Type、Host、Port 与认证字段，保存成功不代表服务端接受了这些参数。

开关回落，或连接保持开启但访问失败

开关立即回落时，先检查系统 VPN 授权和设备限制，再检查应用给出的连接错误。连接保持开启但请求失败时，检查服务端是否可达、账号是否仍有连接权限、当前网络是否允许相应传输。手动添加的 TLS 名称、传输方式与路径尤其需要逐项对应已有资料；不要只检查密码就认定参数已经全部正确。

进入 Settings，查看 Test Method 与 Diagnostics。前者影响测试的解释方式，后者用于检查诊断信息；它们不是自动修复服务器的按钮。记录错误发生在连接建立前还是请求发送后，再判断该检查认证、传输还是规则。首次排错不需要同时改变 Proxy、TCP、UDP 中的多项选项，保持默认或已有明确配置，优先处理能解释当前错误的那一项。

规则、DNS 与 On Demand

只有配置(Config)失败时，到 Config 检查当前文件，寻找目标域名对应的规则以及 FINAL 的策略。如果存在更靠前的宽泛规则，后面的具体规则可能没有机会命中。DNS 方面先确认设备的网络本身可用，再核对 General 中的解析设置；域名解析失败与服务器认证失败不是同一类问题。不要为了处理单个目标，把全部域名规则或解析设置一次改掉。

On Demand 用于按设定条件触发连接，不等于“所有情况下始终保持连接”。首次验证应先手动连接，确认服务器与规则可用，再按需要设置 On Demand。出现主动关闭后又重连、切换网络后状态变化等现象时，先检查其条件。Today Widget 是快捷操作相关设置，也不能替代 Home 中对当前服务器和 Global Routing 的核对。

当 Wi-Fi 与蜂窝数据的结果不同，保留同一服务器、同一姿态和同一测试方法分别复测；仅当一个条件改变时，比较才有意义。每次修改后保存、重新连接并重复验证，再决定是否保留修改。准备发送诊断记录时，隐藏密码、认证标识、完整订阅地址及个人网络信息，保留错误类型和相关操作顺序即可。

完成这五步后，应能明确当前使用的服务器、Global Routing 姿态与验证结果。仍无法定位时，带着这些信息阅读疑难解答；需要调整 Rule、General 或 DNS 时，再进入配置大全。后续更新订阅或修改配置后，也应重复“选中条目 → 连接 → 测试 → 实际访问”的检查，而不是只凭导入成功判断已经生效。