Skip to main content

Podrobný návod na instalaci Beszel na Raspberry Pi

1. Příprava adresářů a souborů

Nejprve se připoj na své Raspberry Pi přes SSH a vytvoř potřebné adresáře:

# Vytvoření hlavního adresáře pro Beszel
sudo mkdir -p /opt/beszel

# Vytvoření podadresářů
sudo mkdir -p /opt/beszel/data
sudo mkdir -p /opt/beszel/agent

# Nastavení oprávnění
sudo chown -R $USER:$USER /opt/beszel
sudo chmod -R 755 /opt/beszel

2. Instalace přes Portainer Stack

  1. Otevři Portainer ve webovém prohlížeči (obvykle http://IP_ADRESA:9000)
  2. Přejdi na Stacks v levém menu
  3. Klikni na "Add stack"
  4. Zadej název stacku: beszel-monitoring
  5. Zkopíruj YAML kód z artefaktu výše do editoru
  6. Klikni na "Deploy the stack"
version: '3.8'

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    ports:
      - "8090:8090"
    volumes:
      - /opt/beszel/data:/beszel_data
    environment:
      - TZ=Europe/Prague
    networks:
      - beszel_network

  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /:/host:ro
      - /opt/beszel/agent:/app/data
    environment:
      - BESZEL_AGENT_HOST=0.0.0.0
      - BESZEL_AGENT_PORT=45876
      - TZ=Europe/Prague
      - KEY_FILE=/app/data/key
    privileged: true

networks:
  beszel_network:
    driver: bridge

3. Konfigurace po instalaci

Po úspěšném nasazení:

  1. Otevři webové rozhraní Beszel: http://IP_RASPBERRY_PI:8090
  2. Při prvním spuštění si vytvoř admin účet
  3. Přidej své Raspberry Pi jako agent:
    • Hostname/IP: IP adresa tvého Raspberry Pi
    • Port: 45876
    • SSL: vypni (pokud nepoužíváš HTTPS)

4. Důležité poznámky pro Raspberry Pi

  • Architektura: Docker image podporuje ARM64 architekturu pro RPi 4/5
  • Výkon: Beszel je optimalizován pro nízkou spotřebu, ideální pro RPi
  • Port 45876: Ujisti se, že je port otevřený v firewallu
  • Privileged mode: Agent potřebuje privilegované oprávnění pro monitoring systému

5. Monitorované metriky

Beszel bude sledovat:

  • CPU využití a teplotu
  • RAM a swap využití
  • Diskové úložiště
  • Síťový provoz
  • Docker kontejnery
  • Systémové procesy

6. Údržba

# Kontrola logů
docker logs beszel
docker logs beszel-agent

# Restart služeb
docker restart beszel beszel-agent

# Aktualizace
docker-compose pull && docker-compose up -d

Beszel je výborná volba pro monitoring Raspberry Pi, protože má minimální nároky na systém a poskytuje přehledné webové rozhraní!

7. Instalace klienta Bezsel Agent

Návod pro instalaci Beszel agenta na další RPi/servery

1. Příprava adresářů na novém RPi/serveru

# SSH na nové Raspberry Pi nebo server

# Vytvoření adresáře pro agent
sudo mkdir -p /opt/beszel-agent/data

# Nastavení oprávnění
sudo chown -R $USER:$USER /opt/beszel-agent
sudo chmod -R 755 /opt/beszel-agent

2. Získej klíče z hlavního Beszel serveru

Na hlavním serveru (192.168.54.4):

  1. Otevři Beszel webové rozhraní
  2. Settings → SSH Keys
  3. Generate new key pair (nebo použij stávající)
  4. Zkopíruj PRIVÁTNÍ klíč

3. Vytvoř soubor s klíčem na novém RPi

# Na novém RPi vytvoř soubor s privátním klíčem
sudo nano /opt/beszel-agent/data/key

# Vlož PRIVÁTNÍ klíč (celý, včetně BEGIN/END řádků)
# -----BEGIN OPENSSH PRIVATE KEY-----
# ... klíč ...
# -----END OPENSSH PRIVATE KEY-----

# Nastav správná oprávnění
sudo chmod 600 /opt/beszel-agent/data/key
sudo chown 1000:1000 /opt/beszel-agent/data/key

4. Nasaď agent stack v Portaineru

Na novém RPi:

  1. Otevři Portainer (http://IP_NOVÉHO_RPI:9000)
  2. Stacks → Add stack
  3. Název: beszel-agent-only
  4. Zkopíruj YAML z artefaktu výše
  5. Deploy stack
version: '3.8'

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /:/host:ro
      - /opt/beszel-agent/data:/app/data
    environment:
      - BESZEL_AGENT_HOST=0.0.0.0
      - BESZEL_AGENT_PORT=45876
      - TZ=Europe/Prague
      - KEY_FILE=/app/data/key
      - DOCKER_STATS_TIMEOUT=5s
    privileged: true

 

5. Zkontroluj, že agent běží

# Z hlavního serveru zkus:
ssh -p 45876 root@IP_TOHOTO_RPI5

# Nebo test portu:
telnet IP_TOHOTO_RPI5 45876

 

 

 

 

No comments to display

Back to top