Home Assistant 部署实战指南三步跑起你的智能家居中枢【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioHome Assistant 是一个运行在你自己硬件上的开源智能家居中枢断网时家里的自动化依然照常工作。本文覆盖树莓派、闲置电脑、现成 Linux 服务器三种常见部署路径带你从选硬件到打开 Web 控制台并完成初始配置。先选对部署路径Home Assistant 提供两种主要安装类型Home Assistant OS内置系统一键更新支持 Add-on 附加组件与Home Assistant Container跑在 Docker 里升级和维护完全自己负责。新手建议选 OS再按下面的表格选硬件载体。你的情况推荐路径最低要求特点不想折腾硬件Home Assistant Green电源适配器 网线开箱即用无需烧录有树莓派或打算入手树莓派 OSPi 4/5、2GB 内存、32GB A2 级 SD 卡官方推荐的新手路径功能完整有闲置 mini PC、旧电脑x86-64 设备 OS64 位 CPU、4GB 内存、U 盘性能更强可接更多设备已有 Linux 服务器或 NASContainerDocker Engine ≥ 23.0资源占用低便于脚本化管理分场景部署实操场景一树莓派 —— 官方新手路径 硬件清单Raspberry Pi 4 或 5至少 2GB 内存、32GB 以上 microSD 卡、官方电源适配器、一根网线。两个容易踩坑的细节SD 卡尽量选A2级A2 卡小文件读写更快低速卡是启动失败的常见原因手机充电头和电脑 USB 口供电都不足必须用专用电源适配器。烧写过程只有四步在电脑上安装并打开 Raspberry Pi Imager系统选择里依次进入Other specific-purpose OS → Home automation → Home Assistant选择与硬件匹配的镜像插入 SD 卡选中卡片后开始写入卡内数据会被覆盖把 SD 卡装入树莓派接好网线通电等待约 5 分钟启动完成后浏览器打开homeassistant.local:8123即可进入初始配置细节可参考树莓派安装文档。场景二旧电脑 —— 闲置 mini PC 或笔记本再利用如果你有一台 64 位 CPU 的 mini PC、NUC 或旧笔记本可以把 Home Assistant OS 镜像写入 U 盘安装到本地硬盘或 SSD。关键在 BIOS 设置把启动方式设为UEFI并指定 U 盘启动若看不到安装程序关闭 Secure Boot安全启动再试。首次启动后按屏幕向导选择安装位置、语言和时区安装结束会自动重启进入系统。硬件门槛与上表一致4GB 内存是稳妥线。场景三Linux 服务器 —— Docker 容器部署前提是Docker Engine 23.0 及以上Docker Desktop 不适用。先建一个目录存放配置然后执行下面命令把路径和时区改成你自己的docker run -d --name homeassistant \ --restartunless-stopped -e TZAsia/Shanghai \ -v /opt/homeassistant/config:/config \ --networkhost \ ghcr.io/home-assistant/home-assistant:stable浏览器打开http://服务器IP:8123即可。两点提醒容器版不包含 Add-on如果打算接 Zigbee、Thread 等 USB 棒改用 OS 版更省事修改配置文件后需要重启容器才生效。首次访问与初始配置清单无论哪种部署初始设置都在浏览器里完成几分钟即可不需要命令行打开地址OS 版一般是homeassistant.local:8123旧版 Windows 或特殊网络下可尝试homeassistant:8123或设备 IP容器版直接http://IP:8123等待准备完成系统自动下载核心包约 700MB网速慢时耗时较长创建所有者账户填写姓名、用户名和密码。这个账户无法找回务必记在安全的地方填写家庭位置系统据此自动设置时区、单位与货币并建立自动化要用的“家”区域选择数据共享默认关闭数据匿名化可自主决定点击 Finish 后进入默认仪表盘。每一步的详细说明见初始配置文档。部署常见卡点浏览器打不开页面现象输入地址后无任何响应。排查先确认设备通电且已连网在路由器管理页查到它的实际 IP。解决改用IP:8123访问OS 版如果 80 端口已被占用比如你搭了反向代理会自动改用 8123不要误以为启动失败。树莓派通电 5 分钟仍无响应现象电源指示灯亮但 5 分钟后页面打不开。排查多数情况是 SD 卡的问题重新烧录一次或换卡再试同时确认电源适配器符合官方规格。解决接显示器看启动画面对照安装排障文档 定位错误信息。本机可访问局域网其他设备不通容器场景现象在服务器本机打开控制台正常同网段其他设备却连不上。原因系统防火墙拦截了 8123 端口。解决sudo ufw allow 8123/tcp放行后网络中其他设备即可通过http://服务器IP:8123访问。下一步控制台打开后建议先做三件事进入集成页面添加第一个设备Home Assistant 会自动发现网络里的设备多数只需一键确认写一两条简单的自动化比如日落开灯、出门发通知直观感受中枢的价值开启备份OS 版在系统设置里内置备份功能容器用户定期把配置目录复制到另一块存储即可到这里部署工作就完成了。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考