Home Assistant 安装#

我使用的是 docker-compose 安装的，docker-compose.yml 文件如下：

version: '3.8'
services:
  homeassistant:
    image: homeassistant/home-assistant
    container_name: home-assistant
    restart: unless-stopped
    volumes:
      - ./home-assistant:/config
    ports:
      - '8123:8123'
    environment:
      - TZ=Asia/Shanghai

在浏览器中访问 http://localhost:8123 即可访问 Home Assistant。

TIP

如果你想要在公网中访问 Home Assistant，可以使用 Nginx Proxy Manager 进行反向代理，可以参考 Nginx Proxy Manager 使用指南。此时你应该仍然无法从公网访问 Home Assistant，查看 home-assistant 容器的日志，可以看到如下日志

2024-12-26 14:59:40.393 ERROR (MainThread) [homeassistant.components.http.forwarded] A request from a reverse proxy was received from 192.168.97.1, but your HTTP integration is not set-up for reverse proxies

此时需要修改 home-assistant 配置文件，在 configuration.yaml 中添加如下配置：

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.97.0/24

启动 Home Assistant#

docker-compose up -d

进入浏览器，访问 http://localhost:8123 即可访问 Home Assistant。根据页面提示，配置 Home Assistant。

米家集成#

得益于小米官方的开放，Home Assistant 可以非常方便的集成小米的智能家居设备。

1. 进入 home-assistant 容器终端中
2. clone 米家集成仓库

git clone https://github.com/XiaoMi/ha_xiaomi_home.git

3. 进入 ha_xiaomi_home 目录

cd ha_xiaomi_home

4. 运行安装脚本

./install.sh /config

5. 浏览器中访问 Home Assistant，并重启 Home Assistant
6. 重启后，在 Home Assistant 中添加米家集成
   1. 在 Home Assistant 中点击 设置 -> 设备与服务 -> 添加集成
   2. 在 搜索集成 中搜索 Xiaomi Home
   3. 点击 Xiaomi Home 集成，并按照提示进行配置
   4. 配置完成后，在 Home Assistant 中可以看到米家设备，并进行控制

TIP

• 如果你使用的是 safari 浏览器，可能会出现无法添加集成的情况，此时可以尝试使用其他浏览器。
• 如果验证小米账号中出现错误，可以修改 http://homeassistant.local:8123/api/webhook/xxx 中的 homeassistant.local 为你局域网 IP 地址。

在苹果家庭App中添加设备#

1. 在 Home Assistant 中点击 设置 -> 设备与服务 -> 添加集成
2. 在 搜索集成 中搜索 Apple -> HomeKit Bridge
3. 点击 HomeKit Bridge 集成，并按照提示进行配置
4. 配置完成后，在左下角通知处可以看到设备码和设备二维码
5. 打开苹果家庭App，点击 + 按钮，选择 添加或扫描配件
6. 添加完成后，在苹果家庭App中可以看到设备，并进行控制

最后#

Home Assistant 是一个非常强大的智能家居平台，可以非常方便的集成小米的智能家居设备。且支持非常多的智能家居设备，可以参考 Home Assistant 官方文档 了解更多。