Windows 子系统方式（WSL2）

本文介绍如何通过 Windows 子系统在 Windows 10 电脑上来安装 Home Assistant Core。

背景信息

Windows 操作系统上无法直接运行 Home Assistant Core。我们可以通过安装 Docker、虚拟机或 Windows 子系统来安装相应的 Linux 系统，从而进一步安装 Home Assistant OS 或者 Home Assistant Core。

操作步骤

安装适用于 Linux 的 Windows 子系统 (WSL)

1. 请参考微软官方文档 适用于 Linux 的 Windows 子系统安装指南 (Windows 10) 进行安装。
2. 在 Windows 应用商店中，安装 Ubuntu 分发。本文以 Ubuntu Server 20.4 为例进行介绍。

安装依赖

开始之前，请确保系统已经安装 apt-get。

1. 在 Windows 操作系统中双击启动 Unbuntu 分发。

2. 确保软件包为最新版本。

   sudo apt-get update sudo apt-get upgrade -y

3. 安装依赖。

   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 tzdata

4. 为 Home Assistant Core 创建一个名为 homeassistant 的账户。

   注意：由于该账户只用于 Home Assistant Core，所以此处增加 -rm 用来创建系统账户主目录。

   sudo useradd -rm homeassistant

5. 创建虚拟环境。

   1. 创建一个安装 Home Assistant Core 的路径，并把路径权限变更至名为 homeassistant 的账户。

      sudo mkdir /srv/homeassistant sudo chown homeassistant:homeassistant /srv/homeassistant

   2. 为 Home Assistant Core 创建并激活虚拟环境。

      sudo -u homeassistant -H -s cd /srv/homeassistant python3.8 -m venv . source bin/activate

   3. 安装 Python 包。

      python3 -m pip install wheel

   4. 安装 Home Assistant Core。

      pip3 install homeassistant

   5. 启动 Home Assistant Core。首次启动时系统会在 /home/homeassistant 目录中创建一个 .homeassistant 配置目录，并安装基本库和依赖。

      hass

      注意：该过程可能会根据网速的不同持续数分钟到十几分钟，并可能在登录 Web 界面时出现“site cannot be reached” 的报错。这些情况只会出现在首次启动时，后续的启动速度将会快得多。

6. 在浏览器中输入 http://homeassistant.local:8123、 http://localhost:8123 或 http://X.X.X.X:8123（X.X.X.X 为电脑的 IP 地址）来登录 Home Assistant。