hasscc/hacs

Home Assistant 增强版Docker镜像

⚠️ 重要提示

本镜像已正式更名为 https://hub.docker.com/r/hacn/hacn

镜像概述

基于Home Assistant官方镜像构建，预装多种常用集成组件，简化用户配置流程。镜像每日自动更新，适用于希望快速部署并使用Home Assistant核心功能及常用扩展的用户。

预装集成

说明：镜像每日更新，可用标签（tag）包括 stable（稳定版）、latest（最新版）、dev（开发版）及月度版本（如 2024.9）。
预装机制：仅对新安装的Home Assistant实例执行预装；若系统中已存在 custom_components 目录，则不会触发预装流程。

• HACS极速版
• https://github.com/al-one/hass-xiaomi-miot%EF%BC%88%E7%B1%B3%E5%AE%B6%E8%AE%BE%E5%A4%87%E9%9B%86%E6%88%90%EF%BC%89
• https://github.com/AlexxIT/XiaomiGateway3%EF%BC%88%E5%B0%8F%E7%B1%B3%E7%BD%91%E5%85%B33%E6%94%AF%E6%8C%81%EF%BC%89
• https://github.com/hasscc/tianqi
• https://github.com/shaonianzhentan/ha_file_explorer

使用方法

命令行安装

参考Home Assistant官方文档的Linux安装说明

bash
docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Asia/Shanghai \
  -v /PATH_TO_YOUR_CONFIG:/config \
  -v /run/dbus:/run/dbus:ro \
  --network=host \
  hacn/hacn:stable

Docker Compose安装

参考Home Assistant官方文档的Docker Compose配置说明

yaml
services:
  homeassistant:
    container_name: homeassistant
    image: hacn/hacn:stable
    volumes:
      - /PATH_TO_YOUR_CONFIG:/config  # 配置文件目录映射
      - /etc/localtime:/etc/localtime:ro  # 时间同步
      - /run/dbus:/run/dbus:ro  # D-Bus服务映射
    restart: unless-stopped
    privileged: true  # 赋予特权模式
    network_mode: host  # 使用主机网络模式

相关链接

• https://github.com/hasscc/hass-docker/blob/main/Dockerfile