如何零基础上手 Home Assistant 安装树莓派到 Docker 的部署教程【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io你家的灯、插座、摄像头分散在 5 个 App 里出门前总要挨个点开检查。这是一篇面向零基础的 Home Assistant 安装教程读完你只做两件事在一台树莓派上装好 Home Assistant OS再在浏览器里打开管理界面、亲眼看到设备被自动发现。回答 3 个问题选定 Home Assistant 安装方式 动手之前按顺序回答 3 个问题设备是什么手里是树莓派或小主机选 Home Assistant OS有没有现成的 24 小时开机的机器已有能跑 Docker 的服务器选 Container想不想折腾打算改 Python 源码、自己写脚本才选 Core。安装方式适合谁你需要接受的事Home Assistant OS新手、树莓派用户升级、插件都由系统代劳Container已有 Docker 环境的人应用市场不可用只有核心功能Core会写代码的开发者升级、依赖全部手动维护拿不准就别纠结选 Home Assistant OS它是后两条路径都覆盖不了的省心项。树莓派上用官方烧录工具安装 Home Assistant OS 的 6 个步骤先备齐 4 样东西树莓派 4 或 5内存 ≥2GB、32GB 且卡面标有A2的 SD 卡、官方电源适配器手机充电头不行、一根网线。在电脑上安装Raspberry Pi Imager树莓派官方烧录工具打开它。在 OS 选项里依次选Other specific-purpose OS → Home automation → Home Assistant再按你的硬件挑 RPi 4 或 RPi 5 版本。把 SD 卡插进电脑在存储列表里选中它卡内原有数据会被清空。点Next再点Write等写入完成点Finish。SD 卡插进树莓派接上网线最后插电源。等 1~5 分钟浏览器打开http://homeassistant.local:8123看到Preparing Home Assistant页面即说明成功。完整官方文档在 source/installation/raspberrypi.markdown。如果你用的是 Windows、macOS 或 Linux只讲差异点如果你用 Windows装 VirtualBox导入官方 generic x86-64 的 VMDK 镜像内存给 2GB、磁盘 32GB启动项勾选 EFI即 UEFI 引导网络设为桥接模式让虚拟机和主机处于同一局域网启动后访问方式与树莓派一致。如果你用 macOS用 UTM 或 VirtualBox 思路相同唯一区别是芯片——Apple SiliconM1/M2必须选 ARM 版镜像Intel 机型选 x86 版选错会直接无法启动。如果你用 Linux推荐 Container 部署要求 Docker Engine ≥23.0.0Docker Desktop 不行。创建配置目录后执行docker run -d \ --name homeassistant \ --restartunless-stopped \ -e TZAsia/Shanghai \ -v /home/user/homeassistant:/config \ --networkhost \ ghcr.io/home-assistant/home-assistant:stable一行说明-v把本地目录映射成容器内/config升级不丢配置--networkhost复用主机网络启动后直接访问http://主机IP:8123要接 Zigbee 网关就追加--device /dev/ttyUSB0:/dev/ttyUSB0。首次打开界面的 5 步验证第 1 步浏览器打开http://homeassistant.local:8123出现欢迎页树莓派上通常 1 分钟内出现第 2 步点Create my smart home填写姓名、用户名小写无空格和密码并创建账号——这是管理员账号且无法找回当场记下来第 3 步在地图上定位你家时区、单位制、货币会自动跟着填好第 4 步决定是否分享匿名统计数据默认关闭可跳过第 5 步点Finish进入默认仪表盘系统开始列出局域网内发现的智能设备——看到这个列表才算装完。装完打不开3 个高频问题的现象-检查-解决⚠️ 排障顺序先确认设备在线再确认地址最后才是镜像。访问不到管理界面现象输入homeassistant.local超时或无响应。检查确认树莓派和你的电脑在同一局域网在路由器后台查到它的 IP。解决改用http://设备IP:8123访问老版本 Windows 解析不了.local域名直接用http://homeassistant:8123。树莓派通电后起不来现象电源灯亮但 5 分钟后界面无响应。检查SD 卡是否 A2 级且 ≥32GB是否使用官方电源适配器而非充电头。解决重新烧录 SD 卡一次仍失败就接 HDMI 显示器看启动报错细节见 source/installation/troubleshooting.markdown。Docker 容器起来了但浏览器打不开现象docker ps显示容器 running页面却打不开。检查执行netstat -tulpn | grep 8123看 8123 是否被别的进程占用。解决停掉占用方或改端口-p 8123:8123服务器装了防火墙的执行sudo ufw allow 8123/tcp放行。到这里你的网络里已经有一台属于你的智能家居中枢了。接下来两条路去官方文档学写第一个自动化规则是 source/getting-started/automation.markdown安装中遇到的怪问题丢到社区问入口在 source/getting-started/join-the-community.markdown。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何零基础上手 Home Assistant 安装：树莓派到 Docker 的部署教程
如何零基础上手 Home Assistant 安装树莓派到 Docker 的部署教程【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io你家的灯、插座、摄像头分散在 5 个 App 里出门前总要挨个点开检查。这是一篇面向零基础的 Home Assistant 安装教程读完你只做两件事在一台树莓派上装好 Home Assistant OS再在浏览器里打开管理界面、亲眼看到设备被自动发现。回答 3 个问题选定 Home Assistant 安装方式 动手之前按顺序回答 3 个问题设备是什么手里是树莓派或小主机选 Home Assistant OS有没有现成的 24 小时开机的机器已有能跑 Docker 的服务器选 Container想不想折腾打算改 Python 源码、自己写脚本才选 Core。安装方式适合谁你需要接受的事Home Assistant OS新手、树莓派用户升级、插件都由系统代劳Container已有 Docker 环境的人应用市场不可用只有核心功能Core会写代码的开发者升级、依赖全部手动维护拿不准就别纠结选 Home Assistant OS它是后两条路径都覆盖不了的省心项。树莓派上用官方烧录工具安装 Home Assistant OS 的 6 个步骤先备齐 4 样东西树莓派 4 或 5内存 ≥2GB、32GB 且卡面标有A2的 SD 卡、官方电源适配器手机充电头不行、一根网线。在电脑上安装Raspberry Pi Imager树莓派官方烧录工具打开它。在 OS 选项里依次选Other specific-purpose OS → Home automation → Home Assistant再按你的硬件挑 RPi 4 或 RPi 5 版本。把 SD 卡插进电脑在存储列表里选中它卡内原有数据会被清空。点Next再点Write等写入完成点Finish。SD 卡插进树莓派接上网线最后插电源。等 1~5 分钟浏览器打开http://homeassistant.local:8123看到Preparing Home Assistant页面即说明成功。完整官方文档在 source/installation/raspberrypi.markdown。如果你用的是 Windows、macOS 或 Linux只讲差异点如果你用 Windows装 VirtualBox导入官方 generic x86-64 的 VMDK 镜像内存给 2GB、磁盘 32GB启动项勾选 EFI即 UEFI 引导网络设为桥接模式让虚拟机和主机处于同一局域网启动后访问方式与树莓派一致。如果你用 macOS用 UTM 或 VirtualBox 思路相同唯一区别是芯片——Apple SiliconM1/M2必须选 ARM 版镜像Intel 机型选 x86 版选错会直接无法启动。如果你用 Linux推荐 Container 部署要求 Docker Engine ≥23.0.0Docker Desktop 不行。创建配置目录后执行docker run -d \ --name homeassistant \ --restartunless-stopped \ -e TZAsia/Shanghai \ -v /home/user/homeassistant:/config \ --networkhost \ ghcr.io/home-assistant/home-assistant:stable一行说明-v把本地目录映射成容器内/config升级不丢配置--networkhost复用主机网络启动后直接访问http://主机IP:8123要接 Zigbee 网关就追加--device /dev/ttyUSB0:/dev/ttyUSB0。首次打开界面的 5 步验证第 1 步浏览器打开http://homeassistant.local:8123出现欢迎页树莓派上通常 1 分钟内出现第 2 步点Create my smart home填写姓名、用户名小写无空格和密码并创建账号——这是管理员账号且无法找回当场记下来第 3 步在地图上定位你家时区、单位制、货币会自动跟着填好第 4 步决定是否分享匿名统计数据默认关闭可跳过第 5 步点Finish进入默认仪表盘系统开始列出局域网内发现的智能设备——看到这个列表才算装完。装完打不开3 个高频问题的现象-检查-解决⚠️ 排障顺序先确认设备在线再确认地址最后才是镜像。访问不到管理界面现象输入homeassistant.local超时或无响应。检查确认树莓派和你的电脑在同一局域网在路由器后台查到它的 IP。解决改用http://设备IP:8123访问老版本 Windows 解析不了.local域名直接用http://homeassistant:8123。树莓派通电后起不来现象电源灯亮但 5 分钟后界面无响应。检查SD 卡是否 A2 级且 ≥32GB是否使用官方电源适配器而非充电头。解决重新烧录 SD 卡一次仍失败就接 HDMI 显示器看启动报错细节见 source/installation/troubleshooting.markdown。Docker 容器起来了但浏览器打不开现象docker ps显示容器 running页面却打不开。检查执行netstat -tulpn | grep 8123看 8123 是否被别的进程占用。解决停掉占用方或改端口-p 8123:8123服务器装了防火墙的执行sudo ufw allow 8123/tcp放行。到这里你的网络里已经有一台属于你的智能家居中枢了。接下来两条路去官方文档学写第一个自动化规则是 source/getting-started/automation.markdown安装中遇到的怪问题丢到社区问入口在 source/getting-started/join-the-community.markdown。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考