官方手册 · 快速上手
Shadowrocket 快速上手
添加服务器或导入订阅,选择连接模式,再检查实际访问结果。
Add Server:添加或导入
先看手头是哪一种资料。订阅链接通常用于取得一组可更新的服务器条目;单台服务器的资料则会给出协议、地址、端口和对应的认证参数。首次设置只选一种方式即可。打开 Shadowrocket,从 Home 进入 Add Server;也可以从 Home 右上角的添加按钮进入。
手上有订阅链接:选 Subscribe
在 Add Server 点开 Type,选择 Subscribe,把自己的完整订阅链接粘贴到显示的地址栏。链接如果带查询参数,复制时要保留它们;不要只复制网址开头,也不要把资料页标题或说明文字一并粘进去。保存后回到 Home,等待订阅取回条目,再检查 SERVER 下是否出现可选的服务器。订阅链接可能含访问凭据,不要发到公开讨论区,也不要连同地址一起截图。
手上有单台服务器资料:按协议填写
在 Type 里先选择资料注明的协议,再填写 Host 和 Port。Host 填资料给出的域名或 IP 地址,Port 单独填端口,不要把两项合并到一个输入框。截图中的 Password 与 Method 是所示协议的字段;更换 Type 后,表单可能不同。逐项照录对应资料,不确定的参数先向原服务商核对,不要用另一个协议的参数补空。如果已有二维码,可使用 Scan QR Code,导入后同样要核对条目。
保存后回到 Home,在 SERVER 下点选本次要测试的服务器。列表有记录只说明资料已保存或取回,不说明服务器已经连通。如果没有可选条目,先处理导入失败,不用反复拨动连接开关。
Global Routing:选择模式
在 Home 点 Global Routing。这个入口决定连接打开后,客户端怎样处理流量;它不会替你选中服务器,也不会修改订阅内容。先明确本轮要做的是日常分流、检查服务器,还是对照直接访问,再从下面三种姿态中选一项。
- 配置(Config)
- 按当前启用的配置文件匹配规则。命中的请求可能走
PROXY、走DIRECT,也可能被REJECT。已有准备好的规则、并且希望按不同访问目标分别处理时,选择 Config。 - 代理(Proxy)
- 不按配置里的分流规则逐条决定策略,使用所选服务器处理客户端接管的流量。首次设置时,如果只想确认服务器是否可用,可暂选 Proxy,待验证后再切回日常使用的模式。
- 直连(Direct)
- 让客户端接管的流量直接访问,不经过所选服务器。可以用它记录当前网络的对照结果。开关处于连接状态并不改变 Direct 的含义,因此不能仅凭开关位置判断请求是否经过服务器。
Global Routing 里的 Config 是模式,底部的 Config 是配置文件入口。若选了配置(Config),请在底部打开 Config,确认当前启用的是打算使用的文件。打开编辑页可以看到 General、Rule、Hosts 等分段;首次验证只需核对文件,不必为了连接去点 Add Rule。规则的匹配顺序和写法见配置大全。
选完回到 Home,查看 Global Routing 一行显示的值。记下这个值以及已选服务器,下一步先保持两项不变,这样测试不通过时才知道要检查哪一项。
Home:打开连接开关
在 Home 最后核对两处:SERVER 下选中的是本次要测试的服务器,Global Routing 显示的是上一步选定的模式。然后拨动顶部 Not Connected 一行的开关。第一次打开时,iOS 或 iPadOS 可能提示添加 VPN 配置。确认提示是在刚才操作 Shadowrocket 后出现的,再按系统提示允许;若系统要求验证身份,在系统界面完成即可。
完成授权后回到 Home,先等顶部状态变化,再确认它没有立即回到 Not Connected。如果开关弹回,先看系统授权是否已完成,以及设备上是否有另一项 VPN 连接正在使用。若设备由学校或单位管理,系统可能限制新增 VPN 配置,应先向管理员核对,而不是反复重试或删除设备已有的配置。
顶部状态反映的是客户端连接是否已打开,不能证明远端服务器可达,也不能说明每个请求都走同一条路径。此时先不要修改 On Demand,也不要立即切换 Wi-Fi 或蜂窝网络。保留当前条件,进入下一步,分别检查客户端测试和实际访问。
Connectivity Test:验证实际访问
在 Home 运行 Connectivity Test,记录所选服务器的结果。它反映的是当前网络与测试方式下这一次测试的情况。测试成功不等于所有目标均可访问;一次超时也不能单独证明服务器失效。先记下成功、超时或界面提示,再做实际访问检查。
选择一个你原本就能正常访问的页面,用浏览器重新载入,确认这次确实发出了新请求,而不是只看已经打开的旧标签页。检查时保留同一网络、同一台服务器和同一目标。如果要核对当前网络本身是否可用,可以只把 Global Routing 切到直连(Direct),重复访问同一目标,并记下对照结果。
怎么读结果:如果只在配置(Config)下失败,而代理(Proxy)下同一目标能打开,先核对启用的文件和实际命中的规则;如果直连(Direct)也打不开,先检查当前网络和目标本身。一次页面加载不能证明是哪条规则生效,判断时要把所选模式和测试目标一起记下来。
换网络后复测,保留可比较的结果
如果问题只在离开家或办公室后出现,先在能正常使用的网络上建立一份基准记录。记下测试时间、所选条目的名称、路由模式和测试结果,再打开一个不需要登录的熟悉页面。记录浏览器是在等待加载、显示域名解析错误,还是已经收到网站的错误页面。这几种表现来自不同环节,不宜都记为连接失败。
随后切换到出现问题的网络,等系统确认接入后,用相同条目、相同路由模式和相同页面再试一次。如果无线网络要求先通过系统页面登录,先完成登录再测试。若只有新网络失败,先保留原配置,返回原网络验证能否恢复;若两边现在都失败,再检查条目和规则。这样能区分网络切换带来的变化和恰好同时发生的故障,也避免重导订阅后失去对照条件。
完成对照后,把 Global Routing 恢复到计划日常使用的模式。如果目标结果符合预期,首次设置就完成了。如果还有异常,按下一节中最接近现象的一项检查,不必从头重新导入。
Settings:常见失败点
导入后没有条目
先确认基础网络可用,再回到对应的 Subscribe 条目检查地址是否完整。复制过程中常见的问题是漏掉末尾参数,或把说明文字、空格一起粘了进去。如果应用提示地址失效,向原服务商核对当前链接和有效期,不要用其他来源的链接覆盖现有资料。手动添加时则先查 Type,再查 Host、Port 与认证字段;即使名称能显示在列表里,也可能有某个必填值录错。
测试报错,但页面能打开
进入 Settings 查看 Test Method,记录当前方式,再回到 Home 重跑 Connectivity Test。不同测试方式的结果不宜直接比较。若计划比较两次测试,保持网络、所选服务器和测试方式一致。也要核对当时的 Global Routing:例如在配置(Config)下,能打开的页面可能命中的是 DIRECT,不能用它单独证明服务器可以正常转发。
只有个别目标失败,或断开后又自动连接
如果只有个别目标失败,先回到 Config 检查当前启用的文件及对应的 Rule。规则通常从上往下匹配,优先检查是否有较宽的条件提前命中,再检查末尾的 FINAL 如何处理未命中的请求。若现象是手动断开后连接又自动打开,则到 Settings 查看 On Demand 及已有条件。这两种现象的检查入口不同,不要同时重写规则和改动连接条件。
每次只更改一项,再回到 Connectivity Test 验证步骤重复同一检查。需要记录异常时,写下失败环节、所用网络、Global Routing 的值和界面提示即可;分享截图前遮住订阅地址、服务器认证字段以及其他不必公开的信息。