Beszel – kompletny przewodnik (instalacja, konfiguracja i użycie)

Beszel to nowoczesne narzędzie open-source służące do monitorowania serwerów, maszyn wirtualnych oraz kontenerów Docker. System został zaprojektowany jako lekka alternatywa dla rozbudowanych platform monitoringu, takich jak Prometheus czy Grafana, które często wymagają skomplikowanej konfiguracji.

Beszel umożliwia szybkie uruchomienie monitoringu infrastruktury IT w kilka minut i zapewnia:

• panel webowy z wykresami i statystykami
• monitoring hostów i kontenerów
• historię danych
• alerty systemowe
• obsługę wielu użytkowników
• integrację OAuth
• REST API.

Projekt jest szczególnie popularny w środowiskach:

• homelab
• self-hosting
• VPS
• serwery firmowe
• DevOps

 

 

---

1. Architektura systemu Beszel

Beszel działa w architekturze hub-agent.

1.1 Hub

Hub to centralny serwer monitoringu.

Jego funkcje:

• panel webowy
• zbieranie danych
• wizualizacja wykresów
• zarządzanie agentami
• konfiguracja alertów
• zarządzanie użytkownikami

Hub jest aplikacją webową opartą o framework PocketBase i działa z własnym serwerem HTTP oraz bazą SQLite.

Domyślny port:

8090

---

1.2 Agent

Agent to lekki program instalowany na każdym monitorowanym serwerze.

Zadania agenta:

• zbieranie danych systemowych
• zbieranie danych Docker / Podman
• wysyłanie statystyk do huba
• obsługa komunikacji z hubem

Agent działa jako mały serwis i komunikuje się z hubem przez SSH/WebSocket.

---

Schemat działania

Serwer 1 ─ Agent ┐
Serwer 2 ─ Agent ├──► Beszel Hub (panel web)
Serwer 3 ─ Agent ┘

---

2. Jakie dane monitoruje Beszel

Beszel zbiera szeroki zestaw metryk systemowych.

2.1 Statystyki systemu

• użycie CPU
• użycie RAM
• swap
• load average (średnie obciążenie)
• temperatura CPU
• użycie GPU (karty graficznej)
• bateria (np. laptop)

2.2 Statystyki dysków

• użycie przestrzeni dyskowej
• I/O dysku
• monitoring wielu partycji

2.3 Sieć

• ruch sieciowy
• transfer
• wykorzystanie interfejsów

2.4 Kontenery

• CPU kontenerów
• RAM kontenerów
• sieć kontenerów
• historia zużycia

Beszel obsługuje kontenery:

• Docker
• Podman.

---

3. Najważniejsze funkcje

3.1 Dashboard

Panel webowy pokazuje:

• wykresy CPU
• wykresy RAM
• użycie dysków
• statystyki kontenerów
• historię obciążenia

---

3.2 Alerty

System może wysyłać alerty gdy:

• CPU przekroczy próg
• RAM przekroczy próg
• kończy się miejsce na dysku
• temperatura jest za wysoka
• serwer przestanie odpowiadać.

---

3.3 Multi-user

Możliwe jest:

• tworzenie wielu użytkowników
• przypisywanie systemów do użytkowników
• współdzielenie infrastruktury.

---

3.4 OAuth

Beszel obsługuje logowanie przez:

• Google
• GitHub
• inne OIDC.

---

3.5 API

Dostępne jest REST API, które umożliwia integrację z:

• skryptami
• automatyzacją
• systemami DevOps.

---

4. Wymagania systemowe

Beszel jest bardzo lekki.

Typowe zużycie zasobów:

Hub:

• RAM: ~20–30 MB

Agent:

• RAM: ~5–10 MB

Może działać na:

• Linux
• macOS
• Windows
• Docker
• NAS
• Raspberry Pi.

---

5. Instalacja Beszel (Docker)

Najłatwiejszą metodą instalacji jest Docker.

5.1 Instalacja Docker

Ubuntu / Debian:

sudo apt update
sudo apt install docker.io docker-compose -y

Uruchomienie dockera:

sudo systemctl enable docker
sudo systemctl start docker

---

5.2 Instalacja Hub

Utwórz katalog:

mkdir beszel
cd beszel

Utwórz plik:

nano docker-compose.yml

Zawartość:

services:
  beszel:
    image: henrygd/beszel
    container_name: beszel
    restart: unless-stopped
    environment:
      - APP_URL=http://localhost:8090
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data

Zapisz plik i uruchom:

docker-compose up -d

---

5.3 Dostęp do panelu

Otwórz w przeglądarce:

http://IP_SERWERA:8090

Przy pierwszym uruchomieniu tworzysz:

• konto administratora

---

6. Dodawanie serwera do monitoringu

Po instalacji huba można dodać pierwszy system.

W panelu:

Hub wygeneruje:

• Port
• Klucz publiczny
• Token
• docker-compose dla agenta lub Plik binarny

---

7. Instalacja agenta

Agent można zainstalować jako:

• Docker – serwery z zainstalowanym Docker
• binarkę – serwery Linux
• Homebrew – macOS
• WinGet – działa tylko z systemami Windows z zainstalowanym WSL (Podsystem Windows dla systemu Linux)
• Home Assistant addon.

---

7.1 Agent przez Docker

Na monitorowanym serwerze, podaj Nazwa oraz Host / adres IP:

Następnie Skopiuj docker compose

Skopiuj wygenerowany tekst, utwórz plik docker-compose.yml na serwerze z docker, który chcesz monitorować:

mkdir agent

cd agent

nano docker-compose.yml

Uruchom:

docker-compose up -d

Następnie kliknij Dodaj system

Po chwili serwer pojawi się w panelu Beszel.

7.2 Agent przez Plik binarny

Analogicznie w panelu:

Kliknij na Plik binarny, dodaj Nazwa oraz Host / adres IP:

Kopiuj polecenie Linux

Skopiuj tekst i wprowadź polecenie na docelowym serwerze do monitorowania:

Jeśli nie masz curl na swoim systemie, zainstaluj go komendą:

sudo apt install curl -y

Skrypt zapyta czy chcesz automatyczne aktualizacje dla beszel-agent, wpisz „y” i potwierdź:

Wróć do Beszel, kliknij Dodaj system

Po chwili system się podłączy do Beszel

Aby podejrzeć szczegóły systemu, kliknij na któryś z nich, ujrzysz więcej szczegółów na temat tego systemu:

Każda z opcji Agent przez Plik binarny czy Agent przez docker, nieznacznie się różni:

Agent przez Plik binarny monitoruje:

• Użycie procesora – Średnie wykorzystanie CPU w całym systemie
• Użycie pamięci – Dokładne wykorzystanie w zarejestrowanym czasie
• Użycie dysku – Użycie partycji głównej
• Dyks I/O – Przepustowość głównego systemu plików
• Przepustowość – Ruch sieciowy interfejsów publicznych
• Średnie obciążenie – Średnie obciążenie systemu w czasie
• Temperatura – Temperatury czujników systemowych.
• Usługi systemd

Agent przez docker monitoruje:

• Użycie procesora – Średnie wykorzystanie CPU w całym systemie
• Użycie CPU przez Docker – Średnie wykorzystanie CPU przez kontenery
• Użycie pamięci – Dokładne wykorzystanie w zarejestrowanym czasie
• Użycie pamięci przez Docker – Użycie pamięci przez kontenery Docker
• Użycie dysku – Użycie partycji głównej
• Dyks I/O – Przepustowość głównego systemu plików
• Przepustowość – Ruch sieciowy interfejsów publicznych
• Sieć Docker I/O – Ruch sieciowy kontenerów Docker
• Średnie obciążenie – Średnie obciążenie systemu w czasie
• Temperatura – Temperatury czujników systemowych
• Wszystkie kontenery

---

8. Konfiguracja alertów

Panel, kliknij na dzwoneczek:

Można ustawić alerty dla:

• Status
• Użycie procesora
• Użycie Pamięci
• Użycie dysku
• Przepustowość
• Użycie GPU
• Temperatura
• Średnie obciążenie 1 min
• Średnie obciążenie 5 min
• Średnie obciążenie 15 min
• Bateria

Przykład:

CPU > 90% przez 5 minut

---

9. Backup danych

Beszel obsługuje backup:

• lokalny
• S3

Konfiguracja:

Użytkownik → Kopie zapasowe

Zostaniesz przekierowany do strony logowania PocketBase, zaloguj się ustawionym mailem i hasłem:

Następnie kliknij na skrzyżowane klucze / Backups i kliknij Initialize new backup

Wpisz nazwę backupu, koniecznie dodaj .zip ! i kliknij Start backup

Po kliknięciu Restore odtworzysz backup:

System może wykonywać automatyczne kopie danych.

---

10. Zastosowania Beszel

10.1 Homelab

Monitorowanie:

• Proxmox
• NAS
• Raspberry Pi
• kontenery

---

10.2 Serwery VPS

Monitoring:

• CPU
• RAM
• ruchu sieci
• aplikacji.

---

10.3 DevOps

Beszel może służyć jako prosty monitoring dla:

• środowisk testowych
• staging
• małych klastrów.

---

11. Zalety Beszel

Bardzo lekki

Nie wymaga:

• Prometheus
• bazy danych
• zewnętrznych komponentów.

Szybka instalacja

Można uruchomić w kilka minut.

Prosty panel

Interfejs jest czytelny i łatwy w użyciu.

Monitoring kontenerów

Świetna integracja z Docker.

---

12. Wady Beszel

• mniej funkcji niż duże systemy
• krótsza historia danych
• brak zaawansowanej analityki
• młody projekt.

---

13. Porównanie z innymi systemami

System	Złożoność	Zużycie zasobów	Funkcje
Beszel	bardzo proste	bardzo małe	podstawowe
Prometheus + Grafana	bardzo duża	duże	ogromne
Zabbix	średnia	średnie	duże

---

14. Podsumowanie

Beszel to nowoczesny, lekki system monitoringu serwerów przeznaczony głównie dla:

• administratorów
• DevOps
• użytkowników homelab
• osób korzystających z self-hostingu.

Największą zaletą Beszel jest prosta instalacja, niewielkie zużycie zasobów oraz czytelny panel webowy, dzięki czemu monitoring infrastruktury można uruchomić w kilka minut.