看懂 Home Assistant 的日誌：從「找不到日誌」到自己解決問題

charles

這篇的內容（6 段）

1. 1-A：HA OS 上讀日誌的三種方式
2. 1-B：Container（Docker）上讀日誌
3. 3-1 先找出精確的時刻
4. 3-2 只撈那個時間前後的日誌
5. 4-3 臨時開，不改設定檔
6. B. 啟動時一大批 WARNING

「日誌貼一下」是論壇上最常出現的第一句回覆。不是為難你 —— 沒有日誌就只能用猜的。但 2025 年底 HA 改了日誌的存放方式，很多舊教學教你去找的那個檔案現在根本不存在。這一篇從「日誌在哪」開始，一路寫到怎麼替單一整合開除錯模式、怎麼讓錯誤自動推播到手機。



■ 步驟 1：先搞清楚你的日誌現在放在哪

這一步是 2026 年才需要特別講的。 Home Assistant 從 2025.11 起，在 HA OS 與 Supervised 安裝上不再產生 /config/home-assistant.log 這個檔案（這是列在發行說明裡的 breaking change）。

所以如果你跟著 2024 年的教學去設定目錄找那個檔，你會看到的是：

• 完全找不到 home-assistant.log
  
• 或者只剩下兩個 0 bytes 的殘骸：home-assistant.log.fault 與 home-assistant.log.old
  

這不是你的系統壞了。日誌改成寫進 systemd 的 journal 了。

先確認你是哪一種安裝：到 設定 → 系統 → 修復 → 右上角三個點 → 系統資訊。

你會看到：

1. Core                 2026.9.3
2. Supervisor           2026.09.1
3. Operating System     16.2

複製代碼

• 有 Supervisor 與 Operating System 兩行 → HA OS。走下面的 1-A
  
• 只有 Core → Container（Docker）。走 1-B
  

1-A：HA OS 上讀日誌的三種方式

方式一：圖形介面（最快，但只看得到最近的）

到 設定 → 系統 → 日誌。

你會看到一個下拉選單（預設是 Home Assistant Core），旁邊有一個「載入完整日誌」的按鈕。

那個下拉裡還有 Supervisor、Host、DNS、Multicast，以及你裝的每一個附加元件。這個下拉是很多人不知道的 —— 整合出問題看 Core，附加元件出問題要切到那個附加元件，看錯地方會以為「日誌上什麼都沒有」。

方式二：CLI（推薦，可以搜尋、可以持續看）

先裝 Terminal & SSH 附加元件（設定 → 附加元件 → 附加元件商店 → 搜尋 Terminal → 安裝 → 啟動 → 開啟網頁介面）。

三個指令：

1. ha core logs              # Home Assistant 本身
2. ha supervisor logs        # Supervisor（附加元件裝不起來時看這個）
3. ha host logs              # 作業系統層（硬碟、USB 裝置的問題看這個）

複製代碼

兩個很有用的參數：

1. ha core logs --follow     # 持續輸出，像 tail -f
2. ha core logs -n 200        # 只看最後 200 行

複製代碼

你會看到輸出長這樣：

1. 2026-09-25 14:22:03.118 WARNING (MainThread) [homeassistant.helpers.frame] Detected code that accesses hass.data directly
2. 2026-09-25 14:22:10.442 INFO (MainThread) [homeassistant.setup] Setting up mqtt
3. 2026-09-25 14:22:11.883 ERROR (MainThread) [homeassistant.components.mqtt.client] Unable to connect to the MQTT broker: [Errno 111] Connection refused

複製代碼

找特定的錯誤：

1. ha core logs | grep -i error | tail -20

複製代碼

方式三：把檔案開回來（2026.1 之後才有）

journal 有大小與時間上限，滿了就會把舊的丟掉 —— 實務上可能連兩小時前的紀錄都翻不到。如果你在追一個「偶爾才發生」的問題，那就需要持久的檔案。

官方在 2026.01 加回了這個選項。在 Terminal 裡執行：

1. ha core options --duplicate-log-file=true
2. ha core rebuild
3. ha core restart

複製代碼

三行都要跑，順序不能變。 只跑第一行不會生效 —— ha core rebuild 是真正重建容器設定的那一步，ha core restart 才讓它跑起來。

你會看到第一行沒有輸出（正常），第二行印出重建的進度，然後 HA 會斷線幾分鐘。

回來之後驗證：

1. ls -lh /config/home-assistant.log

複製代碼

你會看到：

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入