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,117 @@
+# 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](08-server-ui-install.md) (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](04a-api-key.md): pole **API Key** → **Zapisz** → **Sprawdź 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](10-server-ui-cli.md)
+- Edytuj `.env` stacków w `stacks/<nazwa>/.env`
+- Zarządzaj stackami w zakładce **Stacki**
+- Steruj wentylatorami w **GPU Fan**
+
+Powrót: [README.md](../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 |