tomasz-syn-grzegorza
73e4fc005e
Server UI gains Update on stack cards, ComfyUI Models tab with workflow scan and downloads, and centralized comfyui_config. Model catalog and download scripts move from stacks/comfyui to server-ui so ComfyUI stays a minimal Docker wrapper for easier image updates.
4.0 KiB
04a — Klucz API Server UI (krok po kroku)
Cel: wpisać poprawny klucz API w panelu
:8091, żeby działały Start/Stop, CLI, Pliki i GPU Fan.
Szacowany czas: 3 minuty
1. Co to jest klucz API?
To hasło do panelu — bez niego możesz tylko oglądać status stacków. Z kluczem możesz:
- Start / Stop / Restart stacków
- Terminal CLI
- Zakładka Pliki
- Sterowanie GPU Fan
2. Gdzie jest JEDYNY plik z kluczem?
Na serwerze produkcyjnym (systemd):
/opt/control-plane/.env
Nie używaj innych plików — stare ścieżki mylą:
| Plik | Status |
|---|---|
/opt/control-plane/.env |
TAK — używaj tego |
stacks/control-plane/.env |
tylko dev (po sync ma ten sam klucz) |
stacks/server-ui/.env |
NIE — przestarzałe, ignoruj |
GPU_FAN_AGENT_KEY |
NIE — usunięte, używaj API_KEY |
3. Wyświetl klucz na serwerze
Polecane — klucz + link + weryfikacja live:
bash ~/cursor/ubuntu-bare-metal/stacks/server-ui/scripts/show-api-key.sh
Skrypt czyta /opt/control-plane/.env (produkcja), weryfikuje klucz na działającym server-ui i pokazuje Weryfikacja live: OK lub FAIL.
Tylko klucz (ręcznie):
sudo grep ^API_KEY= /opt/control-plane/.env
Skopiuj tylko część po = (bez słowa API_KEY=).
Diagnostyka (exit 0 = OK):
bash ~/cursor/ubuntu-bare-metal/stacks/server-ui/scripts/verify-api-key.sh
4. Wpisz klucz w panelu (3 kroki)
Krok A — otwórz panel
W przeglądarce na swoim komputerze:
http://<IP-serwera>:8091/
Przykład: http://192.168.100.90:8091/
Krok B — wklej klucz
- U góry strony znajdź pole API Key
- Wklej skopiowany klucz (bez spacji na końcach)
- Kliknij Zapisz
Krok C — sprawdź
- Kliknij Sprawdź klucz
- Powinno pojawić się: Klucz poprawny (zielony tekst)
- Dopiero teraz używaj Start/Stop, CLI itd.
Jeśli klucz jest zły: kliknij Wyczyść klucz, wklej ponownie ze skryptu z kroku 3.
5. Szybsza metoda — gotowy link
Zamiast kroków B–C możesz otworzyć od razu:
http://<IP-serwera>:8091/?api_key=TWÓJ_KLUCZ_Z_KROKU_3
Klucz zapisze się w przeglądarce i automatycznie zweryfikuje (status „Klucz poprawny”).
6. Jak sprawdzić że wszystko działa
- Zakładka Stacki → wybierz stack → Start
- Brak czerwonego komunikatu
Invalid or missing API key - Status stacku zmienia się na „running”
7. Błąd „Invalid or missing API key” — checklist
| # | Sprawdź | Co zrobić |
|---|---|---|
| 1 | Kliknąłeś Zapisz? | Wklej klucz → Zapisz → Sprawdź klucz |
| 2 | Stary klucz w przeglądarce? | Kliknij Wyczyść klucz w panelu, lub F12 → Local Storage → usuń server-ui-api-key |
| 3 | Klucz z właściwego pliku? | bash stacks/server-ui/scripts/show-api-key.sh (nie dev ręcznie) |
| 4 | Klucz działa na serwerze? | bash stacks/server-ui/scripts/verify-api-key.sh |
| 5 | Panel po aktualizacji? | sudo systemctl restart server-ui |
| 6 | Właściwy proces na porcie? | ss -tlnp | grep 8091 — powinno być /opt/server-ui |
Sync prod ↔ dev (gdy klucze się rozjechały):
sudo bash ~/cursor/ubuntu-bare-metal/stacks/server-ui/scripts/setup-control-plane-env.sh
sudo systemctl restart server-ui
8. Po instalacji panelu
Instalator wypisuje gotowy link z kluczem. Jeśli go nie zapisałeś:
bash ~/cursor/ubuntu-bare-metal/stacks/server-ui/scripts/show-api-key.sh
Podsumowanie
| Pytanie | Odpowiedź |
|---|---|
| Gdzie klucz? | /opt/control-plane/.env → API_KEY |
| Jak wyświetlić? | bash stacks/server-ui/scripts/show-api-key.sh |
| Jak zweryfikować? | bash stacks/server-ui/scripts/verify-api-key.sh |
| Jak wpisać w UI? | Pole API Key → Zapisz → Sprawdź klucz |
| Stary klucz? | Wyczyść klucz w toolbarze |
| Gotowy link? | http://IP:8091/?api_key=KLUCZ |
Powrót: 08 — Server UI · README