官方手册 · 快速上手

Shadowrocket订阅导入与连接步骤

按“添加 → 选择模式 → 连接 → 验证”的顺序完成首次设置。先确认每一步的结果,再进入下一步;出现异常时,不必把所有设置重新改一遍。

阅读顺序:有订阅链接,从 Subscribe 开始;只有单个服务器参数,直接查看 Add Server;已经完成导入,可跳到 Global Routing。

STEP 01 · 添加已有信息

Subscribe 导入与 Add Server

先分清手里的内容是订阅链接,还是单个服务器的连接参数。订阅通常对应一组由服务商维护的服务器,更新后列表可能变化;单个服务器信息则需要逐项保存。两种方式不必重复操作,避免同一服务器出现多份记录,后续测试时难以辨认。

用 Subscribe 导入订阅链接

进入 Home,点击 Add Server 或右上角添加入口,打开 Add Server 页面。点击 Type,选择 Subscribe,再在 URL 中粘贴从你的服务商处获取的完整链接。Remark 用于填写自己能够辨认的名称,不需要填入账号密码。确认后使用页面的保存按钮返回 Home,等待订阅获取完成。

链接应从开头到末尾完整复制,尤其注意查询参数中的字符。不要把服务商网页地址、说明文字或换行一起粘贴到 URL 中。下面仅为格式示例,不能用于连接,也不需要在浏览器中打开。

https://example.com/sub?token=xxxx

保存后查看 SERVER 分组,确认订阅下是否出现服务器记录。只有订阅名称而没有服务器,不算完成导入;先检查是否显示获取错误,再向服务商核对链接是否有效、是否需要特定的订阅格式。不要在链接尚未获取成功时反复切换 Global Routing,路由模式不会修复订阅下载问题。

用 Add Server 填写单个服务器

如果拿到的是单个服务器参数,在 Type 中选择与资料一致的协议,再填写 Host、Port 以及该协议要求的认证信息。截图中的 Password、Method 对应当前选中的类型;切换为 VMess、VLESS 或 Trojan 后,字段可能不同。不要为了让表单更像截图而改动协议,地址、端口、密码和其他参数都应以服务商提供的资料为准。

填写完成后再核对一遍:Host 不应混入说明文字,Port 应与服务器提供的端口一致,密码前后不要多出空格。若资料包含 TLS、服务器名称或传输参数,也应按原值填写。缺少必要字段时,先补齐信息,而不是猜测一个值保存。

Scan QR Code 扫码添加

已有服务器二维码时,可使用 Scan QR Code 读取,并在系统询问时允许相机权限。扫码后仍需核对识别出来的 Type、Host 和 Port,再保存记录。二维码可能包含完整认证信息,不宜公开分享。Import from Cloud JSON 是另一种导入入口,只有持有匹配格式的资料时才使用,不要把普通订阅 URL 随意填入其中。

本步完成标志:Home 的 SERVER 分组已经出现可选择的服务器。接下来先确认流量处理方式,再打开连接开关。

Shadowrocket 的 Add Server 页面,显示 Type、Host、Port、Password、Method 及 Scan QR Code 等入口
Add Server:按 Type 填写相应字段。截图展示的字段不代表所有协议都需要相同参数。

STEP 02 · 确认流量处理方式

Global Routing 三种姿态

Global Routing 决定请求按什么方式处理,服务器列表决定代理请求使用哪台服务器。这两项不是同一个设置。返回 Home,点击 Global Routing 查看当前选择;日常希望依据规则分流时,使用配置(Config),并继续核对 Config 中当前使用的配置文件。

配置(Config):让规则参与判断

配置(Config)按当前配置文件处理请求。进入 Config,确认使用的是预期的文件,再打开查看内容。官方截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同设置分段;首次上手重点检查 Rule,不必为了完成连接而同时改动其他分段,也不必启用 HTTPS Decryption。

在 Rule 中,规则通常按顺序匹配,命中后执行对应策略。下面的示例表示 example.com 及其子域名使用 PROXY,最后一行处理此前没有命中的请求。这是解释语法的片段,不是可以直接替换现有完整配置的文件;实际配置还需要对应策略及其他必要内容。

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

PROXY、DIRECT、REJECT 表示不同处理策略,不能把它们当作服务器地址。添加规则时应检查目标策略是否在配置中有效,并留意规则的位置。通过 Add Rule 增加一条规则后,如果它位于已经覆盖该请求的规则之后,就可能没有机会匹配。先理解现有规则,再做最小范围修改。

代理(Proxy)与直连(Direct):用于明确对照

代理(Proxy)用于让请求按该模式经代理处理,适合临时检查所选服务器是否可用;直连(Direct)用于直连对照,不代表已经通过代理。若 Proxy 下访问正常、Config 下只有特定页面异常,应优先检查规则与策略,而不是立即删除服务器。测试结束后,回到日常需要的模式,避免遗忘临时选择。

本步完成标志:能够说清当前选择的是配置(Config)、代理(Proxy)还是直连(Direct),并知道 Config 使用哪个文件。更完整的规则原理见Rule 分流说明;复杂异常再转到故障排查,本页继续完成首次连接。

Shadowrocket 的 Config 配置文件编辑页,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:用于核对配置内容。Global Routing 的模式选择入口位于 Home,而不是这张配置编辑页。

STEP 03 · 连接与系统授权

Home 选择服务器并连接

回到 Home,在 SERVER 分组中点选一台已有服务器,确认选择标记落在预期记录上。若存在多个订阅分组,先核对分组名称,避免选择先前导入的旧记录。首次测试只使用一台服务器,暂时不要频繁切换,以便后续把测试结果与具体设置对应起来。

再次查看 Global Routing,然后打开 Home 顶部连接开关。首次连接时,系统会询问是否允许添加 VPN 配置。阅读提示后允许,并按设备要求完成密码或身份验证。这一步是在系统中建立连接所需配置,不是导入服务器,也不会自动补齐订阅信息。

授权后返回 Shadowrocket,观察顶部是否仍为 Not Connected,以及开关是否保持开启。如果仍未连接,先看有没有明确的权限或配置错误提示,不要只凭系统状态栏是否出现 VPN 标识作判断。若此前拒绝授权,重新发起连接并完成系统提示;若没有再次出现提示,可到系统设置中的 VPN 项目核对配置状态。

设备上如有其他正在建立隧道的网络工具,应先结束相关连接,再单独测试 Shadowrocket。由单位或学校管理的设备可能限制 VPN 配置,遇到管理限制时应联系设备管理员,不要反复删除系统管理项目。删除已有 VPN 配置前,也应确认它属于哪项服务。

连接开关保持开启,说明系统连接流程已经推进,但不能据此断言所选服务器可用。连接状态、服务器可达性、目标页面能否访问是三个需要分别确认的结果。下一步使用 Connectivity Test,再通过实际访问验证,不停留在“开关已经打开”这一层。

本步完成标志:已选定服务器、完成必要授权,Home 的连接状态不再停留在未连接。若开关立即回落,直接查看本页的失败点排查。

Shadowrocket 的 Home 页面,顶部显示 Not Connected、Global Routing 和 Connectivity Test,下方为 SERVER 分组与 Add Server
Home:对照连接开关、Global Routing 与 Connectivity Test 的位置。截图中的 Not Connected 是画面状态,并非本次操作结果。

STEP 04 · 检查实际结果

Connectivity Test 与生效验证

先在 Home 运行 Connectivity Test,查看本次测试是否能够完成。测试结果反映当前测试方法和目标下的可达情况,不等于所有网站都能访问,也不能单凭某个数字判断实际浏览速度。如果测试超时,先记录正在使用的服务器、Global Routing 与网络环境,保持其余条件不变,再进行对照。

接着切换到浏览器,打开自己日常使用且有权限访问的页面,检查页面正文、图片与必要操作是否正常。只打开一个已经缓存的页面不足以验证当前连接,可刷新页面或换一个正常可用的页面复测。若浏览器能用而某个应用不能用,应把问题范围缩小到该应用、目标域名和规则,不要直接判定整个连接失效。

把“能够访问”与“按预期分流”分开确认

使用配置(Config)时,即使某个页面可以正常打开,也可能是 DIRECT 规则在生效。若要核对分流,可结合当前 Config 中该域名对应的规则与应用内连接记录,查看实际使用的策略;再核对所选服务器。不要为了证明“所有请求都走代理”而把已经正常工作的直连规则全部删除,分流本来就允许不同请求使用不同路径。

如果 Config 下结果异常,可临时切到代理(Proxy),保持同一服务器和同一测试目标再试一次。Proxy 正常而 Config 异常,通常应从规则匹配、策略引用及相关配置继续定位;两种模式都异常,则先检查服务器参数和基础网络。切到直连(Direct)用于确认基础访问情况,完成对照后恢复原来的模式。

本步完成标志:实际访问符合预期,并能解释当前请求使用规则还是临时代理模式。完成后保留有效设置;不要把为了排查临时修改的模式、测试方法或规则留在不明状态。

STEP 05 · 按失败位置排查

常见失败点与 Settings 检查

排查从最早失败的一步开始。订阅还没有获取成功,就先处理订阅;开关不能保持开启,就先处理授权;只有部分页面异常,再检查规则与目标。以下流程只处理首次上手常见情况,涉及持续 DNS 异常、耗电或更新后问题时,转到故障排查大全继续定位。

订阅保存了,但 SERVER 里没有记录

回到订阅编辑页核对 URL,确认没有漏掉参数、混入空格或复制成服务商的网页入口。再检查设备当前网络能否正常使用。订阅获取失败与服务器连接失败是两个阶段;前者不应靠随意修改 Host 或 Port 处理。若链接已失效或返回内容格式不匹配,从你的服务商处获取有效链接后再更新,不要公开发送完整 URL。

连接开关回落,或系统提示权限问题

先返回 Home 重试一次,留意系统是否等待添加 VPN 配置授权;再检查系统 VPN 设置中是否有冲突或设备管理限制。误拒绝权限时,重新走授权流程即可,不必首先重装。若确需重新安装,先妥善保存自己的服务器信息与配置,避免排错过程中丢失尚未备份的内容。

开关已开,但 Connectivity Test 超时

核对当前选中的服务器是否仍有效,再对照原始资料检查 Type、Host、Port、认证与 TLS 参数。然后保持服务器不变,换一个可用的基础网络测试,区分网络环境与服务器本身的问题。Settings 中的 Test Method 会影响测试方式,因此不同方法的结果不宜直接比较;测试失败也应结合实际访问判断。

只有部分页面异常,或规则没有按预期生效

先检查 Global Routing 是否确实为配置(Config),再确认当前配置文件。查看目标是否被更靠前的 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 等规则覆盖,并检查最终策略。若页面主要文字正常、部分资源失败,相关资源可能使用其他域名,应根据连接记录定位,不要仅按浏览器地址栏中的一个域名判断全部请求。

On Demand 与 Diagnostics 怎么处理

Settings 中的 On Demand 用于按设置条件触发连接。首次手动连接尚未验证成功时,先保持触发条件简单,不要依赖自动连接来替代基础测试。遇到意外自动重连,再核对 On Demand 条件。Diagnostics 可用于进一步收集线索,但不应看到 Proxy、TCP、UDP 等设置就逐项试改;保留原值,只针对已确认的症状调整。

需要向服务商描述问题时,提供失败步骤、错误提示和已做过的对照即可。诊断记录、二维码、订阅 URL 可能含服务器地址、认证信息或个人访问记录,分享之前应隐藏敏感内容。不要把带有完整凭据的截图作为公开求助材料。

排查结束:将 Global Routing 恢复到日常使用模式,重新执行一次生效验证。如果问题仍在,保留能够复现的最小条件,转到深文档按症状继续排查,而不是从导入步骤全部重做。

Shadowrocket 的 Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:排查时重点辨认 Test Method、On Demand 与 Diagnostics,不需要同时调整全部设置。