### 使用 Docker 在 Ubuntu 上安装 Home Assistant 的方法 要在 Ubuntu 系统中通过 Docker 安装 Home Assistant，可以按照以下说明操作： #### 准备工作 确保系统已更新至最新状态并安装必要的工具： ```bash sudo apt-get update && sudo apt-get upgrade -y sudo apt-get install -y curl wget gnupg lsb-release ``` #### 配置 Docker 仓库 由于 `apt-key` 已被弃用[^1]，需采用新的方式添加 GPG 密钥。以下是具体步骤： ```bash curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ``` #### 安装 Docker 完成上述配置后，即可安装 Docker： ```bash sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io ``` 验证 Docker 是否正常运行： ```bash sudo systemctl status docker docker --version ``` 如果一切正常，则继续后续步骤。 #### 创建专用网络（可选） 为 Home Assistant 创建一个独立的 Docker 网络有助于更好地管理服务间的通信： ```bash sudo docker network create hass-network ``` #### 下载并启动 Home Assistant 容器 拉取最新的 Home Assistant 容器镜像，并设置其运行参数： ```bash sudo docker run -d \ --name="home-assistant" \ --privileged=true \ --restart=unless-stopped \ -v /PATH/TO/YOUR/HASS_CONFIG:/config \ -v /etc/localtime:/etc/localtime:ro \ -p 8123:8123 \ --network=hass-network \ ghcr.io/home-assistant/home-assistant:stable ``` > **注意**: 将 `/PATH/TO/YOUR/HASS_CONFIG` 替换为你希望存储 Home Assistant 配置文件的实际路径。 #### 访问 Home Assistant Web 界面 默认情况下，Home Assistant 运行在端口 `8123`。打开浏览器访问地址 `http://<服务器IP>:8123` 即可进入初始配置向导。 --- ### 可能遇到的问题及解决办法 1. 如果无法连接到容器中的 Home Assistant，请确认防火墙规则允许流量通过端口 `8123`。 2. 若需要持久化数据，建议挂载额外卷用于日志记录或其他用途： ```bash -v /var/lib/homeassistant/logs:/logs ``` --- ###