Helyszíni beüzemelési és átadási útmutató

Ez az útmutató az OpenMediaVault (OMV) alapú szerver és a benne futó Home Assistant (HA) rendszer helyszíni üzembe helyezéséhez készült. Az új felhasználó rendelkezik Linux-ismeretekkel, így a műszaki lépések tömörek, de a rendszerarchitektúra sajátosságaira és a kritikus pontokra kitérünk.

1. Hálózati integráció és az OMV IP-címének meghatározása

A szerver az új helyszíni routerre csatlakoztatva DHCP-n keresztül kap IP-címet, de a webes felületek a megadott egyedi portokon érhetők el.

• IP-cím felderítése: Csatlakozás után a helyi hálózaton az alábbi eszközök egyikével deríthető fel a szerver aktuális IP-címe (jelöljük [SERVER_IP]-ként):
  • Router adminisztrációs felülete (DHCP klienslista).
  • Hálózatszkennelő parancs sorból: nmap -sn 192.168.x.0/24 vagy arp -a.
• OMV webes felület: http://[SERVER_IP]:90 (Felhasználónév és belépési jelszó egyedi csatornán küldve)

2. A Home Assistant (HA) elérése és portszáma

A Home Assistant konténer a szerveren fut, és a szabványos belső portján (8123) érhető el az OMV IP-címén keresztül:

• Helyi elérés: http://[SERVER_IP]:8123
• Felhasználónév és jelszó külön csatornán küldve!

3. Wi-Fi és rendszerbizalmas adatok frissítése (secrets.yaml)

Az ESPHome alapú eszközök (pl. LED gyűrűk, érzékelők) és a HA integrációk a központi secrets.yaml fájlból olvassák ki a hitelesítő adatokat.

• Lépj be a Home Assistant felületére, majd nyisd meg az ESPHome panelt a bal oldali menüből.
• A felső vagy oldalsó menüben (vagy a File Editor kiegészítőn keresztül) keresd meg a gyökérkönyvtárban található secrets.yaml fájlt.
• Írd át a helyi hálózat adataira a fájl tartalmát:

wifi_ssid: "Az_Uj_Wifi_Neve"
wifi_password: "Az_Uj_Wifi_Jelszava"

• Mentsd el a fájlt. Ezt követően az ESPHome eszközök (szükség esetén egyszeri USB-s vagy frissített OTA compilation után) az új hálózaton fognak kommunikálni.

4. Biztonságos külső elérés (HTTPS / SSL kényszerítése)

A helyi és távoli elérések során szigorúan kerülni kell a sima http:// protokollt, mivel a modern böngészők (és különösen a fali kijelzők / táblagépek böngészői) blokkolják a nem biztonságos kontextusokat, illetve a mikrofon/kamera és a WebSocket kapcsolatok is hibára futnak HTTPS hiányában.

• Nginx Proxy Manager (Nginx): Az OMV felületén aktiválható Nginx konténer/plugin vagy a Portainerben futó Nginx Proxy Manager biztosítja a fordított irányú elosztást (reverse proxy).
• SSL / TLS konfiguráció: A külső eléréshez generálni/állítani kell egy Let’s Encrypt SSL tanúsítványt a domain nevekhez, és minden külső forgalmat át kell irányítani https:// protokollra.

5. A szerveren futó Docker stackek áttekintése

A rendszer az alábbi konténerizált szolgáltatásokat tartalmazza:

• Nginx: Fordított proxy és SSL-termináció (az OMV felületről vezérelhető). Helyi elérés: http://[SERVER_IP]:81
• Portainer: Konténer-adminisztrációs felület a Docker stackek vizuális felügyeletéhez. Helyi elérés: http://[SERVER_IP]:9000
• Piper: Helyi szövegfelolvasó (TTS) motor a hangasszisztens pipeline-hoz.
• WordPress: Előre telepített, konfigurációra kész webes keretrendszer MariaDB háttéradatbázis kapcsolt környezetben (egyéni Docker Compose fájlokból indítva). Javasolt a már HTTPS címet megnyitva telepiteni, így nem kell majd külön beírni az elérési címet. Maga a conténer már fut, csak a konkrét telepitése fog megtörténni a http://[SERVER_IP]:9104 port nginx-en történt aktíválása után. https://[saját-domain]

Támogatás és konzultáció

Mivel az OMV, a Docker alapú konténerek, valamint a Home Assistant strukturális felépítése elsőre összetett lehet, a felhasználó bármikor fordulhat hozzám kérdésekkel, amíg teljesen át nem látja a rendszer működését, az adatáramlást és a karbantartási feladatokat.

A portainer és a nginx konténerek nincsenek elinditva, hogy ne okozzon akadást a belépésekkor. A piper és esetleges egyéb összetevőknél előfordulhat, hogy ujra kell tölteni a konfigurációt. Bármi kérdés, hiányzó adat esetén hívj, vagy fordulj a Geminihez!!

Jó szórakozást!