已从自己的服务商取得订阅链接,但导入后没有节点,或原有列表刷新失败时,先保留现有条目,再检查链接、返回内容和更新时间,最后用另一张可用网络做对照。界面路径以 iPhone / iPad 的 Home 为例;如果列表里已有节点,只是选中后无法连接,那是节点连接问题,不是订阅解析失败。
先确认链接类型,再从 Home 更新
订阅 URL 是用来获取一份列表的地址。服务商账户页面和订阅 URL 都可能以 https:// 开头,但账户页面通常返回网页,不能当成订阅导入。以 ss:// 或 trojan:// 开头的分享链接也不是订阅 URL:它们描述的是单个节点,应按对应协议导入,而不是填进 Subscribe。
https://example.com/sub?token=xxxx
上面只演示 URL 结构,不能用于导入。? 后的查询参数可能包含访问凭据。使用服务商账户内标明适用于 Shadowrocket 的订阅链接,复制整条地址;不要漏掉查询参数、改动编码字符,或把聊天消息里的引号和句号一并粘贴进去。路径和参数名由服务商决定,不需要按示例改写。
核对原链接
从自己的服务商账户重新复制订阅 URL。首次导入前,确认复制的是订阅地址,而不是登录页、控制台地址或短时间有效的下载地址。
选择订阅类型
首次导入时,打开 Home,点右上角「+」,在
Type中选Subscribe,将完整地址粘贴到URL后保存。已有订阅时不必再建一条,先确认当前条目所用的地址是否已被服务商更换。刷新一次
回到 Home 下拉刷新,等请求结束后查看对应订阅组。若有报错,记录原文;若无报错但看不到节点,先确认订阅组已展开,并记下刷新前后的条目数量。
保留旧条目
旧列表仍可用时,先保留它,不要为了触发更新而删除整个订阅组。需要替换链接时,先确认服务商已生成并启用新地址,再修改原订阅。
区分请求失败、解析失败与空列表
订阅更新分为下载与解析两步。请求超时,客户端可能根本没拿到响应;收到响应但正文是登录页、错误页或不兼容格式,则是拿到了内容却无法读成列表。另有一种情况是响应格式可读,但服务商实际生成了空列表,例如账户下没有可导出的条目。
结论:返回 200 也要核对正文类型
若服务商确认返回 200 OK,但 Home 中仍无条目,下一步问清返回的是 Shadowrocket 可读的订阅内容、网页,还是条目数为零的列表。此时不要把更换节点端口或调整规则作为首项排查。
浏览器里能打开地址,并不表示客户端能取得同样的内容:浏览器可能带有登录状态,或展示了重定向后的网页。若服务商提供账户内的订阅预览,优先核对预览是否有条目;需要确认响应时,请自己的服务商核对状态码、返回格式和条目数,不要把带凭据的地址贴进公开检测页面。
按提示原文处理订阅更新报错
先抄下界面实际显示的提示。下面的 HTTP 状态文本也可能由服务商提供,并不一定会原样显示在 Shadowrocket 中。若只有通用加载提示,不要凭提示猜测是链接过期还是网络故障。
Failed to load subscription
原因:这条提示表示订阅未能载入,单凭它无法区分下载失败和响应不可用。解法:先核对完整 URL,再用同一条地址切换网络刷新一次;若仍失败,请服务商按请求时间核对响应。
401 Unauthorized
原因:服务端未收到有效的身份凭据,可能是订阅参数不完整或凭据已经失效。解法:从自己的账户重新复制当前地址,并向服务商确认旧链接是否仍有效。
403 Forbidden
原因:请求被拒绝,具体原因可能与账户权限、链接状态或服务端访问策略有关。解法:请服务商确认订阅的访问条件,不要反复提交同一请求。
429 Too Many Requests
原因:请求频次触发了限流。解法:停止连续下拉;如果响应带有 Retry-After,按该提示等待,否则按服务商说明择时重试一次。
空列表出现在续期或更换链接之后
付款记录、账户权益状态和订阅内容生成是不同环节。续期完成后,先查看账户显示的生效状态,再确认服务商是否已生成新列表。没有通用的同步等待时长;若服务商给出了生效时间,以其说明为准。在服务商确认生成完成前,重复刷新不能补上尚未发布的条目。
- 续期后列表为空:核对续期是否生效、账户下是否仍有可导出的条目。若账户页面显示正常,请服务商确认现用 URL 返回的实际条目数。
- 重置链接后无法更新:旧地址可能已经作废。复制新地址并更新对应订阅,保留完整路径和查询参数;只改域名,或只替换自己认得的那一段参数,都可能留下错误地址。
- 刷新后仍显示旧列表:旧条目能显示,不代表本次请求成功。先记录刷新提示,并与服务商核对当前导出内容;如果服务商仍返回旧列表,多次删除、重新导入也不会取得新条目。
用 Wi-Fi 和蜂窝数据做一次对照
网络对照的原则是一次只改一个条件:使用同一订阅链接和同一配置,先在当前网络刷新并记录结果,再切换到另一张已确认可上网的网络刷新一次。订阅更新连接的是提供列表的服务器;节点连接用的是列表里的服务器。能连上已有节点,不代表订阅服务器也可达。
- 仅 Wi-Fi 失败:先确认 Wi-Fi 是否需要完成网页认证。普通网页能打开但订阅仍超时,可记录失败时间,请网络管理员或服务商核对该订阅域名的访问情况。
- 仅蜂窝数据失败:先检查系统是否允许 Shadowrocket 使用蜂窝数据,再测试同一订阅。不要同时换链接,否则不能判断是哪项变化产生了影响。
- 两边提示一致:若均为
401或403,优先核对凭据和账户访问权限;若两边都能请求但列表为空,让服务商确认导出内容,而不是先改Global Routing或重置Config。
获取 Shadowrocket 与使用说明
iPhone / iPad 版从 App Store 获取,$2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片 / Intel)/ Windows / 安卓 / Linux 版免费,安装包从本站全平台下载页获取。