官方手册 · 首次连接

Shadowrocket 使用教程

订阅导入 → Global Routing → 连接授权 → 验证 → 排查。先完成一次可重复的连接测试,再逐步调整规则与自动连接设置。

  • iPhone / iPad
  • 使用已有订阅或服务器信息
  • 逐步验证

本页只讲第一次操作所需的顺序。订阅分组、更新与备份等完整流程见服务器管理手册;遇到不熟悉的协议名或规则关键字,可先查阅概念速查,不必在首次连接前修改所有设置。

步骤 01 · 建立服务器条目

Add Server / Subscribe:导入已有信息

打开 Shadowrocket,进入 Home。先看服务器列表是否已有条目,再决定添加方式。订阅链接用于取得一组服务器及其后续更新;单个服务器链接或一组手填参数只描述具体连接。两者用途不同,不要仅凭一段文字看起来像网址,就把它当作订阅填入。

已有订阅链接时使用 Subscribe

在 Home 点右上角添加入口,打开 Add Server。在类型选择中选 Subscribe,把自己的完整订阅链接填入 URL。如需填写名称,使用便于辨认的备注即可。粘贴后检查开头和末尾,去掉误带的空格、换行以及说明文字,但不要自行删改链接里的参数。

保存并返回 Home,等待订阅内容载入。正常导入后,应能在列表中看到订阅对应的服务器条目。备注可以帮助识别来源,但备注本身不决定连接是否可用。若只保存了订阅名称却没有服务器,先检查是否出现获取或解析错误,不要马上继续打开连接开关。

订阅地址可能包含用于识别账户的私密参数。不要把完整链接粘贴到公开问答、截图说明或他人的设备中。后续整理与更新也应围绕同一份订阅进行,避免反复添加相同地址造成重复列表。具体更新方式和多订阅整理见服务器管理手册。

已有单个服务器信息时使用 Add Server

再次从 Home 进入 Add Server,按已有资料选择准确的协议类型。随后逐项填写服务器地址、端口及该协议要求的认证信息。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等协议所需字段不同,不要把其他协议中的密码或标识直接套用到当前表单。

如果资料还提供了 TLS、Server Name、传输方式或路径等参数,也要按原始信息核对。服务器地址与用于 TLS 校验的名称可能不是同一个值。不要为了减少填写步骤而关闭原本要求的校验。某个字段含义不明确时,先查协议与网络术语,再向资料提供方确认该连接所需参数。

若已有可识别的服务器分享链接,可使用相应导入入口;二维码可通过 Scan QR Code 读取。扫码前确认内容来自自己的服务器资料,按系统提示授予相机权限。无论使用哪种方式,保存后都应返回 Home,检查条目是否完整,而不是把“成功识别链接”当作“连接已经成功”。

完成本步后,列表中应有可辨认的服务器,并已选中一个条目。接下来选择流量如何处理,再打开连接。

步骤 02 · 确定流量处理方式

Global Routing:选择三种姿态

在 Home 点开 Global Routing,查看当前选项。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。它们决定连接如何选择策略,不负责补全服务器信息,也不会修复失效的认证资料。

姿态 处理方式 首次验证时关注什么
配置(Config) 按当前启用的配置规则决定策略。 确认当前配置及测试目标命中的规则。
代理(Proxy) 让进入代理处理范围的流量使用代理。 确认选中的服务器能否完成请求。
直连(Direct) 使用直接连接。 用于观察当前网络的直接访问情况。

准备按规则日常使用时,选择配置(Config),再进入 Config 检查实际启用的配置文件。这里的 Config 页面管理配置文件,而 Global Routing 中的 Config 选项表示按配置处理流量,二者相关但不是同一个操作。只把文件导入列表,不等于已经选用它。

如果当前目标是先确认服务器链路,可以暂时选择代理(Proxy),完成测试后再切回配置(Config)。这样能减少规则分流对首次判断的干扰,但不能据此承诺设备上每个应用的全部请求都一定经过同一路径。系统网络行为及具体设置仍会影响结果,判断应以实际请求记录为依据。

直连(Direct)不适合用来证明服务器可用。处于该姿态时,即使网站能正常打开,也可能只是当前网络可以直接访问。相反,选择配置(Config)后某个网站仍走直接连接,也未必是配置失效;它可能正好命中了 DIRECT 策略。

首次操作先记下选中的姿态。如果采用配置(Config),再记下当前配置名称。暂时保留现有的 DNS 与其他高级设置,不必复制一整段不理解的规则。关于 PROXY、DIRECT、REJECT 以及规则匹配顺序,可在概念速查中继续阅读。选择完成后返回 Home,进入连接步骤。

步骤 03 · 建立系统连接

Home:打开开关并授权

回到 Home,再次核对服务器左侧的选中标记,并确认 Global Routing 与上一步一致。然后打开页面顶部的连接开关。首次建立连接时,系统可能请求允许 Shadowrocket 添加 VPN 配置。这是应用通过系统网络扩展处理连接所需的授权,不是导入订阅时已经完成的操作。

阅读系统弹窗,确认请求对应 Shadowrocket,再按系统提示允许添加。系统可能要求使用设备密码或身份验证。完成后返回应用,观察连接状态是否保持开启。如果此前已允许添加配置,本次不一定再次出现相同弹窗,不要因没有重复弹窗就判断连接流程异常。

若刚才选择了拒绝,先返回 Shadowrocket 重新发起连接,并检查系统是否仍有待处理的授权提示。不要连续快速点击开关;等待本次操作结束后再判断。受设备管理策略限制的 iPhone 或 iPad,可能不允许新增 VPN 配置,需要先确认设备允许使用这项系统功能。

为了让首次测试结果明确,检查系统中是否还有其他 VPN 连接处于活动状态。不同网络配置可能互相影响,排查时一次只保留本次需要的连接。暂时不要启用 On Demand,以免自动连接条件与手动操作同时变化。待手动连接稳定后,再单独配置按需连接。

开关保持开启以及系统显示 VPN 状态,只能说明系统连接已建立或正在运行,不能证明所选服务器可以访问全部目标。即使远端服务器认证错误,系统网络扩展也可能已经启动。因此,本步的完成标准是授权已处理、连接状态稳定;实际链路是否可用,必须继续做下一步测试。

需要结束本次连接时,回到 Home 关闭顶部开关。首次验证期间不要通过删除系统配置来代替正常断开,否则下一次连接可能需要重新处理授权,也会增加排查变量。

步骤 04 · 用实际请求确认

Connectivity Test:验证是否生效

连接状态稳定后,运行 Connectivity Test,观察测试是否完成及是否出现错误。测试入口的位置和可选项目应以当前应用界面为准。保留测试结果,同时记下所用服务器、Global Routing 姿态和当前网络,便于失败后用同一组条件重试。

随后打开浏览器,访问一个明确的测试目标并刷新页面。先确认目标本身在正常提供服务,再检查新请求是否完成。不要仅依赖已经打开的页面,因为缓存内容可能在网络不可用时仍然显示。若准备比较不同设置,应重复访问同一个目标,而不是每次更换网站。

区分“有延迟结果”和“业务请求成功”

服务器列表里的延迟测试适合初步筛选条目,但测试方法与实际业务请求并不完全相同。某个条目显示延迟结果,不等于认证、TLS 和目标访问全过程都成功。反过来,某种探测没有响应,也不能单凭这一项就认定服务器完全不可用。应结合 Connectivity Test 与实际页面请求判断。

配置(Config)下还要检查策略

如果使用配置(Config),查看应用的连接记录,找到刚才发出的请求,核对目标域名和实际采用的策略。命中 DIRECT 表示该请求按规则直接连接;命中 PROXY 才说明规则把它交给代理处理。若配置使用策略组,还要检查该组实际选用了哪个服务器,不能只看 Home 的默认条目。

不要把“出口没有变化”直接等同于“开关没有生效”。测试目标可能命中直连规则,也可能仍在复用旧连接。先确认请求是新发出的,再看命中的规则与策略。如果只想分辨服务器链路和规则的影响,可以临时切换到代理(Proxy)重复同一测试,记录结果后恢复原先姿态。

当 Connectivity Test、实际访问与预期策略一致时,首次连接验证就已完成。接下来保持这组可用设置,再逐项尝试配置调整。修改前保存可恢复的配置,不要在确认可用后立即同时改动 DNS、规则和服务器,否则出现问题时很难定位原因。

步骤 05 · 按失败阶段缩小范围

首次连接失败:逐项检查

先判断失败发生在哪一步:订阅没有导入、连接开关无法保持、连接已建立但测试失败,还是只有部分目标无法访问。四种现象对应的检查位置不同。每次只改一个设置,再重复刚才的测试,避免靠反复重装或批量改参数碰运气。

Subscribe 保存后没有服务器

重新检查 URL 是否完整,确认填入的是自己的订阅地址,而不是说明网页或单个服务器链接。查看错误属于获取失败还是内容解析失败。获取失败时先确认当前网络能正常联网;内容解析失败时,应核对资料类型和有效性。订阅可能包含已经过期的认证参数,这类问题不能靠修改 Global Routing 解决。

如果之前已成功导入但现在更新失败,先保留已有条目,不要立即清空列表。记录更新时的错误信息,再检查自己的订阅状态。需要整理重复项目、保留备注或备份时,继续阅读服务器管理手册,避免在排查过程中丢失仍可用的信息。

开关关闭、授权没有完成

检查系统授权是否被拒绝,以及设备是否限制添加 VPN 配置。确认当前没有其他连接反复接管系统网络状态。若此前启用了 On Demand,先检查其触发条件,首次排查时暂时改用手动连接。只有系统连接能稳定保持,后续服务器和规则测试才有明确意义。

已连接,但 Connectivity Test 失败

先确认 Home 选中的确实是准备测试的服务器。手填条目要重新核对协议、地址、端口、认证字段以及 TLS 相关参数,尤其注意复制时混入的空格和大小写差异。不要仅修改备注或重新排序,因为这些操作不会修复连接参数。

若手中已有其他有效条目,可在保持同一模式和同一测试目标的情况下切换条目比较。也可以在 Wi-Fi 与蜂窝网络之间做一次对照,但切换网络后要重新连接并重测。对照结果用于判断问题范围,不表示某一网络或某一条目在所有场景下都一定可用。

代理(Proxy)可用,配置(Config)异常

优先检查 Config 中实际启用的文件,以及测试请求命中的规则。配置可能把目标交给 DIRECT、REJECT 或某个没有可用成员的策略组。此时服务器本身未必有问题。先恢复之前可用的配置,再逐条调整相关规则;规则关键字的含义见概念速查。

只有部分域名失败

留意记录中是否出现解析错误、连接超时或 TLS 校验错误。域名解析失败不等于服务器认证失败,单个网站不可用也不等于全部流量都异常。先比较其他目标,再检查当前配置中的 DNS 设置。不要为了试错同时填入多个不明来源的解析地址,也不要用关闭证书校验来掩盖名称或证书问题。

如果需要进一步求助,整理失败阶段、错误原文、所用协议、路由姿态及网络类型。分享记录前删除订阅地址、密码、用户标识和其他认证参数。清晰描述“哪一步成功、哪一步失败”,通常比只说“不能用”更有助于定位。

Shadowrocket 正版下载