Itse isännöity energianvalvonta Dockerin avulla

Itse isännöity energianvalvonta Dockerin avulla

Itse isännöity energianvalvontajärjestelmä pitää valvontapalvelimen ja sähködatat hallinnassasi. Sen sijaan, että jokainen mittaus lähetettäisiin julkiseen pilveen, energiamittari lähettää tiedot Docker-säiliöön, joka toimii paikallisella palvelimella, NAS-laitteella, Raspberry Pi:llä tai yhteensopivalla reitittimellä.

IAMMETER-Docker tarjoaa valmiin paikallisen energianvalvontapalvelimen sähkönkulutuksen ja aurinkosähköjärjestelmien seurantaan. Se voi kerätä mittauksia, näyttää reaaliaikaista ja historiallista tietoa, tarjota API-rajapintoja ja toimia haluttaessa myös offline-dataloggerina.

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

IAMMETER-Docker on käytännöllinen itse isännöity vaihtoehto, mutta se ei toista kaikkia IAMMETER-Cloudin ominaisuuksia ja raportteja. Jos olet vielä valitsemassa arkkitehtuuria, vertaile vaihtoehtoja itse isännöidyn energianvalvonnan ratkaisusivulla.

🎬 Katso IAMMETER-Dockerin video-ohje

1. Milloin itse isännöityä energianvalvontajärjestelmää kannattaa käyttää?

IAMMETER-Docker sopii, kun haluat:

• säilyttää energiadatan hallinnoimallasi palvelimella;
• valvoa sähköä lähiverkossa ilman riippuvuutta internetyhteydestä;
• ottaa käyttöön paikallisen aurinkovoiman valvontanäkymän;
• kerätä dataa etäkohteessa offline-dataloggerin avulla;
• käyttää mittauksia paikallisen REST API:n tai MQTT:n kautta;
• välittää valittua dataa toiselle alustalle;
• rakentaa yksityisen kojelaudan tai integraation tallennetun energiadatan ympärille.

Tyypillisiä asennuskohteita ovat:

• kodin sähkön- ja aurinkosähkönvalvonta;
• verstaat, toimistot ja pienet kaupalliset kohteet;
• etäiset aurinkosähköjärjestelmät ja laitetilat;
• kehitys- ja testausympäristöt;
• projektit, joissa tarvitaan paikallista datapolkua.

Jos tarvitset vain suoria mittarilukemia Home Assistantille, Node-RED:lle, PLC:lle tai mukautetulle ohjelmistolle, täyden palvelimen käyttöönotto voi olla tarpeetonta. Katso paikalliset ja itse isännöidyt integraatiovaihtoehdot ennen valintaa.

2. Mitä tarvitset

Valmistele ennen käyttöönottoa:

• laite, joka pystyy ajamaan Dockeria, kuten Linux-palvelin, NAS, Raspberry Pi tai yhteensopiva reititin;
• pysyvä tallennustila sovellustietokannalle;
• TCP-portti 5050 vapaana verkko-ohjelmalle ja API:lle;
• TCP-portti 1883, jos sisäänrakennettua MQTT-palvelua käytetään;
• vakaa IP-osoite tai DHCP-varaus Docker-isäntäkoneelle;
• IAMMETER-energiamittari tai muu datalähde, joka pystyy lähettämään tietoja tuetussa API-muodossa.

Docker-isäntäkoneen ja mittarin on pystyttävä tavoittamaan toisensa lähiverkossa. Offline-käytössä internetyhteyttä ei tarvita, kun levykuva ja tarvittavat ohjelmistot on asennettu.

3. Ota IAMMETER-Docker käyttöön

Nykyinen Docker Hub -julkaisu on IAMMETER-Docker V2.4.

3.1 Vaihtoehto A: Docker run

Luo työhakemisto ja käynnistä säiliö pysyvällä tallennustilalla:

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

Vaihda TZ=Etc/UTC valvontakohteen oikeaan aikavyöhykkeeseen. Energiaraportit riippuvat paikallisesta päivämäärästä ja kellonajasta, joten aseta tämä ennen tuotantodatan keräämistä.

3.2 Vaihtoehto B: Docker Compose

Luo 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

Käynnistä palvelu:

docker compose up -d

Tarkista sen tila:

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

3.3 Avaa paikallinen kojelauta

Avaa seuraava osoite saman verkon selaimesta:

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

Oletustunnukset:

Username: testuser
Password: 123456

Vaihda oletussalasana heti. Älä altista porttia 5050 tai 1883 suoraan julkiseen internettiin ilman asianmukaista palomuuria, todennusta ja turvallista verkkosuunnittelua.

4. Alkuasetukset

Kirjautumisen jälkeen:

1. Luo Paikka kodille, aurinkosähkökohteelle tai valvottavalle laitokselle.
2. Lisää Mittari.
3. Anna mittarin sarjanumero (SN).
4. Valitse oikea yksivaiheinen tai kolmivaiheinen mittarityyppi.
5. Määritä kukin vaihe tai kanava Verkko-, Invertteri- tai Kuorma-tilaan.
6. Varmista kohteen aikavyöhyke ja mittausrakenne ennen raporttien tarkastelua.

Oikea kanavamääritys on erityisen tärkeää aurinkovoiman valvonnassa. Järjestelmän on tiedettävä, mikä mittaus edustaa verkkoa, invertteriä tai kuormaa, ennen kuin se voi näyttää mielekkäitä energiavirran tuloksia.

5. IAMMETER-energiamittarin yhdistäminen

IAMMETER-mittarit voivat lähettää tiedot suoraan paikalliselle Docker-palvelimelle.

Määritä mittarin WebUI:ssa kolmannen osapuolen HTTP-lähetys ja käytä Docker-isäntäkoneen osoitetta:

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

Docker-isäntäkoneen IP-osoitteen on oltava tavoitettavissa mittarin Wi-Fi-verkosta. Käytä samaa mittarin SN:ää, joka lisättiin IAMMETER-Dockeriin.

Kun mittarin määritykset on tallennettu:

1. odota ensimmäistä lähetystä;
2. varmista, että mittari näkyy verkossa IAMMETER-Dockerissa;
3. vertaa jännite-, teho- ja energia-arvoja mittarin paikalliseen dataan;
4. tarkista suunta ja kanavamääritys ennen kuin luotat aurinko- tai tuonti-/vientilaskelmiin.

Käytä IAMMETER-Cloudia samanaikaisesti

IAMMETER-Docker voi halutessaan välittää mittarin datan edelleen IAMMETER-Cloudiin. Ota edelleenlähetys käyttöön vain, kun haluat sekä paikallisen tallennuksen että IAMMETER-Cloudin palvelut.

Offline- tai pilviriippumattomassa asennuksessa pidä pilviedelleenlähetys pois käytöstä.

6. Datan lähettäminen toisesta laitteesta tai sovelluksesta

IAMMETER-Docker voi vastaanottaa tuettua energiadatan myös REST API -rajapintansa kautta. Tämä on hyödyllistä simulaattoreille, yhdyskäytäville tai asiakassovelluksille, jotka eivät käytä IAMMETER-mittaria.

Luo mittari mukautetulla SN:llä ja käytä samaa SN:ää jokaisessa API-pyynnössä.

Vuorovaikutteinen API-dokumentaatio on saatavilla paikallisella palvelimella:

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

Testaa API ensin muulla kuin tuotantomittarilla. Pidä SN, vaiheiden lukumäärä, kenttäjärjestys ja yksiköt yhdenmukaisina, jotta historiallinen data pysyy käyttökelpoisena.

7. Offline-energiadataloggerin käyttö

IAMMETER-Docker V2.4 voi tallentaa dataa CSV-muotoon, kun datalogger-hakemisto on liitetty. Tämä on hyödyllistä etäisellä aurinkosähkökohteella, tehtaalla tai laitetilassa, jossa ei ole luotettavaa internetyhteyttä.

Docker run datalogger-tallennuksella

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

Docker Composea varten lisää tämä volyymi:

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

Avaa datalogger-sivu osoitteessa:

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

Datalogger-sivu käyttää aluksi seuraavia tunnuksia:

Username: admin
Password: admin

Vaihda tämä salasana osana käyttöönottoa. Katso täydellinen reititinpohjainen ja CSV-vientiin liittyvä työnkulku kohdasta Offline-energiadataloggeri IAMMETER-Dockerilla.

8. MQTT ja muut lisäominaisuudet

IAMMETER-Dockerin MQTT-palvelu käyttää porttia 1883. Mittari tai muu sovellus voi julkaista tuettua mittaustietoa IAMMETER-Dockeriin, ja MQTT-asiakkaat voivat tilata reaaliaikaisia arvoja.

IAMMETER-Docker tukee myös esimerkiksi seuraavia ominaisuuksia:

• MySQL oletusarvoisen paikallisen tietokannan sijaan suuremmille tietomäärille;
• MQTT-julkaisu ja -tilaus;
• PVOutput-edelleenlähetys;
• yhteensopiva Tasmota-energiadata;
• reaaliaikaiset hälytykset ja sekunnin tarkkuudella toimivat datalogger-skenaariot.

Nämä ominaisuudet on tarkoituksella pidetty pois peruskäyttöönoton polulta. Määritä ja testaa ensin ydinpalvelin, ja jatka sitten edistyneen IAMMETER-Docker-oppaan pariin.

9. Energiadatan varmuuskopiointi

/app/data-volyymi sisältää pysyvää sovellusdataa. Varmuuskopioi vastaava isäntähakemisto säännöllisesti.

Turvallinen perusprosessi on:

1. pysäytä tai keskeytä kirjoitukset säiliöön;
2. kopioi täydellinen liitetty data-hakemisto varmuuskopiotallennustilaan;
3. sisällytä datalogger-hakemisto mukaan, kun CSV-lokitus on käytössä;
4. säilytä useampi kuin yksi varmuuskopiosukupolvi;
5. testaa palauttaminen erillisessä säiliössä ennen kuin luotat varmuuskopiosuunnitelmaan.

Älä käsittele säiliön tiedostojärjestelmää pysyvänä tallennustilana. Jos /app/data ei ole liitetty, säiliön poistaminen voi poistaa myös valvontatietokannan.

10. IAMMETER-Dockerin päivittäminen

Varmuuskopioi pysyvä datakansio ennen päivitystä.

Docker Composea varten:

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

docker run -komennolla luodulle säiliölle:

1. kirjaa ylös nykyiset portit, aikavyöhyke ja volyymiliitokset;
2. hae uusi levykuva;
3. pysäytä ja poista vanha säiliö;
4. luo säiliö uudelleen samalla pysyvällä volyymillä;
5. tarkista kirjautuminen, mittarin tila ja historiallinen data.

docker pull iammeter/iammeter
docker stop myiammeter
docker rm myiammeter

Toista sitten alkuperäinen docker run -komento. Säiliön poistaminen on turvallista vain, jos sovellusdata on tallennettu oikein liitettyyn ja varmuuskopioituun isäntähakemistoon.

11. Vianmääritys

Verkkosivu ei avaudu

• Varmista, että säiliö on käynnissä docker ps- tai docker compose ps -komennolla.
• Tarkista, onko isäntäportti 5050 jo käytössä.
• Tutki säiliön lokit.
• Varmista, että palomuuri sallii pääsyn lähiverkosta.

Mittari ei näy verkossa

• Varmista, että mittari tavoittaa Docker-isäntäkoneen IP-osoitteen.
• Tarkista lähetysosoite ja -portti.
• Varmista, että IAMMETER-Dockerin SN vastaa mittarin SN:ää.
• Älä käytä localhost-osoitetta palvelimen osoitteena mittarissa; se viittaa itse mittariin, ei Docker-isäntäkoneeseen.
• Varmista, ettei asiakkaiden eristys tai vieras-Wi-Fi-verkko estä lähiverkkoliikennettä.

Aurinkodata näyttää virheelliseltä

• Tarkista CT:n suunta ja johdotus.
• Varmista, mikä kanava on määritetty Verkoksi ja mikä Invertteriksi.
• Tarkista pätötehon etumerkki tuonnin ja viennin aikana.
• Varmista aikavyöhyke ennen päivittäisten energiasummien vertailua.

Data katoaa säiliön uudelleenluonnin jälkeen

• Varmista, että /app/data on liitetty pysyvään isäntähakemistoon.
• Tarkista hakemiston käyttöoikeudet.
• Palauta uusin varmennettu varmuuskopio, jos alkuperäinen volyymi ei ole käytettävissä.

12. IAMMETER-Docker, IAMMETER-Cloud vai mukautettu järjestelmä?

Vaihtoehto	Paras käyttötarkoitus	Datan sijainti	Käyttöönoton vaivannäkö	Tärkein kompromissi
IAMMETER-Docker	Valmis paikallinen valvontapalvelin	Oma Docker-isäntäkoneesi	Pieni tai keskitasoinen	Vähemmän hallinnoituja pilviominaisuuksia
IAMMETER-Cloud	Valmis valvonta, raportit ja etäkäyttö	IAMMETER-Cloud	Pieni	Käyttää pilvipalvelua
Home Assistant / Node-RED	Älykotientiteetit ja mukautettu automaatio	Oma alustasi	Keskitasoinen	Suunnittelet kojelaudan ja työnkulut itse
Mukautettu palvelin	Tuote, EMS tai erikoistunut dataputki	Oma infrastruktuurisi	Suuri	Kehität ja ylläpidät järjestelmän itse

Jatka lukemista:

• Itse isännöidyt valvontavaihtoehdot arkkitehtuuritason vertailua varten;
• Avoimen lähdekoodin energianvalvonta-alustat Home Assistantille, Node-RED:lle ja muille alustoille;
• Kehitä oma energianvalvontajärjestelmäsi API- ja vastaanotinpuolen kehitystä varten;
• Energiamittarin käyttö ilman internetiä paikallisia datapolkuja ja offline-skenaarioita varten.

13. Käyttöönoton tarkistuslista

• Docker-isäntäkoneella on vakaa lähiverkko-osoite.
• /app/data on liitetty pysyvään tallennustilaan.
• Aikavyöhyke vastaa valvontakohdetta.
• Oletussalasanat on vaihdettu.
• Portteja 5050 ja 1883 ei ole tarpeettomasti altistettu internettiin.
• Mittarin SN ja kanavamääritykset ovat oikein.
• Paikallinen lähetys on varmennettu live-mittauksilla.
• Pilviedelleenlähetys on käytössä vain tarvittaessa.
• Varmuuskopiointi- ja päivitysmenettelyt on testattu.
• Datalogger-volyymi on liitetty, jos CSV-vientiä tarvitaan.

Päivitetty viimeksi: 17. heinäkuuta 2026.