Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

haproxy-ui

Weboberfläche für haproxy-unraid: HAProxy bequem im Browser konfigurieren, Statistik ansehen und optional an Home Assistant melden.

Weitere Unraid-Pakete: haproxy-unraid, certwarden-unraid

ghcr.io/sysrix/haproxy-ui:latest

Was es kann

Reiter Inhalt
Übersicht Zustand, Sitzungen, Anfragen/s, Eingänge, Backends und Server mit Status, Fehlern und Datenmenge (alle 10 s). Bearbeiten/Ansehen je Zeile führt in den Assistenten oder an die Stelle im Editor
Dienste alle Adressen als Tabelle (Zugang nur intern / nur extern / intern + extern, tls/durch, Anzahl Regeln) und der Assistent „Neue Adresse“
Dateien alle Dateien in bearbeiten/ mit Editor (Strg+S speichert), neue Listen anlegen
Änderungen Unterschied zur laufenden Konfiguration, Knöpfe Prüfen, Prüfen und übernehmen, Verwerfen, Zurück
Zertifikate Restlaufzeit aller Zertifikate, certs.conf, „Jetzt aus Cert Warden holen“
Aussehen Theme-Auswahl oben rechts: Konsole (dunkel, plastisch, Akzent Orange · Grün · Blau – Standard), Dunkel schlicht, Hell, wie das System

Assistent „Neue Adresse“ (Baukasten)

In fünf Schritten statt Konfiguration von Hand:

  1. Adresse: Vorlage wählen (Webseite, Home Assistant, Nextcloud, Jellyfin, Authentik, Oberfläche mit https, Vaultwarden, verschlüsselt durchreichen), Adresse, Zugang (nur intern / nur extern / intern + extern), Verschlüsselung (HAProxy entschlüsselt oder durchreichen)
  2. Ziel: neues Backend (ein oder mehrere Server, Reserve-Server, Lastverteilung, https zum Ziel, Gesundheitsprüfung, lange Verbindungen, Zeitlimit, X-Forwarded-Port, Host-Header, Sitzung am Server halten) oder ein vorhandenes Backend
    • Client-IP und Header: X-Forwarded-For, X-Real-IP, X-Forwarded-Proto, X-Forwarded-Host immer; dazu wählbar Forwarded (RFC 7239), Client-IP in eigenem Header (z. B. CF-Connecting-IP), PROXY-Protokoll zum Ziel (auch beim Durchreichen, z. B. Mailserver), feste Header an Ziel/Besucher setzen, hinzufügen, entfernen, Sicherheits-Header
    • Erweitert: Pfad-Präfix entfernen, gzip, Zertifikat des Ziels prüfen, SNI zum Ziel, bei Fehler anderen Server versuchen, Prüf-Intervall, max. Verbindungen, Gewicht und weitere Optionen je Server, eigene HAProxy-Zeilen für alles, was es nicht als Schalter gibt
  3. Anmeldung (nur wenn HAProxy entschlüsselt):
    • HTTP-Basic, Benutzer in HAProxy: Benutzerlisten hier in der Oberfläche, Passwörter nur als SHA-512-Hash (userlist in dienste.cfg)
    • Authentik (Anmeldeseite): HAProxy schickt an Authentik (eingebetteter Outpost, Proxy-Anbieter), Authentik reicht nach der Anmeldung an das Ziel weiter – mit LDAP/AD, SSO, Zwei-Faktor
    • HTTP-Basic, Benutzer aus Authentik: Browser-Anmeldefenster von HAProxy, geprüft von Authentik („Intercept header authentication“ am Proxy-Anbieter) – also auch LDAP/AD-Benutzer
    • Ausnahmen: von innen ohne Anmeldung, Pfade ohne Anmeldung (bei Authentik gehen diese direkt zum Ziel)
  4. Regeln: wenn Herkunft (von außen / innen / bestimmte IPs / Liste, auch verneint) und Pfad (beginnt mit / genau / beginnt nicht mit) dann sperren (403/404/429/503), umleiten, an anderes Backend, Header setzen oder entfernen – mit fertigen Bausteinen wie „Admin-Bereich nur intern“, „Nur bestimmte IPs“, „HSTS“
  5. Prüfen: Zusammenfassung in Worten, To-dos (DNS, fehlendes Zertifikat), die erzeugten Zeilen und der Unterschied – dann speichern oder gleich übernehmen

Gespeichert wird in bearbeiten/baukasten.json. Daraus schreibt haproxy-ui die Zeile in listen/dienste.map und nur die markierten Blöcke # >>> haproxy-ui: … / # <<< haproxy-ui: … in haproxy.cfg und dienste.cfg – eigene Backends und Handarbeit außerhalb bleiben unangetastet. Eine ältere haproxy.cfg ohne diese Blöcke wird beim ersten Speichern automatisch ergänzt (sichtbar unter „Änderungen“). Bestehende Adressen lassen sich mit Bearbeiten wieder im Assistenten öffnen. Von Hand geschriebene Backends aus dienste.cfg holt Übernehmen (Reiter Dienste oder Übersicht) in den Assistenten – was es nicht als Schalter gibt, landet unter „Eigene Zeilen“ bzw. „weitere Optionen“ des Servers, es geht nichts verloren; gelöschte Adressen nehmen ihre Regeln und ungenutzten Backends mit.

Braucht haproxy-unraid ab dem Stand mit Zugang extern (Image vom 12.11.2026 oder neuer).

Sicher: Die Oberfläche ändert nur bearbeiten/. Übernommen wird immer im HAProxy-Container über hap-uebernehmen – also mit Prüfung, Neuladen ohne Verbindungsabbruch und automatischem Rücksprung bei Fehlern. Oben rechts zeigt „HAProxy verbunden“, ob der HAProxy-Container Aufträge annimmt.

Nicht allein lauffähig: braucht haproxy-unraid mit demselben appdata-Ordner.

Installation in Unraid

  1. haproxy-unraid installieren und einmal starten.
  2. Vorlage holen (falls noch nicht geschehen) und in Apps › Private haproxy-ui installieren:
    mkdir -p /boot/config/plugins/community.applications/private/sysrix && curl -fsSL https://raw.githubusercontent.com/SysriX/haproxy-ui_unraid/main/templates/haproxy-ui.xml -o /boot/config/plugins/community.applications/private/sysrix/haproxy-ui.xml
  3. Netzwerk br0 (bzw. VLAN) mit fester IP. Diese IP muss in listen/intern-netze.lst von HAProxy liegen (Zugriff auf die Statistik).
  4. Aufruf: http://<IP_haproxy-ui>:8080/

Einstellungen

Feld Variable / Pfad Pflicht Bedeutung
HAProxy-Konfiguration /haproxy ja derselbe Ordner wie „Konfiguration“ bei haproxy-unraid
Passwort UI_PASS ja Anmeldung an der Oberfläche
HAProxy-Statistik HAP_URL ja z. B. http://<IP_HAProxy>:8404
Statistik-Passwort STATS_PASS ja wie bei haproxy-unraid
MQTT-Broker MQTT_HOST nein leer = keine Meldung an Home Assistant
MQTT-Port / -Benutzer / -Passwort MQTT_PORT, MQTT_USER, MQTT_PASS nein Zugang zum Broker
MQTT-Intervall MQTT_INTERVALL nein Sekunden zwischen zwei Meldungen (Standard 60)
Gerätename HA_GERAET nein bei mehreren HAProxy unterschiedlich wählen
Discovery-Präfix MQTT_PREFIX nein Standard homeassistant

Home Assistant (optional)

Mit eingetragenem MQTT-Broker legt haproxy-ui per MQTT-Discovery automatisch ein Gerät HAProxy an:

  • Erreichbar und Änderungen nicht übernommen (binary_sensor)
  • je Eingang/Backend: Status (Attribute: Bytes, 4xx/5xx, Fehler), Sitzungen, Rate, Verbindungen gesamt
  • je Zertifikat: Resttage (Attribute: Ablauf, Namen)
  • Letzter Auftrag (OK/Fehler mit Log)

Voraussetzung: MQTT-Broker (z. B. Mosquitto) und die MQTT-Integration in Home Assistant.

Sicherheit

  • Anmeldung mit Passwort, nach 5 Fehlversuchen 5 Minuten Pause
  • Zugriff nur auf die Dateien in bearbeiten/ und certs.conf
  • nur im internen Netz betreiben, nicht nach außen freigeben

Updates

Neu gebaut, sobald das offizielle Python-Image aktualisiert wird; Unraid zeigt dann „Update verfügbar“.

Hilfe

Fragen und Fehler bitte als GitHub-Issue.

Lizenz: MIT – siehe LICENSE. Python steht unter eigener Lizenz.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages