ENPLDEPT
Flash
Cała dokumentacja
Sensmos Hub

Nod działa na sprzęcie, który już masz — bez ESP32.

Jeden kontener na Raspberry Pi, NAS-ie albo domowym serwerze. Dołącza do sieci jak nod, mierzy łącze i otwiera ten sam szyfrowany tunel do Home Assistant, co fizyczny nod.

Co jest potrzebne

  • Docker z Compose na maszynie, która działa cały czas i jest w tej samej sieci LAN co Home Assistant, albo Home Assistant OS / Supervised dla dodatku.
  • Apka Sensmos z portfelem. Hub rejestruje się do adresu portfela, który mu podasz.

Docker

git clone https://github.com/sensmos-network/sensmos-hub.git
cd sensmos-hub
cp .env.example .env        # wpisz adres portfela w HUB_OWNER
docker compose up -d
docker compose logs -f      # pokazuje device_id i PIN

Kontener używa sieci hosta: apka dociera do hubu na porcie 80 (znajduje go przez mDNS jako sensmos-<id>.local, jak płytkę ESP32) przy parowaniu, tunel sięga do Twojej sieci LAN, a ping mierzy prawdziwe łącze domowe.

Po pierwszym starcie hub pojawia się w apce na liście nodów tego portfela.

Dodatek Home Assistant

  1. Ustawienia → Dodatki → Sklep z dodatkami → ⋮ → Repozytoria → dodaj https://github.com/sensmos-network/sensmos-hub.
  2. Zainstaluj Sensmos Hub, wpisz owner (adres portfela) i opcjonalnie pin, uruchom.
  3. Log dodatku pokazuje id noda i PIN.

Parowanie i panel HA

  1. W apce otwórz hub → Ustawienia → Zdalny dostęp → Sparuj, będąc w tej samej sieci Wi-Fi. Podaj PIN. Apka zapisuje w hubie klucz parowania; klucz nigdy nie opuszcza Twojej sieci.
  2. Na karcie noda dodaj integrację Panel HA i wskaż adres Home Assistant w LAN, np. 192.168.1.20:8123. Przy dodatku to adres maszyny, na której on działa.
  3. Od teraz panel otwiera się skądkolwiek, przez hub. Zdalny dostęp opisuje tunel dokładnie; zasady są te same: tylko adresy prywatne, bez przekierowania portów, tylko dla właściciela.

Co robi dziś

  • Rejestruje się do Twojego portfela i trzyma jedno wychodzące, szyfrowane połączenie z siecią, jak nod.
  • Mierzy łącze do kotwic (ping, TCP, HTTP, DNS); wyniki zasilają tę samą mapę i raporty łącza, co inne nody.
  • Paruje się z maksymalnie czterema telefonami i otwiera tunel v2 do prywatnych adresów w Twojej sieci.

Jeszcze nie: radio LoRa po USB, lokalny broker MQTT i bufor danych, lokalna historia czujników, mapa offline. To kolejne kroki na roadmapie.

Pliki

Wszystko, czego hub potrzebuje, leży w jego katalogu danych (./data przy Dockerze, pamięć dodatku przy Home Assistant):

plikco to
identity.jsonpara kluczy hubu; usuń, żeby dostać nową tożsamość (nowy nod)
pairing.jsonklucze parowania zapisane przez telefony
pin.txtPIN, jeśli go nie ustawisz

Pytania i proste odpowiedzi

Czy hub zarabia GALU?

Nie. Nie ma radia, więc niczego nie przekazuje i nie powiększa zasięgu; nagrody dostają nody, które to robią. Hub jest od tunelu, pomiarów i, w następnych krokach, od trzymania Twoich danych z czujników w domu.

Czy mogę mieć hub i nod ESP32 naraz?

Tak. To osobne nody na tym samym portfelu. Hub to dobre miejsce na tunel, gdy nody ESP32 stoją na baterii albo daleko od Home Assistant.

Czy serwer widzi mój ruch do Home Assistant?

Nie. Tunel jest szyfrowany od końca do końca kluczem wyprowadzonym z klucza parowania, który telefon zapisuje w hubie wyłącznie po Twojej sieci LAN. Serwer przekazuje nieczytelne ramki i sam tunelu otworzyć nie może.

Ile to kosztuje?

Ryczałt 0,5 GALU w dniu, w którym używasz tunelu, tak samo jak przy fizycznym nodzie. Sam hub jest darmowy. Przy pustym saldzie nic nie jest blokowane.

Aktualizacja: 2026-11-01