我在树莓派RPI5 *GB上运行Docker 版Home Assistant。

 

首先要安装一个基于 Debian 的底层操作系统，必须直接安装在物理硬盘或虚拟机里。

正确的逻辑是：你先安装好Debian操作系统，然后在 Debian操作系统里面安装和管理 Docker 容器。

 

把 Home Assistant本身作为一个 Docker 容器来运行。

目前Home Assistant有三种安装方式，Home Assistant core、Home Assistant docker以及Home Assistant OS。这三种安装方式都是以操作系统为基础的，运行在物理主机或虚拟机上，简称HA。

 

由于Home Assistant core的安装方式调式起来比较复杂（经常因为依赖包问题运行出错），因此后来改为用docker 安装Home Assistant 让安装出错问题简化。再后来因为小白用户太多，不懂操作系统，便推出Home Assistant OS安装方式（把操作系统和home assistant一起打包了，复刻即可）。

 

安装 Home Assistant = 部署一个 Web 网站

Home assistant 是一个应用程序，其本质是一个网站。安装home assistant的过程，实际上是部署一个网站的过程。

 

 

Table of Contents

 

环境

RPi 5 8GB + Debian 12 + Docker Home Assistant

Home Assistant的外部层次结构

想要使用 Home Assistant，至少你得有一个设备来运行HA。

Debian OS                                 # 操作系统
├── Python                                # 开发语言）
│   └── Home assistant Core( )    # ha web 服务器
└── Docker                        # 扩展功能（各种协议）
    └── piper( )    # 扩展语音 +  协议

Home Assistant项目基于Python编写，故运行ha必须有Python环境。

 

 网关与子设备架构：BLE、Zigbee、Thread、Matter 应该怎么挂到一个ha系统里？

Debian OS                                 # 操作系统
├── Docker                               # 
│   └── Docker Home Assistant    # ha web 服务器
└── Docker  
    ├── # matter 网关                    # 扩展功能（各种协议）
    ├── Matter Server  Matter Server
    ├── OpenThread Border Router（SkyConnect Connect ZBT-1）
    ├── # zigbee 网关 
    ├── Zigbee2MQTT
    ├── # 本地语音
    ├── OpenThread Border Router
    ├── OpenThread Border Router
    ├── llama-server
    ├── Sherpa-ONNX
    └── piper( )    # 扩展语音 +  协议

 

 

Home Assistant的内部结构

~/homeassistant/
└── config/
    ├── configuration.yaml    # 主配置文件（核心，后面要改）
    ├── automations.yaml      # 自动化规则
    ├── scripts.yaml          # 脚本
    ├── scenes.yaml           # 场景
    ├── secrets.yaml          # 敏感信息（密码等）
    ├── home-assistant.log    # 运行日志（排查问题看这里）
    ├── home-assistant_v2.db  # 状态历史数据库（SQLite）
    ├── .storage/             # HA 内部数据（UI 配置、设备注册表等，别改）
    ├── deps/                 # Python 依赖缓存
    ├── tts/                  # 语音合成缓存
    └── custom_components/    # 自定义组件（后

Comments


Comments are closed