Så här konfigurerar du ett dedikerat Docker-nätverk för backendtjänster bakom en omvänd proxy

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Anslut reverse proxyn och varje HTTP-backend till ett delat, användardefinierat nätverk; håll databaserna på privata appnätverk.

Det är onödigt att publicera alla backendportar på NAS-värden när proxyn kan slå upp Compose-tjänstenamn i ett användardefinierat bryggnätverk. Ett mönster med två nätverk ger proxyn en kontrollerad väg till webbbackendtjänster, medan databaser bara är nåbara för sina respektive appar. Definiera nätverksägarskap, undvik tvetydiga alias, avgör vilka tjänster som behöver utgående åtkomst och kontrollera att värdportarna förblir stängda.

Rita upp den avsedda nåbarhetsmatrisen

Lista alla anslutningar: klient till proxy, proxy till backend, backend till databas, backend till externa API:er och administratör till underhållsändpunkter. Ange protokoll, port, DNS-namn och om vägen passerar värden.

Normalt bör endast reverse proxyn publicera portarna 80 och 443. Backendtjänster exponerar sin applikationsport för Docker-nätverket utan en värdportmappning med ports. Databaser ansluts endast till det privata appnätverket, såvida en särskild administrationsväg inte behövs.

Välj stabila, unika tjänstenamn eller nätverksalias. Docker DNS slår upp tjänster i delade, användardefinierade nätverk, men generiska alias som web kan krocka när många Compose-projekt ansluts till samma proxynätverk.

Skapa ett delat proxynätverk och ett privat appnätverk

Skapa proxynätverket en gång, markera det som externt i varje applikationsprojekt och anslut proxyn samt den avsedda backendtjänsten. Då förblir nätverkets identitet stabil när ett enskilt Compose-projekt återskapas.

Definiera ett separat standardnätverk eller namngivet privat nätverk för varje app och anslut dess backend och databas. Backend blir den kontrollerade bryggan mellan proxytrafik och privat tillstånd; proxyn bör inte anslutas till databasnätverket.

Nätverksdefinitioner i Compose dokumenterar externa nätverk och tjänsternas anslutning i Compose. Behandla ett externt nätverk som något vars livscykel hanteras utanför appstacken: vid driftsättning måste du kontrollera att det finns i stället för att anta att Compose skapar eller tar bort det.

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

Ta bort onödiga värdportar och granska utgående trafik

När proxyvägen fungerar tar du bort publicering av värdportar för backendtjänster. Deklarationen expose kan dokumentera containerporten, men den fungerar inte som en brandvägg; nätverkstillhörigheten avgör vilka containrar som kan ansluta.

Överväg internal: true endast för nätverk vars medlemmar verkligen inte behöver någon extern anslutningsväg. Backendtjänster som anropar identitetsleverantörer, webhooks, pakettjänster eller fjärr-API:er kan sluta fungera i ett nätverk som enbart är internt. Använd ett andra nätverk med utgående anslutning om programutformningen kräver det.

Skydda Docker-socketen som används för automatisk proxyupptäckt. En skrivskyddad bindmontering minskar risken för oavsiktliga skrivningar, men gör inte socketen ofarlig. En begränsad socketproxy eller statisk konfiguration ger en mindre angreppsyta.

Single board computer zimaboard2

Verifiera tjänste-DNS, portåtkomst och isolering

Från proxycontainern slår du upp backendtjänstens namn och anropar dess hälsokontroll på containerporten. Kontrollera från en orelaterad container att namnet eller anslutningen inte är tillgänglig, såvida containern inte avsiktligt ingår i proxynätverket.

Skanna NAS-värden från en annan enhet i det lokala nätverket och bekräfta att endast proxyportarna är öppna. Testa sedan TLS, vidarebefordrade headers, WebSocket-uppgraderingar, stora uppladdningar och programomdirigeringar via det offentliga värdnamnet. Översikten över hemtjänstens tjänster bör ange proxynätverket som en del av hemtjänstens tjänsteöversikt.

Återställ den tidigare portmappningen endast för felsökning, inte som ett permanent dolt beroende. Avbryt om proxyn behöver direktåtkomst till databasen, alias pekar på fel projekt eller om borttagning av en värdport bryter en odokumenterad integration.

Vanliga frågor 

Är ett externt Docker-nätverk automatiskt säkrare?

Nej. External beskriver livscykelägarskap, inte säkerhet. Alla anslutna containrar kan i allmänhet kommunicera i enlighet med nätverksdrivrutinen och värdens brandväggsbeteende.

Bör backendtjänster fortfarande ange expose?

Det är valfritt för anslutning inom ett användardefinierat nätverk, men kan dokumentera vilken containerport som är avsedd. Det publicerar inte porten till värden.

Kan proxynätverket markeras som internt?

Bara om proxyns och routningens utformning fortfarande har de nödvändiga inkommande och utgående anslutningsvägarna. Ett internt nätverk blockerar normal extern anslutning för anslutna containrar och kan störa certifikat- eller identitetsflöden.

Varför använda tjänstenamn i stället för container-IP-adresser?

Containeradresser kan ändras när containrar återskapas. Dockers tjänsteupptäckt ger ett stabilt namn inom det delade nätverket, vilket gör proxykonfigurationen mer hållbar.

återställ den sparade baslinjen, tillämpa den godkända konfigurationen en gång, upprepa den ursprungliga produktionsliknande arbetsbelastningen, verifiera den utlovade framgångssignalen och genomför sedan den dokumenterade återställningen. Stäng inte ändringen förrän loggar, tidsåtgång, behörigheter, kapacitet och återställda utdata uppfyller acceptanskriterierna.

Support och tips

Mer att läsa

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.