30 分钟搞定 Home Assistant 安装树莓派、容器、Core 三种方式手把手教程【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io家里二十多个智能设备散落各家的 App 里想统一管起来却不知道第一步该点哪里Home Assistant 是一款开源的智能家居中枢把灯光、插座、传感器等设备收进一个界面统一管理。本文对比三种安装形态并用树莓派路径带你完整走一遍 Home Assistant 安装读完你就能把设备跑起来、创建管理员账户并接入第一批智能设备。先选对路一张表帮你定安装方式安装形态适用人群资源门槛灵活性Home Assistant OS镜像刷入新手、树莓派或迷你主机用户一块 SD 卡或 U 盘即可2 GB 内存起步低但省心得最彻底Home Assistant ContainerDocker 容器已有 Docker 环境的用户4 GB 内存一个独立配置目录高可随时增删组件Home Assistant CorePython 核心想在自有 Python 环境里折腾的开发者2 GB 内存16 GB 存储最高几乎什么都要自己管拿不准就选第一行OS 镜像把系统和 Home Assistant 打包在一起刷卡即用也是官方文档默认推荐的形态。主路径实操树莓派刷 SD 卡四步上线整条路径按准备 → 刷写 → 上线 → 验收四个阶段推进全程约 20 分钟。阶段一准备硬件树莓派 4 或 5内存至少 2 GB配官方或足额电源别用电脑 USB 口直接供电32 GB 以上 microSD 卡卡面标有 A2 标识的读写更稳定一根网线。安装阶段必须有线连接装完后再换 Wi-Fi阶段二刷写系统在你的电脑上安装 Raspberry Pi Imager打开后进入系统选择界面在 OS 一栏依次选择 Other specific-purpose OS → Home automation → Home Assistant按你手上的板子选中 RPi 4 或 RPi 5 对应的版本再插入 SD 卡并选中它点 Next再点 Write 开始写入。注意卡内原有内容会被清空写完后点 Finish 安全弹出阶段三上线SD 卡插入树莓派卡槽接好网线与电脑同网段和电源通电后不要急着操作给系统 1~2 分钟完成初始化阶段四验收浏览器输入homeassistant.local几分钟后出现Preparing Home Assistant准备页即算刷写成功旧版 Windows 打不开时换homeassistant:8123或直接填设备 IP 加 8123 端口试试。Pi 4/5 上超过 5 分钟仍无响应多半是镜像没写好换卡重刷。备选路径速览容器和 Core 各差在哪Home Assistant Container先建一个配置目录再拉ghcr.io/home-assistant/home-assistant:stable镜像运行核心参数只有两个——-v把配置目录挂进容器、--networkhost走宿主机网络。完整命令见 Linux 官方安装文档。适合已有 Docker 环境的服务器玩家Home Assistant Core用 pip 在独立 Python 虚拟环境里装 Home Assistant 核心不含系统层界面之外的事都靠自己补。适合想深度定制的开发者两种方式启动后都是访问http://设备IP:8123端口固定 8123开机后的前 10 分钟从空白界面到能用安装完成后浏览器里按顺序做完四件事等准备页下载完约 700 MB 的核心包随后出现欢迎界面选Create my smart home填写姓名、用户名和密码。用户名必须全小写且不含空格这套凭据无法找回务必记好选定家庭位置。系统据此自动配置时区、单位制和货币还会生成一个默认半径 100 米的家区域供日出日落这类自动化使用数据共享默认关闭按个人意愿选择后点 Finish易错点第 3 步的位置可以以后再改但填错会让天气和日出触发时间不准建议这一步就认真选一次。卡住了三个最高频的坑及解法症状浏览器打不开 Home Assistant 页面原因地址解析或端口不通。OS 装法平时走 80 端口被占用时才落到 8123容器装法则只监听 8123解决依次尝试homeassistant.local、homeassistant.local:8123、路由器里查到的设备 IP 加端口症状树莓派通电后迟迟无法访问原因供电不足或 SD 卡读写性能不够系统卡在初始化解决换标有 A2 的卡重新刷写并确认电源适配器输出电流不少于 2.5 A症状Docker 容器起了但外部访问不了原因Linux 发行版的防火墙默认拦住了 8123 端口解决UFW 环境执行一条命令放行sudo ufw allow 8123/tcp装完之后的下一步收尾备份在设置 系统 备份里做快照或定期打包/config目录存到网盘自动化跟着 官方入门教程 搭第一条如果…就…规则比如日出开灯社区遇到问题先去 社区版块 搜一下九成情况都有前人踩过同样的坑设备列表从空到满才是这个中枢真正开始工作的时刻。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考