Uni-Meter项目HTTP端口冲突问题解决方案

Uni-Meter项目HTTP端口冲突问题解决方案

uni-meter A universal electric meter data converter (emulator) 项目地址: https://gitcode.com/gh_mirrors/un/uni-meter

问题背景

在使用Uni-Meter项目的Homeassistant插件时，用户遇到了端口80被占用的问题。用户尝试将端口修改为8888和4711，但配置后仍然出现端口冲突错误。错误日志显示系统无法在80端口绑定HTTP服务器，提示"Address in use"。

技术分析

Uni-Meter项目实际上运行着两个独立的HTTP服务：

1. 虚拟Shelly设备服务：通过配置文件中的shelly-pro3em部分的port参数配置（用户已设置为4711）
2. Uni-Meter主HTTP服务：默认使用80端口，用于提供外部API和可能的未来UI界面

用户只配置了虚拟Shelly设备的端口，但没有配置主HTTP服务的端口，导致系统仍然尝试使用默认的80端口。

解决方案

要解决此问题，需要在配置文件中显式指定Uni-Meter主HTTP服务的端口。正确的配置方式是在配置文件中添加http-server部分：

uni-meter {
  http-server {
    port = 4711  # 或其他可用端口号
  }
  
  output = "uni-meter.output-devices.shelly-pro3em"
  input = "uni-meter.input-devices.tasmota"
  
  output-devices {
    shelly-pro3em {
      port = 4711
      udp-port = 1010
      udp-interface = "0.0.0.0"
    }
  }

  input-devices {
    tasmota {
      url = "http://192.168.20.112"
      power-json-path = "$.StatusSNS.Wohnung.16_7_0"
      power-scale = 1.0
      energy-consumption-json-path = "$.StatusSNS.Wohnung.1_8_0"
      energy-consumption-scale = 1.0
    }
  }
}

配置建议

1. 端口选择：确保选择的端口号在系统上是可用的（1024以下的端口通常需要root权限）
2. 端口冲突检查：在Linux/Mac上可以使用netstat -tuln | grep <端口号>，在Windows上可以使用netstat -ano | findstr <端口号>来检查端口占用情况
3. 防火墙设置：如果使用了防火墙，确保新配置的端口已被允许通过

技术原理

Uni-Meter采用模块化设计，不同的功能组件使用独立的网络端口：

• 主HTTP服务：提供REST API接口，未来可能包含Web界面
• 虚拟设备服务：模拟实际硬件设备的网络行为
• UDP服务：用于特定设备通信

这种设计提高了系统的灵活性和可扩展性，但也要求用户在配置时明确指定各服务的网络参数。

总结

通过正确配置http-server部分的端口参数，可以解决Uni-Meter项目中的端口冲突问题。这种配置方式体现了软件设计的模块化思想，允许用户根据实际环境灵活调整网络参数。对于初次使用的用户，建议仔细阅读配置文件中的注释说明，理解各参数的作用范围。

uni-meter A universal electric meter data converter (emulator) 项目地址: https://gitcode.com/gh_mirrors/un/uni-meter