Shadowrocket 使用教程
订阅导入与首次连接

打开 Shadowrocket 后进入 Home，找到 Add Server，也可以使用页面上的添加入口进入同名页面。不要仅凭一段地址的外观选择导入方式：订阅地址用于获取一组服务器信息，单条分享链接通常描述一个服务器，而 Host、Port、Password 等参数需要按相应 Type 填写。先确认已有资料的类型，能够避免把订阅地址误填进 Host。

已有订阅：使用 Subscribe

在 Add Server 中打开 Type，选择 Subscribe，将自己已有的完整订阅地址填入相应地址字段。复制时保留地址末尾的参数，检查开头、结尾是否夹入空格、换行或说明文字。可填写便于辨认的备注，用来区分不同订阅；备注只影响本地识别，不会改变远端订阅内容。确认后保存，等待客户端获取内容，再返回 Home 查看结果。

例如，https://example.com/sub?token=xxxx 只是地址结构示例，不可用于实际连接。真正操作时应使用自己已有的地址。若保存后只看到订阅名称，却没有可选择的服务器，先检查订阅是否已成功获取内容；不要连续重复添加同一地址。订阅地址本身需要能够通过当前网络访问，导入尚未完成时，单纯反复切换连接开关并不能补齐服务器列表。

已有参数：先选 Type，再填字段

手动添加时，首先选择与资料一致的 Type。随后填写 Host 与 Port：Host 填服务器域名或地址，Port 填服务端指定的端口。以截图展示的字段为例，还需核对 Password 与 Method。不同协议会展示不同字段，不能把这一组字段当作所有协议的通用表单；例如需要 UUID、TLS 或传输设置的连接，应继续按已有资料核对对应项目。

不要凭经验替换 Method，也不要因为“看起来更安全”就自行打开与服务端不一致的选项。端口、认证信息和传输设置需要相互匹配；即使应用允许保存，也不表示远端能够接受这些参数。填完后检查一次原始资料，再保存返回 Home。

二维码与单条分享链接

已有二维码时，可使用 Scan QR Code，按系统提示授予本次操作需要的相机权限。识别后先核对类型、地址与端口，再确认保存。若使用剪贴板导入，先只复制完整分享链接，再使用应用提供的对应导入操作；出现粘贴访问提示时，按实际需要确认。Import from Cloud JSON 用于相应格式的资料，不应当作任意订阅地址的替代入口。

确认服务器已经出现在 Home 后，打开 Global Routing。首次使用先辨认三个常用姿态：配置(Config)、代理(Proxy)、直连(Direct)。这里改变的是连接处理方式，而不是服务器资料本身。切换姿态不会自动修复错误密码，也不会补上缺失的订阅内容。

配置(Config)：使用当前配置文件的规则

选择 Config 时，连接按照当前使用的配置文件规则处理。一部分目标可能交给 PROXY，另一部分可能使用 DIRECT，也可能命中 REJECT。因此，打开连接后仍有部分请求直连，并不一定是设置失效；需要结合目标命中的规则判断。进入 Config 查看当前配置文件，确认实际使用的文件，而不是只确认某个文件已经保存在列表中。

截图中的配置编辑页包含 General、Rule、Hosts 等分段。规则可以在 Rule 中查看；需要新增时才使用 Add Rule。首次连接不必逐段修改这些设置，尤其不应为了测试普通连接而改动 URL Rewrite 或 HTTPS Decryption。先保留已知用途的配置，等基本连接成功后再逐项理解规则。

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

代理(Proxy)：先检查服务器是否能用

选择 Proxy 后，可由客户端处理的连接会交给代理。首次排查时，这种姿态便于减少规则选择带来的变量：先选中一个服务器，用同一个目标做连通性检查。如果 Proxy 下能够正常访问，再切回 Config 后失败，应优先检查配置文件及规则命中，而不是立即删除订阅。Proxy 不等于所有应用、所有系统流量都必然采用同一处理路径，验证时仍应观察实际请求。

直连(Direct)：直接连接目标

选择 Direct 时，连接直接访问目标，不使用服务器转发。它适合建立对照：同一目标在当前网络下能否直接打开。如果 Direct 下可访问，而 Proxy 下失败，排查重点应转向选中的服务器或其参数。不要把 Direct 当作“自动选择较快服务器”的设置。完成模式选择后回到 Home，下一步再选服务器并打开连接。

回到 Home，在 SERVER 分组中找到刚导入的服务器，点选条目左侧的选择圆点，并确认选择标记落在目标服务器上。进入某个条目的编辑页面，与把该条目设为当前服务器不是同一件事。列表中即使有多条信息，首次检查也只需选中其中一条，记下它的备注，便于后续复测时保持条件一致。

再次核对 Global Routing。若正在检查基本连接，可先使用上一步说明的 Proxy；若已有明确配置文件并希望按规则使用，则选择 Config。随后打开 Home 顶部连接开关。未连接时页面可能显示 Not Connected，操作后观察开关与连接状态是否发生变化，不要只点一下便立即切到其他应用。

首次出现 VPN 配置提示时

首次连接可能出现系统添加 VPN 配置的提示。这是让 Shadowrocket 在设备上建立网络连接所需的系统授权，不是订阅导入提示。确认正在操作的是 Shadowrocket 后，按系统流程允许，并使用设备要求的身份验证方式完成确认。若此前取消过提示，回到应用重新发起连接；不要在系统提示尚未结束时反复点击开关。

授权完成后回到 Home，确认连接开关是否保持开启。系统的 VPN 状态表示相关网络配置已经启用，但不等于远端服务器一定可用。密码错误、端口不可达或规则指向不正确时，也可能需要通过后续请求才能看出问题。因此，这一步的目标是完成“选中条目、允许配置、保持连接”这三个动作，实际访问效果留到下一步验证。

连接后先保持设置不变

不要在刚打开开关后同时更换服务器、改动规则和切换网络。先用当前条件完成一次测试；若失败，再按顺序改变一个变量。iPad 上也采用同样的检查顺序，页面排布以设备上的实际显示为准。应用购买记录与服务器资料是不同内容，换设备后即使已重新取得应用，也仍应确认订阅或服务器信息是否已经导入。

订阅保存了，但没有服务器

先回到订阅资料，检查地址是否完整，以及当前网络能否访问该订阅。订阅地址中的参数可能承担身份识别作用，少复制一段就可能获取失败。区分“保存了一条订阅记录”和“成功取回服务器内容”：前者只是本地保存动作。若已有资料明确提供有效期或使用状态，应核对自己的记录；不要把普通网页地址当作订阅，也不要把错误页面的内容继续当作连接参数。

先修正原条目，再重新获取内容，避免连续添加造成重复列表。需要确认返回内容格式、更新策略或清理多个订阅时，转到订阅与服务器管理手册；完成后再回本页第三步继续连接。

开关无法保持开启

观察是否仍有系统 VPN 配置提示等待处理，以及设备身份验证是否已经完成。若系统网络设置中还有其他正在启用的 VPN 配置，先确认当前使用的是哪一项，再返回 Shadowrocket 重试。在受管理的设备上，也应检查设备管理策略是否限制相关配置。此时先解决系统配置能否启用的问题，不必立即改动服务器密码或 Rule。

开关已开，但请求超时

回到 Home 检查选中标记，确认使用的是准备测试的服务器，而不是另一条旧记录。手填条目再核对 Type、Host、Port 与认证信息，以及资料要求的 TLS 和传输选项。若是订阅条目，优先重新获取已有订阅的内容，避免直接改动大量远端管理的字段。随后用 Proxy 与同一目标复测，判断问题是否独立于规则存在。

若准备换用自己已有的另一条服务器，先保留原条目，每次只替换选中项。必要时在 Wi-Fi 与蜂窝网络之间做一次对照，但应记下网络变化；网络改变与服务器改变同时进行，会让结果无法对应到具体原因。

Proxy 可用，Config 下部分目标失败

检查当前实际使用的 Config 文件及 Rule 顺序，确认目标是否被交给预期的 PROXY 或 DIRECT。域名规则与地址规则的匹配条件不同，目标解析后的连接也可能影响判断。首次排查不需要重写整份配置，先找到与失败目标相关的规则，再检查后备规则。关于规则关键字、匹配范围和配置整理，继续阅读订阅手册中的配置相关说明。

测试结果与浏览器表现不一致

进入 Settings，查看 Test Method，确认当前测试方式，再对照第四步的实际访问结果。Diagnostics 可用于进一步查看诊断信息，但日志需要结合测试时间、目标和错误内容阅读，不能只凭一个词判断原因。分享诊断内容前，应移除订阅地址、认证参数及其他个人信息，完整订阅地址不应作为公开排错材料。

On Demand 与按条件连接的行为有关。若发现连接状态会随网络环境变化，检查自己是否配置了相关条件；不要在尚未理解作用时同时改动 Proxy、TCP、UDP 等设置。先建立可重复的手动连接结果，再处理自动连接需求。Settings 中的 Language 或 Today Widget 也不是修复服务器认证错误的入口。