Een speciaal Docker-netwerk instellen voor backends achter een reverse proxy

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Koppel de reverse proxy en elke HTTP-backend aan één gedeeld, door de gebruiker gedefinieerd netwerk; houd databases op privénetwerken van de apps.

Elke backendpoort publiceren op de NAS-host is niet nodig wanneer de proxy Compose-servicenamen op een door de gebruiker gedefinieerde bridge kan opzoeken. Met een patroon met twee netwerken krijgt de proxy een gecontroleerde verbinding met webbackends, terwijl databases alleen bereikbaar blijven voor hun applicaties. Bepaal wie de netwerken beheert, vermijd dubbelzinnige aliassen, beslis welke services uitgaand verkeer nodig hebben en controleer of de hostpoorten gesloten blijven.

Breng de beoogde bereikbaarheid in kaart

Breng elke verbinding in kaart: client naar proxy, proxy naar backend, backend naar database, backend naar externe API's en beheerder naar onderhoudseindpunten. Noteer het protocol, de poort, de DNS-naam en of de verbinding via de host loopt.

Normaal gesproken hoort alleen de reverse proxy poorten 80 en 443 te publiceren. Backends stellen hun applicatiepoort beschikbaar op het Docker-netwerk, zonder een hosttoewijzing in ports. Databases worden alleen aan het privénetwerk van de app gekoppeld, tenzij een expliciete beheerroute nodig is.

Kies stabiele, unieke servicenamen of netwerkaliassen. Docker-DNS vertaalt servicenamen op gedeelde, door de gebruiker gedefinieerde netwerken, maar generieke aliassen zoals web kunnen conflicteren wanneer veel Compose-projecten aan hetzelfde proxynetwerk zijn gekoppeld.

Maak een gedeeld proxynetwerk en een privénetwerk voor de app

Maak het proxynetwerk één keer aan, markeer het in elk applicatieproject als extern en koppel de proxy en de beoogde backend eraan. Zo blijft de netwerkidentiteit stabiel wanneer een afzonderlijk Compose-project opnieuw wordt aangemaakt.

Definieer voor elke app een afzonderlijk standaard- of benoemd privénetwerk en koppel de backend en database daaraan. De backend wordt de gecontroleerde brug tussen proxyverkeer en privégegevens; de proxy hoort geen deel uit te maken van het databasenetwerk.

De Compose-netwerkdefinities documenteren externe netwerken en de koppeling van services in Compose. Beschouw een extern netwerk als iets waarvan de levenscyclus buiten de app-stack wordt beheerd: bij implementatie moet worden gecontroleerd of het bestaat, in plaats van aan te nemen dat Compose het zal aanmaken of verwijderen.

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

Onnodige hostpoorten verwijderen en uitgaand verkeer controleren

Nadat de proxyrouting werkt, verwijder je de publicaties van backend-hostpoorten. De expose-declaratie kan de containerpoort documenteren, maar is geen firewall; het netwerklidmaatschap bepaalt welke containers verbinding kunnen maken.

Gebruik internal: true alleen voor netwerken waarvan de leden echt geen externe route nodig hebben. Back-ends die identiteitsproviders, webhooks, pakketservices of externe API's aanroepen, werken mogelijk niet op een netwerk dat uitsluitend intern is. Gebruik een tweede netwerk met uitgaand verkeer als het applicatieontwerp dat vereist.

Beveilig de Docker-socket die wordt gebruikt voor automatische proxydetectie. Een alleen-lezen koppeling vermindert het risico op onbedoelde schrijfbewerkingen, maar maakt de socket niet onschadelijk; een socketproxy met beperkte toegang of statische configuratie biedt een kleiner aanvalsoppervlak.

Single board computer zimaboard2

Controleer servicedetectie via DNS, poortblootstelling en isolatie

Los vanuit de proxycontainer de backendservicenaam op en doe een verzoek aan het statusendpoint op de containerpoort. Controleer vanuit een niet-gerelateerde container of de naam of verbinding niet beschikbaar is, tenzij die container opzettelijk deel uitmaakt van het proxynetwerk.

Scan de NAS-host vanaf een ander apparaat op het LAN en bevestig dat alleen de proxypoorten openstaan. Test vervolgens TLS, doorgestuurde headers, WebSocket-upgrades, grote uploads en omleidingen van de toepassing via de openbare hostnaam. In het serviceoverzicht van de homeserver moet het proxynetwerk worden vastgelegd als onderdeel van het serviceoverzicht van de homeserver.

Draai de wijziging terug door de vorige poortkoppeling te herstellen, maar alleen voor diagnose, niet als permanente verborgen afhankelijkheid. Stop als de proxy rechtstreeks toegang tot de database nodig heeft, aliassen naar het verkeerde project verwijzen of het verwijderen van een hostpoort een niet-gedocumenteerde integratie verbreekt.

Veelgestelde vragen 

Is een extern Docker-netwerk automatisch veiliger?

Nee. External beschrijft het eigenaarschap van de levenscyclus, niet de beveiliging. Elke aangesloten container kan doorgaans communiceren volgens het netwerkstuurprogramma en het gedrag van de hostfirewall.

Moeten back-endservices nog steeds expose declareren?

Dit is optioneel voor connectiviteit op een door de gebruiker gedefinieerd netwerk, maar kan het beoogde containerpoortnummer documenteren. De poort wordt hierdoor niet gepubliceerd op de host.

Kan het proxynetwerk als intern worden gemarkeerd?

Alleen als het proxy- en routeringsontwerp nog steeds de vereiste inkomende en uitgaande verbindingen heeft. Een intern netwerk blokkeert de normale externe verbinding voor aangesloten containers en kan certificaat- of identiteitsstromen verstoren.

Waarom servicenamen gebruiken in plaats van container-IP-adressen?

Containeradressen kunnen veranderen nadat containers opnieuw zijn aangemaakt. De servicedetectie van Docker biedt een stabiele naam binnen het gedeelde netwerk, waardoor de proxyconfiguratie duurzamer is.

Herstel de opgeslagen basisconfiguratie, pas de goedgekeurde configuratie één keer toe, herhaal de oorspronkelijke, productieachtige werklast, controleer het beloofde succesresultaat en voer daarna de gedocumenteerde terugdraaiing uit. Sluit de wijziging pas af wanneer de logs, timing, machtigingen, capaciteit en herstelde uitvoer allemaal aan de acceptatiecriteria voldoen.

Ondersteuning en tips

Meer om te lezen

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.