Docker Guard Hilfe

Agent installieren
EN DE

Inhalt

Übersicht Erste Schritte Agent installieren Fehlerbehebung FAQ
Docker-Host
Docker Guard Agent installieren

Der Docker Guard Agent ist ein schlanker Container, der eine schreibgeschützte HTTP-API zur Überwachung deines Docker-Hosts bereitstellt. Er läuft neben deinen bestehenden Containern und liest vom Docker-Socket — kein Portforwarding oder externe Dienste nötig.

Voraussetzungen

  • Ein Host mit Docker Engine (Linux, Synology DSM 7+, TrueNAS SCALE, Unraid, …).
  • Zugriff auf den Docker-Socket (/var/run/docker.sock).
  • Ein erreichbarer Port im lokalen Netz (Standard: 18080).
  • Die Docker Guard iOS-App installiert.

1) API-Schlüssel generieren

Wähle eine lange, zufällige Zeichenkette. Der Agent akzeptiert ausschließlich Anfragen mit passendem X-API-Key Header.

openssl rand -hex 32

2) Mit docker compose starten

Speichere folgende Datei als docker-compose.yml und führe docker compose up -d aus:

services:
  docker-guard-agent:
    container_name: docker-guard-agent
    image: registry.git.no-logs.de/hans/docker-guard-agent-images:latest
    pull_policy: always
    restart: unless-stopped
    ports:
      - '18080:8080'
    environment:
      - DOCKERGUARD_API_KEY=<dein-api-key>
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - docker-guard-data:/data

volumes:
  docker-guard-data:
Wichtig:
  • Der Docker-Socket ist schreibgeschützt eingebunden. Entferne :ro nur, wenn du Start/Stop/Restart-Aktionen aus der App nutzen willst (Control Pack in der App erforderlich).
  • Ersetze <dein-api-key> mit dem Wert aus Schritt 1.
  • Ändere den Host-Port (18080), falls er bereits belegt ist.

3) Agent prüfen

curl -k https://<host-ip>:18080/health
Erwartetes Ergebnis: 
{"status":"ok","version":"0.1.0"}

4) iOS-App konfigurieren

  1. Docker Guard öffnen und zu Einstellungen wechseln.
  2. Unter Agent-Verbindung eintragen:
    • Agent-URL: https://<host-ip>:18080
    • API-Schlüssel: der Wert aus Schritt 1
  3. Verbinden tippen.
Das Dashboard zeigt nun deine Container, Images, Volumes, Netzwerke und Host-Infos.
Weiter: Fehlerbehebung
docker-guard.no-logs.de