现象适用范围与三种空结果
代理集合完成导入后看不到节点,不能直接等同于订阅地址失效。官方资料把来源分成 http、file、inline 三种 type,并写明当 http 或 file 解析失败时,可以使用 payload 作为备用代理。可见「空」至少有三条成因:下载阶段没有得到文件、已经得到文件但解析失败、解析成功后又被筛选条件全部去掉。只有先分开这三类,下一步才不会改错字段。
本区分适用于已经在 proxy-providers 中写好集合、name 未与其他集合重复、并且能够查看运行目录中是否生成缓存文件的情况。尚未提供 url、path 或 payload 任一来源时,应先补来源,而不是做下载与解析的对照。策略组写错名称、因而看不到可用出站,也不属于本文所说的导入为空。
如何判断属于下载或落盘失败
下载失败指核心没有按 url 取回正文,或取回后没有写入允许的 path。type 为 http 时必须配置 url,缺少该字段则下载无从发生。header 会用于请求,授权字段或 User-Agent 不正确,服务器可能返回空体或拒绝。proxy 表示经过指定代理进行下载和更新;更新必须走代理却未配置、或目标代理不可用时,同样拿不到文件。size-limit 限制下载文件的最大大小,单位为字节,默认 0 即不限制;写得过小会导致文件不完整,后续必然无法解析成节点列表。
path 不可重复;省略时使用 url 的 MD5 作为文件名。出于安全问题,路径只允许位于 HomeDir(由启动参数 -d 配置)中,其他位置必须用 SAFE_PATHS 环境变量声明,语法与操作系统 PATH 相同。无法写入时属于落盘失败,本地不会出现完整订阅文件。interval 是更新间隔秒数,间隔未到不会重复下载,但首次加载仍应拉取。若配置了 age-secret-key,资料要求密文为 age-encryption.org/v1 的 armor 格式,密钥为指定 recipient 类型;密钥或格式不对时,得到的是不能当配置解析的密文,也应归入「没有得到可解析正文」。
判断依据是:HomeDir 下对应路径或 MD5 文件不存在、长度为 0、或仍是未解密的 armor。出现这些现象时,优先检查 url、header、proxy、size-limit、路径权限和密钥,而不是先改筛选表达式。
如何判断属于解析或筛空以及下一步
解析失败指响应或文件已经到达,但没有变成节点列表。payload 在 type 为 inline 时作为内容生效,同时也可在 http 或 file 解析失败时作为备用代理。因此可以在同一集合中准备最少量的 payload:若备用节点能够出现,说明集合入口和命名可用,问题出在远程文档结构。若备用节点也不出现,则应回头检查 name 是否重复、配置是否被加载。
解析成功仍可能为空。filter 保留满足关键词或正则的节点,exclude-filter 排除满足关键词或正则的节点,二者都可以用反引号区分多条正则。exclude-type 不支持正则,使用 | 分割,按配置文件中的节点 type 排除。这些条件过严时,结果同样是空列表,既不是下载失败,也不是文件语法失败。override 与 override-expr 在解析之后覆写字段,资料说明表达式数组按顺序执行,且晚于固定字段覆写;它们通常不会把整个列表删空,因此「完全没有节点」应优先怀疑筛选而不是覆写。健康检查只对已展开节点做延迟测试,lazy 为真时不使用该集合可以不测,不能把未检测当成导入失败。
下一步建议固定顺序:先看缓存文件是否存在且非空,不存在则按下载与落盘处理。文件存在则暂时去掉 filter、exclude-filter、exclude-type 做对照,对照后出现节点即筛空。对照后仍无节点,视为解析失败,检查正文是否为可识别的代理列表,或改用 inline 的 payload 验证入口。不要跳过对照直接更换未核验的新地址。