项目简介

​ ​ HomeAssistant是一个开源的 智能家居平台，旨在将各种品牌的智能设备集成到一个统一的系统中，实现本地化控制、自动化和远程管理。

安装环境

工具	版本
系统	CentOS 7
Docker	25.0.4
Docker-Compose	2.24.7
HomeAssistant	2025.5.2

安装步骤

安装Docker

具体安装步骤见：Docker安装教程

安装docker-compose

具体安装步骤见：Docker-Compose安装教程

安装HomeAssistant

新建目录

mkdir -p /你的路径/homeassistant/data

编写docker-compose.yml文件

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:2025.5.2"
    volumes:
      - $PWD/data/config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

启动容器

在docker-compose.yml文件所在目录下执行

docker-compose up -d

实时查看日志：

docker-compose logs -f

至此HomeAssistant就安装好了，访问 http://localhost:8123进行使用。

反向代理（非必须）

我们这里使用Nginx

server {
    listen       443 ssl;
    listen       [::]:443 ssl;
    server_name  xxx.xxx.com;
    charset utf-8;
    access_log off;

    ssl_certificate      /home/cert/fullchain.cer;
    ssl_certificate_key  /home/cert/xxxx.com.key;
    ssl_session_cache    shared:SSL:1m;
    ssl_session_timeout  5m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;

    location / {
        proxy_pass http://localhost:8123;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 80;
    listen [::]:80;
    server_name xxx.xxx.com;

    # 核心代码
    rewrite ^(.*)$ https://${server_name}$1 permanent;
}

使用教程

官方文档