trafex/nefiteasy-http-server

Nefit Easy HTTP服务器Docker容器

镜像概述和主要用途

该Docker镜像用于在容器中运行Nefit Easy HTTP服务器，提供便捷的部署方式，使用户能够通过HTTP接口与Nefit Easy智能温控设备进行通信和交互。

核心功能和特性

• 容器化运行Nefit Easy HTTP服务器，简化部署流程
• 提供HTTP接口，支持与Nefit Easy设备进行数据交互
• 支持标准Docker部署方式，易于集成到现有系统

使用场景和适用范围

适用于需要通过HTTP接口监控或控制Nefit Easy智能温控设备的场景，例如家庭自动化系统集成、自定义控制面板开发、设备状态监控等。

镜像获取与构建

使用预构建镜像

可直接从Docker Hub获取预构建镜像：

bash
docker pull trafex/nefiteasy-http-server

本地构建镜像

若需本地构建，执行以下命令：

bash
docker build -t trafex/nefiteasy-http-server .

运行容器

基本运行命令

bash
docker run -d -p 3000:3000 \
    -e "NEFIT_SERIAL_NUMBER=<序列号>" \
    -e "NEFIT_ACCESS_KEY=<访问密钥>" \
    -e "NEFIT_PASSWORD=<密码>" \
    trafex/nefiteasy-http-server

参数说明

• 端口映射：-p 3000:3000 - 将容器内3000端口映射到主机3000端口，用于访问HTTP服务器
• 环境变量：
  • NEFIT_SERIAL_NUMBER：Nefit Easy设备的序列号
  • NEFIT_ACCESS_KEY：设备访问密钥
  • NEFIT_PASSWORD：设备密码

使用方法

API端点访问

服务器提供两类API接口，访问时需添加相应前缀：

基础端点（前缀/bridge）

参考https://github.com/robertklep/nefit-easy-core/wiki/List-of-endpoints%EF%BC%8C%E8%AE%BF%E9%97%AE%E6%A0%BC%E5%BC%8F%E5%A6%82%E4%B8%8B%EF%BC%9A

bash
curl http://localhost:3000/bridge/ecus/rrc/uiStatus

高级命令API（前缀/api）

使用https://github.com/robertklep/nefit-easy-http-server#commands-api%EF%BC%8C%E4%BE%8B%E5%A6%82%E8%8E%B7%E5%8F%96%E8%AE%BE%E5%A4%87%E7%8A%B6%E6%80%81%EF%BC%9A

bash
curl http://127.0.0.1:3000/api/status

依赖说明

与Nefit Easy设备的通信通过https://github.com/robertklep/nefit-easy-http-server%E8%BD%AF%E4%BB%B6%E5%8C%85%E5%AE%9E%E7%8E%B0%EF%BC%8C%E8%AF%A5%E5%8C%85%E6%8F%90%E4%BE%9B%E4%BA%86%E4%B8%8E%E8%AE%BE%E5%A4%87%E4%BA%A4%E4%BA%92%E7%9A%84%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E3%80%82