So richten Sie ein dediziertes Docker-Netzwerk für Reverse-Proxy-Backends ein

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Verbinde den Reverse-Proxy und jedes HTTP-Backend mit einem gemeinsamen benutzerdefinierten Netzwerk; belasse Datenbanken in privaten App-Netzwerken.

Alle Backend-Ports auf dem NAS-Host zu veröffentlichen, ist unnötig, wenn der Proxy Compose-Dienstnamen in einer benutzerdefinierten Bridge auflösen kann. Mit einem Muster aus zwei Netzwerken erhält der Proxy einen kontrollierten Zugriff auf Web-Backends, während Datenbanken nur von ihren Anwendungen erreichbar bleiben. Lege fest, wem die Netzwerke gehören, vermeide mehrdeutige Aliase, entscheide, welche Dienste ausgehenden Zugriff benötigen, und überprüfe, dass die Host-Ports geschlossen bleiben.

Vorgesehene Erreichbarkeitsmatrix erstellen

Liste jede Verbindung auf: Client zum Proxy, Proxy zum Backend, Backend zur Datenbank, Backend zu externen APIs sowie Administrator zu Wartungsendpunkten. Notiere Protokoll, Port, DNS-Namen und ob der Pfad über den Host führt.

Normalerweise sollte nur der Reverse-Proxy die Ports 80 und 443 veröffentlichen. Backends stellen ihren Anwendungsport im Docker-Netzwerk bereit, ohne eine Host-Zuordnung über ports. Datenbanken werden nur mit dem privaten App-Netzwerk verbunden, sofern kein expliziter Administrationszugriff erforderlich ist.

Wähle stabile, eindeutige Dienstnamen oder Netzwerk-Aliase. Docker DNS löst Dienste in gemeinsamen benutzerdefinierten Netzwerken auf, doch allgemeine Aliase wie web können kollidieren, wenn viele Compose-Projekte mit demselben Proxy-Netzwerk verbunden sind.

Gemeinsames Proxy-Netzwerk und privates App-Netzwerk erstellen

Erstelle das Proxy-Netzwerk einmal, kennzeichne es in jedem Anwendungsprojekt als extern und verbinde den Proxy sowie das vorgesehene Backend damit. So bleibt die Netzwerkidentität stabil, wenn ein einzelnes Compose-Projekt neu erstellt wird.

Definiere für jede App ein separates Standard- oder benanntes privates Netzwerk und verbinde Backend und Datenbank damit. Das Backend bildet so die kontrollierte Brücke zwischen Proxy-Datenverkehr und privaten Daten; der Proxy sollte dem Datenbanknetzwerk nicht beitreten.

Die Compose-Netzwerkdefinitionen dokumentieren externe Netzwerke und die Netzwerkanbindung von Diensten in Compose. Behandle ein externes Netzwerk so, als läge sein Lebenszyklus außerhalb des App-Stacks: Bei der Bereitstellung muss geprüft werden, ob es vorhanden ist, statt davon auszugehen, dass Compose es erstellt oder löscht.

networks:
  proxy:
    external: true
  app-private:
    internal: true
services:
  web:
    networks: [proxy, app-private]
  db:
    networks: [app-private]

Unnötige Host-Ports entfernen und ausgehenden Datenverkehr überprüfen

Sobald die Proxy-Route funktioniert, entferne die Veröffentlichungen der Backend-Ports auf dem Host. Die Deklaration expose kann den Container-Port dokumentieren, ist aber keine Firewall; welche Container eine Verbindung herstellen können, hängt von der Netzwerkzugehörigkeit ab.

Verwende internal: true nur für Netzwerke, deren Mitglieder tatsächlich keine externe Route benötigen. Backends, die Identitätsanbieter, Webhooks, Paketdienste oder Remote-APIs aufrufen, können in einem rein internen Netzwerk ausfallen. Verwende ein zweites Netzwerk mit Egress-Möglichkeit, wenn das Anwendungsdesign dies erfordert.

Schütze den Docker-Socket, der für die automatische Proxy-Erkennung verwendet wird. Ein schreibgeschützter Bind-Mount verringert versehentliche Schreibzugriffe, macht den Socket aber nicht harmlos; ein eingeschränkter Socket-Proxy oder eine statische Konfiguration bietet eine kleinere Angriffsfläche.

Single board computer zimaboard2

Dienst-DNS, Portfreigabe und Isolation überprüfen

Löse im Proxy-Container den Backend-Dienstnamen auf und rufe dessen Health-Endpunkt über den Container-Port ab. Bestätige in einem nicht zugehörigen Container, dass der Name oder die Verbindung nicht verfügbar ist, es sei denn, dieser Container befindet sich absichtlich im Proxy-Netzwerk.

Überprüfe den NAS-Host von einem anderen Gerät im LAN aus und bestätige, dass nur die Proxy-Ports offen sind. Teste anschließend TLS, weitergeleitete Header, WebSocket-Upgrades, große Uploads und Anwendungsweiterleitungen über den öffentlichen Hostnamen. Die Serviceübersicht des Heimservers sollte das Proxy-Netzwerk als Teil der Serviceübersicht des Heimservers aufführen.

Stelle die vorherige Portzuordnung nur zu Diagnosezwecken wieder her, nicht als dauerhafte, versteckte Abhängigkeit. Brich ab, wenn der Proxy direkten Datenbankzugriff benötigt, Aliase zum falschen Projekt führen oder das Entfernen eines Host-Ports eine undokumentierte Integration unterbricht.

FAQ 

Ist ein externes Docker-Netzwerk automatisch sicherer?

Nein. „External“ beschreibt die Zuständigkeit für den Lebenszyklus, nicht die Sicherheit. Jeder verbundene Container kann grundsätzlich entsprechend dem Verhalten des Netzwerktreibers und der Host-Firewall kommunizieren.

Sollten Backend-Dienste weiterhin „expose“ deklarieren?

Für die Konnektivität in einem benutzerdefinierten Netzwerk ist das optional, kann aber den vorgesehenen Container-Port dokumentieren. Der Port wird dadurch nicht auf dem Host freigegeben.

Kann das Proxy-Netzwerk als intern markiert werden?

Nur wenn das Proxy- und Routing-Design weiterhin über die erforderlichen eingehenden und ausgehenden Verbindungen verfügt. Ein internes Netzwerk blockiert die normale externe Konnektivität für verbundene Container und kann Zertifikats- oder Identitätsabläufe beeinträchtigen.

Warum Dienstnamen statt Container-IP-Adressen verwenden?

Containeradressen können sich nach einer Neuerstellung ändern. Die Diensterkennung von Docker stellt innerhalb des gemeinsamen Netzwerks einen stabilen Namen bereit, wodurch die Proxy-Konfiguration robuster wird.

Stelle die gespeicherte Ausgangsbasis wieder her, wende die genehmigte Konfiguration einmalig an, wiederhole die ursprüngliche produktionsnahe Auslastung, überprüfe das zugesagte Erfolgssignal und führe anschließend das dokumentierte Rollback durch. Schließe die Änderung erst ab, wenn Protokolle, Zeitverhalten, Berechtigungen, Kapazität und wiederhergestellte Ausgabe alle Abnahmekriterien erfüllen.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.