节点手册NODE HANDBOOK
FlClash配置故障

FlClash提示configuration file config.yaml is empty怎么办?

切换订阅或配置时出现空配置错误,先保留当前配置、版本和错误原文,再判断是否与官方已修复路径有关。

节点手册编辑部 · · 10分钟阅读
先看结论
  • 这条错误不能证明节点已经失效,也不能证明订阅地址一定为空。
  • 官方Issue #1784记录了Windows 25H2、FlClash 0.8.92切换订阅时的具体个案。
  • 维护者说明v0.8.97修复了“当前Profile缺失时写出空配置”的路径,但不能解释所有同名错误。
  • 不要把删除全部应用数据作为第一步;先保留恢复点并做单变量对照。

先按错误发生阶段判断

现象更可能的阶段先做什么不要先做什么
切换配置立即出现config.yaml is empty与Issue #1784现象相符,但仍需核对版本和当前Profile记录版本、配置名和错误原文不要立即清空数据
更新订阅后节点列表为空获取、响应或解析转到订阅更新失败排查不要只反复测速
节点列表正常,启动内核才报错载入或运行保存核心日志并按阶段排查不要强行套用本文结论
旧版出现,更新后消失可能与已修复路径相关保留更新前后对照不要据此概括所有空配置问题

第一步:保留恢复点并恢复普通网络

先记录FlClash版本、系统版本、错误发生时间、触发动作和当前配置是否仍在列表中。完整订阅URL通常含有令牌,不要放入公开截图、Issue或未脱敏日志。

如果普通网络也受影响,可先关闭系统代理或TUN,再确认不经过代理时能否访问普通HTTPS网站。这只是减少排查变量,现有证据不能证明它会修复空配置错误。

第二步:核对版本和官方修复范围

  1. 低于v0.8.97时,先保存配置和覆写副本,再从官方Releases核对升级。
  2. 已是v0.8.97或更高版本时,不要直接断言仍是同一个Bug,继续检查当前Profile和订阅返回。
  3. 跨越v0.9.0时,注意官方发布说明明确写有“移除自定义覆写,需重建为自定义Profile”等破坏性变化。
  4. 更新后先测试基础配置,再逐项恢复TUN、WebDAV和自定义设置。

版本号只能缩小范围,不能代替日志和配置状态。

第三步:确认当前Profile是否仍存在

  1. 返回配置页面,确认当前选中的配置是否仍在。
  2. 暂时保留原配置,不同时执行删除、重装和清理数据。
  3. 如需重新添加,优先建立独立测试配置。
  4. 记录测试配置能否添加、切换时是否仍出现同样错误。
  5. 只有对照结果稳定后,再决定是否移除旧配置。

新配置可以切换,只能证明两份配置表现不同,不能单独确定旧配置失败的根因。

第四步:区分获取成功与配置生成成功

如果问题发生在获取订阅而不是切换配置,应转到订阅更新失败排查。浏览器取得HTTP 200不等于客户端已经解析、落盘并载入配置。

  • 保存HTTP状态、响应类型和是否为空,不公开响应正文。
  • Connection reset by peer属于获取阶段的独立个案,不能用空配置修复说明解释。
  • 内容取得后才报错,应继续检查格式、当前Profile和配置生成阶段。

第五步:逐项恢复高级设置

基础配置能够切换后,一次只恢复一个变量:自定义Profile、系统代理、TUN、WebDAV。每次都重新确认当前Profile、代理组和普通网络。若恢复某项后错误重现,停止继续叠加并保存前后差异。

如果同时出现域名无法解析而IP可访问,再转到DNS解析故障排查;这条内链不表示DNS是空配置错误的原因。

来源、限制与核验日期

资料核验:2026-10-31。本站没有在所有平台和版本上复现;官方Issue属于具体用户环境,不能保证升级一定解决所有空配置问题。

常见问题

config.yaml is empty说明节点失效了吗?

不能。现有证据围绕配置切换和空配置写入,没有提供节点连通性结论。

升级到v0.8.97就一定能好吗?

不能保证。该版本修复了一个已确认路径,其他原因仍需分别核对。

可以直接删除FlClash数据目录吗?

不建议作为第一步。删除会丢失配置、覆写和恢复线索。

为什么浏览器能打开订阅,FlClash仍失败?

浏览器只证明取得响应;客户端还需解析、生成并载入配置。

Connection reset by peer是同一个问题吗?

不能这样归并。它属于获取阶段的独立错误记录。

提交Issue时需要提供什么?

提供版本、系统、触发阶段、最短复现步骤和脱敏错误原文;不要上传完整订阅或节点信息。

也可以前往全部文章浏览。