Skip to content

ubuntu使用Docker部署HomeAssistant ​

一、检查环境 ​

  • 检查 Docker 是否已安装并运行

    shell
    systemctl status docker

    image-20261016171756196

  • 检查 Docker 版本(建议使用 20.10 或更高版本)

    shell
    docker -v

    image-20261016171840076

  • 检查 Docker Compose 版本(建议使用 v2.0 或更高版本)

    shell
    docker compose version

    image-20261016171939059

二、安装步骤 ​

  1. 拉取 HomeAssistant 镜像

    shell
    sudo docker pull homeassistant/home-assistant:latest
  2. 为配置文件创建挂载目录并设置权限

    shell
    sudo mkdir -p /data/homeassistant/config
    sudo chmod -R 777 /data/homeassistant
  3. 运行 HomeAssistant 容器

    • 方式一:使用 Docker CLI 启动容器

      shell
      sudo docker run -d  --name homeassistant  --restart always  -v /data/homeassistant/config:/config  -e TZ=Asia/Shanghai  -p 8123:8123  homeassistant/home-assistant:latest
    • 方式二:使用 Docker Compose 启动容器

      1. 创建 docker-compose.yaml 文件

        yaml
        version: '3'
        services:
         homeassistant:
           image: homeassistant/home-assistant:latest
           container_name: homeassistant
           restart: always
           volumes:
             - /data/homeassistant/config:/config
           environment:
             - TZ=Asia/Shanghai
           ports:
             - "8123:8123"
      2. 启动容器

        shell
        docker compose up -d

三、访问 HomeAssistant ​

  • 防火墙放行 8123 端口
  • 云服务器安全组放行 8123 端口
  • 浏览器访问 http://<服务器IP>:8123,完成初始配置,包括设置用户名、密码、时区等

MIT版权,未经许可禁止任何形式的转载