树莓派系统安装

树莓派官方image,安装非常慢，不推荐

https://pidoc.cn/downloads/

树莓派操作系统32位带桌面：

https://pidoc.cn/downloads/operating-systems/
2025-12-04-raspios-trixie-armhf.img.xz

安装烧录软件

https://etcher.balena.io/#download-etcher

树莓派镜像配置wifi

SD 卡插电脑，打开 boot 分区
新建文件：wpa_supplicant.conf

country=CN
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
    ssid="你的WiFi名称"
    psk="你的WiFi密码"
    key_mgmt=WPA-PSK
}

同目录新建空文件（启用 SSH）:
ssh

插回树莓派，上电
路由器后台找 IP

树莓派3B+ 安装home Assistant Supervised

教程： https://blog.csdn.net/qq_35456540/article/details/114436772
树莓派直接安装home assistant系统教程： https://sspai.com/post/95117

home assistant树莓派版本:

https://github.com/home-assistant/operating-system/releases/tag/10.5
Home Assistant OS 10.5（armv7 / Raspberry Pi 3）
这是目前在 Raspberry Pi 3 / 3B+（armv7） 上：最后一代 成熟稳定

烧录软件

https://etcher.balena.io/#download-etcher

homeassistant如果启动不想通过网线，希望用wifi

haos_rpi3-10.5.img.xz → balenaEtcher → SD 卡

在sd卡创建my-network文件，完整目录：boot/CONFIG/network/my-network/my-network
文件内容，yml格式，注意缩进位2个空格

version: 2
wifi:
  wlan0:
    dhcp4: true
    dhcp6: true
    access-points:
      "你的WiFi名称":
        password: "你的WiFi密码"

替换 “你的WiFi名称” 和 “你的WiFi密码” 为实际值
注意缩进为 两个空格
SSID 和密码大小写敏感
Pi 3B+ 只支持 2.4GHz Wi-Fi

或者在ha提示符下输入一行命令：

network update wlan0 --wifi-ssid "WIFI名称" --wifi-psk "WiFi密码" --wifi-auth wpa-psk --wifi-mode infrastructure --ipv4-method auto

ha network info
ha core restart

系统开机访问：
http://homeassistant.local:8123或 http://ip:8123

其他命令

命令	功能说明
ha core info	查看 HA Core 状态、版本、IP、运行时间
ha core logs	查看 Core 容器日志
ha core restart	重启 Core 容器
ha core stop	停止 Core 容器
ha core start	启动 Core 容器
ha core update	更新 Core（慎用，Pi 3B+ 内存小需谨慎）
ha supervisor logs	查看 supervisor日志（网络 / 安装失败必看）
ha host logs	查看系统主机日志

Home Assistant + 树莓派：强大的智能家居系统 · 个性化配置篇

https://sspai.com/post/40272

hassio 国内镜像加速
https://bbs.hassbian.com/thread-25022-1-1.html

解决日志出现的：Addons Blocked from installing：
https://community.home-assistant.io/t/addons-blocked-from-installing/638505/3
ha su repair
ha core rebuild
ha host reboot