Home Assistant for China

预装集成

本镜像每日更新，可用标签有stable、latest、dev及月度版本如2024.9

如果想要加载项功能，可以使用hass-super，或使用内置扩展镜像

HA启动时会逐个检测是否安装以下集成，如果没有则自动安装，已安装不会覆盖

• HACS极速版
• 小米 · Xiaomi Miot
• 小米 · Xiaomi Home (2024.11+)
• 小米 · XiaomiGateway3
• 易微联 · Sonoff Lan (2024.11+)
• 天气预报
• 文件管理
• 美的 · Midea AC Lan (2024.11+)
• 美的 · Midea AC Py (2024.11+)
• 海尔 · Haier (2024.12+)
• 巴法 · Bemfa (2024.11+)
• 小燕 · Terncy (2024.12+)
• Edge TTS (2024.11+)
• AI Conversation Agent (2024.9+)

可用镜像

• ghcr.nju.edu.cn/hasscc/hacn
• registry.cn-hangzhou.aliyuncs.com/hasscc/hacn
• ccr.ccs.tencentyun.com/hacn/hacn
• hacn/hacn

可用标签

• stable latest 最新稳定版
• 2025.1 2024.9 对应HA Core月度版本
• addons 2025.1-addons 内置插件版本
• mqtt 2025.2-mqtt 仅内置MQTT Broker版本
• nodered 2025.3-nodered 仅内置Node-RED版本
• dev dev-addons dev-mqtt HA Core开发版

命令安装

https://www.home-assistant.io/installation/linux#install-home-assistant-container

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -v /PATH_TO_YOUR_CONFIG:/config \
  -v /run/dbus:/run/dbus:ro \
  -e TZ=Asia/Shanghai \
  -e ALWAYS_INSTALL=true \
  --network=host \
  ghcr.nju.edu.cn/hasscc/hacn:stable

Compose 安装

https://www.home-assistant.io/installation/linux#docker-compose

services:
  homeassistant:
    container_name: homeassistant
    image: ghcr.nju.edu.cn/hasscc/hacn:stable
    volumes:
      - /PATH_TO_YOUR_CONFIG:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    environment:
      - TZ=Asia/Shanghai
      - ALWAYS_INSTALL=true  # 默认为true，每次启动都会逐个预装，否则仅全新HA才会预装
      - ALWAYS_UPGRADE=false # 默认为false，每次启动都会逐个预装最新版本的插件
    restart: unless-stopped
    privileged: true
    network_mode: host
    healthcheck:
      test: [CMD-SHELL, curl -I localhost:8123 || exit 1]

内置扩展

需要2025.1及以上的镜像，标签 addons 包含以下所有扩展

MQTT Broker

• 镜像标签: mqtt stable-mqtt dev-mqtt
• 环境变量:

  MQTT_USERNAME: homeassistant # 默认为`homeassistant`
  MQTT_PASSWORD: homeassistant # 默认为空无需授权，推荐设置
  MQTT_PORT: 1883 # 默认为`1883`

Node-RED

• 镜像标签: nodered stable-nodered dev-nodered
• 环境变量:

  NODERED_USERNAME: homeassistant # 默认为`homeassistant`
  NODERED_PASSWORD: homeassistant # Node-Red后台密码
  NODERED_PORT: 1880 # 默认为`1880`

• 访问http://IP:1880并登录，需手动配置HA的长效令牌

相关链接

• DockerHub
• Dockerfile