官方手册 · 入门指南

Shadowrocket 导入与首次连接

先准备连接信息,再选择分流方式。按五个步骤完成设置,每一步确认结果后再继续。

Add Server Global Routing Connectivity Test
步骤 01 · 准备连接条目

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

打开 Shadowrocket 后,先停留在 Home,暂时不要打开顶部开关。下方的 SERVER 区域用于查看与选择服务器。应用刚安装时,这里可能还没有可选条目;需要先导入已有信息,连接开关才有明确的使用对象。添加服务器与添加配置文件是两件事:前者保存连接地址和身份信息,后者主要描述如何处理请求。

手动填写:先确定 Type

在 Home 点击 Add Server,先打开 Type,选择与你已有信息一致的协议。不同协议要求的字段不同,不要只凭服务器名称猜测。以 Shadowsocks 为例,核对 Host、Port、Password 与 Method;其他协议则按其实际显示的字段填写。地址栏通常填写主机名或 IP,而不是把一整条网页地址放入其中。

逐项复制时,留意开头和结尾的空格、端口数字、密码大小写,以及加密方式是否完整一致。涉及 TLS、传输方式或其他扩展参数时,按原始服务器信息设置,不要通过随意切换参数来试错。填写完成后使用页面的保存操作,返回 Home,确认新条目已出现在列表中。若仍停留在编辑页,应先查看是否有必填项遗漏。

订阅导入:区分服务器订阅与配置文件

已有服务器订阅链接时,从 Home 进入 Add Server,将 Type 设为 Subscribe,在相应的 URL 字段粘贴从你的服务商处获取的完整链接,再保存并等待获取内容。订阅导入完成后,应能在 Home 看到对应分组和服务器条目。只有订阅名称出现、分组内没有条目,还不能视为导入完成,应继续检查返回内容与错误提示。

Config 页用于管理配置文件。若持有的是配置文件地址,应在该页使用对应的远程配置入口;看到 Subscribe 时,也应先核对当前页面处理的是哪一种内容。不要把含有服务器列表的订阅地址直接当作规则文件使用,也不要把仅含规则的文件当作服务器信息导入。拿不准时,先确认原始说明中的内容类型,再继续操作。

如果已有二维码,可使用 Scan QR Code 读取,并在保存前核对解析出的协议与字段;Import from Cloud JSON 则面向相应格式的内容,并不表示任意订阅都能使用该入口。订阅链接可能包含访问凭据,不要把完整链接贴进公开截图或排查记录。更多格式区别见术语表。

继续前检查:回到 Home 后能看到实际服务器条目,且条目不是空白。接下来选择请求如何使用这些条目,而不是立即反复点击连接。

Shadowrocket Add Server 官方截图,显示 Type、Host、Port、Password、Method,以及 Scan QR Code 与 Import from Cloud JSON
Add Server:先选 Type,再填写该协议需要的字段。截图展示的字段不代表所有协议都相同。
步骤 02 · 确定请求策略

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

完成导入后,返回 Home,点击 Global Routing。这里决定请求采用哪一种整体处理方式,不负责创建服务器,也不会替你补齐缺失的连接信息。三种姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。先理解当前选择,再观察后续结果,可以避免“开关已经打开,但访问方式不是预期”的误判。

  • 配置(Config):按当前配置文件中的规则决定策略。请求可能使用 PROXY、DIRECT 或 REJECT,因此不是所有请求都会走同一条路径。
  • 代理(Proxy):用于让流量按代理方式处理,适合在排查时与 Config 做对照。它不会自动修复错误的服务器参数,也不能代替服务器选择。
  • 直连(Direct):按直连方式处理请求。选择此项后,即使连接开关保持开启,也不能据此判断请求使用了代理服务器。

准备使用规则分流时,选择 Config,再进入底部的 Config 页,确认当前选用的是自己准备使用的配置文件。文件存在与文件已被选用不是同一个状态;编辑了另一个文件,也不等于当前连接会采用那些修改。先确认选用对象,再查看其中的 General、Rule 等分段。

官方截图中的 Hosts、URL Rewrite 与 HTTPS Decryption 是其他配置分段。首次连接只需理解当前规则的用途,不必为了完成上手就逐项启用。Add Rule 用于增加规则,但一开始不建议在尚未验证服务器可用时大量追加规则,否则连接问题与匹配问题会混在一起。

规则通常按顺序检查,前面的匹配可能决定最终结果。例如 DOMAIN-SUFFIX 处理域名后缀,FINAL 处理此前未匹配的请求。以下片段仅展示语法,不是可直接套用的完整连接方案;其中的域名是示例值,策略也需要结合实际配置理解。

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

如果只是想先判断已有服务器能否使用,可暂时选 Proxy 完成连接测试,再切回 Config 比较同一请求。每次只改这一项,保留同一服务器和同一测试目标。关于规则类型与策略的进一步解释,阅读功能与设置;关键词含义见术语表。

继续前检查:记下 Global Routing 当前姿态;使用 Config 时,确认已经选用预期的配置文件。

Shadowrocket Config 配置文件编辑官方截图,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:检查配置分段与规则。Global Routing 的入口位于 Home,不在这张编辑页截图中。
步骤 03 · 建立连接

Home:选择服务器并打开开关

回到 Home,在 SERVER 分组中点选准备使用的服务器,确认选中标记落在目标条目上。若订阅导入了多个条目,先固定使用其中一个完成验证,不要在一次测试期间连续切换。名称只便于辨认,是否能够建立连接仍取决于实际地址、协议参数、凭据与当前网络状态。

确认 Global Routing 后,打开页面顶部的连接开关。首次建立系统连接时,设备可能弹出添加 VPN 配置的授权提示。阅读系统说明,确认这是由你刚刚操作的 Shadowrocket 发起,再按提示允许,并根据设备要求完成身份验证。这一步仅用于授权添加系统网络配置;服务器凭据应在应用内的对应服务器条目中核对。

若此前已经拒绝授权,先回到应用重新发起连接,观察是否再次出现系统提示;如果设备由组织管理或受到使用限制,应先核对相应限制,不要通过反复切换应用内参数处理系统权限问题。iPhone 与 iPad 的系统弹窗排版可能不同,判断时以实际提示的应用名称和操作内容为准。

授权完成后,等待顶部状态从截图中的 Not Connected 转为连接状态,再开始验证。开关开启表示本机连接已启动,并不保证所选服务器一定可达,也不代表每个域名都采用代理策略。若开关立即回落,记录当时的提示;若开关能保持开启但页面打不开,则进入下一步检查请求结果,不要把这两类现象混为一谈。

首次验证期间,建议暂时保持同一种网络环境。切换 Wi-Fi 与移动网络会改变可达条件,如果确实需要对照,应先记录原网络下的结果,再切换后重复同一操作。这样才能知道变化来自网络,而不是刚好同时修改了服务器或规则。

继续前检查:服务器选择明确、系统授权完成、开关能够保持连接。此时进入验证,不以开关本身作为最终结论。

Shadowrocket Home 官方截图,显示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 分组与 Add Server
Home:选择条目、检查 Global Routing,再打开顶部开关。Connectivity Test 用于下一步测试。
步骤 04 · 对照实际请求

Connectivity Test:验证连接与规则

连接建立后,在 Home 点击 Connectivity Test,等待测试结束。先看测试是否返回结果,再看当前测试方式。它提供的是指定方法下的可达性线索,不等于所有网站或所有协议都已正常工作。测试失败也需要结合方法判断,不能仅凭一个结果就认定订阅全部失效。

随后打开一个你需要使用、且能够确认是否加载成功的页面。已有缓存的页面可能在连接异常时仍然显示,因此可以刷新,或打开该站点中尚未加载过的页面。先验证一个目标,确认能否取得新内容,再扩大到其他请求。不要一次打开很多应用,否则难以把记录中的请求与实际操作对应起来。

把三层结果分开看

  1. 系统连接层:Home 顶部开关是否保持连接,系统是否接受了 VPN 配置。这一层失败,先处理授权或启动问题。
  2. 服务器测试层:Connectivity Test 是否得到结果,测试方法是否适合当前条件。这一层正常,只说明对应测试条件下有响应。
  3. 具体请求层:目标页面是否成功取得内容,请求记录显示的策略是否与 Global Routing 和规则一致。这一层才对应实际使用结果。

需要核对规则时,查看应用中的请求记录,按刚才访问的域名定位条目,检查其匹配与策略信息。若使用 Config,目标命中 DIRECT 可能正是配置预期;若命中 REJECT,则要先确认是否被规则主动阻止,而不是直接修改服务器密码。页面成功打开也不必然表示使用了代理,应把成功结果与实际策略一起判断。

如果同一服务器在 Proxy 下可以访问目标,而切回 Config 后失败,优先检查该域名的匹配规则、策略引用与配置选择。反过来,两种姿态都失败时,应先查看服务器参数、网络可达性及解析情况。对照测试结束后,记得恢复日常准备使用的姿态,避免把临时排查设置长期保留。

完成标准:开关状态稳定,目标内容能取得,实际策略符合预期。三项都确认后,再考虑增加规则或调整自动连接。

步骤 05 · 按阶段排查

Settings:检查常见失败点

出现问题时,先确定最后一个成功的步骤:是链接还没导入、开关无法保持、测试没有结果,还是只有目标页面失败。随后打开 Settings,核对与该现象有关的设置。截图中的 Test Method、On Demand 与 Diagnostics 分别涉及测试方式、自动连接条件与诊断,不应当一起改动。

订阅未导入或分组为空

先确认粘贴的是完整订阅链接,而不是服务管理页面地址。检查链接有无多余空格、换行或缺失的查询参数,并核对原始链接当前是否仍有效。订阅从你的服务商处获取,若返回内容或使用权限有问题,应根据原始说明核实。再次导入前先查看现有分组,避免重复添加后误把旧条目当成新结果;涉及凭据的链接不要公开展示。

连接开关立即关闭

回到 Home 确认已经选择实际服务器,再检查是否完成系统授权。记录可见错误提示,留意是否存在其他正在使用系统 VPN 配置的连接。不要直接删除所有配置或重置整台设备的网络;先让当前连接独立运行,才能判断问题是否来自权限、配置加载或系统连接冲突。

测试失败或页面加载失败

先在 Settings 查看 Test Method,记录当前方法,再进行一次同条件测试。只有一个条目失败时,重点核对该条目的协议和字段;多个条目同时失败时,也要考虑当前网络以及订阅状态。测试正常但网页失败,应回查域名解析、Global Routing 与规则命中,而不是只重复运行测试。

必要时通过 Diagnostics 查看可用诊断信息,并记录失败发生的阶段。分享记录前,先遮去订阅 URL、密码、身份标识与其他敏感字段。保留错误提示、当前姿态、测试方法和网络类型通常更有助于定位,不需要公开整份配置。更系统的 DNS、超时与更新后异常流程见问题诊断。

手动连接正常后再检查 On Demand

On Demand 用于按条件触发连接,不会修复错误的服务器信息。首次上手先验证手动连接,再设置自动连接条件;如果发现连接会自动恢复或断开后再次启动,回到该项检查现有条件。修改后重复一次预期场景,确认实际行为与条件一致,不要仅根据开关短暂变化判断结果。

保留可复现的设置:一次只改一项,记录改前与改后的结果。手动连接正常、规则符合预期后,本次入门设置即告完成;后续再按需要学习配置文件和诊断细节。

Shadowrocket Settings 官方截图,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:按现象检查 Test Method、On Demand 与 Diagnostics,不把全部设置同时改动。
前往 App Store