Files
ubuntu-bare-metal/manual-tutorial/09-file-explorer.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.1 KiB

09 — Przeglądarka plików w Server UI

Cel rozdziału: przeglądać i edytować pliki na serwerze z przeglądarki (zakładka Pliki w panelu :8091).

Szacowany czas: 10 minut

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


1. Otwórz zakładkę Pliki

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

Bezpośredni link:

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

2. Klucz API

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


3. Nawigacja

Element Działanie
Lista po lewej Klik na folder → wejście; klik na plik → otwarcie w edytorze
Breadcrumb u góry Skróty do katalogów nadrzędnych
↑ Wyżej Katalog rodzica
Odśwież Ponowne wczytanie listy

Przykładowe ścieżki:

Co chcesz zrobić Ścieżka
Repo projektu /home/tomasz-syn-grzegorza/cursor/ubuntu-bare-metal
.env stacku LocalAI .../stacks/localai/.env
Dane aplikacji /data/apps/
Logi systemowe /var/log/ (jeśli masz uprawnienia)

4. Edycja pliku

  1. Kliknij plik tekstowy na liście
  2. Zawartość pojawi się po prawej
  3. Edytuj w polu tekstowym
  4. Kliknij Zapisz

Pliki binarne (obrazy, modele) — tylko podgląd base64, bez zapisu.


5. Tworzenie i usuwanie

Przycisk Działanie
+ Folder Nowy podfolder w bieżącym katalogu
+ Plik Nowy pusty plik
Zmień nazwę Zaznacz element na liście, potem przycisk
Usuń Zaznacz element — pojawi się potwierdzenie

Uwaga: Nie można usunąć niepustego folderu — najpierw opróżnij go.


6. Brak uprawnień — co to znaczy?

Panel działa jako Twój użytkownik Linux (tomasz-syn-grzegorza), nie jako root.

Objaw Przyczyna Rozwiązanie
„Brak uprawnień” przy /opt/control-plane/.env Plik root-only (600) sudo nano /opt/control-plane/.env w SSH
Nie widać cudzego katalogu Brak prawa odczytu sudo w terminalu lub zmiana właściciela
Zapis odrzucony Brak prawa zapisu chmod / chown w SSH

To normalne — explorer nie omija zabezpieczeń systemu.


7. Weryfikacja

  1. Wejdź w /tmp
  2. Kliknij + Plik, nazwa: server-ui-test.txt
  3. Wpisz tekst, Zapisz
  4. Odśwież — plik na liście
  5. Usuń plik

8. Następny krok

  • Terminal w przeglądarce: 10 — CLI
  • Edytuj .env stacków w stacks/<nazwa>/.env
  • Zarządzaj stackami w zakładce Stacki
  • Steruj wentylatorami w GPU Fan

Powrót: README.md


Podsumowanie

Pytanie Odpowiedź
Gdzie panel? http://<IP>:8091/#files
Klucz API? sudo grep ^API_KEY= /opt/control-plane/.env
Limit rozmiaru pliku? 2 MiB (domyślnie)
Root w przeglądarce? Nie — tylko uprawnienia użytkownika panelu