已有自己的服务商和订阅链接,但在 Shadowrocket 的 Home 看不到服务器条目时,先核对添加类型和链接全文,再确认服务商返回的确实是服务器列表,最后手动刷新一次并比较结果。下文以 iPhone / iPad 界面为例;如果条目已经显示,只是选中后连不上,应转入连接排查,不要反复重导订阅。
先区分下载失败、解析失败和列表为空
订阅条目出现在 Home,只表示应用里已有这项订阅,不代表服务器列表已成功更新。一次更新要先向订阅地址发请求,再读取响应、识别其中的服务器条目,最后在 Home 显示结果。下载失败时,应用可能没有拿到可读取的响应;解析失败时,要核对拿到的内容是不是预期格式;列表为空时,还要确认服务商当前是否实际分配了条目。仅凭一个通用提示,有时不能确定失败发生在哪一步。
Failed to load subscription
可能原因:链接已失效,或者请求未能取得可供读取的订阅内容。处理:到自己的服务商后台确认当前链接是否有效、是否生成了服务器列表,再回 Home 下拉刷新一次并记下结果。
401 Unauthorized
可能原因:如果服务商确认订阅请求返回该 HTTP 状态,通常是请求没有提供有效的认证信息,例如链接中的令牌已失效。处理:从自己的账户后台重新复制完整链接;如果最新链接仍返回此状态,请由服务商核对认证要求。这不是 Shadowrocket 固定显示的提示文案。
核对链接格式:在 Home 用 Subscribe 添加
先确认复制的是服务商专门提供的订阅地址,而不是账户后台、登录页或说明页的网址,也不是单个服务器的分享地址。一个能在浏览器里打开的网址,不一定能用于订阅。下面只演示地址结构,不能用来导入服务器:
https://example.com/sub?token=xxxx
复制当前链接
从自己的服务商后台复制当前订阅地址。不要从聊天消息中复制带省略号的预览文字,也不要把地址末尾的句号、引号或换行一起带入。
选择添加类型
在 Shadowrocket 打开 Home,点右上角的
+,在Type选择Subscribe。此处添加的是用于取得服务器列表的地址,不是到 Config 导入规则文件。核对完整地址
粘贴链接,核对开头的协议、主机名、路径,以及
?后是否保留了全部查询参数。如果原地址含&或百分号编码,应按原样保留;不要凭猜测删掉参数,也不要把编码手动改成普通字符。保存后刷新
保存并返回 Home,在服务器列表区域下拉刷新。等待本次操作返回结果,再检查对应订阅下是否有新条目。若此前已添加同一订阅,先核对原条目,不要为了测试而反复添加副本。
订阅参数可能包含账户凭据。核对时只在自己的设备和服务商后台对照全文,不要把真实链接粘贴到公开的解析工具、帖子或截图中。需要描述链接格式时,用假值替换令牌和其他能识别账户的信息。
核对服务商响应:HTTP 成功不等于列表有效
链接无误但仍解析失败时,在服务商后台核对订阅是否启用、是否有分配给当前账户的服务器,以及是否更换过订阅地址。能登录后台,只能证明浏览器当前可以访问账户页面;浏览器可能带有登录状态,而 Shadowrocket 请求订阅地址时,不会自动取得你在浏览器里的登录状态。
- 返回登录页或错误页:即使最终状态是
200 OK,正文仍可能是网页,而不是订阅数据。请服务商确认链接是否重定向到了登录页,以及应在账户后台复制哪个地址。 - 返回的是空内容或空列表:请服务商确认当前账户是否有已分配的条目,以及最近的分配变更是否已同步到订阅接口。Shadowrocket 无法从空响应中生成服务器条目。
- 返回内容非空,但仍解析失败:请服务商核对输出是否是供 Shadowrocket 导入的格式,以及条目字段是否完整。看到非空文本并不能证明格式兼容,也不需要在 Home 手动猜填服务器地址、端口或凭据。
结论:链接正确后,先问服务商返回了什么
如果完整链接在 Home 下拉刷新后仍失败,向服务商提供刷新时间和时区,请其核对当时的 HTTP 状态、响应是列表还是网页、列表是否含条目。先确认这三项,再决定是否需要更换链接或调整输出格式。
核对更新时机:一次只改变一个条件
刚启用订阅、重置令牌或调整账户分配时,先确认变更已经作用到订阅地址,再回 Home 刷新。续期或分配更新可能仍沿用原地址;如果服务商明确重置了链接,就应更新保存的地址,而不是继续刷新旧地址。没有统一的等待时长,以自己的服务商给出的生效状态为准。
- 记录刷新前的现象。在 Home 确认检查的是哪项订阅,记下当前可见条目数和提示原文。旧条目仍然显示,并不证明刚才的刷新已经成功。
- 确认变更后刷新一次。返回 Home 下拉,查看是否出现条目、旧条目是否如预期发生变化、提示是否仍然相同。若服务商确认返回
429,按服务商提供的等待时间重试,不要连续下拉。 - 只有在怀疑网络时才做对照。如果当前网络上的刷新提示超时,可改用同一设备上的另一种可用网络,对同一地址再试一次。测试时不同时修改链接和账户设置;如果只在一种网络失败,优先检查订阅地址在该网络是否可达,不要据此认定列表格式有误。
- 条目恢复后停止重导。如果 Home 已显示预期条目,而使用其中一条时连不上,再用
Connectivity Test检查连接。该测试不是用来确认订阅返回格式的,不能代替刷新后的列表核对。
仍然为空时,整理可交给服务商的记录
报障时,把“订阅是否更新”和“服务器能否连接”分开描述。写明是首次添加后始终为空,还是原有列表在某次变更后变空;两种情况需要核对的服务端记录不同。先保留现有条目和报错现场,不必用重装应用或清空 Config 来测试同一个订阅响应。
- 客户端侧:设备平台、操作路径
Home → + → Type → Subscribe、保存后是否在 Home 下拉刷新,以及刷新前后的可见条目数和提示原文。 - 账户侧:刷新时间与时区、近期是否续期或更换链接,以及账户后台是否显示已分配服务器。发给服务商的截图应遮住完整地址、账户名和令牌。
- 希望服务商确认的结果:该次请求是否到达、返回的状态和正文类型、列表是否有条目。若服务商确认已经修正响应,回 Home 手动刷新一次,用是否出现预期条目来验收。