hijinx/ha-editor

ha-editor

一款基于Monaco编辑器的网页版编辑器，专为Home Assistant设计，可作为面板组件集成到Home Assistant网页界面中，实现配置文件的在线编辑。

镜像概述

ha-editor是针对Home Assistant用户打造的在线配置编辑工具，基于Monaco编辑器提供专业的代码编辑体验，支持直接绑定Home Assistant的配置文件目录，让用户无需本地操作即可修改配置。

核心功能

• 采用Monaco编辑器，提供语法高亮、代码提示等专业编辑功能
• 可作为iframe面板集成到Home Assistant网页界面
• 支持绑定Home Assistant配置文件目录，直接编辑本地配置文件

使用场景

适用于Home Assistant用户需要在网页端快速修改配置文件的场景，尤其适合不便于直接访问服务器文件系统的用户。

配置说明

Docker部署

1. 拉取镜像：

bash
sudo docker pull voxic/ha-editor

2. 进入Home Assistant配置文件目录并运行容器：

bash
cd /path/to/homeassistant/config
sudo docker run -d -p 3000:3000 --mount type=bind,source="$(pwd)",target=/usr/src/app/configFolder voxic/ha-editor

3. 修改Home Assistant的configuration.yaml文件，添加面板配置：

yaml
panel_iframe:
  editor:
    title: '编辑器'
    url: 'http://[你的Home Assistant IP]:3000'
    icon: mdi:book-open

4. 重启Home Assistant生效。

Nodejs部署

1. 克隆仓库：

bash
git clone https://github.com/voxic/ha-editor.git

2. 安装依赖：

bash
cd ha-editor
npm install

3. 修改app.js中的baseDir变量，指向Home Assistant配置文件目录：

javascript
let baseDir = "configFolder" // 替换为实际配置目录路径

4. 同Docker部署步骤3，修改configuration.yaml并重启Home Assistant。
5. 启动编辑器：

bash
node app.js

技术栈

• Monaco-editor（代码编辑核心）
• Bootstrap（界面框架）
• Express（后端服务）
• EJS（模板引擎）
• Jquery（前端交互）

许可证

本项目采用MIT许可证，详情见LICENSE。 ===FULL_DESC===