官方手册 / 快速上手

Shadowrocket 快速上手

添加已有配置,选择 Global Routing,再完成连接与访问验证。

本文以 iPhone / iPad 的操作顺序为主。系统要求与设备兼容性以 App Store 页面标注为准;截图用于辨认界面,具体项目以设备上实际显示为准。

首次操作建议顺序阅读;已有可用条目时可直接进入模式选择。更完整的配置、规则与日常维护说明见系统教程。

STEP 01 / IMPORT

Add Server:添加与导入

先辨认手中的资料,再选择对应入口;订阅地址与单条服务器信息不是同一种输入。

打开 Shadowrocket,进入 Home,在 SERVER 分组找到 Add Server,或使用页面上的添加入口。接下来先判断资料类型:订阅链接用于取得并更新一组条目;单条分享链接通常包含一个服务器的参数;手动资料则分别给出协议、地址、端口和认证信息。不要把订阅地址直接填进 Host,也不要根据链接看起来的长短判断它属于哪一类。

已有订阅链接:使用 Subscribe

在 Add Server 中点开 Type,选择 Subscribe,再把已有的完整订阅地址填入对应的 URL 字段。备注可使用便于辨认的名称,例如按用途或资料来源记录,避免把认证信息写进备注。粘贴后检查首尾是否多出空格、换行或引号,尤其留意复制时是否截断了地址末尾的参数。确认后保存,返回 Home 等待订阅内容载入。

保存成功不等于内容已成功取回。回到列表后,应能看到订阅分组或其中的服务器条目;若只出现分组名称而没有可选条目,先对该订阅执行更新,再检查是否显示失败提示。订阅的更新只是重新取得条目信息,不会自动保证其中每个服务器都能连接。订阅失效、权限变化或内容为空时,需要核对你原有服务商提供的资料。

已有服务器参数:逐项核对 Type 与字段

手动填写时,先在 Type 中选择与资料一致的协议,再填写 Host、Port 及相应认证字段。截图展示了 Password、Method 等项目,但不同 Type 的字段并不相同,不能把同一组字段套用到所有协议。Host 通常填写域名或 IP 地址,不应附带网页路径;Port 按原资料填写。Password、UUID 等认证值需要完整保留,大小写与符号也不能自行调整。

如果已有可用二维码,可使用 Scan QR Code 读取后检查解析出的类型与地址。Import from Cloud JSON 用于相应格式的数据,不是通用的订阅粘贴入口。无论通过哪种方式导入,保存前都应确认协议与已有资料一致;遇到无法识别的格式,先确认资料的用途,而不是不断切换 Type 尝试。

Shadowrocket Add Server 官方截图,显示 Type、Host、Port、Password、Method 以及 Scan QR Code 和 Import from Cloud JSON
Add Server:先选择 Type,再按已有资料填写对应字段;字段会随所选类型变化。

STEP 02 / ROUTING

Global Routing:选择模式

服务器决定代理连接使用哪个出口;Global Routing 决定请求如何分配,两者需要分别确认。

完成条目选择后,回到 Home,点开 Global Routing。这里需要区分三种姿态:配置(Config)/代理(Proxy)/直连(Direct)。切换模式不会替你补齐服务器参数,也不会使失效的订阅恢复。首次操作的重点是明确当前使用哪种模式,之后的连接与排查才能保持一致。

配置(Config):按当前配置处理请求

Config 根据当前选中的配置文件及其规则决定请求去向。在底部 Config 页面检查已经选择的文件,并进入相应配置查看 Rule 内容。截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置的不同分段;快速上手阶段不必逐项修改,尤其不要为了完成连接而同时开启与当前用途无关的功能。

订阅条目已经导入,并不意味着某份分流规则也已经选中。服务器列表与配置文件分别维护:前者提供连接参数,后者决定匹配逻辑。使用 Config 前,应确认当前文件确实存在,且规则中的策略能够对应到可用的服务器或策略设置。若尚未准备分流配置,可先用 Proxy 完成基础连通性验证,再回到 Config。

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

Proxy 将可由该模式处理的请求交给所选代理路径,适合首次确认服务器是否能够完成实际访问。它是排查中的对照条件,不代表所有应用、所有协议和所有网络请求都必然得到相同结果。Direct 则按直连路径处理请求,可用来比较设备原有网络是否正常;在这个模式下打开连接开关,不应被理解为正在使用所选代理服务器。

一个便于理解的 Config 规则片段如下。它只把 example.com 及其子域交给 PROXY,其他未匹配请求由 FINAL,DIRECT 兜底。example.com 是说明用域名,不是连接服务地址;此片段仅解释路径,不要求首次操作时直接替换整份配置。

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

规则自上而下匹配,命中后按对应策略处理,因此 FINAL 应位于具体规则之后。若需要在 Rule 中使用 Add Rule,先保留原配置,再只添加与当前测试相关的规则。完整语法和策略关联见系统教程中的 Config 与规则说明,本页继续完成连接验证。

Shadowrocket Config 官方截图,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段与 Add Rule
Config:在这里检查配置文件与 Rule。Global Routing 的模式选择入口位于 Home。

STEP 03 / CONNECT

Home:打开连接开关

先确认服务器与模式,再处理系统授权。连接状态只是验证的起点。

回到 Home,重新核对两个位置:SERVER 分组中选中的条目是否为刚才准备测试的服务器,Global Routing 是否仍为预期的 Config、Proxy 或 Direct。订阅更新后,列表条目可能发生变化,因此不要只凭上次记忆判断当前选择。初次连接时先保持当前 Wi-Fi 或蜂窝网络不变,避免同时更换网络导致结果难以比较。

可以先运行 Connectivity Test,查看当前测试方法下的连通性结果。若测试失败,先不要反复开关连接;回到条目检查资料是否完整,并参考最后一节定位。若测试有响应,则继续打开 Home 顶部连接开关。Connectivity Test 的结果只对应其测试方式,不能单凭一次测试就认定所有网页、DNS 解析或应用请求都已经正常。

首次连接:核对系统 VPN 配置提示

第一次启动连接时,系统可能提示允许 Shadowrocket 添加 VPN 配置。这是应用建立系统网络连接所需的授权步骤。确认提示中的应用名称后,按系统说明允许,并完成设备要求的验证。该验证属于设备系统流程,不是在应用里填写订阅密码,也不需要向他人提供设备解锁信息。

授权完成后返回 Shadowrocket,等待顶部连接状态变化。如果刚才取消了授权,连接通常不会完成;可再次打开开关,按实际提示重新处理。如果应用提示授权或配置发生错误,先阅读提示内容,再检查设备是否受到管理限制,或是否有其他正在使用的 VPN 配置影响当前连接。受管理设备应遵循相应管理要求,不要盲目删除不明配置。

已连接:保留当前测试条件

顶部状态从 Not Connected 变为已连接状态后,先保持所选服务器、模式和网络不变。系统显示 VPN 状态,说明相关连接配置已启用,但它不能证明目标网站一定经过代理,也不能证明服务器具备访问所有目标的能力。接下来必须发起一次新的实际请求,检查结果是否符合当前模式。

本轮手动验证期间,先不要额外调整 On Demand。它影响后续自动建立连接的行为,不是导入服务器参数的步骤。若应用在你关闭后又自动连接,应检查已有的 On Demand 设置,而不是立即认定连接开关失效。

Shadowrocket Home 官方截图,显示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 分组和 Add Server
Home:连接开关、Global Routing 与 Connectivity Test 是不同操作,应分别检查。

STEP 04 / VERIFY

访问验证:确认实际路径

把“开关已打开”“测试有响应”“目标访问成功”分开判断,避免只看一个状态。

连接建立后,打开浏览器或需要使用网络的应用,对预先选定的目标发起新请求。已经显示的旧页面可能来自缓存,不能作为本次连接成功的依据。可以重新载入页面,或重新进入具体内容,观察是否能完整载入文字、图片及后续请求,而不只是出现一个页面标题。

验证时至少记录三项:当前服务器名称、Global Routing 模式,以及实际访问是否成功。必要时打开 Data 查看本轮产生的连接或流量记录;记录范围以应用当前设置和显示为准。只有流量计数增加仍不足以证明目标请求使用了预期策略,应结合请求域名、可见的处理信息及实际访问结果判断。

Config 模式:分别验证代理目标与直连目标

如果使用 Config,应选择一个规则明确要求代理的目标,再选择一个预期直连的目标,分别验证。不能因为一个直连目标可以打开,就认定代理服务器正常;也不能因为代理目标可访问,就推断其余请求都正确分流。规则匹配需要关注实际请求域名,网页地址栏中的域名可能并不涵盖页面加载的全部资源。

当 Proxy 可以访问、Config 却失败时,先保留当前服务器,只比较模式差异。检查是否选错了配置文件、较早的规则是否提前命中,以及最终策略是否与预期一致。如果两种模式都失败,优先回到服务器参数、连通性和 DNS 检查,不要一开始就重写整份规则。Direct 下目标可访问,只能说明该目标在当前直连条件下可用。

更换网络:重复同一组验证

完成当前网络测试后,如果日常需要在 Wi-Fi 与蜂窝网络之间切换,再换到另一种网络,使用同一个服务器和同一个目标复测。切换后如出现问题,记录问题是否只在某一网络下发生,并检查系统对该应用的网络权限。不要在换网络的同时更新订阅、切换服务器和修改 DNS,否则难以知道哪一步导致了变化。

最后关闭连接,确认普通网络访问仍符合预期,再重新连接复测一次。这样可以区分偶然缓存、短暂网络波动与可重复的连接结果。若当前配置工作正常,先保留这组设置;更深入的分流调整可在完成基础验证后进行,不需要在首次使用时一次配置所有功能。

STEP 05 / DIAGNOSE

常见失败点:逐项排查

每次只改一个条件,沿用同一测试目标;有改善就保留,没有改善就恢复。

订阅保存了,但没有服务器条目

先确认 Type 是否为 Subscribe,地址是否完整,以及更新操作有没有明确错误提示。此时故障发生在取得订阅内容的阶段,还不能判断服务器连接好坏。检查设备当前基础网络能否正常使用,再核对已有订阅是否仍有效。不要把反复删除并重新添加当作更新成功的证明,也不要将包含认证参数的完整地址贴到公开页面。

Connectivity Test 失败或结果不一致

进入 Settings 查看 Test Method,先记下当前方法,再解释测试结果。测试方法不同,所验证的内容也不同,不能把不同方法的结果直接当成同一种延迟或可用性指标。对单个条目复测,并检查 Host、Port、协议类型与认证值。若已有其他可用条目,可在保持模式和测试目标不变的条件下切换比较;只对某个条目失败时,应优先核对该条目的资料。

连接已建立,但页面无法打开

先看 Global Routing。如果当前是 Direct,所选代理服务器并没有按 Proxy 模式处理请求;如果是 Config,则确认当前文件和规则策略。接着用 Proxy 作为对照,判断问题是否只随配置模式出现。若模式变化不影响失败结果,再检查域名解析、服务器状态以及目标本身是否可用,避免同时修改多处设置。

DNS 排查应从现有设置入手,记录系统解析方式或配置中的 DNS 项目。不要为了试错一次填入多组来源不明的地址。若表现为部分域名失败,而另一些请求正常,可结合 Data 中的新请求和实际错误信息继续缩小范围。完整的解析与规则关联见系统教程;修改后使用同一目标发起新请求,不能只刷新旧的测试数字。

连接行为与手动开关不一致

在 Settings 中检查 On Demand 是否已有自动连接条件。它可能影响网络变化后或满足条件时的连接行为,因此手动关闭后出现再次连接,需要先核对这些条件。首次排查时将自动行为与手动测试分开记录,确认是哪种操作触发连接,再决定是否调整。不要通过同时改动 Proxy、TCP、UDP 等多个分段来解决一个尚未定位的问题。

仍不能定位:整理 Diagnostics 信息

必要时进入 Settings 的 Diagnostics 查看可用诊断项目。先记录问题发生时的网络类型、所选服务器、Global Routing、Test Method 和可重复的操作顺序,再收集对应信息。不要假定所有诊断文件都会自动隐藏敏感内容;发送给相关支持方前,检查并移除订阅地址、密码、认证参数和不需要公开的访问记录。

如果需要向原有服务商确认服务器状态,只提交与该条目相关、且已经去除敏感值的错误描述。若涉及应用获取、已购恢复或设备兼容性,改看获取应用说明。基础连接恢复后,回到访问验证复测,最后保留一份可用配置;后续调整可据此对照,不必从零开始。

Shadowrocket Settings 官方截图,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:先核对 Test Method 与 On Demand;需要进一步定位时再查看 Diagnostics。
前往 App Store