Initial import: bare-metal stacks, Server UI, GPU fan, tutorials.

Infrastructure configs for GMKtec K11 (Docker, vLLM, LocalAI, ComfyUI, control-plane, gpu-fan agent, Server UI with CLI/file explorer/GPU fan curve). Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-05 12:02:04 +00:00
commit 359afb3a59
153 changed files with 18169 additions and 0 deletions
@@ -0,0 +1,100 @@
+# Otwieranie panelu GPU Fan w przeglądarce
+
+**Cel:** Wejść do panelu sterowania wentylatorami GPU z komputera w sieci LAN.  
+**Czas:** ~3 minuty  
+**Wymagania:** Działające usługi `gpu-fan` (agent) i `server-ui` (panel)
+
+> UI gpu-fan **nie** jest już na porcie 8090. Użyj **Server UI** na porcie **8091**, zakładka **GPU Fan**.
+
+---
+
+## Krok 1 — Sprawdź IP serwera
+
+Na serwerze:
+
+```bash
+hostname -I | awk '{print $1}'
+```
+
+Przykład wyniku: `192.168.100.90` — to Twój adres w LAN.
+
+---
+
+## Krok 2 — Pobierz klucz API
+
+Na serwerze:
+
+```bash
+grep ^API_KEY= /opt/control-plane/.env
+# lub ten sam klucz z agenta:
+grep ^API_KEY= /opt/control-plane/.env
+```
+
+Przykład: `API_KEY=a1b2c3d4e5f6...` — skopiuj część **po** znaku `=`.
+
+---
+
+## Krok 3 — Otwórz URL w przeglądarce
+
+Z innego komputera w tej samej sieci Wi‑Fi/LAN:
+
+```
+http://192.168.100.90:8091/?api_key=WKLEJ_TUTAJ_KLUCZ#gpu-fan
+```
+
+Zamień:
+- `192.168.100.90` → IP z kroku 1
+- `WKLEJ_TUTAJ_KLUCZ` → wartość z kroku 2
+
+Kliknij zakładkę **GPU Fan** (lub użyj `#gpu-fan` w URL).
+
+**Co zobaczysz gdy OK:** wykres krzywej wentylatorów, temperatura GPU, monitoring mocy/VRAM.
+
+Klucz zapisze się w przeglądarce (localStorage `server-ui-api-key`) — przy kolejnych wizytach wystarczy `http://IP:8091/#gpu-fan`.
+
+---
+
+## Dostęp tylko z samego serwera
+
+```
+http://127.0.0.1:8091/#gpu-fan
+```
+
+(API key może być wymagany gdy `SERVER_UI_HOST=0.0.0.0`.)
+
+---
+
+## Dostęp przez SSH (opcjonalnie)
+
+Na **swoim** laptopie:
+
+```bash
+ssh -L 8091:127.0.0.1:8091 TWOJ_USER@192.168.100.90
+```
+
+W przeglądarce na laptopie: `http://localhost:8091/#gpu-fan`
+
+---
+
+## Co zrobić gdy nie działa
+
+| Objaw | Co zrobić |
+|-------|-----------|
+| Strona się nie ładuje | `sudo systemctl status server-ui` — czy **running**? |
+| Zakładka GPU Fan pusta / błąd 502 | `sudo systemctl status gpu-fan` — agent na :18090 |
+| `401` / brak danych | Zły klucz API — sprawdź `/opt/control-plane/.env` |
+| Agent nie odpowiada | `curl -s http://127.0.0.1:18090/api/status -H "X-API-Key: KLUCZ"` |
+
+Test proxy:
+
+```bash
+curl -s http://127.0.0.1:8091/api/gpu-fan/health -H "X-API-Key: $(grep ^API_KEY= /opt/control-plane/.env | cut -d= -f2)"
+```
+
+---
+
+## Bezpieczeństwo (krótko)
+
+- Panel **nie** wystawiaj na internet bez firewall / VPN.
+- W LAN używaj `API_KEY` w Server UI.
+- Agent gpu-fan (:18090) nasłuchuje tylko na localhost.