深色外观
导入订阅失败排查:怎样分清地址返回异常和客户端读不懂文件?
先看返回了什么
遇到的现象:添加地址后报语法错误或无法解码,应从哪里查起?
先区分文件内容不合要求,还是下载到了错误网页。
接着确认应用需要的配置类型:Clash 使用 YAML;通用节点导入入口可接收 Base64 编码内容。账户管理页面与配置下载接口用途不同,不要互相替代。
接着确认应用需要的配置类型:Clash 使用 YAML;通用节点导入入口可接收 Base64 编码内容。账户管理页面与配置下载接口用途不同,不要互相替代。
从提示信息找到失败环节
| 界面中的提示 | 出现位置 | 值得检查的内容 | 接下来怎样操作 |
|---|---|---|---|
yaml: unmarshal errors: cannot unmarshal string | Clash 读取配置时 | 拿到的文本无法按 YAML 读取:可能是另一种编码,也可能只是 HTML 错误页 | 在账户内重新选择匹配的配置出口,检查取回内容是否为.yaml格式的有效配置 |
Base64 decode failed / 未能读出条目 | 通用节点订阅入口 | 导入框要求通用节点文本,收到的却是面向 Clash 的配置 | 回到账户选择通用格式,并核对输出标记&flag=clash是否与导入入口相符 |
Invalid Subscribe | 移动端导入界面 | 地址可能夹带空白、被转义,或误指向需要交互的管理网页 | 在设备浏览器进入账户,从对应的导入按钮或二维码重新添加 |
unsupported protocol / 出现无法识别的字段 | 较早的客户端内核 | 配置使用了VLESS-Reality / Hysteria2等协议,而当前内核不支持对应字段 | 先确认所用内核的协议支持范围,再参照基于 Mihomo 的客户端配置方法重新核对设置,操作入口见桌面端添加订阅的方法。 |
地址看起来相同,内容可能已经变了
管理网页不能充当下载接口
地址栏中若是https://example.com/#/dashboard这一类面板路径,取回的可能是页面代码。请从账户里的订阅复制功能取得地址,再检查其中的接口路径subscribe和身份参数token=。
跨设备传递时检查符号是否完整
经聊天工具传递后,地址里的参数连接符&可能变成实体文本,也可能丢失尾部内容。可在同一设备直接登录账户复制,避免继续使用已经损坏的文本。
经过转换的响应也需要核对
若地址经过第三方转换,模板异常或网关提示响应错误都可能让返回结果不再是完整配置。可改从服务商提供的对应格式入口下载,相关风险见转换服务与隐私保护说明。
先确认响应,再调整导入方式
- 查看下载结果:参考地址无法连接时的检查方法,辨认取回的是
.yaml文件、编码文本还是错误页面。 - 把导入框与配置类型对应起来:参照客户端与配置语法说明,避免将不同格式放入同一个入口。
- 检查内核是否认识配置字段:遇到协议不支持的提示时,核对客户端版本与内核能力,再选择能够读取该配置的版本。
- 自动唤起失败时改为在应用内添加:先打开客户端里的
添加配置入口,再粘贴完整地址。可参照手动添加 URL 的操作说明。
导入时的疑问
看到 YAML 解析提示,应该先核实什么?
先查看下载内容。若内容是编码后的节点集合或网页,YAML 解析器就无法按预期读取;应回到账户内选择与 Clash 对应的输出,再重新添加。
移动端提示 Invalid Subscribe 时怎样检查地址?
先比对账户中复制的原地址与导入框内容,留意空格、截断及实体文本,例如&;再确认取回的内容并非登录页或错误页。也可从设备上的账户页面重新发起导入。
还在下载就停住,与解析错误有什么区别?
尚未取得配置时,应先检查下载路径;文件语法的检查要等响应成功后进行。可接着阅读配置地址的连接检查 或 刷新请求失败的处理。