Shadowrocket订阅导入后没有节点？格式与更新失败排查指南

先确认导入的是什么：订阅、单节点还是配置文件

Shadowrocket 中的“订阅”通常指向一组可更新的连接资料。添加后，应用需要访问该地址并解析返回内容，才能把节点条目显示在 Home 列表中。导入操作显示完成，不一定代表服务器列表已经成功解析；应以 Home 中是否出现条目、订阅更新是否报告成功为准。

还要区分订阅地址与单个节点分享链接。订阅地址通常用于批量获取和后续更新；单节点链接只描述一个连接条目，常见形式会包含协议名称及编码后的参数。把单节点链接当作订阅地址添加，可能无法取得预期列表。配置文件则可能包含规则、全局参数等内容，并不等于订阅中的节点清单。

订阅内容可能采用服务方生成的格式，也可能经过转换或按客户端提供不同内容。Shadowrocket 能否解析，取决于返回内容是否符合其可识别的节点格式及字段要求。不要仅凭链接以 http 或 https 开头，就判断它一定是有效订阅；网页能打开，也不代表页面返回的是节点数据。

• 订阅地址：确认复制的是服务方提供的完整地址，没有漏掉字符、额外空格或换行。
• 单节点链接：确认使用适合添加单个服务器的方式，不要把它作为批量订阅地址反复更新。
• 配置文件：如果得到的是 .conf 文件，应在 Config 中导入和选择；它与 Home 中的连接条目用途不同。
• 返回内容：若浏览器只显示登录页、错误提示或普通网页，说明订阅请求可能没有拿到可解析的节点内容。

协议名称也不能互相替代。常见节点可能使用 Shadowsocks、VMess、VLESS 或 Trojan 等协议；订阅条目需要包含对应协议所需的服务器地址、端口及认证参数。协议不受支持、字段缺失或订阅内容被截断时，可能导致部分条目无法解析。协议名称保留英文原文，判断时应以服务方提供的资料和 Shadowrocket 当前界面为准。

按正确入口导入订阅并检查结果

首次添加订阅时，从 Home 进入添加入口，使用订阅类型而不是单服务器类型。保存后回到列表检查是否出现订阅或节点条目；若显示为空，再手动更新一次，并留意更新结果。不同版本的界面布局可能略有差别，按屏幕上的英文标签辨认，不要因按钮位置不同就切换到 Config 页面导入。

1. 复制完整地址

   从自己的服务商账户页面复制订阅地址。检查首尾空格、遗漏字符和剪贴板内容，不要把账户密码或其他无关文字一起复制。

2. 选择订阅类型

   打开 Home 右上角「+」→ Type → Subscribe，在订阅地址栏粘贴链接。若当前添加页显示的是单服务器字段，返回后重新选择 Subscribe。

3. 保存并刷新

   保存后回到 Home，按界面提供的方式刷新订阅。刷新时保持网络可用；若连接状态影响订阅地址的访问，可在服务方确认后再检查更新选项。

4. 核对节点列表

   确认列表中出现实际连接条目，再点选其中一个并查看协议及服务器字段是否完整。列表为空与节点能否连接是两个不同阶段的问题。

如果已存在同一订阅，不必连续新增多个重复条目。先找到原有订阅并执行更新，避免把重复项目误认为节点数量增加。更新成功后仍为空时，记录订阅名称、更新时间和可见提示，向自己的服务商确认该账户是否有可用内容，以及提供给 Shadowrocket 的链接是否正确。

导入节点不等于已经建立连接。节点出现在 Home 后，还需选中条目并开启连接；如果连接失败，应转而检查地址、端口、认证信息、网络连通性和服务端状态。使用规则分流时，也要确认 Home 中的 Global Routing 与当前任务相符。不要用“列表为空”的排查方法处理已经出现节点后的连接故障。

更新失败或导入为空：按错误阶段逐项排查

订阅更新通常要经过设备联网、访问订阅地址、取得服务器返回内容、解析节点字段几个环节。先判断失败发生在哪一环：完全无法访问地址、请求超时、返回内容异常，还是更新提示完成但列表仍为空。每次只检查一项，保留原有订阅记录，不要随意改写订阅内容或删除仍可能有效的条目。

错误文字会随版本、系统语言和失败环节变化，以上提示是排查线索，不是每台设备都会出现的固定原文。向服务方反馈时可提供发生时间、网络类型、订阅名称和错误提示；不要公开完整订阅地址、节点凭据或含有账户信息的截图。

若只在某一种网络下更新失败，可先对照该网络是否能访问订阅服务，再观察 Shadowrocket 的连接状态和更新选项。若错误始终发生在内容解析阶段，反复切换 Wi-Fi 或 Global Routing 通常无法修复格式问题。此时应重点核对链接类型、服务方提供的客户端格式，以及返回内容中是否包含完整节点字段。

核对格式与协议字段：不要把名称当成连接参数

节点名称主要用于识别列表中的条目，可以由服务方自定义；名称正常或乱码，都不能单独证明连接参数正确。真正影响解析和连接的字段包括协议类型、服务器地址、端口及相应认证信息。协议不同，必需字段也不同，不能把一种协议的参数照搬到另一种协议。

如果只有个别条目缺失，而其余节点正常，可能是订阅内某些协议或字段未被正确识别，也可能是服务方没有向当前账户返回这些条目。不要因为一个节点缺失，就直接判定整条订阅失效。记录缺失数量和其他条目是否可见，再让服务方检查生成的订阅内容。

必要时可以用服务方提供的原始信息对照 Shadowrocket 中已导入条目，但不要把真实凭据粘贴到公开论坛或在线格式转换工具。对照时只核验字段是否存在、是否明显截断，不要通过猜测改端口、密码、UUID、加密方式或传输参数。无法确认字段含义时，应保留原值并向服务方求证。

多设备使用与订阅链接保密

在多台设备上使用同一订阅时，分别在每台设备添加或更新订阅，并确认各设备上的条目数量、名称和更新时间。不要默认某台设备更新成功后，其他设备一定同步完成；不同设备可能处于不同网络，也可能保存了不同的旧订阅。若某台设备列表为空，应在该设备上单独检查更新结果。

iPhone、iPad、Mac、Windows、安卓和 Linux 设备上的 Shadowrocket 均可按各自版本的界面管理连接资料。首次在电脑或安卓设备打开应用若被系统拦截，请按下载页中的“安装放行”说明处理。设备间使用时，订阅链接仍应通过可信方式保管和传递，不要为了省事将完整链接发到公开聊天、工单或截图中。

• 按设备记录：记下设备名称、最近一次更新时间和节点是否出现，避免把另一台设备的结果当作当前结果。
• 更新前留意状态：若服务方通知订阅或账户发生变化，先按其说明更新；不要在不清楚来源时替换现有订阅。
• 谨慎分享截图：检查画面是否露出订阅 URL、服务器地址、账号标识或认证信息，必要时遮盖后再反馈。
• 链接视为敏感信息：拥有完整订阅链接的人可能获得对应连接资料。若链接意外泄露，联系自己的服务方处理，而不是只在本地删除记录。

客户端购买与连接服务是两件事：iPhone / iPad 版在 App Store 一次性购买 $2.99；Mac（Apple 芯片版与 Intel 版）、Windows、安卓和 Linux 版免费，并可从本站下载页获取。客户端买断不包含线路或订阅服务，本文的导入与更新步骤均以用户已经拥有自己的订阅为前提。

常见问题