Docker MQTT Energiebewaking: Geavanceerde IAMMETER-Docker Configuratie

Docker MQTT Energiebewaking en Geavanceerde Configuratie

Nadat de basis IAMMETER-Docker-server draait, kan deze worden uitgebreid tot een lokale MQTT-energiebewakingsserver, MySQL gebruiken voor een grotere dataset, zonne-energiegegevens doorsturen naar PVOutput en compatibele metingen van derden accepteren.

Deze handleiding behandelt geavanceerde datapaden en opslagopties. Voor installatie, persistente volumes, eerste aanmelding, meterconfiguratie, back-up en containerupgrades, begin met Self-Hosted Energiebewaking met Docker.

IAMMETER-meter / compatibel apparaat / aangepaste applicatie
                         │
             ┌───────────┼───────────┐
             │           │           │
            HTTP        MQTT       REST API
             │           │           │
             └───────────┼───────────┘
                         ▼
                  IAMMETER-Docker
                         │
       ┌─────────────────┼─────────────────┐
       ▼                 ▼                 ▼
 SQLite / MySQL     MQTT-abonnees     PVOutput

Gebruik alleen de interfaces die nodig zijn voor het project. Een eenvoudige lokale bewakingsinstallatie heeft geen MySQL, externe MQTT-clients of gegevensdoorsturing nodig.

1. Voordat u Geavanceerde Functies Inschakelt

Controleer of de basisinstallatie stabiel is:

• de IAMMETER-Docker-container draait;
• /app/data is toegewezen aan persistente opslag;
• de Docker-host gebruikt een stabiel LAN-adres;
• de tijdzone van de site is correct;
• ten minste één meter of testgegevensbron werkt;
• standaardwachtwoorden zijn gewijzigd;
• er bestaat een actuele back-up.

De standaardimplementatie stelt bloot:

• 5050 voor de webapplicatie en API;
• 1883 voor MQTT.

Publiceer geen van beide poorten rechtstreeks naar internet. Gebruik een firewall, VPN of een andere gecontroleerde toegangslaag wanneer externe toegang nodig is.

2. Kies SQLite of MySQL

IAMMETER-Docker gebruikt SQLite voor een eenvoudige standaardimplementatie en ondersteunt MySQL voor installaties met een grotere dataset.

Database	Het beste voor	Voordelen	Overwegingen
SQLite	Thuis, test en kleinere lokale implementaties	Geen aparte databaseservice; eenvoudige initiële installatie	Database blijft gekoppeld aan de applicatievolume
MySQL	Grotere of langdurigere installaties	Aparte databaseservice en betere geschiktheid voor groeiende datasets	Vereist database-implementatie, inloggegevens, back-up en onderhoud

Ga niet over op MySQL alleen omdat het beschikbaar is. Gebruik het wanneer het verwachte gegevensvolume, de bewaartermijn of de databasebeheervereisten een extra service rechtvaardigen.

2.1 Bereid eerst MySQL voor

Voordat u MySQL selecteert in IAMMETER-Docker:

1. implementeer een bereikbare MySQL-server;
2. maak een speciale database en gebruiker aan;
3. beperk die gebruiker tot de vereiste database;
4. bevestig netwerktoegang vanaf de IAMMETER-Docker-container;
5. configureer regelmatige databaseback-ups;
6. noteer de databasehost, poort, naam en inloggegevens veilig.

Voer vervolgens de MySQL-verbindingsinstellingen in IAMMETER-Docker in en bevestig dat nieuwe metingen worden opgeslagen.

Maak een back-up van de bestaande IAMMETER-Docker-gegevens voordat u de databasemodus wijzigt. Controleer historische gegevens en nieuwe uploads na de wijziging.

3. Gebruik IAMMETER-Docker als een MQTT-Energiebewakingsserver

IAMMETER-Docker bevat MQTT-ondersteuning voor twee verschillende richtingen:

1. Publiceren naar IAMMETER-Docker: een meter of compatibele applicatie stuurt metingen naar de Docker-server.
2. Abonneren op IAMMETER-Docker: Node-RED, een aangepaste service of een andere MQTT-client ontvangt real-time metingen van de server.

Deze paden gebruiken hetzelfde topic-patroon maar verschillende authenticatiemodi.

3.1 MQTT-topic

Het gedocumenteerde real-time topic is:

device/<SN>/realtime

Vervang <SN> door het serienummer dat is geregistreerd in IAMMETER-Docker. De SN in het MQTT-topic en de clientconfiguratie moet overeenkomen met de meter die in het lokale platform is aangemaakt.

3.2 Publiceer energiegegevens naar IAMMETER-Docker

Voor een publicerend apparaat of applicatie:

Instelling	Waarde
Broker	IP-adres of hostnaam van de IAMMETER-Docker-server
Poort	1883 standaard
Authenticatie	Client-ID
Client-ID	Meter-SN geregistreerd in IAMMETER-Docker
Topic	device/<SN>/realtime
Payload	IAMMETER-ondersteund uploadgegevensformaat

Voordat u productiegegevens gebruikt:

1. registreer de SN in IAMMETER-Docker;
2. publiceer één testpayload;
3. controleer spanning, stroom, actief vermogen en energievelden;
4. bevestig het fase- of kanaalaantal;
5. controleer eenheden en actief-vermogenrichting;
6. schakel pas daarna continu publiceren in.

3.3 Abonneer op real-time energiegegevens

Voor een MQTT-abonnee:

Instelling	Waarde
Broker	IAMMETER-Docker-serveradres
Poort	1883 standaard
Authenticatie	IAMMETER-Docker gebruikersnaam en wachtwoord
Topic	device/<SN>/realtime

Typische abonnees zijn onder andere:

• Node-RED-automatiseringsstromen;
• een lokale gegevensverwerkingsservice;
• een MQTT-foutopsporingsclient;
• een gateway die geselecteerde metingen doorstuurt;
• een aangepast dashboard of waarschuwingsservice.

Als Node-RED de primaire applicatie is en historische opslag in IAMMETER-Docker niet vereist is, kan de meter ook rechtstreeks verbinding maken met Node-RED via MQTT, Modbus TCP of zijn lokale API. Vergelijk de opties in de Node-RED-energiemeterhandleiding.

4. Test en Los MQTT-Problemen Op

Begin met één meter en exact topic in plaats van een brede wildcard-abonnement.

Controleer het volgende wanneer er geen gegevens verschijnen:

• poort 1883 is toegewezen vanuit de container;
• de client kan de Docker-host bereiken via het LAN;
• de SN bestaat in IAMMETER-Docker;
• de MQTT-client-ID en het topic gebruiken dezelfde SN;
• het topic is device/<SN>/realtime met de juiste hoofdlettergevoeligheid;
• de authenticatiemodi voor publiceren en abonneren worden niet verward;
• de JSON-payload komt overeen met de ondersteunde veldvolgorde en eenheden;
• een andere MQTT-client verbreekt de sessie niet door dezelfde client-ID te hergebruiken.

Voor betrouwbare stromen:

• gebruik een unieke client-ID voor elke abonnee;
• ga om met herverbindingen en dubbele berichten;
• valideer de payload voordat u deze naar een database schrijft;
• noteer de bron-SN bij elke opgeslagen meting;
• gebruik netwerkisolatie in plaats van de onversleutelde MQTT-poort openbaar bloot te stellen.

5. Stuur Zonne-energiegegevens door naar PVOutput

PVOutput is een service van derden voor het delen en vergelijken van zonne-energieopwekking en energieverbruiksgegevens. IAMMETER-Docker kan sitegegevens doorsturen naar PVOutput.

Gebruik deze optie wanneer IAMMETER-Docker de lokale verzamelserver blijft, maar PVOutput vereist is voor openbare of externe zonne-energierapportage.

Voordat u doorsturen inschakelt:

1. maak het juiste PVOutput-systeem aan of selecteer het;
2. verkrijg de vereiste PVOutput-inloggegevens;
3. bevestig dat Grid- en Inverter-kanalen correct zijn toegewezen in IAMMETER-Docker;
4. controleer de tijdzone van de site;
5. schakel doorsturen alleen in voor de beoogde site;
6. vergelijk een daggemiddelde in beide systemen na de eerste volledige dag.

PVOutput-doorsturing vereist internettoegang vanaf de Docker-host. Het is gescheiden van lokale bewaking: een tijdelijke PVOutput-verbindingsfout mag niet voorkomen dat de meter blijft uploaden naar de lokale server.

6. Ontvang Gegevens van een Compatibel Tasmota-Apparaat

IAMMETER-Docker bevat een gedocumenteerde MQTT-workflow voor een meetgeschikt apparaat met Tasmota. Het oorspronkelijke voorbeeld gebruikte een Sonoff POW R2.

Dit is een compatibiliteitspad voor ondersteunde energiepayloads, geen bewering dat elk Tasmota-apparaat of elke sjabloon dezelfde meetstructuur produceert. Test het daadwerkelijke apparaat en de firmware vóór implementatie.

Gebruik de volgende Tasmota MQTT-structuur:

Instelling	Waarde
Host	IAMMETER-Docker IP-adres
Poort	IAMMETER-Docker MQTT-poort, normaal 1883
Client	SN geregistreerd in IAMMETER-Docker
Gebruiker	Laat leeg voor deze gedocumenteerde publicatieworkflow
Wachtwoord	Laat leeg voor deze gedocumenteerde publicatieworkflow
Topic	SN geregistreerd in IAMMETER-Docker
Volledig Topic	device/%topic%/%prefix%/

Na configuratie controleert u elke gerapporteerde waarde in IAMMETER-Docker, inclusief spanning, stroom, actief vermogen, energie en arbeidsfactor wanneer ondersteund door het apparaat.

7. Gebruik de IAMMETER-Docker REST API

IAMMETER-Docker stelt interactieve API-documentatie beschikbaar op de lokale server:

http://<docker-host-ip>:5050/docs

De REST API kan worden gebruikt om:

• ondersteunde metingen te uploaden vanaf een aangepaste gateway;
• gegevens op te vragen voor een privé-dashboard;
• een lokale applicatie te verbinden met de self-hosted server;
• payloads te testen voordat u een integratie automatiseert.

Houd API-toegang op een vertrouwd netwerk. Als een extern systeem op afstand verbinding moet maken, plaats de service dan achter een geschikte beveiligde toegangslaag in plaats van de applicatiepoort onbeschermd bloot te stellen.

Voor ontwikkelaars die een complete ontvanger of aangepast platform bouwen in plaats van IAMMETER-Docker te gebruiken, zie Ontwikkel Uw Eigen Energiebewakingssysteem.

8. Combineer Lokale Opslag en Clouddiensten

Self-hosting hoeft niet te betekenen dat elke externe service is uitgeschakeld. IAMMETER-Docker kan het lokale registratiesysteem zijn terwijl geselecteerde gegevens elders worden doorgestuurd.

Architectuur	Lokale gegevens	Internetafhankelijkheid	Het beste voor
Alleen lokaal	IAMMETER-Docker	Niet vereist na implementatie	Privacy, offlinesites en LAN-dashboards
Lokaal + IAMMETER-Cloud	IAMMETER-Docker en IAMMETER-Cloud	Vereist voor doorsturing	Lokale kopie plus IAMMETER-Cloud-rapporten en externe toegang
Lokaal + PVOutput	IAMMETER-Docker en PVOutput	Vereist voor doorsturing	Zonne-energiegebruikers die PVOutput gebruiken
Lokaal + MQTT-abonnee	IAMMETER-Docker plus door abonnee gedefinieerde opslag	Niet vereist met een lokale abonnee	Node-RED, automatisering en aangepaste verwerking

Schakel alleen de doelen in die een duidelijk doel dienen. Meer doelen creëren meer inloggegevens, netwerkafhankelijkheden en foutopsporingspaden.

9. Geavanceerde Implementatie Checklist

• Basis IAMMETER-Docker-verzameling is al stabiel.
• Persistente gegevens en databaseback-ups zijn geverifieerd.
• MySQL wordt alleen gebruikt wanneer de operationele overhead gerechtvaardigd is.
• MQTT-poort 1883 is alleen bereikbaar vanaf vertrouwde netwerken.
• Elke MQTT-client gebruikt een geschikte en unieke client-ID.
• Meter-SN, topic en geregistreerd apparaat komen overeen.
• Payload-eenheden, fase-aantal en vermogensrichting zijn getest.
• PVOutput- of clouddoorsturingsfouten onderbreken de lokale verzameling niet.
• Tasmota-compatibiliteit is bevestigd met het daadwerkelijke apparaat en de firmware.
• Wijzigingen worden getest op één meter voordat ze worden toegepast op een grotere implementatie.

10. Versiegeschiedenis en Legacy-notities

De bovenstaande secties beschrijven de momenteel gedocumenteerde IAMMETER-Docker-workflows. De oorspronkelijke pagina is geschreven rond V1.8 en V1.9; de volgende geschiedenis is bewaard voor gebruikers die oudere installaties onderhouden.

V2.4

• Toegevoegd: automatisch CSV-opslaan wanneer de /app/datalogger-map is gekoppeld.
• Zie Offline Energiedatalogger met IAMMETER-Docker.

V2.3

• Een PVOutput-uploadprobleem opgelost.

V2.2

• Logs toegevoegd voor IAMMETER-Cloud-doorsturingsfouten.

V2.1

• Dataloggermodus en logging van elektrische parameters per seconde toegevoegd.
• Zie de V2.1 datalogger- en alarmintroductie.

V1.9

• MySQL-ondersteuning toegevoegd.
• Een aangepaste afbeeldingsoptie voor elke Place toegevoegd.

V1.8

• MQTT-upload naar IAMMETER-Docker toegevoegd.
• MQTT-abonnement op real-time gegevens toegevoegd.
• Directe PVOutput-doorsturing toegevoegd.
• De gedocumenteerde Tasmota/Sonoff-meetworkflow toegevoegd.

11. Gerelateerde Bronnen

• IAMMETER-Docker-image en huidige uitvoeringsopdracht
• Basis IAMMETER-Docker-implementatie
• Self-hosted energiebewakingsopties
• Offline Docker-dataloggeroplossing
• Open-source energiebewakingsplatforms
• IAMMETER-Docker-onderwerp

Laatst bijgewerkt: 17 juli 2026.