Home Assistant 家庭助理安装

目录

1. 前言

2. 树莓派

2.1 安装家庭助理操作系统

2.2.1 推荐的硬件

2.1.2 将映像写入启动媒体

2.1.3 启动你的树莓派

2.2 安装家庭助理容器

2.2.1 平台安装

2.2.1 重新启动家庭助理

2.2.2 Docker Compose

2.2.3 显示设备

2.2.4 优化

3. ODROID

3.1 安装家庭助理操作系统

3.3.1 推荐的硬件

3.1.2 将映像写入启动媒体

3.1.3 启动您的 ODROID

4. Windows视窗

4.1安装家庭助理操作系统

4.1.1 下载相应的图像

4.1.2 创建虚拟机

4.1.3 管理程序特定配置

4.1.4 启动您的虚拟机

5. 总结

1. 前言

第一步是安装Home Assistant 家庭助理。我们建议使用专用系统来运行 Home Assistant。如果您不确定要选择什么，请按照Raspberry Pi 指南安装Home Assistant 操作系统。

Home Assistant 提供四种不同的安装方法。我们建议使用以下两种方法之一：

有经验的用户可以使用两种替代安装方法：

下面的列表显示了基于所使用的设备和平台的可用安装方法。

如果您使用的是Home Assistant Blue，则已安装 Home Assistant 操作系统。继续入职。

        以下列出都可以使用，但暂时只提供树莓派、 ODROID、Windows视窗安装教程

2. 树莓派

        请记住确保您为 Raspberry Pi 使用合适的电源。移动充电器可能不适合，因为有些充电器设计为只为该制造商的手机提供全功率。计算机上的 USB 端口也无法提供足够的电力，因此不得使用。

2.1 安装家庭助理操作系统

        如果您想轻松开始使用 Home Assistant，或者您几乎没有 Linux 经验，请遵循本指南。

2.2.1 推荐的硬件

        我们需要做一些事情来开始安装 Home Assistant。下面的链接指向亚马逊美国。如果您不在美国，您应该能够在您所在国家/地区的网上商店中找到这些商品。

2.1.2 将映像写入启动媒体

将 Home Assistant 启动媒体（SD 卡）连接到您的计算机

下载并启动Balena Etcher。（您可能需要在 Windows 上以管理员权限运行它）。

选择“从 URL 闪现”

获取 Raspberry Pi 的 URL：

树莓派 4 64 位：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi4-64-7.6.img.xz
树莓派 4 32 位：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi4-7.6.img.xz
树莓派 3 64 位:
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi3-64-7.6.img.xz
树莓派 3 32 位:
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi3-7.6.img.xz

 建议使用 64 位）

选择并复制 URL 或使用悬停时出现的“复制”按钮。

2.1.3 启动你的树莓派

插入您刚刚创建的启动媒体（SD 卡）。

为网络连接以太网电缆。

连接电源线。

在您的桌面系统的浏览器中，几分钟内您将能够在homeassistant.local:8123上访问您的新家庭助理。

安装并访问 Home Assistant 操作系统后，您可以继续学习。

2.2 安装家庭助理容器

        以下这些说明适用于在您自己管理的容器环境中安装 Home Assistant Container。可以使用任何与OCI兼容的运行时，但是本指南将重点介绍使用 Docker 安装它。

2.2.1 平台安装

使用 Docker 安装很简单。调整以下命令，以便：

/PATH_TO_YOUR_CONFIG指向要存储配置并运行它的文件夹。

MY_TIME_ZONE是一个tz 数据库名称，如TZ=America/Los_Angeles.

安装：
docker run -d \
--name homeassistant \
--privileged \
--restart=unless-stopped \
-e TZ=MY_TIME_ZONE \
-v /PATH_TO_YOUR_CONFIG:/config \
--network=host \
ghcr.io/home-assistant/home-assistant:stable

更新：
# if this returns "Image is up to date" then you can stop here
docker pull ghcr.io/home-assistant/home-assistant:stable
# stop the running container
docker stop homeassistant
# remove it from Docker's list of containers
docker rm homeassistant
# finally, start a new one
docker run -d \
--name homeassistant \
--restart=unless-stopped \
--privileged \
-e TZ=MY_TIME_ZONE \
-v /PATH_TO_YOUR_CONFIG:/config \
--network=host \
ghcr.io/home-assistant/home-assistant:stable

        一旦 Home Assistant 容器运行 Home Assistant 应该可以使用http://<host>:8123（替换使用系统的主机名或 IP）。您可以继续学习。 

2.2.1 重新启动家庭助理

如果更改配置，则必须重新启动服务器。为此，您有 3 个选项。

Docker CLI：
docker restart homeassistant
Docker Compose：
docker-compose restart

2.2.2 Docker Compose

        随着 Docker 命令变得越来越复杂，切换到docker-compose可能更可取，并支持在故障或系统重新启动时自动重新启动。创建一个docker-compose.yml文件：

version: '3'
services:
homeassistant:
container_name: homeassistant
image: "ghcr.io/home-assistant/home-assistant:stable"
volumes:
- /PATH_TO_YOUR_CONFIG:/config
- /etc/localtime:/etc/localtime:ro
restart: unless-stopped
privileged: true
network_mode: host

通过运行启动它： 

docker-compose up -d

        一旦 Home Assistant 容器运行 Home Assistant 应该可以使用http://<host>:8123（替换使用系统的主机名或 IP）。您可以继续学习。 

2.2.3 显示设备

        为了使用 Z-Wave、Zigbee 或其他需要访问设备的集成，您需要将适当的设备映射到容器中。确保运行容器的用户具有访问/dev/tty*文件的正确权限，然后将设备映射添加到容器指令中：

Docker CLI：
docker run ... --device /dev/ttyUSB0:/dev/ttyUSB0 ...
Docker Compose：
version: '3'
services:
homeassistant:
...
devices:
- /dev/ttyUSB0:/dev/ttyUSB0

2.2.4 优化

        Home Assistant Container 使用替代的内存分配库jemalloc来更好地进行内存管理和 Python 运行时加速。

        由于 jemalloc 可能会在某些硬件上引起问题，因此可以通过传递DISABLE_JEMALLOC具有任何值的环境变量来禁用它，例如：

Docker CLI：
docker run ... -e "DISABLE_JEMALLOC=true" ...
Docker Compose：
version: '3'
services:
homeassistant:
...
environment:
DISABLE_JEMALLOC: true

错误消息<jemalloc>: Unsupported system page size是一种已知指标。

3. ODROID

3.1 安装家庭助理操作系统

如果您想轻松开始使用 Home Assistant，或者您几乎没有 Linux 经验，请遵循本指南。

3.3.1 推荐的硬件

我们需要做一些事情来开始安装 Home Assistant。下面的链接指向 Ameridroid。如果您不在美国，您应该能够在您所在国家/地区的网上商店中找到这些商品。

首先，我们建议使用 ODROID N2+，它是最强大的 ODROID。它速度快，内置 eMMC，是运行 Home Assistant 的最佳板之一。它也是为我们的Home Assistant Blue提供动力的板。

如果不可用，我们还推荐ODROID C4或ODROID XU4。

3.1.2 将映像写入启动媒体

将 Home Assistant 启动媒体（eMMC 模块/SD 卡）连接到您的计算机

如果您使用的是Home Assistant Blue或 ODROID N2+，您可以直接连接您的设备。

下载并启动Balena Etcher。（您可能需要在 Windows 上以管理员权限运行它）。

选择“从 URL 闪现” 

获取您的 ODROID 的 URL：

ODROID-N2：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-n2-7.6.img.xz
ODROID-N2+：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-n2-7.6.img.xz
ODROID-C2：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-c2-7.6.img.xz
ODROID-C4：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-c4-7.6.img.xz
ODROID-XU4：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-xu4-7.6.img.xz

3.1.3 启动您的 ODROID

插入刚刚创建的引导介质（eMMC 模块/SD 卡）。

为网络连接以太网电缆。

连接电源线。

在您的桌面系统的浏览器中，几分钟内您将能够在homeassistant.local:8123上访问您的新家庭助理。

安装并访问 Home Assistant 操作系统后，您可以继续学习。

4. Windows视窗

4.1安装家庭助理操作系统

4.1.1 下载相应的图像

虚拟盒子 (.vdi)

KVM (.qcow2)

Vmware 工作站(.vmdk)

Hyper-V (.vhdx)

        如果您已经在运行受支持的虚拟机管理程序，请遵循本指南。如果您不熟悉虚拟机，我们建议您直接在Raspberry Pi或ODROID上安装 Home Assistant OS 。

4.1.2 创建虚拟机

        将设备映像加载到您的虚拟机管理程序中。（注意：您可以随意为 VM 分配尽可能多的资源，请根据您的附加组件需求分配足够的资源）。

最低推荐任务：

如果您的使用需要更多资源，所有这些都可以扩展。

4.1.3 管理程序特定配置

虚拟盒子

虚拟机

VMware工作站

创建 VM 后，转到“设置”和“选项”，然后“高级”并选择“固件类型”为“UEFI”。

Hyper-V

Hyper-V 不支持 USB

创建后转到“设置”->“安全”并取消选择“启用安全启动”。

4.1.4 启动您的虚拟机

安装并访问 Home Assistant 操作系统后，您可以继续学习。

具体操作可参考：Home Assistant安装之win10上安装VM虚拟机

5. 总结

        本文学习了home assistant在树莓派、ODROID、Windows上的安装，后期会分享更多有趣物联网的操作从而实现对外部世界进行感知，充分认识这个有机与无机的环境，科学地合理地进行创作和发挥效益，然后为人类社会发展贡献一点微薄之力。

参考文献：