官方手册 · 首次连接

Shadowrocket 使用教程

先把已有的连接信息添加到 Home,再决定请求是按规则处理、统一走代理,还是直接访问。开关打开后,用一次服务器测试和一次实际访问确认结果,不把开关状态当成验证结论。

开始前:确认已安装 Shadowrocket,并且已有自己的订阅链接或服务器信息。iPhone / iPad 版从 App Store 产品页获取,$2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac / Windows / 安卓 / Linux 版免费,从客户端下载页安装。本教程以 iPhone / iPad 界面为例。

客户端一次性买断 ≠ 线路套餐。本站不提供、销售或推荐节点与订阅。订阅链接可能含有访问凭据,只需在客户端内填写,不要把完整链接发到公开页面或贴入排查记录。

01 / 导入

Add Server 或 Subscribe:导入已有连接信息

打开 Shadowrocket,进入底部的 Home,点右上角的加号进入 Add Server。手头只有一组服务器参数时,按单条服务器添加;拿到的是一条用于同步服务器列表的订阅链接时,使用 Subscribe。两种方式选其一即可,不用为了导入同一组连接信息分别做两次。

在 Add Server 中填写单条服务器

先选与现有参数一致的协议,再填服务器地址、端口和该协议要求的认证信息。不同协议显示的字段不完全一样,不能把一个协议的认证信息照搬到另一个协议。若参数另外指定了传输或 TLS 设置,也要与原始资料对应。地址、端口分开填写时,不要把两项连同冒号一起贴进地址字段。保存前特别检查复制时是否多带了空格、换行或引号。

保存后回到 Home,在 SERVER 列表中找到刚加的条目。如果列表里有名称相似的旧条目,先查看内容,确认地址和协议与这次添加的一致,再选定它。条目出现只代表信息已经保存,还没有验证远端服务器是否可达。

在 Subscribe 中导入已有订阅

在 Add Server 的类型选项中选择 Subscribe,再把完整订阅链接贴到链接字段并保存。链接如果自带查询参数,应保持原样,不要只复制域名,也不要把链接当服务器地址填到单条记录里。回到 Home 等待获取完成,查看订阅下是否出现可选的服务器条目,而不是只看有没有新增订阅名称。若已经有同一条订阅,先刷新原条目,不必再建一个同名副本。

无论采用哪种方式,继续前都要在 Home 选定一条用于测试的服务器。后面切换 Global Routing 或检查访问时,先保留这条选择,这样测试结果变化时才容易判断是模式变了,还是服务器本身有问题。

02 / 分流

Global Routing:选择流量处理方式

在 Home 点 Global Routing,结合今天要验证的目标选择姿态。这里决定的是请求如何走,不会更改刚保存的服务器参数。第一次验证代理路径时,可暂用代理(Proxy)减少规则条件;日常要让不同请求按各自策略处理时,再用配置(Config)。直连(Direct)可作为对照,但不能证明代理服务器可用。

配置(Config)
按当前配置的规则处理请求。先进入底部的 Config,确认实际启用的是准备使用的配置,而不是仅确认文件出现在列表里。测试某个域名时,从规则前段往后找可能先命中的条件;若没有对应条件,再看 FINAL 指向的默认策略。
代理(Proxy)
将客户端接管的请求交给代理处理,不逐条按当前配置做日常分流。适合确认选定的服务器能否承载实际访问。测试通过后如果改回配置(Config),还要再测一次代表性页面,因为两种姿态的请求路径可能不同。
直连(Direct)
让请求直接访问目的地址,不经所选代理服务器。遇到打不开的页面时,可用它检查当前 Wi‑Fi 或蜂窝网络下的基础访问表现。直连成功说明这次请求有直接访问路径,不说明分流规则是否正确。

选好后回到 Home,核对 Global Routing 一栏的当前值。注意底部的 Config 是管理配置文件的入口,Global Routing 中的 Config 是启用规则处理的姿态:只打开配置文件列表,不等于已经改变了流量处理方式。

03 / 连接

Home:打开连接开关

在 Home 中核对当前服务器和 Global Routing,随后打开连接开关。首次开启时,系统可能弹出添加 VPN 配置的请求。这是为了让 Shadowrocket 按所选方式处理设备流量。确认请求是刚才的操作触发的,再点系统弹窗中的「允许」,并按提示完成设备验证。若之前已经完成授权,不一定会再次看到这个弹窗。

完成后回到 Home,看开关在短暂等待后是否保持开启。如果开关立刻弹回关闭,先不要反复点击,也不用马上删掉订阅。检查有没有忽略的系统弹窗,或者设备上是否有另一条 VPN 连接正在运行。若设备由单位或学校管理,先确认允许变更网络配置,不要自行移除管理描述文件。开关仍然回落时,直接前往常见失败点检查授权与连接状态。

开关保持开启表示系统连接已建立,但并不表示服务器一定响应、每个网站一定可达,或者每条规则都命中了预期策略。现在保持网络、服务器和姿态不变,进入下一步验证。若此前设置过 On Demand,要留意它是否会在切换网络时自动重新连接,以免把两次不同条件下的结果当成同一次测试。

04 / 验证

Connectivity Test:检查服务器与实际访问

先在 Home 找到 Connectivity Test 并运行,等待结果刷新,再查看刚才选定的服务器有没有返回测试结果。响应时间只描述当时的测试条件,不等于实际访问速度;单次超时也不足以判定服务器长期不可用。记录是有响应还是超时即可,不必分享服务器地址、认证字段或订阅链接。

接着打开浏览器,重新加载一个此前确认能够访问的页面。不要只看已经打开的标签页:标签页可能仍显示连接前加载的内容。测试前后尽量使用同一网络和同一地址。若用代理(Proxy)测试并且页面能正常重新加载,说明这次实际访问成功;若 Connectivity Test 有响应而页面加载失败,则需要单独检查目标站点、域名解析或当前请求路径,而不是把两种结果当成矛盾。

如果目标是验证配置(Config)下的分流,先找一个按配置预期走 DIRECT 的域名,再找一个预期使用代理策略的域名,分别重新加载。若客户端诊断记录可用,再按域名和请求时间核对实际使用的策略。页面能打开并不能单独证明命中了指定规则;网页也可能同时请求其他域名,所以应按具体请求核对,不只看地址栏里的主域名。

完成标准:连接开关能保持开启,选定的服务器在测试条件下有响应,实际页面能重新加载。若目标是验证分流,还应确认代表性请求使用了预期策略。做完对照后,将 Global Routing 切回日常所需的姿态,并再访问一次测试页面。

05 / 排查

常见失败点:按最早出错的步骤定位

先确认故障第一次出现在哪里:列表没有条目、开关不能保持开启、Connectivity Test 超时,还是只有个别页面加载失败。从最早失败的位置处理,不要一次同时换网络、服务器和配置。每改一项,就用同一个测试动作复查;否则即使恢复访问,也很难知道哪项修改起了作用。

订阅已保存,但没有可选服务器

回到 Home 看订阅是否已经获取并展开,先对现有订阅执行一次更新。没有条目时,检查设备当前是否本来就能联网,核对链接是否复制完整、是否已失效,以及拿到的内容是否确实用于 Subscribe。如果单条服务器保存后找不到,回到 Add Server 核对必要字段,而不是把同一组参数再粘进 Subscribe。修正后先确认 SERVER 列表有可选条目,再回到流量处理方式继续。

开关弹回关闭,或未出现预期的授权提示

先看系统弹窗是否已被拒绝,或已有其他 VPN 正在连接。在设备的「设置 → 通用 → VPN 与设备管理」中查看 VPN 状态;系统菜单随版本可能略有变化,也可在设置内搜索 VPN。确认没有冲突后,返回 Shadowrocket 再开启一次。若是受管理设备且设置不可更改,应向设备管理员确认限制,不要靠清空客户端数据来处理系统侧问题。

开关能开启,但服务器测试总是超时

先关闭连接,确认设备在当前网络能正常访问常用页面。若基础访问就失败,例如公共 Wi‑Fi 尚未完成登录,应先恢复网络再重测。基础网络正常时,核对服务器协议、地址、端口及对应设置。若已经有其他可用条目,可在同一网络下只换一条服务器作对照,保留其余设置。这样可以缩小问题范围,但不能仅凭一次对照就断定服务端故障。

代理测试通过,但配置模式下个别页面失败

在同一个网络下,用相同的页面分别复测代理(Proxy)和配置(Config)。若只有配置(Config)下出错,先查看当前启用的文件,再看故障域名是否被更靠前的规则匹配。没有命中时检查 FINAL。一个页面可能会从独立域名加载图片或发出登录请求;正文能显示而部分内容失败时,要分别核对这些请求,不要仅凭主域名的策略就改掉整份配置。

排查记录只需保留发生在哪一步、当前姿态、使用的是 Wi‑Fi 还是蜂窝网络,以及问题是否可重复。遇到系统版本、商店可见性或换机恢复问题,改查获取指南,不必通过重新导入订阅来处理购买或安装问题。