Self-hostované monitorování energie pomocí Dockeru

Self-hostované monitorování energie pomocí Dockeru

Self-hostovaný systém monitorování energie udržuje monitorovací server a data o elektřině pod vaší kontrolou. Místo odesílání každého údaje do veřejného cloudu měřič energie nahrává data do kontejneru Docker spuštěného na lokálním serveru, NAS, Raspberry Pi nebo kompatibilním routeru.

IAMMETER-Docker poskytuje připravený lokální monitorovací server energie pro sledování spotřeby elektřiny a fotovoltaických systémů. Dokáže shromažďovat měření, zobrazovat data v reálném čase i historická data, zpřístupňovat API a volitelně fungovat jako offline datalogger.

IAMMETER energy meter
        │
        │ Wi-Fi / local network
        ▼
IAMMETER-Docker
        │
        ├── Local web dashboard
        ├── Historical energy data
        ├── REST API
        ├── MQTT
        ├── CSV datalogger
        └── Optional forwarding

IAMMETER-Docker je praktickou self-hostovanou volbou, ale nereprodukuje všechny funkce a sestavy služby IAMMETER-Cloud. Pokud stále vybíráte architekturu, porovnejte možnosti na stránce řešení self-hostovaného monitorování energie.

🎬 Podívejte se na video tutoriál o IAMMETER-Docker

1. Kdy použít self-hostovaný systém monitorování energie?

IAMMETER-Docker je vhodný, pokud chcete:

• uchovávat data o energii na serveru, který spravujete;
• monitorovat elektřinu v rámci LAN bez závislosti na přístupu k internetu;
• nasadit lokální přehled monitorování solární energie;
• sbírat data na vzdáleném místě pomocí offline dataloggeru;
• přistupovat k měřením prostřednictvím lokálního REST API nebo MQTT;
• přeposílat vybraná data na jinou platformu;
• vytvořit soukromý přehled nebo integraci nad uloženými daty o energii.

Typické instalace zahrnují:

• monitorování domácí spotřeby elektřiny a fotovoltaiky;
• dílny, kanceláře a malé komerční provozy;
• vzdálené solární systémy a technické místnosti;
• vývojová a testovací prostředí;
• projekty, kde je vyžadována lokální datová cesta.

Pokud potřebujete pouze přímá měření z měřiče pro Home Assistant, Node-RED, PLC nebo vlastní software, nasazení kompletního serveru nemusí být nutné. Před výběrem si prohlédněte možnosti lokální a self-hostované integrace.

2. Co budete potřebovat

Před nasazením si připravte:

• zařízení schopné spouštět Docker, například Linuxový server, NAS, Raspberry Pi nebo kompatibilní router;
• trvalé úložiště pro databázi aplikace;
• volný TCP port 5050 pro webovou aplikaci a API;
• TCP port 1883, pokud bude používána vestavěná služba MQTT;
• stabilní IP adresu nebo rezervaci DHCP pro hostitele Dockeru;
• měřič energie IAMMETER nebo jiný zdroj dat schopný odesílat podporovaný formát API.

Hostitel Dockeru a měřič by měly být vzájemně dosažitelné v rámci lokální sítě. Pro offline provoz není po instalaci obrazu a potřebného softwaru přístup k internetu nutný.

3. Nasaďte IAMMETER-Docker

Aktuální vydání na Docker Hub je IAMMETER-Docker V2.4.

3.1 Možnost A: Docker run

Vytvořte pracovní adresář a spusťte kontejner s trvalým úložištěm:

docker run -d \
  --name myiammeter \
  --restart always \
  -p 5050:5050 \
  -p 1883:1883 \
  -e TZ=Etc/UTC \
  -v "$PWD/data:/app/data" \
  iammeter/iammeter

Změňte TZ=Etc/UTC na správné časové pásmo pro monitorované místo. Energetické sestavy závisí na místním datu a čase, proto to nastavte před zahájením sběru produkčních dat.

3.2 Možnost B: Docker Compose

Vytvořte soubor compose.yaml:

services:
  iammeter:
    image: iammeter/iammeter
    container_name: myiammeter
    restart: always
    ports:
      - "5050:5050"
      - "1883:1883"
    environment:
      TZ: Etc/UTC
    volumes:
      - ./data:/app/data

Spusťte službu:

docker compose up -d

Zkontrolujte její stav:

docker compose ps
docker compose logs --tail=100 iammeter

3.3 Otevřete lokální přehled

Z prohlížeče ve stejné síti otevřete následující adresu:

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

Výchozí přihlašovací údaje:

Username: testuser
Password: 123456

Okamžitě změňte výchozí heslo. Nevystavujte port 5050 ani 1883 přímo veřejnému internetu bez odpovídajícího firewallu, autentizace a bezpečného návrhu sítě.

4. Počáteční konfigurace

Po přihlášení:

1. Vytvořte Place pro domácnost, solární lokalitu nebo sledované zařízení.
2. Přidejte Meter.
3. Zadejte sériové číslo měřiče (SN).
4. Vyberte správný typ měřiče pro jednu nebo tři fáze.
5. Přiřaďte každou fázi nebo kanál jako Grid, Inverter nebo Load.
6. Před vyhodnocením sestav ověřte časové pásmo lokality a strukturu měření.

Správné přiřazení kanálů je důležité zejména pro monitorování solární energie. Systém potřebuje vědět, které měření představuje síť, střídač nebo zátěž, než může zobrazit smysluplné výsledky toku energie.

5. Připojení měřiče energie IAMMETER

Měřiče IAMMETER mohou nahrávat data přímo na lokální Docker server.

Ve webovém rozhraní měřiče nakonfigurujte nahrávání HTTP třetí strany a použijte adresu hostitele Dockeru:

<docker-host-ip>:5050/api/v1/sensor/uploadsensor

IP adresa hostitele Dockeru musí být dosažitelná ze sítě Wi-Fi měřiče. Použijte stejné sériové číslo měřiče, které bylo přidáno do IAMMETER-Docker.

Po uložení konfigurace měřiče:

1. počkejte na první nahrání;
2. ověřte, že se měřič zobrazuje v IAMMETER-Docker jako online;
3. porovnejte hodnoty napětí, výkonu a energie s lokálními daty měřiče;
4. před spoléháním na výpočty solární energie nebo importu/exportu ověřte směr a přiřazení kanálů.

Použití IAMMETER-Cloud zároveň

IAMMETER-Docker může volitelně přeposílat data z měřiče do IAMMETER-Cloud. Přeposílání povolte pouze tehdy, pokud chcete mít lokální úložiště i služby IAMMETER-Cloud zároveň.

Pro offline instalaci nebo instalaci nezávislou na cloudu ponechte přeposílání do cloudu vypnuté.

6. Nahrávání dat z jiného zařízení nebo aplikace

IAMMETER-Docker může přijímat podporovaná energetická data také prostřednictvím svého REST API. To je užitečné pro simulátory, brány nebo zákaznické aplikace, které nepoužívají měřič IAMMETER.

Vytvořte měřič s vlastním SN a použijte stejné SN v každém požadavku API.

Interaktivní dokumentace API je k dispozici na lokálním serveru:

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

Nejprve otestujte API na neprodukčním měřiči. Zachovejte konzistentní SN, počet fází, pořadí polí a jednotky, aby historická data zůstala použitelná.

7. Provoz offline energetického dataloggeru

IAMMETER-Docker V2.4 umí ukládat data do CSV, pokud je připojen adresář dataloggeru. To je užitečné pro vzdálenou solární lokalitu, továrnu nebo technickou místnost bez spolehlivého internetového připojení.

Docker run s úložištěm dataloggeru

docker run -d \
  --name myiammeter \
  --restart always \
  -p 5050:5050 \
  -p 1883:1883 \
  -e TZ=Etc/UTC \
  -v "$PWD/data:/app/data" \
  -v "$PWD/datalogger:/app/datalogger" \
  iammeter/iammeter

Pro Docker Compose přidejte tento svazek:

volumes:
  - ./data:/app/data
  - ./datalogger:/app/datalogger

Otevřete stránku dataloggeru na adrese:

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

Stránka dataloggeru zpočátku používá:

Username: admin
Password: admin

Změňte toto heslo jako součást nasazení. Pro kompletní postup s routerem a exportem do CSV viz Offline energetický datalogger s IAMMETER-Docker.

8. MQTT a další pokročilé funkce

Port 1883 používá služba MQTT systému IAMMETER-Docker. Měřič nebo jiná aplikace může publikovat podporovaná měřená data do IAMMETER-Docker a klienti MQTT mohou odebírat hodnoty v reálném čase.

IAMMETER-Docker také podporuje funkce jako:

• MySQL místo výchozí lokální databáze pro větší datové sady;
• publikování a odběr MQTT;
• přeposílání do PVOutput;
• kompatibilní energetická data Tasmota;
• alarmy v reálném čase a scénáře dataloggeru s jednosekundovým intervalem.

Tyto funkce jsou záměrně vynechány ze základního postupu nasazení. Nejprve nakonfigurujte a otestujte základní kontejner a poté pokračujte pokročilým průvodcem IAMMETER-Docker.

9. Zálohování dat o energii

Svazek /app/data obsahuje trvalá data aplikace. Pravidelně zálohujte odpovídající adresář na hostiteli.

Bezpečný základní postup:

1. zastavte nebo pozastavte zápisy do kontejneru;
2. zkopírujte celý připojený adresář data do záložního úložiště;
3. zahrňte adresář datalogger, pokud je povoleno protokolování CSV;
4. uchovávejte více než jednu generaci záloh;
5. před spoléháním na záložní plán otestujte obnovení na samostatném kontejneru.

Nepovažujte souborový systém kontejneru za trvalé úložiště. Pokud není /app/data připojen, odstranění kontejneru může odstranit i monitorovací databázi.

10. Upgrade IAMMETER-Docker

Před upgradem zálohujte adresář s trvalými daty.

Pro Docker Compose:

docker compose pull
docker compose up -d
docker compose logs --tail=100 iammeter

Pro kontejner vytvořený příkazem docker run:

1. zaznamenejte stávající porty, časové pásmo a připojené svazky;
2. stáhněte nový obraz;
3. zastavte a odstraňte starý kontejner;
4. vytvořte kontejner znovu se stejným trvalým svazkem;
5. ověřte přihlášení, stav měřiče a historická data.

docker pull iammeter/iammeter
docker stop myiammeter
docker rm myiammeter

Poté zopakujte původní příkaz docker run. Odstranění kontejneru je bezpečné pouze tehdy, pokud byla data aplikace uložena ve správně připojeném a zazálohovaném adresáři na hostiteli.

11. Řešení problémů

Webová stránka se neotevírá

• Ověřte, že kontejner běží, příkazem docker ps nebo docker compose ps.
• Zkontrolujte, zda není hostitelský port 5050 již používán.
• Prohlédněte si protokoly kontejneru.
• Ověřte, že firewall umožňuje přístup z lokální sítě.

Měřič se nezobrazuje jako online

• Ověřte, že měřič dosáhne IP adresy hostitele Dockeru.
• Zkontrolujte adresu pro nahrávání a port.
• Ověřte, že SN v IAMMETER-Docker odpovídá SN měřiče.
• Nepoužívejte jako adresu serveru v měřiči localhost; odkazuje na samotný měřič, nikoli na hostitele Dockeru.
• Ověřte, že izolace klientů nebo síť Wi-Fi pro hosty neblokuje provoz v rámci LAN.

Údaje o solární energii vypadají nesprávně

• Zkontrolujte směr CT a zapojení.
• Ověřte, který kanál je přiřazen jako Grid a který jako Inverter.
• Zkontrolujte znaménko činného výkonu při importu a exportu.
• Před porovnáváním denních součtů energie ověřte časové pásmo.

Data zmizí po opětovném vytvoření kontejneru

• Ověřte, že byl /app/data připojen k trvalému adresáři na hostiteli.
• Zkontrolujte oprávnění adresáře.
• Pokud není původní svazek k dispozici, obnovte poslední ověřenou zálohu.

12. IAMMETER-Docker, IAMMETER-Cloud nebo vlastní systém?

Možnost	Nejvhodnější pro	Umístění dat	Náročnost nastavení	Hlavní kompromis
IAMMETER-Docker	Hotový lokální monitorovací server	Váš hostitel Dockeru	Nízká až střední	Méně spravovaných cloudových funkcí
IAMMETER-Cloud	Hotové monitorování, sestavy a vzdálený přístup	IAMMETER-Cloud	Nízká	Využívá hostovanou cloudovou službu
Home Assistant / Node-RED	Entity pro chytrou domácnost a vlastní automatizace	Vaše vlastní platforma	Střední	Přehled a pracovní postupy si navrhujete sami
Vlastní server	Produkt, EMS nebo specializovaná datová pipeline	Vaše infrastruktura	Vysoká	Systém vyvíjíte a udržujete sami

Pokračujte:

• Možnosti self-hostovaného monitorování pro srovnání na úrovni architektury;
• Open-source platformy pro monitorování energie pro Home Assistant, Node-RED a další platformy;
• Vyvíjejte vlastní systém monitorování energie pro API a vývoj na straně příjemce;
• Použití měřiče energie bez internetu pro lokální datové cesty a offline scénáře.

13. Kontrolní seznam nasazení

• Hostitel Dockeru má stabilní adresu v LAN.
• /app/data je připojen k trvalému úložišti.
• Časové pásmo odpovídá monitorované lokalitě.
• Výchozí hesla byla změněna.
• Porty 5050 a 1883 nejsou zbytečně vystaveny internetu.
• SN měřiče a přiřazení kanálů jsou správné.
• Lokální nahrávání bylo ověřeno živými měřeními.
• Přeposílání do cloudu je povoleno pouze v případě potřeby.
• Postupy zálohování a upgradu byly otestovány.
• Svazek dataloggeru je připojen, pokud je vyžadován export CSV.

Poslední aktualizace: 17. července 2026.