用戶端或核心啟動失敗排查

啟動失敗通常有四類原因:連接埠被占用、服務模式異常、設定檔語法錯誤、安裝檔案損壞。按順序排查,多數問題幾分鐘內可定位。

排查步驟

  1. 檢視「日誌」頁面(或系統匣選單開啟日誌目錄),錯誤訊息通常直接指向原因。
  2. 日誌出現 bind: address already in use 即連接埠衝突,按 連接埠衝突排查 處理。
  3. 剛編輯過設定的,檢查 YAML 縮排與語法;清空 Merge / Script 內容再試。
  4. 服務模式狀態異常的,先解除安裝服務再重新安裝,見 服務模式教學
  5. 仍無法啟動時,從官方管道重新下載最新版覆蓋安裝。

蒐集資訊求助

以上無效時,攜帶日誌片段、系統版本與用戶端版本到 GitHub Issues 搜尋或提交問題。提交前先搜尋,多數問題已有解決方案。