官方手册 · 首次使用

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

按“导入 → 路由 → 连接 → 验证 → 排查”的顺序操作。先完成一次可复现的连接,再调整规则和自动连接设置,避免同时改动多项后无法判断原因。

01 · Add Server:导入已有信息

打开 Shadowrocket 后,先停留在 Home,暂时不要打开连接开关。首次使用时,列表中可能还没有服务器。接下来只需根据手头的信息选择一种导入方式:一条可以更新服务器列表的链接通常按订阅处理;单台服务器的地址、端口和认证字段则按手动添加处理。订阅链接与服务器地址不是同一个字段,不要把整条订阅链接填进服务器地址栏。

有订阅链接:选择 Subscribe

  1. 在 Home 点击右上角的加号,进入 Add Server。点击 Type,在类型列表中选择 Subscribe,然后返回填写页面。
  2. 将已有订阅链接完整粘贴到 URL。如果需要填写 Remarks,可使用便于辨认的名称,只用于区分列表,不改变连接参数。
  3. 保存并返回 Home,等待订阅内容载入。检查对应分组下是否出现服务器条目,而不只是多出一个订阅名称。出现条目后,再点选其中一台用于首次连接。

粘贴后先检查链接首尾有没有空格或换行,尤其注意复制时是否带入了说明文字。若载入失败,先确认基础网络可用,再核对链接是否完整、是否仍然有效。订阅内容的获取与代理服务器的连接属于两个过程:能更新列表,并不等于列表内每台服务器都可连接;列表暂时不能更新,也不应立即删除已保存的全部信息。

有单台服务器参数:按协议填写

同样从 Home 的加号进入 Add Server,在 Type 中选择资料标注的协议,例如 Shadowsocks、VMess、VLESS 或 Trojan。先填写服务器地址与端口,再逐项核对密码、UUID 或其他认证字段。协议不同,需要的字段也不同;不能只凭地址相同就沿用另一种协议的参数。字段大小写、连字符以及传输设置应与已有资料保持一致。

如果资料包含 TLS、SNI、Host、Path 或传输方式,还要展开对应设置逐一填写。服务器地址用于建立连接,SNI 和 Host 可能用于不同阶段的识别,不能因为它们看起来都是域名就互相替换。没有提供的参数不要凭印象补写;不清楚某项含义时,先向你的服务商核实,再保存测试。

已有兼容二维码或分享链接时,也可以使用 Scan QR Code 或剪贴板导入入口。扫码需要相机权限;从剪贴板读取时,按系统提示确认。无论采用哪种方式,导入后都应打开条目核对 Type、地址和端口。服务器链接、二维码和订阅 URL 可能包含认证信息,不要公开粘贴或发送到公开讨论区。

本步完成标志:Home 列表内已有实际服务器条目,并且已经选中一项。只完成导入还没有开始连接。多订阅整理、更新与备份等操作见订阅与服务器管理手册,首次使用先继续选择路由姿态。

02 · Global Routing:选择处理方式

返回 Home,找到并打开 Global Routing。这里决定客户端接管的连接如何处理,不负责导入服务器,也不会修复错误的认证参数。三个基本姿态是配置(Config) / 代理(Proxy) / 直连(Direct)。切换前先明确本次目的:是验证服务器能否工作,还是让不同目标按规则分别处理。

配置(Config):使用当前配置的规则

配置(Config)按当前启用的配置文件匹配连接,适合需要规则分流的使用方式。进入底部 Config 页面,确认准备使用的配置已经保存并被选中;仅把文件导入列表,不等于它已经生效。不同配置可能包含不同的策略和规则,因此不能只看 Home 选中了哪台服务器,就认定所有请求都会通过它。

规则通常按从上到下的顺序匹配,命中后使用相应策略。PROXY 表示交由代理策略处理,DIRECT 表示直连,REJECT 表示拒绝;FINAL 用于处理前面没有命中的连接。首次使用不必立即编辑规则,先确认生效配置的用途。没有准备好的配置时,不要将陌生文件直接作为排查起点。

代理(Proxy):用于检查代理链路

代理(Proxy)将客户端接管的流量交由代理策略处理,可用于短暂检查选中服务器的连接能力。这也是常被称作“全局模式”的姿态,但不代表应用能绕过所有系统限制或接管设备上的每一种流量。测试时固定一台服务器和同一个访问目标;如果此时能够访问,而切回配置(Config)后失败,就应优先检查配置及规则,而不是重复导入订阅。

直连(Direct):直接访问目标

直连(Direct)让客户端接管的请求直接访问目标,不通过代理服务器。它可用于对照基础网络状况,但不能用来验证代理服务器是否正常。如果当前目的是测试已有服务器,确认没有误选 Direct。完成短暂对照后,将 Global Routing 切回计划使用的姿态,再继续下一步。

本步完成标志:能够说清当前选择了 Config、Proxy 还是 Direct;使用 Config 时,也知道当前启用的是哪个配置。先保留默认的自动连接安排,不急于调整 On Demand,让首次连接过程更容易观察。

03 · Home:打开开关并授权

回到 Home,再次确认服务器选择与 Global Routing,然后打开顶部连接开关。首次连接时,iPhone / iPad 会显示添加 VPN 配置的系统提示。该提示用于允许 Shadowrocket 建立系统网络通道,不是导入订阅的提示,也不表示系统已经验证服务器可以连接。确认当前操作来自刚打开的 Shadowrocket 后,按提示允许,并完成设备密码或生物识别验证。

授权结束后返回 Shadowrocket,观察开关和连接状态。如果之前取消过授权,重新打开连接开关,按系统提示操作即可,不需要先删除全部服务器。若系统没有再次提示,可到“设置 → 通用 → VPN 与设备管理”查看相关 VPN 配置,再返回应用重试。设备受到管理策略限制时,权限可能不能由当前使用者自行更改,应按设备管理要求处理。

如果设备上已有其他 VPN 连接,先结束正在运行的连接,再测试 Shadowrocket,避免互相替换导致状态变化。排查期间也不要反复启停多个网络工具。连接开关刚打开就关闭、系统配置被移除、后台自动连接条件触发,属于不同问题,需要记录实际发生的现象,而不是统称为“订阅失效”。

VPN 标识或系统中的连接状态,只说明网络通道已建立到相应阶段,不能证明每个目标都可以访问。认证错误、服务器不可达以及 DNS 异常,都可能在通道建立之后影响请求。因此,看到开关保持打开后不要停在这里,继续做下一步的实际访问验证。

若稍后要使用 On Demand,建议等手动连接与断开均正常后再配置。自动触发条件会影响连接何时开始或恢复,首次排查时保持手动控制,更容易区分是服务器问题还是连接条件变化。关于系统提示的进一步说明,可阅读添加 VPN 配置与系统权限说明。

本步完成标志:系统授权完成,连接开关保持开启,并且没有立刻出现错误提示。接下来用实际请求判断链路与规则,而不是继续反复切换开关。

04 · Connectivity Test:验证生效结果

保持刚才选定的服务器与路由姿态,先使用 Home 中的 Connectivity Test 检查服务器可达性。测试结果用于初步定位,不是访问速度承诺:有结果说明测试所用方式得到响应,出现 timeout 则表示本次测试在规定时间内没有完成。不同测试方式与实际应用请求可能使用不同连接路径,不能只凭一次结果判断所有用途。

接下来打开浏览器,重新载入一个平时熟悉、允许访问的页面。使用新请求,而不是只看此前已经缓存的页面;先测试普通网页,再测试需要登录或具有额外访问条件的功能。如果一个页面失败、其他页面正常,应保留失败目标的现象,避免直接将整个连接判断为不可用。测试期间不要同时更换网络、服务器和配置,否则很难比较前后结果。

在 Data 中观察本次请求

返回 Shadowrocket,进入 Data,查看是否出现与刚才操作相关的连接记录,并结合其中可见的目标、策略或错误信息判断。使用配置(Config)时,某些请求走 DIRECT 是规则安排的正常结果,不能以“全部请求都走 PROXY”作为成功标准。若记录显示 REJECT,应先检查是否被当前配置主动拒绝,而不是继续更换服务器。

如果没有看到预期记录,先确认浏览器确实发出了新请求、连接开关仍开启,并检查当前 Global Routing。记录中出现流量也只说明有请求经过处理,还需要结合页面结果判断是否完成。分享排查信息前,隐藏服务器地址、订阅链接、认证字段以及可能关联个人账号的内容,只保留必要的状态与错误文字。

用一次对照区分服务器与规则

若配置(Config)下失败,可临时改为代理(Proxy),保持服务器与目标不变后再试。Proxy 正常而 Config 失败,优先检查配置文件选择、规则顺序与 DNS 设置;两种姿态都失败,则继续检查基础网络和服务器参数。完成对照后恢复原本计划使用的姿态,不要因为测试时切过选项,就忘记当前实际设置。

本步完成标志:不仅能看到连接开关开启,还能通过实际请求和记录解释连接结果。对于需要分流的设备,应分别验证一个预期走 PROXY 的目标和一个预期走 DIRECT 的目标;具体匹配结果以当前配置为准,不根据网站所在地区直接猜测。

05 · 按失败阶段逐项排查

排查的第一步是描述失败发生在哪里:Subscribe 内容没有载入、服务器显示 timeout、开关无法保持开启,还是只有某个页面打不开。它们对应不同阶段。先保留当前配置或必要备份,每次只调整一项,随后重复相同的测试;不要把删除重装作为起点,因为重装不能修正服务端参数,也可能丢失有用的诊断线索。

先查基础网络,再查订阅与参数

  1. 基础网络:关闭连接后,确认 Wi-Fi 或蜂窝网络能正常完成普通访问。需要网页认证的网络应先完成认证。可以更换一次网络进行对照,但应记录切换前后的结果。
  2. 导入结果:确认 Home 中有真实服务器条目,并且选中了一台。Subscribe 更新失败时核对 URL 的完整性与有效性;不要把订阅名称当成已导入成功的依据,也不要在更新过程中连续重复提交。
  3. 地址与认证:进入服务器编辑页,对照已有资料检查 Type、地址、端口、密码或 UUID。复制内容时多出的空格、少掉的字符,以及误选协议,都会导致无法连接。
  4. 传输参数:继续核对 TLS、SNI、Host、Path 与传输方式。不要为消除报错而随意关闭证书验证;先确认域名、证书要求与服务端资料一致。

若 Connectivity Test 持续显示 timeout,可在同一网络下选择另一台已有服务器进行对照。只有一台失败时,优先核对这台服务器的参数与状态;多台同时失败时,再考虑当前网络和公共设置。更多逐项操作见节点超时排查顺序。

再查路由、时间与系统权限

只有部分目标失败时,检查 Global Routing 是否为预期姿态,并到 Config 确认生效文件。宽泛规则放在前面,可能先于后面的特定规则命中;FINAL 应作为末尾处理。首次使用不建议边测试边大量追加规则,先通过 Proxy 与 Config 的对照确定是否属于分流问题,再阅读自定义规则与匹配顺序。

出现 TLS 或证书相关错误时,还要检查设备日期、时间与时区是否正确。时间偏差会影响证书有效期判断,不能只检查密码。DNS 相关现象则应结合失败目标和 Data 记录判断,不要一次替换全部设置。若应用能连接而某个业务仍失败,也可能与该业务自身的账号状态、访问条件或服务器故障有关。

开关立即回落或系统反复切换 VPN 时,检查 VPN 配置是否仍在、是否有其他连接正在运行,以及 On Demand 是否设置了自动触发条件。如果设备受到组织管理,先确认管理策略允许该连接。授权问题应先在系统设置中处理,不需要重新生成订阅或更改服务器密码。

经过上述检查仍不能定位时,整理一份最小记录:当前网络类型、选用协议、Global Routing 姿态、Connectivity Test 结果、失败发生的步骤,以及准确错误文字。不要附上完整订阅链接或认证内容。参数与服务器状态从你的服务商处核实;客户端设置与常见系统问题可继续查阅问答。

完成后的保留项:记住可用服务器、当前路由姿态和生效配置,备份必要资料后再调整订阅更新或 On Demand。更细的扫码、剪贴板导入、多订阅整理、删除与备份流程集中在服务器管理手册,无需在首次连接时一次完成全部设置。