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 prona instalaci Beszel agentaAgenta na(verze dalšís RPi/serveryTokenem)

1. PřípravaZískání adresářůTokenu (Na hlavním Beszel Hubu)

  1. Otevři webové rozhraní Beszel Hubu.

  2. Klikni na tlačítko Add System.

  3. Do pole Name napiš název nového RPi (např. Nove-RPi).

  4. Do pole Host napiš IP adresu tohoto nového RPi.

  5. Klikni na Add (nebo Save).

  6. V seznamu systémů uvidíš u nově přidaného záznamu sloupec Token. Tento kód si zkopíruj.

2. Příprava adresáře (Na novém RPi/serveruRPi přes SSH)

I když nepoužíváme soubor s klíčem, agent potřebuje datovou složku pro svou vnitřní databázi.

# 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.3. ZískejNasazení klíčev zPortaineru hlavního Beszel serveru

(Na hlavnímnovém serveru (192.168.54.4):

RPi)

  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íčemPortainer 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:zařízení.

  1. Otevři Portainer (http://IP_NOVÉHO_RPI:9000)

  2. Jdi do Stacks →-> Add stack.

  3. Název:

    Název: beszel-agent-onlyagent.

  4. Zkopíruj

    Vlož následující YAML zkód:

    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
    privileged: true
    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=PORT=45876
      - TZ=Europe/PragueKEY=ZDE_VLOZ_TOKEN_Z_KROKU_1

  1. V řádku - KEY_FILE=/app/data/keyKEY= -nahraď DOCKER_STATS_TIMEOUT=5stext privileged:ZDE_VLOZ_TOKEN_Z_KROKU_1 truetím tokenem, který jsi zkopíroval v prvním kroku.

  2. Klikni na Deploy the stack.

Ověření funkčnosti

  1. V Portaineru zkontroluj, že kontejner beszel-agent běží (Status: running).

  2. Na hlavním Beszel Hubu se u nového systému změní stav na Online (zelená kontrolka) a začnou se načítat data.

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

 

Funkční pro LINUX server Ubuntu:

Ve stack yml kod portaineru:


version: "3.9"

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    
    environment:
      # URL tvého Beszel hubu – upraveno DLE TVÝCH DAT
      - HUB_URL=http://192.168.54.4:8090
      # Váš SSH Klíč
      - KEY=ssh-ed25519 AAAAC3zadfgfdGTFGHJ1lZDI1NTE5AAAIFtwhzb4bOxyIlB+ko1suJgRsuQlJO+6W9Jnp
      # Váš Token
      - TOKEN=3fde-731f5e2ddfdsfsdf-2aea-113c6a
      # Volitelné: vlastní název stroje
      - NAME=Ubuntu-Server
      # Port agenta (nechte)
      - PORT=45876
      # *** KLÍČOVÉ PŘIDÁNÍ: POUŽÍT DOCKER SOCKET ***
      - DOCKER_HOST=unix:///var/run/docker.sock 
      
    volumes:
      # *** KLÍČOVÉ PŘIDÁNÍ: NAMONTOVÁNÍ DOCKER SOCKETU ***
      - /var/run/docker.sock:/var/run/docker.sock
      # Můžete přidat i volume pro data agenta, pokud je požadováno:
      # - agent_data:/var/lib/beszel-agent
      
    ports:
      # Port SSH serveru BESZEL (pokud ho používáte)
      - "45876:45876"
      
    networks:
      - beszel-net

networks:
  beszel-net:
    driver: bridge

 

Back to top