Gluetun WebUI - grafische Oberfläche zur Gluetun-Verwaltung

≈ 2 min
sicherheitnetzwerkdocker

Gluetun WebUI - grafische Oberfläche zur Gluetun-Verwaltung

Die Gluetun WebUI ergänzt den Gluetun VPN-Container um eine browserbasierte Oberfläche, über die Verbindungsstatus, Serverauswahl und Kill-Switch-Zustand überwacht werden können.

Was ist die Gluetun WebUI?

Gluetun selbst bringt eine eingebaute HTTP-Control-API mit, über die sich Verbindungsparameter abfragen und VPN-Server wechseln lassen. Die WebUI visualisiert diese API in einer übersichtlichen Browser-Oberfläche: aktuell verbundener Server, zugewiesene IP, Protokoll, Verbindungszeit und die Möglichkeit, den VPN-Tunnel neu zu starten oder den Server zu wechseln — alles per Klick statt per curl-Kommando. Das Tool ist besonders nützlich in Homelab-Setups, wo Gluetun zentral mehrere Container absichert.

Voraussetzungen

  • Docker 20.10+ / Docker Compose
  • Laufender Gluetun-Container mit aktivierter Control-API (Port 8000)

Compose-Beispiel

services:
  gluetun:
    image: qmcgaw/gluetun:latest
    container_name: gluetun
    restart: unless-stopped
    cap_add:
      - NET_ADMIN
    ports:
      - "8000:8000"
      - "1883:1883"
    environment:
      - VPN_SERVICE_PROVIDER=mullvad
      - VPN_TYPE=wireguard
      - WIREGUARD_PRIVATE_KEY=deinPrivaterKey
      - HTTP_CONTROL_SERVER_ADDRESS=:8000

  gluetun-webui:
    image: ghcr.io/0x2142/gluetun-webui:latest
    container_name: gluetun-webui
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - GLUETUN_API_URL=http://gluetun:8000

Hinweise

  • Control-API aktivieren: Die Gluetun-API muss explizit über HTTP_CONTROL_SERVER_ADDRESS=:8000 aktiviert werden; standardmäßig ist sie nicht gebunden.
  • Netzwerk-Namespace: Die WebUI darf nicht im Netzwerk-Namespace von Gluetun laufen — sie muss Gluetun über dessen Container-Namen im Docker-Netzwerk erreichen.
  • Serverauswahl per API: Über die API lässt sich der VPN-Server zur Laufzeit wechseln, ohne den Container neu starten zu müssen.
  • Kombination mit Portainer: Wer Portainer einsetzt, kann den Gluetun-Status alternativ über dessen Container-Logs überwachen; die WebUI bietet aber eine strukturiertere Ansicht.