padhihomelab/hass

docker_hass

镜像概述和主要用途

docker_hass 是一个非root用户运行的多架构 HomeAssistant Docker镜像，集成了 HACS（Home Assistant Community Store）。该镜像旨在提供安全、便捷的HomeAssistant部署方案，支持多种硬件架构，适用于构建智能家居控制系统。

核心功能和特性

• 非root用户运行：采用非root用户权限运行容器，提升系统安全性，降低权限滥用风险
• 多架构支持：兼容386、amd64、arm/v6、arm/v7、arm64架构（ppc64le、riscv64、s390x架构暂不支持）
• 集成HACS：预装Home Assistant Community Store，方便安装自定义组件、插件和主题
• 原生HomeAssistant功能：基于官方HomeAssistant核心功能，确保兼容性和稳定性

支持架构

使用场景和适用范围

适用于需要部署HomeAssistant智能家居系统的用户，尤其适合：

• 追求容器安全性，希望以非root权限运行服务的场景
• 使用不同架构硬件设备（如x86服务器、ARM开发板、树莓派等）的用户
• 需要便捷安装自定义组件和主题的HomeAssistant用户

使用方法和配置说明

Docker 命令部署

通过以下命令快速启动容器：

bash
docker run -p 8123:8123 \
           -e DOCKER_UID=$(id -u) \
           -e DOCKER_GID=$(id -g) \
           -v /path/to/store/config:/config \
           -it padhihomelab/hass

参数说明：

• -p 8123:8123：映射容器内HomeAssistant Web界面端口到主机
• -e DOCKER_UID=$(id -u)：设置容器运行用户ID（使用当前用户ID，避免权限问题）
• -e DOCKER_GID=$(id -g)：设置容器运行组ID（使用当前用户组ID）
• -v /path/to/store/config:/config：挂载主机目录到容器内/config，用于持久化存储HomeAssistant配置
• -it：交互式运行（如需后台运行，可替换为--detach或-d）

Docker Compose 部署

可通过Docker Compose实现更便捷的管理，示例配置可参考 https://github.com/padhi-homelab/services/tree/master/hass%E3%80%82

环境变量说明