如何 SSH 進 Home Assistant（OS、Container 及從手機）

如何 SSH 進 Home Assistant

「SSH 進 Home Assistant」有兩個層次,搞混是常見困惑來源。在 Home Assistant OS 上,你不直接 SSH 進主機——而是裝一個 SSH 載入項(add-on),它把你放進 Home Assistant 環境,在那裡改設定、跑 ha 命令。在 Container/Core/Supervised 安裝上,你照常 SSH 進底層 Linux 主機。本文兩者都講,以及怎麼從手機操作。

Home Assistant OS——用 SSH 載入項

1. 在 Home Assistant 裡進 設定 → 載入項 → 載入項商店。
2. 安裝 "Terminal & SSH"(官方)或 "Advanced SSH & Web Terminal"(社群,更靈活)。
3. 打開載入項的 設定 標籤,設密碼,或更好地在 authorized_keys 下加你的 SSH 公鑰。
4. 設連接埠(advanced 載入項預設 22;官方那個用 web 終端 + 可選 SSH),然後 啟動 載入項。

現在從任意 SSH 用戶端連到你 HA 機器的 IP 和該連接埠,使用者名稱 root(advanced 載入項)——你就進入了 Home Assistant shell,/config 目錄就在那裡。

Container / Core / Supervised——SSH 進主機

如果你用 Docker 跑 Home Assistant 或自己 Linux 機器上的 Core 安裝,就沒有載入項這一層:直接照常 SSH 進那臺主機(主機 IP、連接埠 22、你的使用者),然後直接操作容器或 config 目錄。

從手機操作

這就是方便之處——在沙發上或在外面修你的智慧家庭。裝一個 SSH 用戶端(iPhone 選項 / Android 選項),新增到你 HA 的 IP 和連接埠的連線,連上。

有用的 Home Assistant SSH 命令

• ha core check —— 重啟前校驗設定
• ha core restart —— 重啟 Home Assistant
• ha core logs —— 看記錄檔排查問題
• nano /config/configuration.yaml —— 編輯主設定
• ha su update / ha core update —— 更新 supervisor / core

記不住具體的 ha 子命令時,把要做的事描述給 TermAI 助理,它會建議——在手機上排查問題時很有用。

當你用 ha core logs -f(或 Container 主機上的 journalctl -f)跟記錄檔看一條自動化觸發時,TermAI 進入記錄檔流模式:工具列可暫停、把最近 500 行的錯誤/警告分色高亮、並把最近 100 行交給 AI 快速判讀「這條自動化為什麼失敗」。比在手機上盯著 HA 記錄檔捲動舒服得多。

從網路之外 SSH 進 Home Assistant

別為了在外存取 HA 而把 SSH 連接埠轉發到公網——那會暴露你的智慧家庭中樞。在 HA 機器和手機上裝 Tailscale(有 Home Assistant 載入項),或用 TermAI 內建的 Tailscale,你就能從任何地方用私有位址 SSH 進 Home Assistant。見 iPhone 上的 Tailscale。

常見問題

為什麼不能直接 SSH 進 Home Assistant OS?
HA OS 是鎖定的裝置型系統;主機 shell 不適合日常使用。SSH 載入項給你一個受支援的、進入 Home Assistant 環境的 shell。

用什麼使用者名稱?
用 Advanced SSH & Web Terminal 載入項是 root。在 Container/Core 主機上,是你普通的 Linux 使用者。

怎麼遠端 SSH 進 Home Assistant?
用 Tailscale(有 HA 載入項)而不是連接埠轉發,然後連到 HA 的私有位址。

快速事實

• HA OS:裝 Terminal & SSH 或 Advanced SSH 載入項——別直接 SSH 主機
• Container/Core:照常 SSH 進底層 Linux 主機
• 關鍵命令:ha core check、ha core restart、ha core logs
• 從手機:任意 SSH 用戶端;TermAI 加了對 ha 命令的 AI 幫助
• 遠端存取:用 Tailscale,別連接埠轉發