Shadowrocket怎么导入订阅?从订阅链接到节点连接排查
简答:Shadowrocket 导入订阅的核心路径是:Home → Add Server → Type → Subscribe,粘贴完整订阅 URL 后保存,再手动 Update 拉取节点。若节点为空,先查链接是否完整和网络是否可达;若节点已出现但全部超时,再检查节点、路由模式与 VPN 权限。本文以 iPhone/iPad 为例,按钮名称可能随当前版本变化。
定义:Shadowrocket 订阅链接是用于重复获取一组节点配置的地址,不等同于单个节点链接,也不等同于 Config 配置文件。
先按这4步导入:保存订阅不等于节点已经更新
本文是第三方使用指南,以 iPhone/iPad 为例。Shadowrocket 的 App Store 页面将其定义为基于规则的代理工具,并明确说明它本身不提供代理服务或服务器资源;你需要先准备已有的订阅链接或单节点信息。App Store 中的 Shadowrocket 页面可用于核对应用名称、开发者和支持平台。
| 步骤 | 操作 | 成功判定 | 失败时先查什么 |
|---|---|---|---|
| 1 | 打开 Home,点击右上角加号,进入 Add Server | 出现 Type 或类型选择 | 菜单名称可能随版本变化,以当前界面为准 |
| 2 | 在 Type 中选择 Subscribe,将完整订阅 URL 粘贴到 URL 字段,填写便于识别的名称 | 订阅记录出现在 Home | 不要把普通网页地址、登录页或单节点地址当成订阅链接 |
| 3 | 返回 Home,打开刚保存的订阅并执行 Update;部分界面也支持下拉刷新或侧滑后选择 Update | 订阅分组下出现可选择的节点 | 保存成功但节点为空,说明还没有完成拉取或返回内容无法解析 |
| 4 | 选择一个节点,检查 Global Routing,再打开顶部连接开关 | VPN 权限通过,开关保持开启,节点可进行测试 | 开关闪退或无法保持开启时,先检查 iOS VPN 配置授权和节点参数 |
- 复制链接时保留完整内容:从开头到结尾完整复制,保留问号后的参数;去掉聊天软件附带的说明文字、引号、首尾空格和换行,但不要凭猜测补齐被截断的字符。
- 确认导入类型:订阅链接用于获取一组节点;单节点链接或主机、端口、密码等字段应使用对应的单节点入口;Config 通常用于规则、DNS 等配置文件,不要把 Config 链接误放到 Home 的服务器订阅入口。
- 保存后主动更新:“订阅记录已保存”只代表 URL 被客户端接受,并不代表远程内容已经成功下载。完成 Update 后,才进入“节点已拉取”阶段。
- 首次连接授权:选择节点并打开连接后,iOS 可能弹出允许添加 VPN 配置的系统授权。拒绝授权时,节点即使已经出现,也可能无法建立系统级连接。
上述入口和“保存后还要更新”的分层操作,可与公开的 Shadowrocket 导入说明交叉核对:Shadowrocket Tutorial: Subscribe, Nodes, Rules说明了 Home、加号、Subscribe、保存和 Update 的顺序;Shadowrocket import subscription guide也区分了 Home 的服务器订阅和 Config 配置文件。
先判断卡在哪个阶段:订阅、节点、选中和连通是四回事
排查时不要只看“列表里有没有一行订阅”。Shadowrocket 导入成功至少可以拆成四个阶段:订阅记录已保存、远程节点已拉取、节点已选中、VPN 代理已连通。每个阶段失败的原因不同。
| 当前现象 | 说明 | 下一步 |
|---|---|---|
| Home 有订阅名称,但没有节点 | URL 可能只保存成功,尚未 Update,或返回内容为空、过期、不可解析 | 执行 Update,再检查 URL 完整性和网络可达性 |
| 节点数量为 0 | 客户端没有得到可识别的节点条目 | 在浏览器或其他可控网络环境中核对订阅地址返回的是否是配置内容,而不是网页或登录页 |
| 节点已经出现,但没有选中节点 | 导入完成,但连接目标尚未确定 | 点击一个节点,记录当前选择,再检查 Global Routing |
| 节点已选中,但开关无法保持开启 | 可能是 VPN 权限、节点参数、系统网络或客户端状态问题 | 重新授权 VPN,切换 Wi-Fi/蜂窝网络,并测试另一个节点 |
| 所有节点都超时 | 更接近节点、订阅状态、当前网络或协议兼容性问题 | 先确认订阅仍有效,再用另一网络和另一节点对照 |
安全提醒:完整订阅 URL 可能包含 Token 或其他访问凭据。不要把真实链接、二维码、配置文件或带凭据的截图发布到公开论坛;需要求助时只提供错误文字、协议类型和已脱敏的必要信息。相关公开说明也提醒用户不要公开包含凭据的订阅地址,可参考 Shadowrocket FAQ 中的订阅导入与安全排查说明。
按错误现象排查:节点为空、更新失败和全部超时
节点为空或数量为 0
- 回到 Home,打开订阅记录并执行 Update,确认不是只完成了保存。
- 重新取得原始订阅 URL,检查开头、结尾和问号后的参数是否完整;不要使用聊天软件生成的短链接预览。
- 切换 Wi-Fi 与蜂窝网络分别测试。若一种网络能更新、另一种不能,优先判断为当前网络到订阅地址的可达性差异,而不是立即删除全部节点。
- 在浏览器中访问订阅地址只能用于判断是否可达,不能据此证明内容一定能被 Shadowrocket 解析。若浏览器显示登录页、网页说明或错误页,说明地址用途或权限可能不对。
更新失败或更新超时
- 确认订阅仍在有效期内,并向提供链接的一方核对是否更换了地址、Token 或访问权限。
- 检查当前网络是否能访问订阅地址;必要时在 Shadowrocket 已经存在可用节点的前提下,查看订阅更新相关设置是否允许通过代理请求,但不要把“能打开网页”当成订阅一定可更新。
- 不要连续重复添加同一 URL。先保留原记录,记录错误提示,再只修改一个变量,例如网络、URL 或更新方式。
- 如果更新后节点仍为空,检查返回内容是否是客户端支持的订阅格式;普通网页、登录页面和说明文本不能替代节点订阅内容。
节点全部超时或连接后立即掉线
- 先选择一个节点进行测试,再换第二个节点。若只有个别节点超时,更像是节点本身或该节点参数问题;若全部节点同时超时,再查订阅有效性、当前网络和客户端权限。
- 关闭并重新打开 VPN 连接,确认 iOS 已允许添加 VPN 配置;如果系统设置中存在不再使用的旧 VPN 配置,也可以先记录当前设置后清理冲突项。
- 检查 Global Routing 当前模式。Proxy、Direct 和 Config 的用途不同:Proxy 通常把匹配到的流量交给代理,Direct 直接连接,Config 由当前配置文件中的规则决定。不同版本的具体菜单位置可能变化,以当前界面显示为准。
- 如果切换网络、重新授权和更换节点后仍全部失败,保留错误原文,向订阅提供方核对服务状态和节点参数;不要仅凭“能导入”推断“必然能连接”。
公开排障资料同样建议按“URL 完整性→当前网络可达性→订阅有效性→返回格式→节点连接”的顺序缩小范围,可参考 Shadowrocket connection and node troubleshooting guide。其中具体按钮位置可能因版本不同而变化,本文不把未核实的版本号或固定坐标写死。
导入后最小验证清单:不要只看开关颜色
完成导入后,可以按下面清单做一次可复现的检查:
- 订阅层:Home 中能看到订阅记录,Update 操作有明确完成结果。
- 节点层:订阅分组下出现节点名称,并能点选其中一个。
- 路由层:确认当前是 Proxy、Direct 还是 Config 模式,不要把切换配置文件误认为更新节点。
- 系统层:连接开关保持开启,iOS 没有再次弹出 VPN 授权请求。
- 网络层:用一个你明确知道结果的网页或应用进行访问测试,再切换到第二个节点对照;不要把单次页面打开失败直接归因于订阅导入失败。
如果只是想刷新节点,不必先删除全部配置;删除前应至少保存原始订阅 URL、当前选中的节点、有效的 Config 和自定义设置。订阅链接和配置文件都可能包含敏感凭据,备份应存放在自己控制的位置。
常见问题
Shadowrocket 订阅导入后为什么没有节点?
最常见的情况是只保存了订阅记录,还没有执行 Update。先打开 Home 中的订阅并更新;如果仍为空,再检查 URL 是否完整、是否过期、当前网络能否访问,以及返回内容是否为可解析的订阅数据。
订阅链接应该放在 Home 还是 Config?
用于获取一组服务器节点的订阅链接,通常从 Home → Add Server → Type → Subscribe 添加;用于规则、DNS 等配置文件的远程地址,则应根据当前版本的 Config 入口导入。两者名称相近,但作用不同。
节点已经出现,但 Shadowrocket 连接开关一打开就关闭怎么办?
先确认已经选中节点,并检查 iOS 是否允许添加 VPN 配置;然后切换 Wi-Fi 与蜂窝网络、测试另一个节点,并检查 Global Routing。若仍无法保持开启,记录完整错误提示,核对节点参数和订阅状态,不要反复删除重导。
能不能把完整订阅链接发到群里让别人帮忙排查?
不建议。订阅 URL 可能包含 Token 或其他访问凭据。求助时应脱敏,只提供错误原文、协议类型、网络环境和不含凭据的必要配置片段。
Shadowrocket 的订阅更新成功,是否代表节点一定能用?
不代表。更新成功只说明客户端取得并解析了订阅内容;还需要选中节点、确认路由模式、完成 VPN 授权,并实际测试连接。若所有节点都超时,应继续排查网络、节点参数和订阅有效性。
相关阅读
参考资料
- Shadowrocket App - App Store
- Shadowrocket Tutorial: Subscribe, Nodes, Rules(shadowrocketx.com)
- How to Import a Shadowrocket Subscription: Subscribe, Add Server, QR Code, and Clipboard(shadowrocketdocs.com)
- Shadowrocket FAQ: Purchase, Subscriptions & Connection Troubleshooting(shadowrocketsubscribe.com)
- Fix Shadowrocket: Connection, Nodes, Routing(shadowrocketx.com)