客户端或内核启动失败排查

启动失败通常有四类原因:端口被占用、服务模式异常、配置文件语法错误、安装文件损坏。按顺序排查,多数问题几分钟内可定位。

排查步骤

  1. 查看“日志”页面(或托盘菜单打开日志目录),错误信息通常直接指向原因。
  2. 日志出现 bind: address already in use 即端口冲突,按 端口冲突排查 处理。
  3. 刚编辑过配置的,检查 YAML 缩进与语法;清空 Merge / Script 内容再试。
  4. 服务模式状态异常的,先卸载服务再重新安装,见 服务模式教程
  5. 仍无法启动时,从官方渠道重新下载最新版覆盖安装。

收集信息求助

以上无效时,携带日志片段、系统版本与客户端版本到 GitHub Issues 搜索或提交问题。提交前先搜索,多数问题已有解决方案。