如何 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 选项 / 安卓选项),添加到你 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,别端口转发