ProxMenuX

Spis treści

1. Co to jest ProxMenux
2. Krótka historia i wersje — od której wersji jest WEB
3. Funkcje CLI (menu terminalowe)
4. Funkcje WEB (ProxMenux Monitor) — co znajdziesz na porcie 8008
5. Instalacja
6. Bezpieczeństwo i dobre praktyki (autoryzacja, reverse proxy, TLS, 2FA)
7. Przykładowe scenariusze użycia
8. Porównanie z innymi narzędziami (Cockpit, Portainer, Proxmox GUI)
9. Rozwiązywanie problemów i FAQ

Zapisz się już dziś!

Sprawdź szczegóły: https://asdevops.pl/kurs-zabbix

1. Co to jest ProxMenux

ProxMenux to zestaw skryptów i narzędzi, które instalujesz na hoście Proxmox VE. Daje:

• interaktywne menu w terminalu (TUI) do szybkich czynności administracyjnych;
• webowy panel monitorujący i (w kolejnych wydaniach) ułatwiający część operacji z przeglądarki;
• zestaw helper-scriptów do instalacji popularnych usług (Docker, Portainer, Netdata itp.).

2. Krótka historia i — od której wersji jest WEB

• ProxMenux istniał najpierw jako menu TUI (CLI). W 2025 projekt rozpoczął szybki rozwój modularności i dodatkowych narzędzi.
• Webowy panel („ProxMenux Monitor”) pojawił się oficjalnie wraz z wydaniem v1.1.7 — release z 31 października 2025 wprowadził pierwszą wersję Monitor (pierwsze wydanie webowego narzędzia do podglądu/monitorowania). Od tego momentu interfejs WWW (dostępny domyślnie na porcie 8008) stał się częścią projektu.
• W kolejnych wydaniach (np. v1.1.8 — 14 listopada 2025) Monitor otrzymał istotne ulepszenia: oficjalne logowanie, obsługę proxy, dwuskładnikowe uwierzytelnianie (2FA) i inne funkcje bezpieczeństwa oraz poprawki wydajności. Jeśli zależy Ci na bezpiecznym wystawianiu panelu, użyj co najmniej v1.1.8 lub nowszego.

3. Funkcje CLI (menu terminalowe)

CLI to serce ProxMenux — jeśli lubisz pracować przez SSH, docenisz tempo i wygodę.

Główne możliwości:

• Post-install / konfiguracja po instalacji Proxmox (skrypty post-install).
• Aktualizacje i repozytoria: szybkie przełączanie repo (non-subscription), aktualizacje PVE.
• Instalatory narzędzi: Docker, Portainer, Cockpit, Netdata, Log2RAM, narzędzia GPU/Coral TPU itd.
• Zarządzanie VM/LXC: start/stop/restart, szybkie informacje o stanie.
• Narzędzia dyskowe / montowanie: Mount & Share Manager, zarządzanie NFS/Samba.
• Diagnostyka i czyszczenie: logi, cache, monitoring błędów.
• Helper scripts — zbiór skryptów społeczności (wersjonowane/mirrorowane).

Zalety CLI:

• bardzo szybkie akcje, niskie zużycie zasobów, proste skrypty automatyzujące rutynę.

4. Funkcje WEB — ProxMenux Monitor (na porcie 8008)

Panel WWW to wygodny dashboard do szybkiego podglądu i prostych akcji:

• Dashboard: CPU, RAM, użycie dysków, obciążenia, wykresy zdrowia systemu;
• Lista VM/LXC: szybkie start/stop/restart, podstawowe statystyki;
• Health warnings: wykrywanie potencjalnych problemów (np. dyski, usługi);
• Instalatory: uruchamianie popularnych instalatorów tak jak w CLI;
• Uwierzytelnianie: w pierwszym publicznym wydaniu Monitor mógł nie mieć zabezpieczeń — jednak w nowszych wydaniach (v1.1.8+) dodano login, obsługę 2FA i wsparcie dla reverse proxy. Dlatego nie wystawiaj panelu do internetu bez aktualizacji i konfiguracji zabezpieczeń.

Domyślny adres: http://<IP_NODU>:8008

A tak prezentuje się w przeglądarce:

5. Instalacja

1. Pobierz i uruchom instalator:

bash -c "$(wget -qO- https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)"

(ten skrypt instaluje wymagane zależności, kopiuje pliki i tworzy katalogi projektu; skrypt w repo wskazuje wersję i datę aktualizacji).

2. Po instalacji

• uruchom menu: menu (tak jak na obrazku)

• otwórz w przeglądarce: http://<IP>:8008

Utwórz hasło i podążaj za instrukcjami. Gotowe ! Możesz teraz Przejrzeć wszystkie funkcję aplikacji Webowej:

6. Bezpieczeństwo i dobre praktyki

Panel webowy to dodatkowe ryzyko — oto kroki, które warto wykonać:

6.1 Zainstaluj aktualizacje

• używaj nowszych wydań (min. v1.1.8 jeśli chcesz mieć auth/2FA).

6.2 Nie wystawiaj go bezpośrednio do internetu

• preferuj dostęp z sieci wewnętrznej lub VPN; jeśli musisz wystawić — zastosuj reverse proxy (Nginx/Traefik, Cloudflare) z HTTPS i ograniczeniem adresów IP.

6.3 Reverse proxy + TLS

• postaw Nginx/Traefik i ustaw certyfikat (Let’s Encrypt). Skonfiguruj nagłówki bezpieczeństwa i limituj dostęp za pomocą basic auth / IP whitelist.

6.4 Uwierzytelnianie i 2FA

• w v1.1.8 pojawiła się opcja logowania i TOTP 2FA — włącz ją jeśli dostępne. Jeśli używasz starszej wersji, nie wystawiaj panelu.

7. Przykładowe scenariusze użycia

Scenariusz A — szybkie wdrożenie Docker+Portainer

1. SSH do noda → menu → wybierz Install → Docker → Portainer
2. Po instalacji otwórz Portainera z GUI lub otwórz task z panelu Monitor.

Scenariusz B — szybkiej diagnostyka dysku

1. CLI: menu → Disk and Storage Manager → Check disk
2. WEB: Dashboard → Health → dyski → szczegóły

Scenariusz C — mobilny podgląd (PWA)

• jeśli chcesz używać monitor jako PWA: skonfiguruj reverse proxy z HTTPS i dodaj manifest PWA (w niektórych buildach Monitor wspiera PWA).

8. Porównanie z innymi narzędziami

• Proxmox GUI — pełnoprawne zarządzanie infrastrukturą; ProxMenux nie ma ambicji zastąpić GUI, raczej dać szybszy dostęp i automatyzację.
• Cockpit — rozbudowany panel serwerowy; Cockpit jest bardziej ogólny (wiele dystrybucji). ProxMenux jest szyty pod Proxmox i dostarcza dedykowane skrypty.
• Portainer — zarządzanie kontenerami/Dockerem; ProxMenux instaluje Portainera, ale nie konkuruje z jego funkcjami.

9. Rozwiązywanie problemów i FAQ

Nie widzę panelu na porcie 8008

• sprawdź procesy: ss -tunlp | grep 8008
• sprawdź logi instalacji (w katalogu instalacyjnym ProxMenux).
• upewnij się, że firewall/iptables nie blokuje portu.

Monitor nie prosi o hasło (ponowne ostrzeżenie)

• wcześniejsze buildy monitor mogły startować bez auth — zaktualizuj do v1.1.8 lub wyżej i skonfiguruj login/2FA; dodatkowo umieść panel za reverse proxy.

Proxmox GUI działa nieprawidłowo po instalacji ProxMenux

• są doniesienia o konfliktach (użytkownicy forum Proxmox) — jeśli napotkasz problem, usuń ProxMenux tymczasowo i przywróć pve-manager (instrukcje na forum Proxmox). Zawsze wykonuj backupy przed modyfikacjami systemowymi.

Zapisz się już dziś!

Sprawdź szczegóły: https://asdevops.pl/kurs-zabbix