OFFICIAL MANUAL / QUICKSTART

Shadowrocket 使用说明 导入、连接与验证

先让一份已有配置完成一次可复现的连接,再调整分流与自动连接。本篇官方手册只讲 iPhone、iPad 上的首次操作,按下面五步依次进行。

操作原则:每完成一步就核对结果。订阅导入成功、连接开关打开、实际请求走到预期路径,分别是三个不同的检查点。

STEP 01 / IMPORT

Add Server / Subscribe:导入已有资料

打开 Shadowrocket 后先进入 Home。这里用于查看和选择服务器;尚未添加资料时,先不用打开连接开关。检查手中的信息是哪一种:订阅链接用于取得一组服务器资料,单个分享链接通常只描述一个服务器,而手动参数则包含协议、地址、端口及认证信息。三种资料的入口可能不同,不要仅凭链接外观把它们混用。

已有订阅链接:选择 Subscribe

在 Home 点右上角加号,进入 Add Server。打开类型选择项,选 Subscribe,将自己已有的完整订阅链接粘贴到 URL 输入项,再保存。若出现备注输入项,可使用便于辨认的名称。粘贴后检查开头和结尾是否完整,尤其不要遗漏问号后的参数,也不要把聊天文字、引号或空格一并带入。

保存后回到 Home,等待订阅内容获取完成,确认对应分组下出现可选服务器。只看到订阅名称而没有服务器,不等于导入已经完成:可能是当前网络无法取得内容,也可能是链接返回了网页提示而非有效订阅。此时应先检查链接状态与获取结果,而不是连续重复添加同一地址。订阅更新入口的呈现以当前界面为准,执行更新后再次检查列表内容。

已有服务器参数:选择对应协议

同样通过加号进入 Add Server,在类型选择中选择资料对应的协议,再逐项填写地址、端口和认证参数。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等协议需要的字段并不相同;只填写资料明确要求的项目,传输方式、TLS、服务器名称等附加参数也应与原资料一致。不要为了凑齐表单,给未提供的字段随意填写内容。

如果拿到的是单个服务器分享链接,可以使用应用提供的链接导入入口;二维码资料则可通过 Scan QR Code 读取。无论采用哪种方式,保存后都应回到 Home 核对条目,再点选准备使用的一项。订阅地址可能含个人访问凭据,不要公开粘贴到评论、截图或排查记录中,也不要把它当作普通网页链接分享。

这一阶段只确认“资料进入列表且可以被选中”,尚未证明服务器可连接。另需区分:订阅通常更新服务器列表,Config 页面管理的是配置文件与规则;导入订阅后,不应直接假设分流规则也已准备好。确认列表正常后,再进行下一步的 Global Routing 选择。

STEP 02 / ROUTING

Global Routing:选择处理方式

回到 Home,打开 Global Routing。它决定请求采用哪一种整体处理方式,并不负责替你补全服务器信息。首次操作时先记录当前选项;不同安装状态、已有配置与此前修改都会影响当前显示,本教程不预设一个统一默认值。三个姿态分别是配置(Config)、代理(Proxy)和直连(Direct),请选择与这次验证目的相符的一项。

配置(Config):按当前配置文件处理

已有可用规则文件并希望按规则分流时,选择配置(Config)。先到 Config 页面确认文件已存在,并且选中了本次要使用的配置。规则可能把不同请求交给 DIRECT、PROXY 或其他已定义策略,因此连接开启后,一部分访问直接连接是可能的正常结果。选中 Config 姿态本身不等于已经选好规则,也不代表所有请求都使用 Home 当前服务器。

代理(Proxy):用于核对代理路径

如果当前重点是确认刚导入的服务器能否工作,可在短时测试中选择代理(Proxy),并核对 Home 中选中的服务器。这样能减少配置文件规则对本次对照的干扰,但仍不能据此推断设备上的每一种流量都必然经过同一路径。测试结束后,若日常使用目标是规则分流,应恢复已准备好的配置(Config),再验证实际需要的访问。

直连(Direct):用于直接连接与对照

直连(Direct)用于直接连接,不适合作为“所选代理服务器已经生效”的证据。排查时它可以帮助比较直接连接与代理路径的差异,但切换前后应保持测试目标与本地网络一致。如果普通访问原本就能完成,仅凭页面能打开无法区分 Direct 和 Proxy,必须结合当前模式、配置规则与后续记录判断。

建议首次验证只选一个明确目标:先确认服务器连接,再确认规则分流。不要在同一轮测试中同时切换 Global Routing、修改 DNS 并更换配置文件,否则结果变化后难以确定原因。关于规则顺序、DNS 与策略的详细关系,可在完成首次连接后阅读Settings 设置手册。

STEP 03 / CONNECT

Home:打开连接开关

返回 Home,先看两处:选中的服务器是否正确,Global Routing 是否仍为刚才确定的姿态。若订阅内存在相近名称,点选后再核对,不要只凭列表中的第一项判断。确认当前 Wi-Fi 或蜂窝网络本身能够联网,再打开 Home 顶部的连接开关。连接资料即使已保存,也需要这一步才会尝试建立连接。

首次建立连接时,系统可能提示添加 VPN 配置。核对该提示是由刚打开的 Shadowrocket 操作触发,再按系统要求允许,并完成设备认证。这个弹窗是在请求系统网络配置权限,不是在购买另一项服务。如果此前取消了授权,回到应用重新发起连接,按实际提示处理;设备受管理或受到限制时,还应检查相应系统限制。

授权后回到 Home,观察开关与连接状态是否保持。系统的 VPN 标识可以辅助确认网络扩展状态,但标识出现不代表每个远端服务器、DNS 请求或目标页面都已成功。相反,如果开关刚打开就关闭,或应用立即报告连接错误,应先处理权限与参数问题,不必急着修改分流规则。

首次测试建议保持条件简单:选定一个服务器、一种本地网络和一种 Global Routing 姿态,暂不调整 On Demand 等自动连接条件。相关选项的初始值以当前应用显示为准;如果原先已启用自动触发条件,应记录下来,避免手动关闭后又自动连接而误判开关异常。不要为了排查,批量重置尚未理解的 Settings 项目。

iPad 的页面布局可能与 iPhone 不同,但核对顺序相同:Home 中选择条目、确定 Global Routing、打开连接、处理系统授权。完成后先不要立刻切换多个应用或网络,保持这次连接进入下一步验证。若需要主动停止连接,可回到 Home 关闭开关,再确认系统状态;已有 On Demand 条件时还需结合其触发设置判断。

STEP 04 / VERIFY

Connectivity Test:核对实际结果

连接开关保持开启后,在 Home 使用 Connectivity Test,查看列表项目返回的结果。测试方式与目标受当前设置影响,因此数值适合在相同条件下比较,不适合直接当作真实下载速度。某次测试失败也不必立刻删除条目:先确认测试条件,再通过实际访问做第二次判断。

接着打开准备使用的网页或应用,执行一次明确操作,例如重新加载页面或请求一项新内容。尽量不要只看已经缓存的页面,因为缓存内容能显示,并不能证明刚才建立的连接已经处理了新请求。记录能否加载、是否长时间等待、是否只有部分资源失败,这些现象比一句“不能用”更有利于定位问题。

使用配置(Config)时,实际请求可能被规则分到不同路径。一个页面能打开,不能说明其他域名也会匹配同一策略;页面主体成功而图片失败,也可能涉及多个域名或不同请求。需要确认具体处理路径时,可查看应用内相关连接记录或 Log,结合当前配置判断,不要单凭 VPN 标识推断全部流量的去向。

如果结果含糊,可以做一组有限对照:保持服务器和本地网络不变,先记录当前 Config 下的现象,再短时切换 Proxy 测试同一目标,结束后恢复原来的姿态。如果 Proxy 正常而 Config 异常,优先检查配置文件、命中规则和策略;如果两者都失败,优先检查服务器参数与网络可达性。对照用于缩小范围,不应变成反复随意切换。

首次验证完成后,保留一份不含敏感信息的简短记录:所用本地网络、服务器备注、Global Routing、Connectivity Test 结果以及实际访问现象。日后修改设置时用同一目标复测,才容易比较前后变化。连接和访问都符合预期时即可结束上手流程,其他 Settings 项目留到确有需求时再逐项了解。

STEP 05 / TROUBLESHOOT

常见失败点:按出现顺序排查

遇到问题先停在失败的那一步,不要直接重做全部流程。下面按资料导入、连接建立与实际访问的顺序检查。每次只改变一个条件,复测后再决定下一步;已经能成功的部分应尽量保留,这样才不会把一个问题变成多个变量。

保存订阅后没有服务器

先核对 URL 是否完整、是否混入空格,以及这份资料是否确实是订阅链接。再确认当前网络能够获取订阅内容,查看应用给出的更新提示。链接失效、凭据不正确或返回内容格式不匹配,都可能导致列表未生成。请向原资料提供方确认有效状态,不要把错误页面当成订阅再次导入,也不要公开整条链接求助。

连接开关无法保持

先检查系统 VPN 配置授权是否完成,然后核对 Home 当前所选条目。手动填写的资料尤其要检查协议、端口、认证字段以及 TLS 等附加参数,不能只确认地址正确。如果设备存在管理限制或其他网络配置影响,应先核对系统提示。修改资料前保留原始信息,避免排查过程中忘记最初参数。

连接已开启,但访问失败

先确认本地网络可用,再比较相同服务器在不同本地网络下的现象。若只有某一个服务器失败,重点检查该服务器资料与状态;若所有已有条目都失败,先看共同的本地网络条件和设置。不要同时更改多个 DNS、协议与传输字段;仅在资料要求或诊断证据明确时,修改对应项目并记录结果。

部分网站正常,部分请求异常

记录出问题的目标和操作,检查 Global Routing 是否为预期模式。Config 下优先核对当前启用的配置与命中策略,再用同一目标作必要对照。若问题只发生在一个网页或应用,还应考虑目标服务自身状态及缓存影响。规则分流的完整说明见设置手册,不建议在首次上手时直接批量改写规则。

测试有结果,但速度不符合预期

Connectivity Test 的响应结果与持续传输能力不是同一个指标。先固定测试目标,比较本地网络状态,再检查所选服务器与协议参数;每轮只换一个条件。若需要进一步整理排查思路,可阅读连接慢的分层检查说明。一次结果不足以判断长期表现,也不应据此反复删除有效配置。

需要查看 Log 时,只复现一次相关失败并关注该时段,避免大量无关记录干扰判断。向资料提供方描述问题时,可提供失败发生在哪一步、当前模式、网络类型及脱敏后的错误信息;应移除密码、完整订阅地址、认证参数和个人访问记录。资料有效性由原提供方确认,应用内操作则可回到本页对应步骤重新核对。

下一步:先保留可用状态,再逐项设置。

本篇负责完成首次连接。DNS、On Demand、Ping、Log 等项目的含义与推荐检查顺序,继续查看Settings 设置手册 →;需要重做导入时,从第一步 Add Server / Subscribe开始即可。