HAProxy 3.4 LTS (offizielles Image haproxy:3.4-alpine) als zentraler Eingang für außen und innen – vorbereitet für Unraid.
Weitere Unraid-Pakete: haproxy-ui, certwarden-unraid
ghcr.io/sysrix/haproxy-unraid:latest
- TLS-Ende mit eigenen Zertifikaten oder verschlüsselt durchreichen – je Dienst über den Namen (SNI)
- intern / extern / alle: Dienste nur aus internen Netzen, nur von außen oder von beiden Seiten erreichbar
- Schutzregeln mit benannten Ablehnungsgründen: Scanner-Pfade, Passwort-Raten, unbekannte Namen, Sperrliste, automatische Sperre für 15 Minuten
- Sicheres Übernehmen: jede Änderung wird geprüft, ohne Verbindungsabbruch neu geladen und springt bei Fehlern automatisch zurück
- Zertifikate aus Cert Warden (optional), stündlich abgeholt, neu geladen nur bei Änderung
- Statistik und Prometheus an Port 8404 (nur interne Netze)
- JSON-Zugriffslogs per Syslog, z. B. an einen Home-Assistant-Zugriffsmonitor
- Weboberfläche dazu: haproxy-ui (optional)
Läuft allein; Cert Warden und haproxy-ui sind optional.
- Vorlage holen (einmal in der Unraid-Konsole), danach in Apps › Private
haproxy-unraidinstallieren:mkdir -p /boot/config/plugins/community.applications/private/sysrix && curl -fsSL https://raw.githubusercontent.com/SysriX/haproxy_unraid/main/templates/haproxy-unraid.xml -o /boot/config/plugins/community.applications/private/sysrix/haproxy-unraid.xml - Netzwerk
br0(bzw. das VLAN der Firewall) und eine feste IP wählen. Keine Portfreigaben nötig; die Firewall leitet WAN 80/443 auf diese IP. - Variablen ausfüllen (siehe unten) und starten. Beim ersten Start wird die Vorlage nach
appdata/haproxy/kopiert.
| Feld | Variable / Pfad | Pflicht | Bedeutung |
|---|---|---|---|
| Konfiguration | /usr/local/etc/haproxy |
ja | appdata-Ordner. Unraid ohne Cache: Plattenpfad wie /mnt/disk1/appdata/haproxy |
| Statistik-Passwort | STATS_PASS |
ja | Benutzer admin, Port 8404 |
| Cert Warden IP | CW_IP |
nein | feste IP von certwarden-unraid; leer = ohne Cert Warden |
| Cert Warden Name | CW_HOST |
nein | Adresse von Cert Warden selbst (z. B. certwarden.example.de), nicht die Zertifikate der Dienste – die stehen in certs.conf |
| Home Assistant Syslog | HA_SYSLOG |
nein | IP:Port (UDP) für JSON-Logs; 127.0.0.1:5514 = aus |
| Zertifikats-Intervall | CERT_INTERVALL |
nein | Sekunden zwischen zwei Abrufen (Standard 3600) |
| Cert Warden ohne Prüfung | CW_UNSICHER |
nein | 1 = Zertifikat von Cert Warden nicht prüfen (nur am Anfang) |
| Weboberfläche zulassen | UI_WAECHTER |
nein | 1 = Aufträge aus haproxy-ui ausführen, 0 = aus |
| Ordner / Datei | Inhalt |
|---|---|
bearbeiten/ |
hier ändern: haproxy.cfg, dienste.cfg (Backends), listen/dienste.map, listen/*.lst |
aktiv/ |
läuft gerade – nicht von Hand ändern |
vorher/ |
vorige Fassung für den Rücksprung |
certs/ |
Zertifikate (<name>.pem = Schlüssel + Zertifikat + Kette) |
certs.conf |
welche Zertifikate aus Cert Warden geholt werden |
bearbeiten/listen/dienste.map, je Zeile:
<name> <backend>:<zugang>:<modus>
nextcloud.example.de be_nextcloud:alle:tls
unraid.example.de be_unraid:intern:tls
mail.example.de be_mail:alle:durch
- Zugang
alle= außen und innen,intern= nur auslisten/intern-netze.lst,extern= nur von außen - Modus
tls= HAProxy beendet TLS (Backendmode http),durch= verschlüsselt durchreichen (Backendmode tcp)
Das Backend dazu kommt in bearbeiten/dienste.cfg.
Bequemer geht es mit dem Assistenten in haproxy-ui: Adresse, Zugang, Backend und Regeln zusammenklicken. Er schreibt nur in die markierten Blöcke >>> haproxy-ui … <<< haproxy-ui in haproxy.cfg und dienste.cfg.
- Mit Cert Warden: in
certs.confje Zeile<name-in-cert-warden> <zertifikat-api-key>.<schluessel-api-key>. - Ohne Cert Warden: eigene
.pem(Schlüssel + Zertifikat + Kette) nachcerts/legen, dannhap-uebernehmen.
Beliebig viele Zertifikate und Domains: je Zertifikat eine Zeile in certs.conf, z. B.
mail <key>.<key> # mail.deinedomain.de
cloud <key>.<key> # cloud.andere-domain.de
web <key>.<key> # deinedomain.de + www.deinedomain.de
Daraus werden certs/mail.pem, certs/cloud.pem, certs/web.pem. HAProxy lädt den ganzen Ordner und wählt je Anfrage das Zertifikat, das zum angefragten Namen (SNI) passt – egal zu welcher Domain. Wildcards wie *.deinedomain.de (nur per DNS-01) decken alle Subdomains mit einer Zeile ab. Passt kein Zertifikat, liefert HAProxy das Ersatz-Zertifikat 000-ersatz.pem.
| Befehl | Wirkung |
|---|---|
docker exec haproxy-unraid hap-uebernehmen |
bearbeiten/ prüfen, übernehmen, ohne Abbruch neu laden, bei Fehler zurück |
docker exec haproxy-unraid hap-uebernehmen --pruefen |
nur prüfen |
docker exec haproxy-unraid hap-uebernehmen --zurueck |
vorige Konfiguration |
docker exec haproxy-unraid hap-zertifikate |
Zertifikate jetzt aus Cert Warden holen |
Bequemer geht es mit der Weboberfläche haproxy-ui.
| Port | Zweck |
|---|---|
| 80 | HTTP: Let's-Encrypt-Prüfung an Cert Warden, sonst Umleitung auf https |
| 443 | HTTPS: Dienste nach Name |
| 8404 | Statistik (/) und Prometheus (/metrics), nur interne Netze |
Das Image wird automatisch neu gebaut, sobald das offizielle HAProxy-Image aktualisiert wird. Unraid zeigt dann „Update verfügbar“. Tags: latest, die HAProxy-Version (z. B. 3.4.1) und Version-Datum.
Fragen und Fehler bitte als GitHub-Issue.
Lizenz: MIT – siehe LICENSE. HAProxy steht unter eigener Lizenz.