适用条件与现象

适用于 type: file 的代理集合,尤其是把终端配置搬进 GUI 或系统服务后才失败的情况。这里读取的是本地节点文件,不需要重新购买或生成订阅。

先区分原因

相对路径与内核实际 HomeDir 有关,不一定是你打开终端的目录。官方对 provider 路径还有安全目录限制;能在文件管理器看见文件,不证明运行内核的用户能读取。

按顺序操作

  1. 从客户端日志或服务启动参数确认内核的数据目录;有 -d 参数时以其指定的 HomeDir 为准。记录当前配置文件位置。
  2. 把节点文件复制到该数据目录下的专用 providers 子目录,保留原文件;让副本使用一个清晰的相对 path。
  3. 核对文件不是 .yaml.txt、目录链接或只有管理员可读的文件。以实际运行内核的用户检查读取权限,避免把整个目录改成任何人可写。
  4. 运行客户端配置检查并加载副本,查看日志是否从“路径拒绝/不存在”变成具体内容解析结果;再核对集合的节点数量。

怎样确认结果

日志显示读取目标文件,且集合里出现预期节点。随后断开订阅更新网络也能加载这份 file 集合,才能证明使用的是本地内容,而不是另一个 HTTP 集合的旧缓存。

失败后的恢复与下一步

若仍报路径限制,恢复原配置,检查客户端是否另外设置了 HomeDir。确有跨目录需求再由熟悉运行环境的人配置 SAFE_PATHS,不把允许范围扩大到整个磁盘。