danielperna84/hass-configurator

HASS Configurator

Home Assistant配置UI

镜像概述

HASS Configurator是一个小型网页应用，提供文件浏览器和文本编辑器，用于修改运行设备上的文件，主要为Home Assistant配置设计。基于Ace编辑器，支持多种语言语法高亮，YAML文件（Home Assistant默认配置语言）编辑时会自动检查语法错误。注意：该工具从CDN获取JS库、CSS和字体，客户端设备需联网，且仅支持Python 3。

核心功能

• 基于网页的编辑器，支持语法高亮和自动YAML语法检查
• 上传和下载文件
• 列出可用的触发器、事件、实体、条件和服务，选中可插入编辑器
• Home Assistant事件观察者（通过WebSocket连接查看所有事件）
• 一键重启Home Assistant
• SSL支持
• 可选的认证和IP过滤增强安全性
• 直接链接到Home Assistant文档和图标
• 执行shell命令
• Git仓库操作（暂存、提交、分支管理、推送到SSH远程）
• 可自定义编辑器设置（通过localStorage保存）
• 独立模式（隐藏Home Assistant相关面板，设置HASS_API为None或用-s/--standalone标志）

使用场景

适用于Home Assistant用户快速编辑配置文件、管理相关文件、监控HA事件、进行Git版本控制等场景。

配置说明

详细配置选项可参考官方Wiki：https://github.com/danielperna84/hass-configurator/wiki/Configuration

Docker部署示例

docker run命令

bash
docker run -d \
  --name hass-configurator \
  -p 3218:3218 \
  -v /path/to/your/home-assistant/config:/config \
  danielperna84/hass-configurator

嵌入Home Assistant示例

在Home Assistant配置文件中添加panel_iframe组件：

yaml
panel_iframe:
  configurator:
    title: Configurator
    icon: mdi:wrench
    url: http://[你的设备IP]:3218

注意：设置端口转发时需谨慎，若未启用认证或IP过滤，配置可能暴露到公网！