sb-manager

Stav služby

Rychlé ověření, že sb-manager běží.

Celkem zařízení

—

ACTIVE

—

NEW

—

Ostatní

—

Poslední načtení:

—

Co je v MVP

Registr zařízení + přidělení n (port blok).
Generace provisioning tokenu (one‑time) pro REGISTER_TUNNEL_KEY.
Provisioning endpoint: POST /api/v1/provision/register.

Tip: pokud jdeš na / a vidíš 404, znamená to, že UI nebylo nasazené (teď už je).

Zařízení

Fleet seznam + vytvoření zařízení (registry).

Tip: klikni na řádek zařízení v tabulce → otevře se Device detail.

n	sbId	deviceLabel	poznámka	status	lastSeenAt	createdAt

Vytvořit zařízení

Device detail

—

sbId

—

deviceLabel

—

status

—

basePort

—

portRange

—

createdAt

—

lastSeenAt

—

notes max 500 znaků; prázdné = smaže notes

Port plán (BLOCK=10)

BASE = 20000 + (n-1)*10. Rezervovaný blok je BASE..BASE+9; kanonicky používáme +0(web + /health), +2(SSH), +3(config), +4(api), +5(ops).

Pozn.: v dalších krocích sem přidáme „Keys“ (authorized_keys) a „Tunnel status“.

Tunely & URL

Veřejně se na SB přistupuje přes subdomény (443/sb-router). Porty BASE..BASE+9 jsou typicky jen pro SBC (VPS) a zvenku nemusí být dostupné. `-health` jde kanonicky přes stejný web tunnel jako default, jen na cestu /health.

Veřejné (přes sb-router)

default

—

ops (UI)

—

api

—

health

—

Tohle jsou URL, které má používat servis / uživatel zvenku (přes 443).

Alias (hezká doména)

Alias nesmí obsahovat pomlčku. Služby se oddělují suffixem -ops/-api/-health.

povoleno: a-z0-9 (lowercase), min 2, max 32

alias

—

alias (default)

—

alias-ops

—

alias-api

—

alias-health

—

SBC lokálně (jen na VPS)

BASE

—

80 /health

—

3002

—

3001

—

SSH port

—

SSH (ProxyJump)

—

Tyto URL fungují jen když jsi přihlášený na VPS (ne z prohlížeče zákazníka).

Stav služeb

Health check všech mikroslužeb na SB (z ops-agent /health)

Načítání...

Telemetrie (live)

Live snapshot z ops-agentu. U multi-machine instalací zůstává detail primární machine a níže je tabulka všech nahlášených machines.

Nenaciteno

Elektomer (sit)

Kladne = export do site (ven), zaporne = odber ze site (dovnitr)

Export limit (Feed Power)

Omezeni exportu do site. Register 47509 (enable, RO mirror 10410) + 42004 (limit W, S32).

Anti-backflow

Aktualni limit

Enable Novy limit (W)

Rychle:

Rizeni vykonu (47120 Meter Offset)

Eco mode (47000=5). Kladna = export do site, zaporna = import ze site. Scale: registr = watty / 16.

Vlastni watty (+ export, - import) --

EMS & Inverter Status

Klicove registry ridici chovani invertoru.

Work Mode (47000)

Work Status (35187)

Grid Mode (35136)

Mfg Code (47505)

EMS Mode (47511)

EMS Power (47512)

EMS FeedPwr En (47509)

EMS FeedPwr W (47510)

GoodWe UDP live

Prime read-only cteni kazdych 20 s pres UDP 8899, po jednotlivych adresach menicu.

Modbus Registry

Přímé čtení a zápis Modbus registrů invertoru přes aktuální konfiguraci SmartBoxu.

Měnič Registr Typ | Hodnota (zapis)

Rychle cteni (klikni pro nacteni):

Telemetrie (live)

Zive cteni registru z invertoru. Filtruj dle kategorie. Interval: 5 min.

Kategorie:

Klikni Nacist...

DC Polling konfigurace

Nastavení intervalů čtení registrů z invertoru. Změny se zapíšou do DC konfigurace a DC se restartuje.

Klikni Nacist...

Sensor DB

Historie senzorových dat z invertoru (SQLite na SB, port 5011). DC ukládá každých ~6s.

Posledních zaznamov

Klikni Obnovit...

Logy

Logy ze vsech sluzeb na SB (SQLite, port 5012). Filtrovani dle sluzby a urovne.

Posledních Level: Sluzba:

Klikni Obnovit...

Bootstrap (první instalace SB)

Stáhni balík sb-ops-agent + vygeneruj bootstrap skript s provisioning tokenem. Oba soubory nahraj na SB a spusť skript. Je idempotentní (můžeš pustit opakovaně).

1) Balík sb-ops-agent

Doporučené: port 3002 (ops UI) + /health přes web na portu 80.

name

—

version

—

channel

—

sha256

—

Pokud je tu „—“, nejdřív nahraj balík v sekci Balíky (name=sb-ops-agent, channel=stable).

2) Bootstrap skript

Skript obsahuje provisioning token, vytvoří tunnel key, zaregistruje ho a nastaví systemd služby.

ttlSeconds (volitelné)

Kam nahrát na SB

/home/energity/bootstrap

Nahraj: sb-bootstrap.sh + sb-ops-agent.tar.gz

1) Připrav adresář na SB (vždy používá service user energity; když chybí, vytvoří ho)

2) Po nahrání nastav práva

3) Spusť

Po kliknutí na „Vygenerovat & stáhnout“ se připraví .sh soubor ke stažení.

Tunnel keys

Klíče pro reverse SSH tunel (záznamy v DB). Umí import z authorized_keys na VPS.

fingerprint	status	createdAt	revokedAt

Import čte $VPS_AUTHORIZED_KEYS_PATH (default /home/ra_tunnel/.ssh/authorized_keys) a zapíše nalezené klíče do DB. Nemění host keys.

Provisioning token

Vygeneruje token pro zařízení (one-time). Staré nepoužité tokeny se při generaci zneplatní.

purpose	createdAt	expiresAt	usedAt	revokedAt

Token string je vidět jen při vygenerování. V tabulce jsou jen metadata.

Provisioning token

Token je „one‑time odemčení“ pro provisioning (typicky registrace pubkey). Neřeší ownership.

Poznámka

Token se zobrazuje jen při vygenerování. Na serveru se ukládá hash, takže zpětně ho už neuvidíš.

Balíky (Artifacts)

Upload release tarballů (např. sb-ops-agent, sb-installer, …). Prozatím jen manuální správa v sb-manageru.

name	version	channel	size	sha256	createdAt	akce

Pozn.: download probíhá přes API (UI stáhne blob přes fetch, aby fungoval i AUTH_MODE=dev).

Nahrát balík

Debug

Zařízení: Konfigurace:

Připojení

Název IP adresa Port Unit ID Typ zařízení

Registry

Adresa	Název	DB klíč	Typ	Scale	Jednotka	Skupina

Poll skupiny

Název funkce	Interval (s)	Aktivní

Lokální override pro AUTH_MODE=dev

V produkci přes AUTH_MODE=pge-auth se používá centrální login gateway. Tyto hlavičky jsou jen pro lokální/dev režim.

E‑mail (X-Dev-User) Groups (X-Dev-Groups)

Uloží se do localStorage pro tenhle browser.

Stav služby

Co je v MVP

Zařízení

Vytvořit zařízení

Device detail

Tunely & URL

Veřejné (přes sb-router)

Alias (hezká doména)

SBC lokálně (jen na VPS)

Stav služeb

Telemetrie (live)

Střídače (live)

Elektomer (sit)

Export limit (Feed Power)

Rizeni vykonu (47120 Meter Offset)

EMS & Inverter Status

GoodWe UDP live

Modbus Registry

Telemetrie (live)

DC Polling konfigurace

Sensor DB

Logy

Bootstrap (první instalace SB)

1) Balík sb-ops-agent

2) Bootstrap skript

Tunnel keys

Provisioning token

Provisioning token

Poznámka

Balíky (Artifacts)

Nahrát balík

Debug

Přehled

Machines (live)

Tok energie

Podíly energie

Přehled energie

Správa baterie

Nastavení zařízení

Primární konektor

Připojení

Registry + Přidat registr + Přidat 5

Poll skupiny + Přidat skupinu

Register definice (YAML)

Poll functions (YAML)

AI Prompt generátor

Lokální override pro AUTH_MODE=dev

Registry

Poll skupiny