官方手册 · 操作入门

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

先把已有信息正确导入,再选择路由姿态并连接。按下面五步操作,逐项确认结果;出现异常时,回到对应步骤检查,不要同时修改多项设置。

步骤 01 · 先得到可选条目

Add Server:添加服务器或导入订阅

打开 Shadowrocket,停留在 Home。此时先不要打开顶部连接开关,而是在页面下方找到 Add Server。准备的信息通常有两类:一类是单个服务器的地址、端口及认证参数,另一类是一条能够返回服务器列表的订阅链接。两种信息对应不同的填写方式,不能把订阅链接整段填进 Host,也不能只凭一个服务器地址推断其他参数。

已有单个服务器信息

点 Add Server,先核对 Type,再填写该类型要求的字段。截图中的 Host、Port、Password、Method 是对应类型下的字段示例,切换 Type 后显示内容可能变化。Host 填服务器域名或地址,Port 填对方给出的端口;Password 与 Method 必须逐字匹配已有资料。遇到额外认证、传输或 TLS 相关选项,继续按原始参数填写,不要沿用截图中的默认值作为自己的连接参数。

如果拿到的是二维码,可以使用页面中的 Scan QR Code 读取自己的服务器信息。读取成功后仍要检查 Type、Host 和 Port,再保存。Import from Cloud JSON 用于相应格式的数据导入,不是任意网页或订阅地址的通用入口。无法确认资料属于哪种格式时,先核对信息说明,避免反复尝试不同入口而生成重复条目。

已有订阅链接

对于订阅,在 Add Server 的 Type 中选择 Subscribe,找到 URL 输入位置,粘贴自己的完整订阅链接并保存。复制时尤其注意链接开头、结尾及参数是否完整,避免混入换行、空格或说明文字。订阅可能含有个人访问凭据,不要把完整链接发到公开页面,也不要为了求助而展示包含凭据的二维码。

保存后回到 Home,等待列表加载;需要刷新时,对相应订阅执行更新操作。只有出现可选择的服务器条目,才表示这一步已经得到列表。订阅名称出现在页面上,并不等于链接返回了有效数据。若更新失败,先确认链接仍有效、当前网络能够访问订阅地址,并检查是否返回了登录页面或错误提示;不要把导入失败直接当成连接协议不兼容。

本步完成标志:Home 的 SERVER 区域出现自己的服务器,打开条目能核对到预期的类型和地址。暂时保留原始订阅或参数,后续排错时用于对照,不需要在这里批量修改所有条目。

Shadowrocket 添加服务器页面,显示 Type、Host、Port、Password、Method 以及二维码和 JSON 导入入口
Add Server:先选 Type,再按自己的信息填写对应字段。

步骤 02 · 确定请求如何处理

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

列表准备好以后,回到 Home 打开 Global Routing。这里决定整体路由姿态,不是添加服务器的入口。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。先理解它们的区别,再选择适合本次验证的一项,避免服务器已经添加正确,却因为路由姿态与预期不一致而误判。

配置(Config):按当前文件的规则处理

选择配置(Config)后,请求按当前配置文件中的规则处理,一部分可能使用 PROXY,另一部分可能使用 DIRECT。进入 Config,确认当前实际选中的文件,再查看 Rule。配置文件里的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 各有不同用途,初次上手只需确认选中文件和规则,不必为了连接而把每个分段都修改一遍。

订阅和配置文件不是同一类内容:订阅通常负责提供服务器列表,配置文件负责描述分流等行为。导入订阅不会自动证明已选中适合自己的规则文件。同样,看到 Config 中有文件,也不能证明其中引用的策略在当前环境下都有效。开始时使用自己理解的配置,修改前保留原文件,便于恢复。

代理(Proxy)与直连(Direct):用于明确当前路径

代理(Proxy)适合在排查时观察请求是否能够通过选中的代理服务器处理;直连(Direct)则用于观察直接访问的结果。它们不能简单理解为“更快”或“更稳定”的档位,实际结果取决于当前网络、服务器和访问目标。Global Routing 也不应被当作所有系统流量路径的绝对证明,最终仍要结合实际请求判断。

若已有明确的规则文件,日常使用可选择配置(Config);若暂时只想区分服务器连接问题与规则问题,可短暂切换到代理(Proxy)进行同一目标的对照测试,测试结束再恢复原来的选择。不要在一次测试中同时更换服务器、切换姿态并修改 DNS,否则即使结果改变,也很难判断究竟是哪项设置起了作用。

本步完成标志:能说清当前 Global Routing 的选择。若选择配置(Config),还应知道当前使用哪个配置文件。规则语法需要逐条学习时,可继续阅读规则关键字匹配说明,本页先完成连接闭环。

Shadowrocket 配置文件编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:核对当前文件及 Rule,不需要逐项开启所有分段。

步骤 03 · 建立连接

Home:选择服务器,再打开顶部开关

完成导入和路由选择后,返回 Home。在 SERVER 区域点选本次准备使用的服务器,确认选中标记确实停在目标条目上。如果有多个订阅分组,先确认条目所属分组,避免选择名字相似但参数不同的旧记录。随后再次看一眼 Global Routing,确保它仍是上一步确定的姿态。

现在打开 Home 顶部连接开关。首次连接时,系统可能请求添加 VPN 配置。核对请求由 Shadowrocket 发起,再按系统提示确认;如系统要求设备认证,直接在系统界面完成。这里需要的是设备自身的授权,不需要把设备密码填写到服务器字段中。若之前拒绝过请求,重新发起连接并检查系统显示的具体提示。

回到应用后观察顶部状态是否由 Not Connected 发生变化,同时留意是否出现错误提示。不要只看开关是否短暂变为开启状态:开关马上回落、持续停在连接过程中、或者已显示连接但无法访问,是不同阶段的问题,应分别记录。系统显示 VPN 状态,说明相关连接配置已工作,但不能据此认定所有请求都已经按预期经过目标服务器。

连接过程中,先暂停其他可能改变系统 VPN 配置的连接任务,保持一个清楚的测试环境。如果需要切换服务器,建议先停止连接,确认选中新条目后再连接,这样更容易把现象与服务器对应起来。首次验证时也可以暂时不设置 On Demand,等手动开关的结果稳定后,再决定是否启用自动连接条件。

本步完成标志:目标服务器已选中,顶部连接状态能够保持,且没有持续出现授权或连接错误。即便状态正常,也请继续下一步实际验证;连接建立和目标页面可访问并不是同一个结论。

Shadowrocket Home 页面,显示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 分组和 Add Server
Home:先确认 SERVER 选择,再操作顶部连接开关。

步骤 04 · 把状态与结果分开检查

Connectivity Test:验证测试结果与实际访问

在 Home 找到 Connectivity Test,运行一次测试并等待结果。它有助于检查列表中条目的响应情况,但结果与所选测试方法、测试目标及当前网络有关。某个条目有响应,不代表任意网站或应用都能正常工作;某次测试失败,也不能立即证明服务器所有能力均不可用。先记录现象,再结合实际访问判断。

先检查基础网络,再检查目标请求

打开浏览器,使用平时能够正常访问的页面确认设备确实联网。遇到需要登录或同意使用条款的 Wi-Fi,先完成网络自己的认证流程。随后在连接状态下打开本次需要验证的页面,等待页面主要内容加载,而不只是看到缓存标题或旧内容。必要时刷新页面,并留意是否只有图片、登录或某个子页面失败。

使用配置(Config)时,同一个页面可能产生多个域名请求,各请求可能匹配不同规则。因此,不能用一个页面打开成功来证明全部流量都走 PROXY,也不能用某个页面失败来判断客户端完全没有连接。需要确认分流时,结合应用中可用的请求记录查看目标、匹配规则和使用策略,重点检查结果是否符合当前 Rule 的预期。

每次只做一个对照

如果结果不明确,保留同一个目标与同一个服务器,只改变一项条件。例如,在当前网络下分别观察直连(Direct)与代理(Proxy)的结果,或者保持配置(Config)不变,只替换一个自己已有的服务器。每次记录当前姿态和实际现象,测试后恢复日常配置。避免同时打开多个页面、连续点击更新和快速切换开关,这些操作会使结果混在一起。

本步完成标志:能够同时确认“连接状态保持”“实际目标可访问”“路由行为符合预期”三件事。若只有其中一项成立,就按下一节对应的失败阶段继续检查,不必删掉全部配置重新开始。

步骤 05 · 回到最先失败的位置

Settings 与常见失败点排查

排错从“最早在哪一步不符合预期”开始。导入后没有服务器、测试没有响应、开关无法保持、连接后只有部分页面异常,对应的检查对象不同。先回到本教程对应锚点复查,而不是直接重置所有设置。Settings 中的 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 是进一步检查的入口,不需要在第一次使用时逐项改动。

导入失败:检查输入和订阅返回内容

如果 Home 没出现可选条目,先回到添加与导入。确认选择了正确的 Type,订阅 URL 没有截断,服务器 Port 没有混入文字。订阅更新失败时,核对当前网络能否访问链接,以及链接是否已失效或需要重新生成。若仅缺少某个条目,核对订阅实际返回的数据,不要通过随意切换协议类型来补齐。

测试失败:核对 Test Method 与服务器参数

如果条目存在但 Connectivity Test 结果异常,在 Settings 查看 Test Method,弄清当前测试的是什么。不同方法可能得到不同结果,不能只凭一个数值选择日常服务器。继续对照原始信息检查地址、端口、认证字段和传输设置;字段中多一个空格或使用了旧参数,都可能导致失败。涉及 TLS 时,也应确认设备日期与时间正确,避免证书验证因时间偏差而失败。

开关回落:先检查授权与系统连接状态

如果顶部开关无法保持,确认系统 VPN 配置请求已经处理,再检查是否有其他连接任务正在改变系统配置。暂时关闭 On Demand 做一次手动连接,观察是否仍然出现同一现象。需要查看 Diagnostics 时,先记下本次失败发生的时间与操作,再阅读附近的错误信息;不要把与本次操作无关的旧记录当作当前原因。

已连接但局部失败:区分规则、DNS 与服务器能力

若只有某类目标异常,先确认 Global Routing,再检查当前 Config 的规则顺序、使用策略和 DNS 设置。可在保留原文件后,使用同一服务器做一次代理(Proxy)对照:如果对照正常而配置(Config)异常,优先检查规则与相关设置;如果两者都失败,再检查服务器和当前网络。该方法用于缩小范围,不意味着任何一种姿态都应长期替代另一种。

只有实时通信、特定应用或某些内容异常时,还应结合实际业务检查 TCP、UDP 等相关设置及服务器支持情况,不要只根据“网页能打开”就判定所有传输都正常。涉及 DNS 的调整一次只改一项,记录原值,失败后恢复。不了解的高级选项先保持原状,比同时更换多个参数更容易找到原因。

本步完成标志:能把问题定位到输入、基础网络、连接授权、服务器或规则设置中的某一层,并保留可复现的操作。App Store 获取、账号与恢复购买问题不属于连接排错,另见正版指南;已经定位到规则顺序的问题,可继续阅读规则匹配说明。

Shadowrocket Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:围绕具体失败现象检查,不要同时修改多项设置。