官方手册 首次连接 · 五步检查

Shadowrocket 使用教程

从已有订阅或服务器信息开始,依次完成导入、Global Routing 选择、连接与验证。

下面的步骤按操作顺序排列。若已经完成导入,可以直接跳到 Global Routing;若连接开关已打开但网页无法访问,从验证步骤开始检查。

第一步:Add Server 与订阅导入

打开 Shadowrocket,进入 Home。先分清手中的资料是哪一种:一条能够返回服务器列表的订阅链接,还是包含地址、端口、协议和认证参数的单个服务器信息。两种资料的填写方式不同。不要把订阅链接填进服务器地址栏,也不要把单个服务器的分享内容当成 Subscribe 地址。开始时可以先保持连接开关关闭,避免尚未检查完参数就切换设备网络。

已有订阅链接:选择 Subscribe

在 Home 点击右上角的加号,进入 Add Server。打开 Type,选择 Subscribe,然后返回填写页面,将自己的完整订阅链接粘贴到 URL。填写便于辨认的备注后保存。链接中的查询参数可能用于识别订阅,不要自行删除问号后面的内容;复制时也要检查开头和结尾,避免带入聊天说明、换行或空格。

保存并完成订阅更新后,返回 Home 查看服务器列表。正常结果是出现订阅分组及其中的服务器条目,而不只是留下一个名称。点击其中一个服务器,使它成为当前选择。如果只看到分组却没有服务器,先检查订阅更新是否提示失败;此时反复开关连接不能补全列表,应先解决订阅读取问题。

订阅链接属于敏感资料,不要公开发送完整链接,也不要把包含链接的页面截图交给不相关人员。后续订阅内容发生变化时,更新对应订阅即可。手动修改订阅生成的条目可能在下次更新时被覆盖,因此不要把临时调整当成已经保存的长期配置。

已有单个服务器:选择对应协议

如果手中是单个服务器参数,同样从 Home 的加号进入 Add Server,但 Type 应选择资料标明的协议,例如 Shadowsocks、VMess、VLESS 或 Trojan。按原始信息填写地址、端口与认证字段。需要 TLS、传输方式或其他附加参数时,也应逐项对应;不要仅凭端口数字推测协议,更不要把不同协议的认证字段互相替换。

若持有的是二维码,可使用 Scan QR Code 读取已有服务器资料。导入后仍要打开条目检查协议、地址和端口是否完整,二维码被识别并不等于服务器一定可连接。保存后返回 Home,选择刚添加的条目。到这里,应当能明确指出当前选中了哪个服务器,再进入下一步决定哪些请求使用它。

订阅与单个条目可以同时存在,但首次配置建议只使用一份已确认有效的资料完成验证。不要一次导入大量内容再靠随机切换判断结果。关于订阅更新、重复分组和参数字段的更多说明,见问答。

第二步:选择 Global Routing

服务器条目决定可使用哪条连接路径,Global Routing 决定请求如何选择路径。在 Home 点击 Global Routing,检查当前姿态。教程统一使用配置(Config)/代理(Proxy)/直连(Direct)三种写法,对应界面中的 Config、Proxy、Direct。切换后返回 Home,再确认显示的是刚才选择的姿态,避免记忆中的设置与实际状态不一致。

配置(Config):按当前配置规则处理

配置(Config)适合按规则区分请求去向。使用前进入 Config,确认当前选中的是准备使用的配置,而不只是列表里存在一份同名文件。服务器订阅与规则配置不是同一件事:导入服务器列表不代表已经导入完整规则,也不代表所有网站都会自动使用所选服务器。

规则通常按顺序匹配,前面的命中结果会影响后面的处理。PROXY、DIRECT 与 REJECT 表示不同动作,不能只看规则里是否出现某个域名。初次使用时先保留已经理解用途的配置,确认正常访问后再做修改。若暂时没有弄清 Config 中的规则,不要通过叠加多份配置尝试修复连接。

代理(Proxy):检查所选服务器链路

代理(Proxy)可用于暂时减少规则差异,观察所选服务器能否完成实际请求。它适合定位问题,不等于必须长期使用的姿态。如果代理(Proxy)下目标页面能够打开,而配置(Config)下失败,应优先检查当前配置及规则,而不是立即重新输入服务器密码。测试结束后,应按实际需求切回准备使用的姿态。

直连(Direct):检查设备基础网络

直连(Direct)用于检查不经过代理服务器时的网络表现。选择它并不能验证服务器是否可用;即使客户端开关处于打开状态,请求也可能按直连方式处理。若目标是检查代理连接,不要停留在直连(Direct)后仅根据开关颜色下结论。

首次验证可以先检查基础网络,再用代理(Proxy)验证服务器,最后回到配置(Config)检查规则。这个顺序把问题拆成三个层次,每次只改变一个条件。有关规则顺序、FINAL 和 DNS 的详细关系,留到基础连接成功后再阅读故障排查手册,不必在第一次连接前逐项调整。

第三步:打开开关并完成授权

返回 Home,依次确认服务器条目已选中、Global Routing 与测试目的相符、订阅列表没有正在等待处理的错误。然后打开 Home 顶部的连接开关。第一次连接时,系统可能显示添加 VPN 配置的提示。阅读提示并确认由当前操作触发后,选择允许,再按系统要求完成设备验证。

系统授权用于让客户端建立网络连接配置,不是填写订阅账号的地方。不要把服务器密码输入到设备解锁验证中,也不要因为出现系统提示就反复删除并重装应用。完成授权后回到 Shadowrocket,等待连接状态稳定。若系统提示被取消,应用可能回到未连接状态;重新发起连接并完成授权即可继续检查。

开关保持打开只说明连接流程进入了相应状态,不代表所有目标都能访问。状态栏中的 VPN 标识也不能替代网页验证,部分设备布局下标识的显示位置可能不同。下一步仍要同时检查服务器测试和实际请求,不能把某一个标识当成全部完成的依据。

如果开关刚打开就立即回落,先确认系统授权有没有完成,再检查设备是否存在其他正在工作的 VPN 配置或设备管理限制。暂时停止其他连接后再测试,避免多个配置同时尝试接管网络。受管理设备若限制了添加 VPN 配置,应按设备管理要求处理,不要用连续重试掩盖系统限制。

首次手动连接尚未验证成功时,先不要同时调整 On Demand。自动触发连接的条件会增加观察变量,例如断开后又自动连接,容易被误认为开关失效。先把手动连接与断开各验证一次,再根据需要设置 On Demand。iPad 上操作顺序相同;横屏或分栏只影响页面呈现,不改变先确认条目、再选择姿态、最后连接的顺序。

第四步:验证连接与规则结果

连接后先在 Home 运行 Connectivity Test,观察当前服务器是否返回测试结果。测试用于提供可达性线索,不是线路质量保证。某个测试失败可能与测试目标或服务器设置有关,某次测试有响应也不能证明所有网站都正常。因此应继续打开浏览器,访问实际需要使用的页面,检查能否加载新的内容。

先看基础网络,再看服务器

如果结果不明确,先断开客户端,访问一个平时能够直连打开的页面。若基础网络本身不可用,先处理 Wi-Fi 登录认证、蜂窝网络或路由器连接,再返回客户端。如果基础网络可用,重新选择原服务器,使用代理(Proxy)完成一次连接,并重新访问目标页面。检查时保持网络环境不变,避免同时切换 Wi-Fi、服务器和模式。

浏览器已经打开的页面可能来自缓存,现有应用连接也可能沿用切换前的路径。复测时重新加载页面,必要时关闭原页面后再打开,确保产生新的请求。不要仅凭页面还停留在屏幕上就认为新配置已经生效,也不要仅凭某个应用短暂转圈就判断所有连接失败。

回到配置(Config)验证分流

代理(Proxy)下可访问后,切换到配置(Config),用相同服务器和相同目标再测一次。若只有此时失败,进入 Config 检查选中的配置与规则顺序;在可查看连接记录的位置,关注目标域名对应的匹配动作和实际去向。应当核对请求是否按预期使用 PROXY 或 DIRECT,而不是只看规则文本是否含有目标名称。

若仅有某个域名失败,还需要区分域名解析、规则动作与远端连接。首次排查先记录出错域名、当前姿态与错误现象,不要立刻改写全部 DNS 设置。服务器可达、域名可解析、目标服务正常是不同条件,单独完成其中一个不能替代其余检查。更深入的判断见DNS 排查。

完成后做一次收尾检查:保留计划使用的服务器与姿态,断开再连接,确认结果可以重复。记下有效组合,之后更新订阅或修改 Config 时才有可比较的基线。记录中不要包含完整订阅链接、密码或其他认证信息。

第五步:按现象检查常见失败点

遇到失败时,先确定停在哪一步:资料没有导入、服务器无法测试、开关无法保持,还是连接后特定页面异常。每轮只修改一个项目,复测同一目标,并保留错误提示原文。直接清空配置会丢失对照信息,反而难以知道问题来自订阅、规则还是设备网络。

Subscribe 更新失败或列表为空

回到订阅编辑页面检查 URL 是否完整,有没有误用网页地址、复制到过期链接,或遗漏认证参数。再确认设备本身能联网。订阅返回的内容格式也必须能被客户端识别,网页说明或错误页面不能当作服务器列表导入。涉及链接有效期、访问权限或服务端返回异常时,向自己原有的服务提供方确认,不要把个人订阅链接公开用于求助。

Connectivity Test 超时

先在当前网络下检查基础访问,再核对服务器地址、端口、协议与认证参数。手动添加的条目应逐项对照原始资料,特别留意 TLS 与传输参数。可以在同一订阅中选择另一个已有条目作对照,但不要在每次测试时同时更换网络和配置。只有测试超时而实际页面可访问时,应继续检查测试目标,不能仅凭一项测试删除服务器。

开关打开,但网页无法访问

先检查 Global Routing 是否停在直连(Direct),再确认当前服务器是预期条目。如果代理(Proxy)能用、配置(Config)不能用,优先检查规则与当前 Config;两种姿态都失败,则继续检查服务器链路和网络。只有部分域名失败时,再进一步查看 DNS 与目标请求记录。不要一开始就更换所有设置,也不要把订阅导入成功当成服务器一定可用的证明。

切换网络或恢复前台后异常

从 Wi-Fi 切换到蜂窝网络后,先确认新网络能够独立访问,再断开并重新连接。若设备从休眠恢复后表现不同,观察是否有 On Demand 条件重新触发,以及所选服务器是否仍然相同。iPad 分屏时可将浏览器与客户端并排核对,但应为每次切换记录清楚先后顺序,避免把旧页面的缓存当成新的连接结果。

仍无法定位时,整理设备类型、系统版本、当前网络、Global Routing、是否所有服务器都失败,以及经过脱敏的错误原文。不要提交完整订阅、密码或二维码。概念性问题继续查看问答;需要按开关、订阅、超时、DNS 或耗电症状逐层检查时,进入故障排查手册。本教程到能够稳定复现一次正常连接为止,后续再逐项调整规则与自动连接条件。

其他设备的获取入口

下载 Shadowrocket