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>
3.1 KiB
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
- Wejdź na panel:
http://<IP-serwera>:8091/ - Wpisz API Key (toolbar u góry) i kliknij Zapisz
- 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 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
- Kliknij plik tekstowy na liście
- Zawartość pojawi się po prawej
- Edytuj w polu tekstowym
- 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
- Wejdź w
/tmp - Kliknij + Plik, nazwa:
server-ui-test.txt - Wpisz tekst, Zapisz
- Odśwież — plik na liście
- Usuń plik
8. Następny krok
- Terminal w przeglądarce: 10 — CLI
- Edytuj
.envstacków wstacks/<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 |