官方手册 / 首次连接

Shadowrocket 使用教程:
从导入到连接验证

按顺序完成五件事:准备可用条目、选择路由姿态、授权连接、验证请求、定位失败点。首次操作从第一步开始;已经导入成功,可以直接跳到对应步骤。

完成标准:Home 有可选服务器,连接开关保持开启,实际请求按所选模式处理。仅看到 VPN 标识,还不足以确认全部操作正确。

STEP 01 / Home → Add Server

添加服务器或导入订阅

先分清手里的资料是什么,再选择对应入口。订阅链接与单个服务器参数的填写方式不同。

打开 Shadowrocket 后,先停留在 Home。这里用于查看服务器条目、选择当前使用的服务器以及控制连接。点击右上角加号进入 Add Server,先查看 Type,不要急着粘贴。你需要判断手里的信息是一条能更新服务器列表的订阅链接,还是某个服务器的地址、端口及认证参数;二者不能按同一种格式填写。

已有订阅链接:选择 Subscribe

在 Add Server 的 Type 中选择 Subscribe,将从自己的服务商处取得的完整订阅链接粘贴到 URL。填写便于自己辨认的名称后保存,返回 Home 等待列表载入。如果出现订阅分组,展开后检查是否有具体服务器条目,而不是只看到分组标题。订阅用于取得或更新列表,订阅标题本身并不等于已经选好可用服务器。

粘贴前后各核对一次:开头、末尾和参数部分是否完整,是否混入空格、换行、引号或聊天软件附带的说明文字。不要把服务商网页地址、账户页面地址当作订阅 URL。链接可能包含账户识别信息,应仅保存在自己的设备上;求助时不要公开完整链接,也不要把它放入共享配置或截图。

已有单个服务器信息:按 Type 填写

如果拿到的是单个服务器参数,在 Type 中选择服务商指定的协议,例如 Shadowsocks、VMess、VLESS 或 Trojan,再逐项填写相应字段。地址与端口要分别放入对应位置,密码或其他认证信息也必须使用原值。遇到 TLS、传输方式或服务器名称等附加选项,按原始资料核对,不要凭协议名称自行猜测。协议相同,不代表所有附加参数都能互换。

如果已有的是供导入的二维码,可以使用 Scan QR Code 读取;出现相机权限请求时,确认用途后再授权。读取完成后仍要查看导入的类型与关键字段,不能只以“出现了一个名称”作为成功依据。手动录入、订阅和二维码是不同的信息进入方式,最终都需要回到 Home 检查实际服务器条目。

保存后在 Home 点选一个具体服务器,核对其选中标记。名称只用于辨认,不证明服务器可用。先不要连续导入同一份资料,以免产生多个近似条目,后续难以判断实际测试的是哪一个。如果列表仍为空,直接跳到第五步的导入排查;已经看到并选中服务器,则继续选择 Global Routing。

STEP 02 / Global Routing

选择 Global Routing 姿态

服务器决定连接交给谁,Global Routing 决定请求如何处理。先确认模式,再解释访问结果。

返回 Home,点击 Global Routing 查看当前模式。三种姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。这三个名称不是服务器分组,也不是协议;切换它们通常不会替你修正导入参数。首次上手时,记下自己选择的模式,后续每次测试都以这个模式为前提,避免把模式差异误判为服务器失效。

姿态处理方式使用前核对
配置(Config)按当前配置文件中的规则选择处理策略。当前生效的配置文件与规则顺序。
代理(Proxy)将适用连接交给所选服务器处理。Home 当前选中的具体服务器。
直连(Direct)适用连接直接访问,不通过所选代理服务器。当前网络本身是否能访问目标。

日常按规则使用:核对 Config

需要按规则区分请求时,选择配置(Config),再打开底部的 Config 标签页,核对当前选用的配置文件。这里的 Config 标签页用于管理配置,而 Global Routing 里的 Config 是路由模式,两处名称相同,职责不同。只有选中某个文件还不够,也要确认 Global Routing 正在使用 Config,否则观察到的行为未必来自该文件的规则。

规则一般从上到下匹配,命中后按对应策略处理。PROXY、DIRECT、REJECT 分别表示不同处理策略,并不是可以填写进服务器地址栏的值。本页先完成首次连接,不要求此时编写自定义规则;配置文件来源、规则排列与 FINAL 兜底等内容可在新手到进阶完整手册继续阅读。

仅为定位问题切换 Proxy 或 Direct

当 Config 下某个目标表现异常,可以暂时选择代理(Proxy),在所选服务器不变的前提下重试同一个目标,用来缩小规则影响的范围。直连(Direct)则可作为当前网络直接访问的对照。切换并不是修复所有问题的通用操作;如果服务器认证参数有误,换成 Proxy 也不会使它自动正确。测试结束后应恢复预定模式,重新发起请求,再进入下一步。

STEP 03 / Home → 连接开关

授权 VPN 配置并连接

先确认本次授权来自刚刚的连接操作,再按系统提示完成验证。

回到 Home,最后核对两项:选中的是刚才导入并准备使用的服务器,Global Routing 显示的是预定姿态。确认后打开顶部连接开关。第一次连接时,iPhone 或 iPad 可能弹出添加 VPN 配置的系统提示。这是系统允许应用建立相应网络连接配置的授权流程,不是要求再次购买应用,也不是订阅导入成功的证明。

如果弹窗由你刚刚打开开关触发,确认应用名称和提示内容后选择允许,并按系统要求完成设备验证。完成后返回 Shadowrocket,查看连接开关是否保持开启、连接状态是否变化。若此前已经授权,后续启动连接可能不再重复出现同样提示;没有弹窗并不必然意味着异常,不要为了再次看到弹窗而反复删除配置。

如果此前选择了取消,应用可能无法完成连接。可以重新尝试开关并留意系统提示;仍无法继续时,到系统 Settings 中搜索 VPN,检查对应配置和授权状态。系统设置入口的分组会随系统界面变化,应以设备实际显示为准。处理前先停止连接,避免在连接过程中同时删除或更改配置。

首次验证期间,建议只保留当前需要测试的 VPN 连接。若另一个 VPN 配置正在连接或自动恢复,可能影响你对当前状态的判断。先停止其他正在工作的 VPN 连接,再返回 Home 重试,不要同时修改服务器、模式和系统配置。暂时不必开启 On Demand;先让手动连接形成可重复的正常结果,再考虑自动连接条件。

当开关保持开启且系统显示相应连接状态后,进入验证步骤。注意,“连接已建立”只说明本地连接流程进入工作状态,不代表远端认证、名称解析或目标网站访问都已成功。此时不要停在状态图标上,应继续用实际请求确认。如果开关立即回落或状态反复变化,先按第五步检查授权与配置,而不是连续快速点击开关。

STEP 04 / Connectivity Test → 实际请求

验证连接是否按预期生效

把服务器测试、目标访问与规则记录放在一起看,不用一个状态数字代替完整验证。

先在 Home 使用 Connectivity Test,观察当前所选服务器对应的测试结果。如果列表中有多个条目,注意结果属于哪一项,不要把其他条目的成功结果当作当前服务器可用的依据。测试未返回响应时,先检查当前网络和服务器信息;测试返回响应时,再继续检查实际目标访问,二者回答的是不同层面的问题。

Connectivity Test 的结果受测试方法、测试目标和当时网络环境影响。某种测试能得到响应,并不保证目标网站的实际请求、名称解析或所需传输都正常;反过来,一次测试失败也不应立即被解释为所有访问均失败。以同一服务器、同一模式重复一次,再用真实访问交叉确认,比不断切换不同条目更有判断价值。

用新请求验证,而不是只看旧页面

打开浏览器,访问自己原本需要使用的目标,重新加载或新开页面,确保产生新的网络请求。已经缓存的页面可以在没有新连接时显示;已经建立的连接也可能延续之前的处理方式。因此切换 Global Routing 或服务器后,应重新发起请求。必要时关闭旧页面再打开,避免用切换前的结果解释切换后的配置。

如果当前使用 Config,可结合请求或连接记录,核对目标是否命中了预期策略。某个请求按 DIRECT 处理并不自动等于分流错误,需要先看配置是否本来就要求直连;同样,选择了服务器也不代表每一个请求都会交给它。先记录目标、当前模式和实际处理结果,再决定是否需要检查对应规则。

Data 用于辅助观察流量

打开底部 Data,观察本次操作前后的流量变化,帮助判断是否产生了新的活动。流量增加只能作为辅助证据,不能单独证明某个指定目标已经走了预期策略,因为设备上的其他请求也可能产生流量。应同时确认目标确实能够完成访问,以及当前模式和相关记录符合预期。

至少完成一次“连接后发起请求、观察结果、重新发起后仍能复现”的小闭环。Wi-Fi 与蜂窝网络之间切换后,必要时再做一次相同验证,判断是否存在特定网络环境下的问题。若只在其中一种网络失败,保留这个差异,带着它进入排查;如果当前结果稳定,就保持这份有效设置,不必继续改动。

STEP 05 / 按失败阶段检查

常见失败点与检查顺序

先找到最早失败的一步。每次只改一项,并重复同一个验证动作。

导入后为空,或提示解析失败

先确认填写的是订阅 URL,而不是账户页面或说明页面地址,再核对链接是否完整。若链接已失效、服务状态有变化或返回的内容不是有效订阅,反复保存同一链接通常不会解决。回到自己的服务商处检查链接状态与原始资料;如需重新取得链接,应替换旧值后再更新,避免保留多个名称相似但内容不同的分组。

接着检查更新订阅时设备是否能够访问该链接。订阅刷新和使用服务器访问目标是两个不同过程,现有连接状态也可能影响刷新。保留当前有效条目,不要先清空列表;在确认网络条件后重试更新,并记录提示原文。如果旧条目仍在而更新失败,优先处理刷新原因,不要把旧列表仍可见误认为已取得最新内容。

有服务器条目,但 Connectivity Test 失败

先核对选中条目,再检查地址、端口、协议与认证信息。手动录入时尤其要注意相似字符和遗漏字段;使用订阅导入时,则检查该订阅对应的服务状态与条目是否仍有效。有其他已有服务器可用时,可以在相同网络、相同测试条件下对照,但不要一次性修改所有条目的参数,否则很难保留清晰的判断依据。

连接开关无法保持开启

这类问题先回到系统授权层排查。确认添加 VPN 配置的提示已完成,检查是否有其他 VPN 连接正在接管,或自动连接条件造成状态反复变化。将手动开关连接作为基线,先暂停相关自动连接设置再试。若仍有错误提示,记录提示内容与触发动作,不要仅凭“开关关了”就断定是订阅链接问题。

开关已开启,但只有部分目标异常

先看 Global Routing:Direct 下不会因为选中服务器就自动使用它;Config 下则要核对生效文件与目标规则。保持服务器不变,短时切换 Proxy 后对同一目标发起新请求。如果 Proxy 可用而 Config 异常,检查范围可先集中在配置、策略和名称解析相关设置;这只是缩小范围,不代表已经证明具体哪条规则有误。

若两种模式都失败,但其他目标正常,应继续考虑目标自身状态、特定连接条件以及服务端对该目标的处理。不要立即重装应用,也不要删除全部配置。先保存有效设置,用同一个目标逐项复测;需要研究 DNS、规则排序或协议附加参数时,转到完整使用手册,本页保持首次连接的操作顺序。

整理结果,再做下一次改动

一份足够有用的排查记录包括:失败发生在导入、连接还是实际访问阶段;使用的 Global Routing;当前网络类型;提示原文;刚修改的那一项;修改前后的结果。记录时遮去订阅 URL、密码及个人账户信息。不要公开整个配置文件来代替问题描述,因为其中可能同时包含多项敏感连接资料。

恢复正常后,将 Global Routing 调回日常预定模式,确认有效配置仍被选中,再重复第四步的实际访问。今后更新订阅、调整配置或切换网络时,也沿用这个验证闭环。若只是忘记操作顺序,回到本页添加与导入或连接验证即可;需要系统理解各项设置,再继续阅读进阶手册。