# 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.