3、系统安装：树莓派烧录系统、Windows/Linux/Mac安装Home Assistant OS、Docker部署方式
好，咱们进入实操环节了。系统安装这块，说难不难，说简单吧，坑也不少。我这些年帮朋友装过不下几十套HA，各种平台都折腾过。今天就把这些经验掰开揉碎了讲给你听。
3.1 树莓派烧录系统——最经典的入门方式
树莓派跑Home Assistant，我个人觉得是最省心的方案。功耗低、安静、24小时开机不心疼。但前提是——你得把系统烧对。
3.1.1 准备工作
你需要这些东西：
- 树莓派4B或5（4GB内存起步，8GB更稳）
- 32GB以上的TF卡（建议用A2级别的，读写速度快很多）
- 读卡器一个
- 电脑一台（Windows/Mac/Linux都行）
3.1.2 烧录步骤
我推荐用官方工具——Raspberry Pi Imager。为啥？因为它内置了Home Assistant OS的镜像，不用你到处找下载链接。
- 下载并安装Raspberry Pi Imager
- 打开软件，点击「选择操作系统」
- 往下翻，找到「Other specific-purpose OS」→「Home Assistant OS」
- 选择对应你树莓派型号的版本（HAOS rpi4-64或rpi5-64）
- 点击「选择存储设备」，选中你的TF卡
- 点击右下角的齿轮图标——这里可以提前配好WiFi和SSH
- 点击「写入」，等进度条跑完就行
3.1.3 首次启动
把烧好的TF卡插回树莓派，接上网线（或者用你提前配好的WiFi），通电。第一次启动会比较慢，大概5-10分钟。你可以在路由器后台看看有没有叫「homeassistant」的设备上线。
看到它了？好，在浏览器输入 http://homeassistant.local:8123，就能进入安装向导了。
3.2 Windows/Linux/Mac安装Home Assistant OS
有人会问：我手头没有树莓派，能不能用电脑跑？当然可以。不过这里要分清楚——你是想跑HAOS（完整系统），还是只跑HA Core（核心程序）？
我个人建议，如果是长期稳定使用，尽量上HAOS。它自带 Supervisor 和加载项商店，后期扩展功能方便得多。
3.2.1 虚拟机方案（推荐）
用虚拟机跑HAOS，说白了就是把树莓派上的系统搬到你的电脑里。Windows用VMware或Hyper-V，Mac用UTM或Parallels，Linux用KVM。
具体步骤：
- 去Home Assistant官网下载HAOS的虚拟机镜像（.vmdk或.qcow2格式）
- 新建虚拟机，选择Linux系统，分配2核CPU、4GB内存、32GB硬盘
- 把下载的镜像挂载为虚拟硬盘
- 启动虚拟机，剩下的就跟树莓派一样了
我踩过的坑：虚拟机网络一定要选「桥接模式」，别用NAT。否则你从手机访问HA时会发现死活连不上——因为它们在两个不同的网段里。
3.2.2 直接安装（不推荐新手尝试）
如果你非要在Windows上直接跑...嗯，我建议你放弃这个想法。HAOS本质上是Linux系统，Windows没法直接装。你可以用WSL2，但性能损耗大，而且很多加载项跑不起来。
Linux用户倒是可以试试直接装，但说实话，我折腾过两回，最后还是换回了虚拟机。省心。
3.3 Docker部署方式——灵活但需要动手能力
Docker部署，说白了就是把HA装在一个「集装箱」里。好处是干净、好迁移、不污染宿主机系统。坏处是——你得自己搞定Docker环境。
3.3.1 安装Docker
不管你是Windows、Mac还是Linux，先去装Docker Desktop（Linux装Docker Engine就行）。
装好之后，打开终端验证一下：
docker --version
# 看到版本号就说明装好了3.3.2 拉取并运行HA容器
这是最基础的命令：
docker run -d \
--name homeassistant \
--restart=unless-stopped \
-p 8123:8123 \
-v /path/to/config:/config \
ghcr.io/home-assistant/home-assistant:stable解释一下这几个参数：
-d：后台运行--name：给容器起个名字--restart：挂了自动重启-p：端口映射，把容器的8123映射到宿主机-v：挂载配置目录，这样你改配置不会丢
/path/to/config 这个路径一定要写绝对路径。我见过有人写相对路径，结果容器重启后配置全没了...那感觉，就像你写了半天文档没保存一样。
3.3.3 Docker Compose方案（更优雅）
如果你要跑多个容器（比如HA + Mosquitto + Zigbee2MQTT），用Docker Compose会更方便。创建一个 docker-compose.yml：
version: '3'
services:
homeassistant:
container_name: homeassistant
image: ghcr.io/home-assistant/home-assistant:stable
volumes:
- ./config:/config
ports:
- "8123:8123"
restart: unless-stopped
network_mode: host然后运行：
docker-compose up -d看到「Done」就搞定了。浏览器打开 http://你的IP:8123，开始配置吧。
3.3.4 Docker部署的注意事项
几个容易翻车的地方：
- Docker版HA没有Supervisor，所以加载项商店用不了。想装插件？自己手动配Docker容器吧。
- 网络模式建议用
host，否则有些设备（比如蓝牙、USB网关）会找不到。 - 升级时先备份配置目录，别问我怎么知道的...
3.4 三种方式怎么选？
我直接给你个参考：
| 场景 | 推荐方案 | 理由 |
|---|---|---|
| 新手入门、长期稳定用 | 树莓派 + HAOS | 功耗低、省心、加载项齐全 |
| 手头有闲置电脑 | 虚拟机 + HAOS | 性能好、可玩性高 |
| 老手、喜欢折腾 | Docker部署 | 灵活、好迁移、资源占用少 |
| 只想试试水 | Windows虚拟机 | 不用额外买硬件，随时能删 |
好了，系统安装这块就这些。不管你选哪种方式，装好之后记得先做一件事——改密码、开两步验证。安全第一嘛。
下一章咱们聊聊怎么把设备接进来，那才是HA真正好玩的地方。