tomasz-syn-grzegorza
359afb3a59
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>
118 lines
3.1 KiB
Markdown
118 lines
3.1 KiB
Markdown
# 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 |
|