智能家居平台服务端安装教程——东方仙盟部署

登录阿里云服务器：使用 SSH 工具（如 ssh 命令）登录到你的阿里云 Linux 服务器。确保服务器已安装并能正常运行，且网络连接正常。更新系统软件包：执行以下命令更新系统软件包到最新版本。

bash

sudo apt updatesudo apt upgrade -y

Home Assistant 是基于 Python 的应用，需要安装 Python 及其相关依赖。

bash

sudo apt install -y python3 python3-dev python3-venv python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libtiff5 tk8.6-dev tcl8.6-dev

为了隔离 Home Assistant 的依赖，建议创建一个 Python 虚拟环境。

bash

python3 -m venv /srv/homeassistantsource /srv/homeassistant/bin/activate

在激活的虚拟环境中，使用 pip 安装 Home Assistant。

bash

安装完成后，可以启动 Home Assistant 服务。

bash

hass

首次启动时，Home Assistant 会进行一些初始化操作，可能需要一些时间。启动成功后，你可以通过浏览器访问 http://:8123 来访问 Home Assistant 的 Web 界面。

6. 配置 Home Assistant 作为系统服务（可选但推荐）

为了确保 Home Assistant 在服务器重启后能自动启动，可以将其配置为系统服务。

bash

sudo nano /etc/systemd/system/home-assistant@homeassistant.service

plaintext

[Unit]Description=Home AssistantAfter=network-online.target[Service]Type=simpleUser=rootExecStart=/srv/homeassistant/bin/hass -c "/root/.homeassistant"[Install]WantedBy=multi-user.target

保存并退出文件。

bash

bash

sudo systemctl start home-assistant@homeassistantsudo systemctl enable home-assistant@homeassistant

如果服务器启用了防火墙，需要开放 Home Assistant 使用的端口（默认是 8123）。

bash

sudo ufw allow 8123

ollecting importlib-metadata==0.23 (from homeassistant) HTTP error 502 while getting https://mirrors.aliyun.com/pypi/packages/f6/d2/40b3fa882147719744e6aa50ac39cf7a22a913cbcba86a0371176c425a3b/importlib_metadata-0.23-py2.py3-none-any.whl#sha256=d5f18a79777f3aa179c145737780282e27b508fc8fd688cb17c7a813e8bd39af (from https://mirrors.aliyun.com/pypi/simple/importlib-metadata/) (requires-python:>=2.7,!=3.0,!=3.1,!=3.2,!=3.3) Could not install requirement importlib-metadata==0.23 from https://mirrors.aliyun.com/pypi/packages/f6/d2/40b3fa882147719744e6aa50ac39cf7a22a913cbcba86a0371176c425a3b/importlib_metadata-0.23-py2.py3-none-any.whl#sha256=d5f18a79777f3aa179c145737780282e27b508fc8fd688cb17c7a813e8bd39af (from homeassistant) because of error 502 Server Error: Bad Gateway for url: https://mirrors.aliyun.com/pypi/packages/f6/d2/40b3fa882147719744e6aa50ac39cf7a22a913cbcba86a0371176c425a3b/importlib_metadata-0.23-py2.py3-none-any.whl Could not install requirement importlib-metadata==0.23 from https://mirrors.aliyun.com/pypi/packages/f6/d2/40b3fa882147719744e6aa50ac39cf7a22a913cbcba86a0371176c425a3b/importlib_metadata-0.23-py2.py3-none-any.whl#sha256=d5f18a79777f3aa179c145737780282e27b508fc8fd688cb17c7a813e8bd39af (from homeassistant) because of HTTP error 502 Server Error: Bad Gateway for url: https://mirrors.aliyun.com/pypi/packages/f6/d2/40b3fa882147719744e6aa50ac39cf7a22a913cbcba86a0371176c425a3b/importlib_metadata-0.23-py2.py3-none-any.whl for URL https://mirrors.aliyun.com/pypi/packages/f6/d2/40b3fa882147719744e6aa50ac39cf7a22a913cbcba86a0371176c425a3b/importlib_metadata-0.23-py2.py3-none-any.whl#sha256=d5f18a79777f3aa179c145737780282e27b508fc8fd688cb17c7a813e8bd39af (from https://mirrors.aliyun.com/pypi/simple/importlib-metadata/) (requires-python:>=2.7,!=3.0,!=3.1,!=3.2,!=3.3) [root@iZ2vcbr09kxsytmlhp8egbZ homeassistant]# hass -bash: hass: command not found

从你给出的错误信息来看，在安装 importlib-metadata==0.23 这个依赖时，因为阿里云镜像源返回了 502 错误（Bad Gateway），导致安装失败，并且后续尝试运行 hass 命令时系统提示找不到该命令。下面为你提供相应的解决办法：

阿里云镜像源临时出现问题，你可以暂时更换为其他镜像源，例如清华大学的镜像源。

在使用 pip 安装依赖时，通过 -i 参数指定镜像源：

bash

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple homeassistant

你也可以把镜像源永久配置为清华大学的镜像源，具体操作如下：

bash

mkdir ~/.pipcat ~/.pip/pip.conf[global]index-url = https://pypi.tuna.tsinghua.edu.cn/simple[install]trusted-host = pypi.tuna.tsinghua.edu.cnEOF

之后再重新安装 Home Assistant：

bash

pip install homeassistant

确保你处于正确的 Python 虚拟环境中，因为 hass 命令是在虚拟环境里可用的。你可以使用以下命令激活虚拟环境：

bash

source /srv/homeassistant/bin/activate

激活虚拟环境之后，再次尝试运行 hass 命令：

bash

如果更换镜像源之后仍然无法安装 importlib-metadata，可以尝试手动安装这个依赖：

bash

pip install importlib-metadata==0.23

若手动安装成功，再尝试安装 Home Assistant：

bash

要是 hass 命令依旧无法找到，你可以检查虚拟环境的 bin 目录是否已经添加到系统的 PATH 环境变量中。可以使用以下命令查看 PATH 变量：

bash

echo $PATH

确保 /srv/homeassistant/bin 在其中。如果不在，可以临时添加：