官方手册 Home → Connect

Shadowrocket 使用说明

从已有订阅开始,依次完成添加、模式选择、连接与验证。先跑通一次连接,再调整规则与自动连接设置。

开始前:客户端与连接信息需要分别准备

本教程以 iPhone / iPad 界面为例。请先装好 Shadowrocket:iPhone / iPad 从 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版从下载页免费安装,首次安装的系统放行步骤见安装说明。iPhone / iPad 系统要求以 App Store 页面标注为准。

同时确认已经有自己的订阅链接或服务器信息,相关内容从你的服务商处获取。本站不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐,安装客户端不会自动生成可用的服务器。

按顺序操作即可;已经完成导入的用户,可以直接从 Global Routing 开始。截图用于辨认界面区域,具体字段随所选 Type 和应用界面而变化。

STEP 01 / IMPORT

添加服务器 / 导入订阅

打开 Shadowrocket 后,先停留在 Home,不必马上打开顶部开关。页面下方的 SERVER 分组用于选择服务器;如果这里还没有自己的条目,进入 Add Server。此时应先判断手上的资料属于哪一种:能够更新一组服务器的订阅链接、单台服务器的分享链接,或需要逐项填写的参数。三种资料的入口可以不同,不要仅凭链接看起来相似就填进同一个字段。

已有订阅链接:选择 Subscribe

在 Add Server 中打开 Type,选择 Subscribe,再把完整订阅链接填入 URL。链接应从你的服务商处获取,粘贴时保留开头、路径和查询参数,不要带入聊天消息中的解释文字、换行或末尾标点。若界面提供备注字段,可以写一个便于辨认的名称,例如“日常连接”;备注只用于本地识别,不会修正链接本身的错误。

确认后保存,等待订阅下载完成,再返回 Home 查看 SERVER。成功的标志是出现对应的服务器条目,而不仅是保存了一条订阅记录。若只看到订阅名称却没有服务器,先检查网络能否访问订阅地址,再核对链接是否失效、内容是否属于服务商提供的适用格式。不要为了让列表出现内容而反复添加同一条链接,重复条目会增加后续选择和排错的难度。

已有服务器参数:按 Type 手填

如果收到的是 Host、Port、Password 等独立字段,就在 Add Server 中先选正确的 Type,再填写该类型要求的内容。Host 填服务器域名或 IP,Port 填对应端口,Password 保留大小写与符号。Method 等字段只在对应协议需要时填写,不要照着另一种协议的截图补齐所有项目;选择 Type 后出现的字段才是本次需要核对的对象。

例如,Shadowsocks 的 Method 必须与服务器一致;Trojan 涉及的 TLS 与服务器名称设置也应按已有资料核对。地址、密码或服务器名称有任何一项不明确,应向你的服务商确认,而不是轮流试填。截图中的字段用于说明 Add Server 的结构,并不代表所有 Type 都使用同一组字段。保存后回到 SERVER,核对备注与目标服务器,接下来再选择流量走向。

已有分享链接或二维码:导入后仍要核对

如果收到的是单台服务器分享链接,可使用应用提供的剪贴板导入入口;二维码可从 Scan QR Code 进入,并按系统提示允许相机访问。导入前确认来源与内容属于自己的服务器信息,导入后打开条目核对 Type、Host 和 Port。Import from Cloud JSON 是另一种指定格式入口,不应当作任意订阅地址的通用输入框。

订阅链接往往包含访问凭据,二维码也可能包含完整密码。不要把它们贴到公开评论区或作为排错截图直接发送。订阅更新、多组订阅整理及分享链接字段的详细说明,见订阅与服务器管理手册;这里先保留一组确认有效的资料继续下一步。

Shadowrocket Add Server 页面,显示 Type、Host、Port、Password、Method 及 Scan QR Code 等入口
Add Server:先确定 Type,再按对应字段填写。Subscribe 与单台服务器的参数填写用途不同。

STEP 02 / ROUTING

选择 Global Routing 模式

服务器已经出现后,返回 Home,打开 Global Routing。这里决定请求按什么方式处理,不负责下载订阅,也不会替你补全服务器参数。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。先理解这一步,再打开连接,可以避免把“选中了服务器”误当成“所有请求都已经经过服务器”。

配置(Config):按当前规则决定去向

配置(Config)会使用当前选用配置中的规则。进入 Config 可以查看、选择和编辑配置文件;编辑页中的 General、Rule、Hosts 等分段有各自用途,Rule 用于核对规则内容。日常使用前,应确认选中的是准备使用的文件,而不是仅下载了文件却仍在使用另一份配置。首次上手不必同时改 DNS、重写与 HTTPS Decryption,先保留能够解释清楚的基本规则。

下面是规则格式说明,不是要求直接覆盖现有配置。规则通常按顺序匹配,命中的策略决定对应请求走 PROXY 还是 DIRECT,FINAL 用于处理此前未匹配的请求。如果尚不了解当前配置的来源与规则顺序,先查看它的 Rule 内容;具体关键字可查概念速查。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

代理(Proxy)与直连(Direct):用于对照流量路径

代理(Proxy)用于将应用接管的请求交给所选代理策略,是检查服务器是否基本可用的对照方式;直连(Direct)则让应用接管的请求直接连接目标。Direct 不是关闭顶部连接开关,两者控制的是不同层面。需要退出连接时仍应回到 Home 关闭开关,而不是只把模式改为 Direct。

如果 Config 下某个页面打不开,可以短暂切换 Proxy 再测试同一个页面:Proxy 可用而 Config 不可用时,检查重点转向配置匹配、策略选择与解析设置;两者都不可用时,先继续检查服务器和本地网络。一次只改一个选项,记录原来的模式,测试完成后恢复日常选择,避免排错设置长期留在设备上。

Shadowrocket Config 配置编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config 编辑页:Rule 用于查看与编辑规则。Global Routing 的模式选择位于 Home,不在这个编辑页内。

STEP 03 / CONNECT

选择条目,打开连接开关

回到 Home,在 SERVER 分组中点选准备使用的服务器,确认选择标记落在正确条目上。订阅里有多个条目时,不要只看备注中相似的文字;必要时打开详情确认地址。服务器列表已经出现,只能说明资料已经导入,是否能够建立连接还要通过接下来的授权与实际访问验证。

打开页面顶部连接开关。第一次连接时,系统可能询问是否允许添加 VPN 配置;阅读提示,确认这是刚刚在 Shadowrocket 中主动发起的操作,再按照系统要求完成授权与设备验证。此提示是客户端建立系统网络连接所需的权限,与订阅是否有效是两回事。若先前取消了授权,返回应用重新发起连接,并观察系统是否再次出现确认步骤。

授权结束后回到 Home,观察顶部是否从 Not Connected 转为已连接状态。不要在状态变化期间连续开关;先等待本次操作结束。如果开关立即回落,记录是否出现错误提示,再进入后面的排错步骤。若另有正在运行的系统 VPN 配置,也应先确认连接状态,避免把另一项配置的表现误算到当前测试中。

首次验证阶段建议保持手动连接。On Demand 可以在之后按需要配置,但现在开启会增加自动重连条件,让“是否已经手动断开”变得不容易判断。完成第四步并确认访问符合预期后,再阅读FAQ 中的连接与 On Demand 说明,决定是否需要按条件自动请求连接。

Shadowrocket Home 页面,顶部显示 Not Connected 开关、Global Routing 和 Connectivity Test,下方为 SERVER 与 Add Server
Home:先在 SERVER 选择条目,再操作顶部开关;Global Routing 与 Connectivity Test 也在此页。

STEP 04 / VERIFY

验证连接,不只看开关状态

开关保持连接后,先在 Home 运行 Connectivity Test,观察所选条目是否有测试结果。测试结果只能说明当前测试方法下的连通情况,不等同于所有网站可用,也不等同于实际下载速度。某种测试方法没有响应时,不要立即删除服务器,先配合真实访问判断。

  1. 检查普通访问。打开浏览器,访问一个平时已知可用的页面,确认设备仍能正常加载内容。如果普通页面也失败,先检查 Wi-Fi 或蜂窝网络是否需要登录认证,再考虑规则问题。
  2. 检查预期经过代理的目标。选择一个你明确需要通过代理访问、且已知服务正常的目标,刷新页面并等待加载。Config 下普通页面可以直连成功,因此仅靠普通页面打开,不能证明代理路径已经工作。
  3. 必要时做模式对照。保持同一个服务器、同一个网络和同一个目标,短暂切换 Proxy 与 Config。每次只改变模式,避免同时更换服务器和网络后无法判断到底是哪项变化生效。
  4. 恢复日常设置。测试结束后回到准备长期使用的模式。若需要断开,关闭 Home 顶部开关,并确认状态变化;不要把 Direct 当成断开操作。

如果浏览器工作正常而某个应用仍失败,继续确认该应用自身服务状态、连接缓存和实际请求目标。可以结束该应用的当前操作后重新打开再试,但不必先重装 Shadowrocket。遇到证书警告时也不要通过开启 HTTPS Decryption 来“试修复”;首次连接验证并不需要这项设置。

完成这一步后,已经能够区分“导入成功”“系统连接建立”和“目标访问成功”这三个结果。以后遇到问题,先说明失败停在哪一层,比只描述“连不上”更容易缩小排查范围。

STEP 05 / TROUBLESHOOT

常见失败点与检查顺序

排错时先保留当前配置,不要一开始就清空列表。依次检查下面的层次,每修正一处就返回 Home 重测。这样可以确认修改是否有效,也便于在没有改善时恢复原值。服务商提供的参数与当前界面不一致时,先核对 Type,而不是把缺少的字段随意放进备注或密码栏。

订阅保存了,但 SERVER 没有条目

这通常应从订阅下载环节检查。核对 URL 是否完整,是否误把单台服务器分享链接放进 Subscribe,或复制时带入空格与标点。再确认本地网络能够完成订阅请求,以及服务商是否调整了链接。订阅更新失败不一定会立即使已有条目失效,先保留仍可辨认的旧资料;整理与更新策略见节点管理手册。

开关回落,或者始终停在未连接

先看系统添加 VPN 配置的授权是否完成,再检查 Home 是否已经选中有效条目。记录应用提示的具体文字,并确认设备当前有没有其他正在工作的 VPN 配置。此阶段还没有必要反复修改 Rule:如果系统连接本身没有建立,规则层面的调整通常不能解释授权失败。

已经连接,但测试超时或目标打不开

先关闭连接,确认本地网络本身可用,再恢复连接核对 Host、Port、认证字段与 TLS 相关参数。Connectivity Test 的表现还取决于 Test Method;进入 Settings 查看当前方法后,再结合浏览器访问结果判断。测试有响应但某个页面失败,不能单凭该结果断言整条连接都正常;测试无响应但页面可以访问,也应继续核对测试方式。

Proxy 可以,Config 不可以

这种对照结果更适合从当前配置检查:Config 中是否选对文件,Rule 的匹配顺序是否符合预期,目标请求是否被分配给了不同策略。先定位具体目标与命中方向,不要直接将所有 DIRECT 替换为 PROXY。规则关键字与策略含义可在概念速查查看,深入整理留到基本连接稳定之后。

需要保留诊断记录时

Settings 中的 Diagnostics 用于进一步检查问题。记录当时的网络类型、Global Routing 模式、所选服务器备注及失败表现,必要时只截取相关错误片段。发送记录前遮盖完整订阅 URL、Password、二维码与其他认证信息;仅为说明故障,不需要公开整份服务器资料。更长的问题清单见FAQ。

当导入、连接与真实访问都已验证通过,就先保持这一组设置。之后再逐项学习 On Demand、配置备份与订阅更新,每次调整都保留可返回的状态。这样后续即使出现变化,也能知道是新增设置的影响,还是原有连接条件已经改变。

Shadowrocket Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:排错时关注 Test Method 与 Diagnostics。On Demand 留到手动连接验证通过后再设置。