故障排查

“开启服务”不可用

先检查“概览 → 系统自测”：

1. “设置 → 内核”是否已经配置有效的内核组件；
2. “配置”是否存在一份当前生效配置；
3. 配置是否包含可用的本地入站和出站；
4. 本地监听端口是否被其他程序占用。

内核启动后仍无法连接

客户端会等待内核健康检查和本地代理端口。如果这里失败：

• 查看应用日志和内核日志中的第一条启动错误；
• 检查配置字段和引用的 tag；
• 在“能力信息”中确认当前内核支持配置所需的协议和传输；
• 根据日志中的首个错误检查配置路径、字段和监听端口。

不要只根据进程存在判断服务可用；健康检查、本地监听和系统代理三者都需要成功。

已连接但应用没有走代理

• 确认概览中的系统代理状态为“已开启”；
• 检查目标应用是否自行覆盖系统代理；
• 检查当前本地代理地址、端口与内核实际监听是否一致；
• 如果使用 TUN，确认 TUN 状态和系统权限，不要把 TUN 与系统代理状态混为一谈。

订阅同步失败

• 检查 URL 是否仍然有效；
• 检查网络是否允许访问订阅服务；
• 将格式切换为明确的 Zero JSON、Zero Base64 JSON、Clash YAML 或 Clash Base64 YAML；
• 查看错误是否来自下载、Base64 解码、YAML/JSON 解析还是 Clash 转换。

节点或测速状态没有更新

节点选择和测速结果通过运行时事件更新。先确认事件连接正常，再检查 policy.probe.completed 是否到达。不要用重复点击或轮询代替事件链路排查。

仍无法定位

按照数据与诊断导出诊断包，并附上：

• ZNet Sink 版本；
• 内核版本；
• 操作系统与架构；
• 可以稳定复现的步骤；
• 首次出现的错误，而不是只截取最后一条连带错误。