marijngiesen/hadashboard

HADashboard镜像概述

HADashboard是针对Home Assistant的壁挂式仪表盘，基于Dashing框架构建，优化了远距离查看体验，通过Home Assistant API实现设备控制与状态实时更新，适用于家庭智能设备的集中监控与管理。

核心功能

1. 多设备兼容：支持开关、锁、传感器、灯光、报警面板、天气等多种Home Assistant实体类型。
2. 实时状态更新：通过hapush组件监听Home Assistant事件流，自动推送设备状态变化，无需手动刷新。
3. 灵活布局配置：支持自定义网格布局、多页面切换及多仪表盘设置，满足不同场景需求。
4. 报警控制：提供完整的报警控制面板组件，支持布防、撤防、触发等操作。
5. 扩展功能：集成Dark Sky天气数据展示及RSS新闻订阅功能。

使用场景

• 家庭智能设备的集中监控与控制中心。
• 壁挂式展示，方便远距离查看家庭状态。
• 多房间/区域的智能设备管理（通过多仪表盘实现）。

配置说明

Docker安装（非树莓派）

1. 克隆仓库：

bash
git clone https://github.com/home-assistant/hadashboard.git
cd hadashboard

2. 构建镜像：

bash
docker build -t hadashboard .

3. 运行容器：

bash
docker run --name="hadashboard" -d \
  -v <本地仪表盘目录>:/app/dashboards \
  -v <本地ha_conf.rb路径>:/app/lib/ha_conf.rb \
  -v <本地hapush目录>:/app/hapush \
  --net=host \
  -e "TZ=Asia/Shanghai" \
  hadashboard

Docker安装（树莓派）

使用树莓派专用Dockerfile构建：

bash
docker build -f Docker-raspi/Dockerfile -t hadashboard .

运行命令与非树莓派一致。

实时更新配置（hapush）

1. 复制配置文件：

bash
cp hapush/hapush.cfg.example hapush/hapush.cfg

2. 编辑配置（Docker环境下路径为/app/dashboards和/app/hapush/hapush.log）：

ini
ha_url = "http://你的HomeAssistant地址:8123"
ha_key = "你的API密钥"
dash_host = "仪表盘主机地址:3030"
dash_dir = "/app/dashboards"
logfile = "/app/hapush/hapush.log"

Docker环境下hapush自动启动，手动安装需运行：

bash
./hapush.py hapush.cfg

自定义仪表盘

复制示例模板并修改：

bash
cp dashboards/example.erb dashboards/main.erb

添加组件示例：

html
<li data-row="1" data-col="1" data-sizex="1" data-sizey="1">
  <div data-id="office" data-view="Hadimmer" data-title="办公室灯" data-icon="lightbulb-o"></div>
</li>