官方手册 · 上手步骤

Shadowrocket 使用教程:
订阅导入与连接验证

按“导入 → 选择模式 → 连接 → 验证 → 排错”的顺序操作。首次配置先建立一条可验证的连接,再调整规则与自动连接条件。

01 / 添加与导入

Add Server:导入已有订阅或填写服务器

打开 Shadowrocket,进入底部的 Home。先辨认自己手中的资料:订阅链接通常用于一次导入并持续更新一组服务器;单条服务器资料则包含协议类型、地址、端口以及身份验证参数。二者用途不同,不要把订阅链接整段填入服务器的 Host 字段。

已有订阅链接:选择 Subscribe

在 Home 点右上角添加按钮,或点 SERVER 分组中的 Add Server,进入添加页面。点 Type,选择 Subscribe,再把从你的服务商处获取的完整订阅链接填入 URL。可填写便于自己识别的备注,检查链接前后没有空格、换行或聊天软件附带的标点,然后保存。

保存后回到 Home,等待订阅内容获取完成。成功时,应能在相应分组里看到导入的服务器条目;先展开分组确认实际内容,而不是只看订阅名称是否出现。如果仅出现分组名称、里面没有可选条目,说明还没有完成有效导入,应先检查更新结果,不要直接进入连接步骤。

后续需要更新时,在订阅条目的操作菜单中执行更新,完成后重新检查当前选中的服务器。订阅更新可能修改名称、增删条目,也可能改变原先选中的项目。订阅链接含有访问凭据,应只保存在自己的设备中,不要把完整链接放入公开截图或诊断留言。

已有单条资料:按 Type 对应填写

如果服务商给出的是逐项参数,在 Add Server 的 Type 中选择与资料一致的协议,再依次核对 Host、Port 及身份验证字段。Host 一般填写服务器域名或 IP,不附加网页路径;Port 按提供的数字填写。协议改变后,页面字段也可能改变,不能把一种协议的密码、标识或传输设置直接套到另一种协议上。

截图展示了包含 Password、Method 的添加页面,这些字段适用于相应 Type,并非每种协议都需要填写。需要 TLS、Server Name 或其他传输参数时,严格对应服务商资料;没有给出的值不要凭经验补上。若提供二维码,可使用 Scan QR Code;Import from Cloud JSON 则用于相应格式的导入,不是所有订阅链接的通用入口。

保存后回到 Home,点选刚添加的条目,确认选中标记落在预期项目上。至此完成的是“资料进入客户端”,还没有验证服务器是否可达。下一步先确定请求采用哪一种 Global Routing,再打开连接,便于后面解释测试结果。

Shadowrocket Add Server 添加页面,展示 Type、Host、Port、Password、Method 以及底部导入入口
Add Server:字段随 Type 改变,按已有资料填写。

02 / 模式与规则

Global Routing:选择配置、代理或直连

返回 Home,点 Global Routing 查看当前姿态。这里决定请求如何选择处理路径,与“选中了哪个服务器”是两件事:前者控制路由方式,后者指定需要代理时使用的服务器。刚完成导入就遇到访问结果不符,先查看这一项,比连续更换服务器更容易定位原因。

三种姿态分别检查什么

配置(Config):按当前启用的配置文件匹配规则,不同请求可能走不同策略。准备日常按规则使用时选择这一项,但必须先确认 Config 中实际启用的文件,不能仅凭模式名称推断已有合适规则。

代理(Proxy):以代理路径处理请求,可用于对照排查服务器连接是否正常。它不等同于某条规则已命中,也不表示所有系统流量都一定经过相同路径。测试结束后,如果原本需要按规则分流,应恢复到 Config,再做一次实际验证。

直连(Direct):以直连路径处理请求,不使用所选代理服务器转发。它可以帮助比较本地网络能否直接访问目标,但不能用来证明所选服务器工作正常。若一直停在 Direct,单纯切换服务器通常不会改变访问路径。

使用 Config 前确认当前文件

进入底部 Config,确认当前启用的是哪份配置,再打开相应文件查看内容。编辑页中的 General 管理通用参数,Rule 用于规则匹配,Hosts 涉及地址映射;URL Rewrite 与 HTTPS Decryption 属于进一步的请求处理设置,初次连接不必为了“配置完整”而逐项开启。

Rule 通常按从上到下的顺序判断,命中后交给对应策略处理。查看规则时,既要看匹配条件,也要看末尾策略;一条域名规则存在,并不代表它一定使用 PROXY。使用 Add Rule 前先保留原文件副本,避免把验证连接的问题与修改规则的问题混在一起。

这一阶段只需明确“正在使用哪份 Config、目标大致应走哪条路径”。暂时没有把握时,不要一次加入大量规则。协议字段、匹配顺序与策略的进一步解释见协议参考;常见的全局模式理解问题见常见问题。

Shadowrocket Config 配置编辑页面,展示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:先确认启用文件,再检查 Rule 与对应策略。

03 / 连接与授权

Home:选中服务器并打开顶部开关

回到 Home,展开导入的 SERVER 分组,点选计划使用的服务器。再次检查 Global Routing 与上一步的选择一致,再打开顶部连接开关。把这两个动作分开确认,可以避免“切换了条目,却仍沿用上一次测试姿态”的情况。

首次连接时,系统可能弹出添加 VPN 配置的授权提示。核对这是刚才在 Shadowrocket 中主动发起的操作,再按系统提示允许,并使用设备验证方式确认。这里创建的是客户端处理网络请求所需的系统配置,不是在购买新的连接服务;若取消授权,应返回客户端重新打开开关,再完成确认。

授权完成后回到 Home,观察顶部原来的 Not Connected 是否转为已连接状态。如果仍未连接,先停在当前页面,确认系统提示是否已经处理、所选条目是否仍在,不要连点开关。开关显示连接状态,只能说明连接流程所处阶段,不能代替目标网站的实际请求测试。

初次验证建议保持前台,先不要启用复杂的自动连接条件,也不要在同一轮测试中同时切换 Wi-Fi 与蜂窝网络。若设备上已有其他正在工作的 VPN 连接,先在系统设置中确认当前生效的连接,避免测试对象与预期不一致。

本步完成的检查点是:有明确选中的服务器、Global Routing 已确认、系统授权已完成、Home 显示连接已建立。四项具备后再进入验证步骤。如果顶部短暂变化后立即恢复 Not Connected,直接转到第五步,按连接层检查参数与网络。

Shadowrocket Home 页面,顶部显示 Not Connected 开关、Global Routing 与 Connectivity Test,下方为 SERVER 分组和 Add Server
Home:截图为未连接状态;实际操作时核对开关与所选条目。

04 / 验证结果

Connectivity Test:先测试,再验证实际请求

连接建立后,在 Home 点 Connectivity Test,等待结果返回。它适合检查当前测试目标是否能够完成对应的连接过程,但一次成功只覆盖这次测试所涉及的条件。测试目标、当前网络以及所用测试方式不同,结果也可能不同,不要把一个数值当成全部应用的访问结论。

接着打开浏览器,访问一个你有权限使用、且能判断预期结果的网站。如果选择 Config,应分别检查预期直连和预期代理的目标;如果只是用 Proxy 做连通性对照,完成后切回 Config,再重复同一个目标的请求。比较时保持服务器与本地网络不变,每次只改变一个因素,结果才有参考意义。

需要进一步确认分流时,回到 Shadowrocket 查看当前版本提供的请求记录或诊断信息,查找刚才访问的目标及实际使用的策略。Data 中的流量变化可作为请求发生的线索,但流量增长本身不能证明某条 Rule 已命中;还要结合目标、当前 Config 与具体策略一起判断。

如果浏览器仍显示旧内容,先刷新页面或重新打开目标,再观察新请求。网页缓存、应用自己的连接复用和 DNS 缓存都可能让一次切换后的表现不够直观。不要仅凭浏览器里已经加载好的页面,判断刚才的服务器切换已经成功或失败。

如果 Connectivity Test 成功而某个网站失败,保留当前可用设置,优先排查目标相关的规则、解析与服务端条件。如果所有目标都失败,则返回检查连接与服务器资料,不要先大范围修改 Rule。下面按失败发生的位置整理检查顺序。

05 / 设置与排错

Settings:按失败位置逐层检查

排错先记录三件事:失败发生在导入、连接还是实际访问阶段;发生时使用 Wi-Fi 还是蜂窝网络;刚才修改过哪一项设置。保留这些条件,再按下面的顺序检查,比同时换订阅、改协议和重装应用更容易找到原因。

订阅无法导入,或更新后没有条目

回到订阅设置,核对 URL 是否完整、有无过期,以及获取内容是否仍是服务商提供的订阅。链接能够在浏览器打开,不一定表示返回了客户端支持的内容;如果实际返回登录页面、提示文本或空内容,仍无法生成服务器列表。先确认设备基础网络正常,再从你的服务商处核实链接状态与格式。

若更新后只缺少原来的某个条目,先检查分组是否收起、名称是否变化,再重新选择可用条目。不要为了找回名称而反复恢复旧订阅内容;服务器是否仍在服务范围内,应以你的服务商提供的信息为准。

开关无法保持连接,或测试持续超时

先确认系统 VPN 授权,再逐项核对 Type、Host、Port 与身份验证参数。连接超时可能与地址、端口、当前网络或服务端状态有关,不能仅凭超时判断密码错误;出现身份验证相关提示时,再重点核对对应字段。需要比较 Wi-Fi 与蜂窝网络时,完成一次测试后再切换,并记录结果。

进入底部 Settings,可查看 Test Method 与 Diagnostics。不同 Test Method 所测过程不同,切换测试方式后的结果不应直接当作同一条件比较。Diagnostics 用来收集线索,不是自动修复按钮;阅读其中与刚才测试时间相近的记录,避免被历史错误干扰。

连接正常,但部分请求不符合预期

先核对 Global Routing,再核对启用的 Config。在 Config 下检查相关 Rule 是否被更早的规则命中,策略是否为预期值,以及最终规则如何处理未匹配请求。只有某个域名异常时,还要检查 Hosts 与 DNS 相关设置;不要立刻改动所有 TCP、UDP 参数,这会增加新的变量。

如果表现为手动断开后又自动连接,查看 Settings 中的 On Demand 条件。为了重现手动测试,可先记录现有条件并暂时关闭自动触发,等基本连接确认后再逐条恢复。On Demand 的触发范围和规则顺序属于进阶内容,参阅On Demand 按需连接说明。

需要向服务商反馈时,提供失败阶段、网络类型、所选协议与已做的对照步骤即可。发送 Diagnostics 记录或截图前,移除订阅 URL、密码、身份标识、密钥等敏感内容。更多订阅更新与连接问题请继续阅读常见问题;协议参数含义则见协议参考。

Shadowrocket Settings 设置页面,展示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:按问题查看 Test Method、On Demand 与 Diagnostics。