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