Após o servidor básico do IAMMETER-Docker estar em execução, ele pode ser expandido para um servidor local de monitoramento de energia MQTT, usar MySQL para um conjunto de dados maior, encaminhar dados solares para o PVOutput e aceitar medições compatíveis de terceiros.
Este guia aborda caminhos avançados de dados e opções de armazenamento. Para instalação, volumes persistentes, primeiro login, configuração do medidor, backup e atualizações do container, comece com Monitoramento de Energia Autogerenciado com Docker.
Medidor IAMMETER / dispositivo compatível / aplicação personalizada
│
┌───────────┼───────────┐
│ │ │
HTTP MQTT REST API
│ │ │
└───────────┼───────────┘
▼
IAMMETER-Docker
│
┌─────────────────┼─────────────────┐
▼ ▼ ▼
SQLite / MySQL Assinantes MQTT PVOutput
Utilize apenas as interfaces necessárias para o projeto. Uma instalação simples de monitoramento local não precisa de MySQL, clientes MQTT externos ou encaminhamento de dados.
Confirme que a instalação básica está estável:
/app/data está mapeado para armazenamento persistente;A implantação padrão expõe:
5050 para a aplicação web e API;1883 para MQTT.Não publique nenhuma das portas diretamente na Internet. Use um firewall, VPN ou outra camada de acesso controlado quando o acesso remoto for necessário.
O IAMMETER-Docker usa SQLite para uma implantação padrão simples e suporta MySQL para instalações com um conjunto de dados maior.
| Banco de Dados | Melhor para | Vantagens | Considerações |
|---|---|---|---|
| SQLite | Implantações domésticas, de teste e locais menores | Sem serviço de banco de dados separado; configuração inicial fácil | Banco de dados permanece vinculado ao volume da aplicação |
| MySQL | Instalações maiores ou de longa duração | Serviço de banco de dados separado e melhor adequação para conjuntos de dados crescentes | Requer implantação de banco de dados, credenciais, backup e manutenção |
Não migre para MySQL apenas porque está disponível. Utilize-o quando o volume de dados esperado, o período de retenção ou os requisitos de gerenciamento de banco de dados justificarem um serviço adicional.
Antes de selecionar MySQL no IAMMETER-Docker:
Em seguida, insira as configurações de conexão MySQL no IAMMETER-Docker e confirme que novas medições estão sendo armazenadas.
Faça backup dos dados existentes do IAMMETER-Docker antes de alterar o modo de banco de dados. Verifique os dados históricos e novos uploads após a alteração.
O IAMMETER-Docker inclui suporte MQTT para duas direções diferentes:
Esses caminhos usam o mesmo padrão de tópico, mas modos de autenticação diferentes.
O tópico em tempo real documentado é:
device/<SN>/realtime
Substitua <SN> pelo número de série registrado no IAMMETER-Docker. O SN no tópico MQTT e na configuração do cliente deve corresponder ao medidor criado na plataforma local.
Para um dispositivo ou aplicação de publicação:
| Configuração | Valor |
|---|---|
| Broker | Endereço IP ou hostname do servidor IAMMETER-Docker |
| Porta | 1883 por padrão |
| Autenticação | ID do Cliente |
| ID do Cliente | SN do medidor registrado no IAMMETER-Docker |
| Tópico | device/<SN>/realtime |
| Payload | Formato de dados de upload suportado pelo IAMMETER |
Antes de usar dados de produção:
Para um assinante MQTT:
| Configuração | Valor |
|---|---|
| Broker | Endereço do servidor IAMMETER-Docker |
| Porta | 1883 por padrão |
| Autenticação | Nome de usuário e senha do IAMMETER-Docker |
| Tópico | device/<SN>/realtime |
Os assinantes típicos incluem:
Se o Node-RED for a aplicação principal e o armazenamento histórico no IAMMETER-Docker não for necessário, o medidor também pode se conectar ao Node-RED através de MQTT, Modbus TCP ou sua API local diretamente. Compare as opções no guia do medidor de energia Node-RED.
Comece com um único medidor e tópico exato, em vez de uma assinatura ampla com curinga.
Verifique o seguinte quando nenhum dado aparecer:
1883 está mapeada a partir do container;device/<SN>/realtime com a capitalização esperada;Para fluxos confiáveis:
O PVOutput é um serviço de terceiros para compartilhar e comparar dados de geração solar e consumo de energia. O IAMMETER-Docker pode encaminhar dados do site para o PVOutput.
Use esta opção quando o IAMMETER-Docker permanecer como o servidor de coleta local, mas o PVOutput for necessário para relatórios solares públicos ou externos.
Antes de ativar o encaminhamento:
O encaminhamento para o PVOutput requer acesso à Internet a partir do host Docker. É separado do monitoramento local: uma falha temporária de conexão com o PVOutput não deve impedir o medidor de continuar enviando dados para o servidor local.
O IAMMETER-Docker inclui um fluxo de trabalho MQTT documentado para um dispositivo com capacidade de medição executando Tasmota. O exemplo original usava um Sonoff POW R2.
Este é um caminho de compatibilidade para payloads de energia suportados, não uma afirmação de que todo dispositivo ou template Tasmota produz a mesma estrutura de medição. Teste o dispositivo e firmware reais antes da implantação.
Use a seguinte estrutura MQTT do Tasmota:
| Configuração | Valor |
|---|---|
| Host | Endereço IP do IAMMETER-Docker |
| Porta | Porta MQTT do IAMMETER-Docker, normalmente 1883 |
| Cliente | SN registrado no IAMMETER-Docker |
| Usuário | Deixe em branco para este fluxo de trabalho de publicação documentado |
| Senha | Deixe em branco para este fluxo de trabalho de publicação documentado |
| Tópico | SN registrado no IAMMETER-Docker |
| Tópico Completo | device/%topic%/%prefix%/ |
Após a configuração, verifique cada valor reportado no IAMMETER-Docker, incluindo tensão, corrente, potência ativa, energia e fator de potência quando suportado pelo dispositivo.
O IAMMETER-Docker expõe documentação interativa da API no servidor local:
http://<docker-host-ip>:5050/docs
A API REST pode ser usada para:
Mantenha o acesso à API em uma rede confiável. Se um sistema externo precisar se conectar remotamente, coloque o serviço atrás de uma camada de acesso seguro apropriada, em vez de expor a porta da aplicação sem proteção.
Para desenvolvedores que estão construindo um receptor completo ou plataforma personalizada em vez de usar o IAMMETER-Docker, consulte Desenvolva Seu Próprio Sistema de Monitoramento de Energia.
O autogerenciamento não significa que todos os serviços externos devem ser desabilitados. O IAMMETER-Docker pode ser o sistema de registro local enquanto dados selecionados são encaminhados para outros lugares.
| Arquitetura | Dados Locais | Dependência de Internet | Melhor para |
|---|---|---|---|
| Apenas local | IAMMETER-Docker | Não necessária após a implantação | Privacidade, sites offline e painéis LAN |
| Local + IAMMETER-Cloud | IAMMETER-Docker e IAMMETER-Cloud | Necessária para encaminhamento | Cópia local mais relatórios do IAMMETER-Cloud e acesso remoto |
| Local + PVOutput | IAMMETER-Docker e PVOutput | Necessária para encaminhamento | Usuários solares que utilizam PVOutput |
| Local + assinante MQTT | IAMMETER-Docker mais armazenamento definido pelo assinante | Não necessária com um assinante local | Node-RED, automação e processamento personalizado |
Habilite apenas os destinos que servem a um propósito claro. Mais destinos criam mais credenciais, dependências de rede e caminhos de solução de problemas.
1883 é acessível apenas a partir de redes confiáveis.As seções acima descrevem os fluxos de trabalho atualmente documentados do IAMMETER-Docker. A página original foi escrita por volta das versões V1.8 e V1.9; o histórico a seguir é mantido para usuários que mantêm instalações mais antigas.
/app/datalogger é montado.
Última atualização: 17 de julho de 2026.
Medidor de energia Wi-Fi trifásico (WEM3080T)
Medidor de energia Wi-Fi monofásico (WEM3080)
Medidor de energia Wi-Fi trifásico (WEM3046T)
Medidor de energia Wi-Fi trifásico (WEM3050T)