Files
ubuntu-bare-metal/manual-tutorial/10-server-ui-cli.md
T
tomasz-syn-grzegorza 359afb3a59 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

3.0 KiB
Raw Blame History

10 — Terminal CLI w Server UI

Cel rozdziału: uruchomić shell bash w przeglądarce (zakładka CLI w panelu :8091) — jak krótkie SSH, ale w UI.

Szacowany czas: 5 minut

Wymagania: rozdział 08 — Server UI (działający panel + klucz API)


1. Otwórz zakładkę CLI

  1. Wejdź na panel: http://<IP-serwera>:8091/
  2. Wpisz API Key (toolbar u góry) i kliknij Zapisz
  3. Kliknij zakładkę CLI (pierwsza od lewej)

Bezpośredni link:

http://<IP-serwera>:8091/#cli?api_key=TWÓJ_KLUCZ

Status u góry terminala:

  • Połączono (zielony) — gotowe
  • Wpisz i zapisz API Key — brak klucza
  • Rozłączono — kliknij Połącz ponownie

2. Klucz API

Zobacz 04a — Klucz API: pole API KeyZapiszSprawdź klucz.


3. Podstawowe komendy

W terminalu wpisz jak w SSH:

whoami
pwd
ls
docker ps

Powinieneś zobaczyć użytkownika tomasz-syn-grzegorza i dostęp do Dockera.


4. Programy interaktywne

Program Jak wyjść
htop klawisz q
less plik q
vim plik :q lub :wq
nano plik Ctrl+O, Ctrl+X

Zmiana rozmiaru okna przeglądarki dostosowuje terminal automatycznie.


5. sudo

Możesz użyć sudo — terminal poprosi o hasło Twojego użytkownika Linux (nie API Key):

sudo ls /root

6. Ograniczenia

Co Wyjaśnienie
Nie jesteś rootem Panel działa jako Twój użytkownik — jak zwykłe SSH
Nowa sesja po reconnect Zamknięcie zakładki / Połącz ponownie = nowy bash
Limit sesji Domyślnie max 5 równoległych terminali (wszystkie karty)
Wyłączenie CLI Admin może ustawić CLI_ENABLED=0 w /opt/control-plane/.env

7a. Pusty terminal (inne zakładki działają)

  1. U góry: ZapiszSprawdź klucz (musi być „Klucz poprawny”)
  2. Kliknij Połącz ponownie
  3. Status powinien zmienić się na Połączono — pojawi się prompt bash
  4. Jeśli nadal pusto: twardy refresh strony (Ctrl+F5), potem kroki 12
  5. Zły klucz: status „Zły klucz API…” — zobacz 04a — Klucz API

7. Weryfikacja

  1. Zakładka CLI → status Połączono
  2. echo test-cli-ok → widzisz test-cli-ok
  3. docker ps → lista kontenerów
  4. Zmień rozmiar okna — prompt nie „łamie się” dziwnie
  5. Przełącz na Stacki i wróć do CLI — nowa sesja (to normalne)

8. Następny krok

  • Przeglądaj pliki w zakładce Pliki
  • Zarządzaj stackami w Stacki
  • Steruj wentylatorami w GPU Fan

Powrót: README.md


Podsumowanie

Pytanie Odpowiedź
Gdzie terminal? http://<IP>:8091/#cli
Klucz API? 04a — Klucz API
Kto jesteś w shellu? tomasz-syn-grzegorza (nie root)
vim/htop? Tak — pełny PTY