订阅导入失败 · 排查指南
典型表现:在客户端点击“下载/导入配置”后,提示 Network Error、Invalid Config、YAML 解析失败或长时间卡在拉取状态无法生成节点列表。
常见触发原因
- 误将服务商的“注册/登录网页地址”当作客户端专属订阅链接填入导入框。
- 复制订阅链接时遗漏了末尾参数,或前后端夹带了多余的空格与中文标点。
- 开启了旧的代理开关去拉取订阅,而旧代理本身已失效,导致拉取请求被阻断。
- 订阅格式与客户端不匹配(例如将其他协议专用的链接直接导入仅支持 YAML 的客户端)。
推荐分步排查顺序
确认您复制的是服务后台仪表盘中的“客户端订阅地址(Subscription URL)”,而非注册推广链接。将其粘贴到记事本检查是否完整以 https:// 开头且无空格。
在客户端主界面先关闭“系统代理(System Proxy)”与“TUN/VPN 开关”,使用本地纯净直连网络重新点击下载订阅。
若当前家庭宽带或校园网 DNS 无法解析订阅服务器域名,可临时将设备连接至手机 4G/5G 热点完成首次配置拉取,成功后再切回原 Wi-Fi。