HomeAssistant 是一款开源的智能家居自动化平台。该平台能让用户通过中心化系统，控制和管理家中各类智能设备。它的设计核心是摆脱对特定设备制造商的依赖，可集成小米等不同品牌的智能设备，为用户打造开放、可定制的智能家居使用体验。
HomeAssistant 官网：https://www.home-assistant.io
本次教程将实现树莓派部署 HomeAssistant，充分利用闲置的树莓派，从零上手搭建专属智能家居控制中心！
一、准备环境
硬件
Raspberry Pi 4B
系统镜像
HA-OS 版本 HomeAssistant、2022-09-22-raspios-bullseye-arm64.img（上交镜像源）
软件版本
Python 3.9.2
HomeAssistant 版本说明
HomeAssistant 共有 4 种安装版本：HA-OS、Docker、Core、Supervised。本次优先推荐 HA-OS 版本，该版本安装操作简单，自带 Add-on 加载项和 Superviser 管理工具，拥有专属加载项商店，可便捷下载各类插件。本教程将详细讲解树莓派部署 HomeAssistant 的两种方式：HA-OS 版本、Core 版本，步骤简洁易操作。
二、安装 HA-OS 版本 HomeAssistant
HA-OS 版本的核心安装步骤是通过 Raspberry Pi Imager 工具，将系统烧录至 TF 卡，官网有详细操作指引：https://www.home-assistant.io/installation/raspberrypi
关键后续操作：配置网络
-
烧录完成后，将 TF 卡插入树莓派，此时树莓派无网络连接，可选择网线直连，或通过命令配置 WiFi 联网；
-
用 HDMI 线将树莓派连接屏幕，屏幕会显示 Home Assistant CLI 命令行界面；
-
无网线时，在 HA 专属提示符下，输入以下命令配置 WiFi（替换自身 WiFi 信息）：
network update wlan0 --wifi-ssid "你的WiFi名称" --wifi-psk 你的WiFi密码 --wifi-auth wpa-psk --wifi-mode infrastructure --ipv4-method auto
-
输入以下命令，查看树莓派网络信息（含关键 IP 地址）：
network info
访问 HomeAssistant 界面
在同一局域网的设备浏览器中，输入对应网址，即可打开 HA 相关界面：
- 系统操作主界面：homeassistant.local:8123
- Observer 监控界面：homeassistant.local:4357
常见问题 FAQ
Q ：homeassistant.local:8123 无法访问，但 homeassistant.local:4357 的 Observer 界面可正常打开？A：若页面提示 404 not found，需重新烧录系统、重新配置；若提示暂时无法访问，是 Supervisor 正在后台更新，需耐心等待几分钟至数小时，完成后即可正常访问。
三、安装 Core 版本 HomeAssistant
Core 版本需基于树莓派官方系统（如 raspios-bullseye-arm64）安装，全程通过命令行操作，步骤如下：
步骤 1：更新系统软件源
首先更新树莓派软件源，确保能获取最新的软件包和安全更新，等待命令执行完成即可：
sudo apt-get update
sudo apt-get upgrade步骤 2：安装运行依赖
输入以下命令，一键安装 HomeAssistant Core 所需的所有依赖包，无需手动逐个安装：
sudo apt-get install -y python3 python3-dev python3-venv python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libtiff5 --fix-missing步骤 3：创建 Python 虚拟环境
为避免 HomeAssistant 依赖与系统其他软件冲突，需单独创建虚拟环境，操作如下：
-
输入命令，创建 HomeAssistant 安装目录：
mkdir ~/hass
-
输入命令，进入该目录（后续所有操作均在此目录下进行）：
cd ~/hass
-
输入命令，创建虚拟环境：
python3 -m venv /home/pi/hass
-
输入命令
ls，若目录下出现新增文件，说明虚拟环境创建成功； -
输入命令，激活虚拟环境：
source bin/activate
-
若命令行前缀出现
(hass)，说明虚拟环境激活成功。
步骤 4：更换 pip 源（解决国内下载慢问题）
国内直接下载 HomeAssistant 包速度较慢，易出现丢包、报错，需将 pip 下载源更换为国内镜像，操作如下：
# 备份原pip配置文件
sudo cp /etc/pip.conf /etc/pip.conf.bak
# 编辑pip配置文件
sudo vi /etc/pip.conf打开配置文件后，将内容替换为以下阿里云镜像源，保存并退出：
[global]
index-url=https://mirrors.aliyun.com/pypi/simple/
extra-index-url=https://www.piwheels.org/simple步骤 5：安装 HomeAssistant Core
保持虚拟环境激活状态，按以下顺序执行命令安装：
-
安装 wheel 工具（必备依赖）：
python3 -m pip install wheel
-
安装 HomeAssistant Core：
pip3 install homeassistant
安装过程中可能出现警告提示，无需理会，等待执行完成；若页面出现绿色success字样，说明安装成功。
步骤 6：启动 HomeAssistant Core
-
输入以下任意一条命令，启动 HomeAssistant：
基础启动命令
hass
启动并自动打开网页界面
hass --open-ui
-
首次启动时，系统会自动创建
~/.homeassistant配置目录，并安装基础依赖，该过程约 10 分钟，需耐心等待，无需中断命令。
步骤 7：访问 Core 版本 HomeAssistant 界面
- 首次启动无明显命令行输出为正常现象，无需担心；
- 在同一局域网的其他设备浏览器中，输入
树莓派IP地址:8123（例如 192.168.137.88:8123）； - 页面加载完成后，即可进入 HomeAssistant 初始化配置界面。