Samostojno gostovano spremljanje energije z Dockerjem

Samostojno gostovano spremljanje energije z Dockerjem

Sistem za samostojno gostovano spremljanje energije ohranja nadzor nad strežnikom za spremljanje in podatki o električni energiji v vaših rokah. Namesto pošiljanja vsakega odčitka v javni oblak merilnik energije nalaga podatke v Docker vsebnik, ki teče na lokalnem strežniku, napravi NAS, Raspberry Pi ali združljivem usmerjevalniku.

IAMMETER-Docker ponuja lokalni strežnik za spremljanje energije, pripravljen za zagon, za spremljanje porabe električne energije in sončnih (PV) sistemov. Zbira meritve, prikazuje podatke v realnem času in zgodovinske podatke, izpostavlja API-je in lahko po želji deluje tudi kot zapisovalnik podatkov brez internetne povezave (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 praktična rešitev za samostojno gostovanje, vendar ne ponuja vseh funkcij in poročil, ki jih ima IAMMETER-Cloud. Če se še vedno odločate o arhitekturi, primerjajte možnosti na strani z rešitvami za samostojno gostovano spremljanje energije.

🎬 Oglejte si video vadnico za IAMMETER-Docker

1. Kdaj uporabiti sistem za samostojno gostovano spremljanje energije?

IAMMETER-Docker je primeren, kadar želite:

• hraniti podatke o energiji na strežniku, ki ga upravljate sami;
• spremljati porabo električne energije v lokalnem omrežju (LAN) brez odvisnosti od internetne povezave;
• namestiti lokalno nadzorno ploščo za spremljanje sončne energije;
• zbirati podatke na oddaljeni lokaciji s pomočjo zapisovalnika podatkov brez internetne povezave;
• dostopati do meritev prek lokalnega REST API-ja ali MQTT;
• posredovati izbrane podatke na drugo platformo;
• zgraditi zasebno nadzorno ploščo ali integracijo na podlagi shranjenih podatkov o energiji.

Tipične namestitve vključujejo:

• spremljanje porabe električne energije in sončnih elektrarn v gospodinjstvih;
• delavnice, pisarne in manjše poslovne objekte;
• oddaljene sončne elektrarne in tehnične prostore;
• razvojna in testna okolja;
• projekte, kjer je potrebna lokalna pot podatkov.

Če potrebujete le neposredne odčitke števca za Home Assistant, Node-RED, PLC ali lastno programsko opremo, namestitev celotnega strežnika morda ni potrebna. Pred odločitvijo si oglejte možnosti lokalne in samostojno gostovane integracije.

2. Kaj potrebujete

Pred namestitvijo pripravite:

• napravo, ki lahko poganja Docker, na primer strežnik z Linuxom, napravo NAS, Raspberry Pi ali združljiv usmerjevalnik;
• trajno shrambo za podatkovno bazo aplikacije;
• prosta TCP vrata 5050 za spletno aplikacijo in API;
• TCP vrata 1883, če boste uporabljali vgrajeno storitev MQTT;
• stabilen naslov IP ali rezervacijo DHCP za gostitelja Docker;
• merilnik energije IAMMETER ali drug vir podatkov, ki lahko pošilja podatke v podprti obliki API.

Gostitelj Docker in števec morata biti dosegljiva drug drugemu prek lokalnega omrežja. Za delovanje brez interneta po namestitvi slike in potrebne programske opreme internetna povezava ni več potrebna.

3. Namestitev IAMMETER-Docker

Trenutna različica na Docker Hub je IAMMETER-Docker V2.4.

3.1 Možnost A: Docker run

Ustvarite delovni imenik in zaženite vsebnik s trajno shrambo:

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

Spremenite TZ=Etc/UTC v pravilen časovni pas za lokacijo spremljanja. Poročila o energiji so odvisna od lokalnega datuma in časa, zato to nastavite pred začetkom zbiranja dejanskih podatkov.

3.2 Možnost B: Docker Compose

Ustvarite datoteko 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

Zaženite storitev:

docker compose up -d

Preverite njeno stanje:

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

3.3 Odprite lokalno nadzorno ploščo

Iz brskalnika v istem omrežju odprite naslednji naslov:

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

Privzeti prijavni podatki:

Username: testuser
Password: 123456

Takoj spremenite privzeto geslo. Vrat 5050 in 1883 ne izpostavljajte neposredno javnemu internetu brez ustreznega požarnega zidu, preverjanja pristnosti in varne zasnove omrežja.

4. Začetna nastavitev

Po prijavi:

1. Ustvarite Place (lokacijo) za dom, sončno elektrarno ali spremljani objekt.
2. Dodajte Meter (števec).
3. Vnesite serijsko številko števca (SN).
4. Izberite pravilno vrsto enofaznega ali trifaznega števca.
5. Vsako fazo ali kanal dodelite kot Grid (omrežje), Inverter (razsmernik) ali Load (porabnik).
6. Pred vrednotenjem poročil potrdite časovni pas lokacije in strukturo meritev.

Pravilna dodelitev kanalov je še posebej pomembna pri spremljanju sončne energije. Sistem mora vedeti, katera meritev predstavlja omrežje, razsmernik ali porabnik, preden lahko prikaže smiselne rezultate pretoka energije.

5. Povezovanje merilnika energije IAMMETER

Merilniki IAMMETER lahko nalagajo podatke neposredno na lokalni strežnik Docker.

V spletnem vmesniku (WebUI) števca nastavite pošiljanje podatkov prek HTTP tretji osebi in uporabite naslov gostitelja Docker:

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

Naslov IP gostitelja Docker mora biti dosegljiv iz omrežja Wi-Fi števca. Uporabite isto serijsko številko (SN) števca, kot je bila dodana v IAMMETER-Docker.

Po shranjevanju nastavitve števca:

1. počakajte na prvo pošiljanje podatkov;
2. preverite, da je števec v IAMMETER-Docker prikazan kot na spletu;
3. primerjajte vrednosti napetosti, moči in energije z lokalnimi podatki števca;
4. preverite smer in dodelitev kanalov, preden se zanesete na izračune sončne energije ali uvoza/izvoza.

Hkratna uporaba IAMMETER-Cloud

IAMMETER-Docker lahko po želji posreduje podatke števca v IAMMETER-Cloud. Posredovanje omogočite le, kadar želite uporabljati tako lokalno shranjevanje kot storitve IAMMETER-Cloud.

Pri namestitvi brez interneta ali neodvisni od oblaka pustite posredovanje v oblak onemogočeno.

6. Pošiljanje podatkov z druge naprave ali aplikacije

IAMMETER-Docker lahko prek svojega REST API-ja sprejema tudi podprte podatke o energiji. To je uporabno za simulatorje, prehode (gatewaye) ali aplikacije strank, ki ne uporabljajo merilnika IAMMETER.

Ustvarite števec s posebno serijsko številko (SN) in to isto SN uporabite v vsaki zahtevi API.

Interaktivna dokumentacija API je na voljo na lokalnem strežniku:

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

API najprej preizkusite na števcu, ki ni v produkciji. Serijsko številko, število faz, vrstni red polj in enote ohranite dosledne, da bodo zgodovinski podatki ostali uporabni.

7. Zapisovalnik podatkov o energiji brez internetne povezave

IAMMETER-Docker V2.4 lahko shranjuje podatke v CSV, kadar je priklopljen imenik zapisovalnika podatkov. To je uporabno za oddaljeno sončno elektrarno, tovarno ali tehnični prostor brez zanesljive internetne povezave.

Docker run s shrambo zapisovalnika podatkov

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

Za Docker Compose dodajte ta nosilec:

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

Odprite stran zapisovalnika podatkov na naslovu:

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

Stran zapisovalnika podatkov na začetku uporablja:

Username: admin
Password: admin

To geslo spremenite med namestitvijo. Za celoten potek dela z usmerjevalnikom in izvozom CSV si oglejte Zapisovalnik podatkov o energiji brez internetne povezave z IAMMETER-Docker.

8. MQTT in druge napredne funkcije

Vrata 1883 uporablja storitev MQTT v IAMMETER-Docker. Števec ali druga aplikacija lahko objavlja podprte merilne podatke v IAMMETER-Docker, odjemalci MQTT pa se lahko naročijo na vrednosti v realnem času.

IAMMETER-Docker podpira tudi funkcije, kot so:

• MySQL namesto privzete lokalne podatkovne baze za večje nabore podatkov;
• objavljanje in naročanje na MQTT;
• posredovanje v PVOutput;
• združljive podatke o energiji Tasmota;
• alarme v realnem času in scenarije zapisovalnika podatkov z enosekundno ločljivostjo.

Te funkcije so namenoma izključene iz osnovnega poteka namestitve. Najprej nastavite in preizkusite osnovni vsebnik, nato nadaljujte z naprednim vodnikom za IAMMETER-Docker.

9. Varnostno kopiranje podatkov o energiji

Nosilec /app/data vsebuje trajne podatke aplikacije. Ustrezni imenik na gostitelju redno varnostno kopirajte.

Varen osnovni postopek:

1. ustavite ali prekinite zapisovanje v vsebnik;
2. kopirajte celoten priklopljeni imenik data v shrambo za varnostne kopije;
3. vključite imenik datalogger, kadar je omogočeno beleženje CSV;
4. hranite več kot eno generacijo varnostnih kopij;
5. pred zanašanjem na načrt varnostnega kopiranja preizkusite obnovitev na ločenem vsebniku.

Datotečnega sistema vsebnika ne obravnavajte kot trajne shrambe. Če /app/data ni priklopljen, lahko odstranitev vsebnika s seboj odstrani tudi podatkovno bazo za spremljanje.

10. Nadgradnja IAMMETER-Docker

Pred nadgradnjo varnostno kopirajte imenik s trajnimi podatki.

Za Docker Compose:

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

Za vsebnik, ustvarjen z ukazom docker run:

1. zapišite obstoječa vrata, časovni pas in priklopljene nosilce;
2. prenesite (pull) novo sliko;
3. ustavite in odstranite stari vsebnik;
4. znova ustvarite vsebnik z istim trajnim nosilcem;
5. preverite prijavo, stanje števca in zgodovinske podatke.

docker pull iammeter/iammeter
docker stop myiammeter
docker rm myiammeter

Nato znova zaženite prvotni ukaz docker run. Odstranitev vsebnika je varna le, če so bili podatki aplikacije shranjeni v pravilno priklopljen in varnostno kopiran imenik na gostitelju.

11. Odpravljanje težav

Spletna stran se ne odpre

• Preverite, ali vsebnik teče, z ukazom docker ps ali docker compose ps.
• Preverite, ali so vrata 5050 na gostitelju že zasedena.
• Preglejte dnevnike vsebnika.
• Preverite, ali požarni zid omogoča dostop iz lokalnega omrežja.

Števec ni prikazan kot na spletu

• Preverite, ali števec lahko doseže naslov IP gostitelja Docker.
• Preverite naslov URL za pošiljanje in vrata.
• Preverite, ali se serijska številka v IAMMETER-Docker ujema s serijsko številko števca.
• V števcu se izogibajte uporabi localhost kot naslova strežnika; ta se nanaša na sam števec, ne na gostitelja Docker.
• Preverite, da izolacija odjemalcev ali gostujoče omrežje Wi-Fi ne blokira prometa v lokalnem omrežju.

Podatki o sončni energiji so videti nepravilni

• Preverite smer tokovnih transformatorjev (CT) in ožičenje.
• Preverite, kateri kanal je dodeljen omrežju (Grid) in kateri razsmerniku (Inverter).
• Preverite predznak delovne moči pri uvozu in izvozu.
• Pred primerjavo dnevnih količin energije preverite časovni pas.

Podatki izginejo po ponovnem ustvarjanju vsebnika

• Preverite, ali je bil /app/data priklopljen na trajni imenik na gostitelju.
• Preverite dovoljenja imenika.
• Če prvotni nosilec ni na voljo, obnovite najnovejšo preverjeno varnostno kopijo.

12. IAMMETER-Docker, IAMMETER-Cloud ali lastni sistem?

Možnost	Najboljši za	Kje so podatki	Zahtevnost namestitve	Glavna pomanjkljivost
IAMMETER-Docker	Pripravljen lokalni strežnik za spremljanje	Vaš gostitelj Docker	Nizka do srednja	Manj upravljanih funkcij v oblaku
IAMMETER-Cloud	Pripravljeno spremljanje, poročila in oddaljeni dostop	IAMMETER-Cloud	Nizka	Uporablja storitev v oblaku pri ponudniku
Home Assistant / Node-RED	Entitete za pametni dom in lastno avtomatizacijo	Vaša lastna platforma	Srednja	Nadzorno ploščo in poteke dela oblikujete sami
Lastni strežnik	Izdelek, EMS ali specializiran podatkovni cevovod	Vaša infrastruktura	Visoka	Sistem razvijate in vzdržujete sami

Nadaljujte z:

• Možnosti samostojno gostovanega spremljanja za primerjavo na ravni arhitekture;
• Platforme za spremljanje energije z odprto kodo za Home Assistant, Node-RED in druge platforme;
• Razvijte lasten sistem za spremljanje energije za API-je in razvoj na strani sprejemnika;
• Uporaba merilnika energije brez interneta za lokalne poti podatkov in scenarije brez povezave.

13. Kontrolni seznam za namestitev

• Gostitelj Docker ima stabilen naslov v lokalnem omrežju.
• /app/data je priklopljen na trajno shrambo.
• Časovni pas se ujema z lokacijo spremljanja.
• Privzeta gesla so spremenjena.
• Vrata 5050 in 1883 niso po nepotrebnem izpostavljena internetu.
• Serijska številka števca in dodelitev kanalov sta pravilni.
• Lokalno pošiljanje podatkov je preverjeno z dejanskimi meritvami.
• Posredovanje v oblak je omogočeno le, kadar je potrebno.
• Postopka varnostnega kopiranja in nadgradnje sta preizkušena.
• Nosilec zapisovalnika podatkov je priklopljen, če je potreben izvoz CSV.

Nazadnje posodobljeno: 17. julij 2026.