Files
skills/public/containers-container-networking.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

685 lines
29 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>containers-container-networking</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/containers-container-networking.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/containers-container-networking">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/containers-container-networking.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>containers-container-networking</h1><p class="lede">Configuring container network connectivity</p><h1>Container Networking</h1>
<p><strong>Scope</strong>: Bridge/host/overlay networks, service discovery, port mapping, DNS <strong>Lines</strong>: ~280 <strong>Last Updated</strong>: 2025-10-18</p>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Configuring container network connectivity</li><li>Debugging inter-container communication</li><li>Implementing service discovery</li><li>Isolating services with custom networks</li><li>Choosing network drivers (bridge/host/overlay)</li><li>Troubleshooting DNS resolution</li><li>Optimizing network performance</li><li>Setting up multi-host networking</li></ul>
<h2>Core Concepts</h2>
<h3>Docker Networking Fundamentals</h3>
<p><strong>Network drivers</strong>: Docker supports multiple network types.</p>
<p><strong>Key properties</strong>:</p>
<ul><li><strong>Isolated</strong>: Each network provides isolation</li><li><strong>DNS-based discovery</strong>: Containers resolve via service names</li><li><strong>Software-defined</strong>: Networks created/destroyed dynamically</li><li><strong>Driver-based</strong>: Different drivers for different use cases</li><li><strong>Pluggable</strong>: Custom network drivers via plugins</li></ul>
<p><strong>Default behavior</strong>:</p>
<pre><code class="lang-bash"># Containers on default bridge network can communicate
docker run -d --name web nginx
docker run -d --name api node
# &#x27;web&#x27; and &#x27;api&#x27; can reach each other via IP, not name</code></pre>
<hr>
<h2>Network Drivers</h2>
<h3>Bridge (Default for Single Host)</h3>
<p><strong>Purpose</strong>: Isolated network on single host.</p>
<p><strong>Characteristics</strong>:</p>
<ul><li><strong>Default driver</strong>: Used if no network specified</li><li><strong>DNS resolution</strong>: Custom bridges support name resolution</li><li><strong>Isolation</strong>: Containers on different bridges can&#x27;t communicate</li><li><strong>Port mapping</strong>: Required to expose to host</li></ul>
<p><strong>Create bridge network</strong>:</p>
<pre><code class="lang-bash">docker network create mynetwork
docker run -d --name web --network mynetwork nginx
docker run -d --name api --network mynetwork node
# &#x27;web&#x27; can reach &#x27;api&#x27; via hostname
docker exec web curl http://api:3000</code></pre>
<p><strong>Bridge vs default bridge</strong>:</p>
<pre><code class="lang-bash"># Default bridge (docker0)
docker run -d --name web nginx
# No automatic DNS, use IP addresses
# Custom bridge
docker network create mybridge
docker run -d --name web --network mybridge nginx
# DNS works, can use container names</code></pre>
<p><strong>docker-compose.yml</strong> (automatic custom bridge):</p>
<pre><code class="lang-yaml">services:
web:
image: nginx
api:
image: node
# Docker Compose creates custom bridge automatically
# Services resolve each other by name</code></pre>
<h3>Host Network</h3>
<p><strong>Purpose</strong>: Use host&#x27;s network directly (no isolation).</p>
<p><strong>Characteristics</strong>:</p>
<ul><li><strong>No isolation</strong>: Container shares host network stack</li><li><strong>No port mapping</strong>: Container binds directly to host ports</li><li><strong>Performance</strong>: Faster (no NAT overhead)</li><li><strong>Use cases</strong>: Performance-critical apps, network monitoring</li></ul>
<p><strong>Run with host network</strong>:</p>
<pre><code class="lang-bash">docker run -d --network host nginx
# Nginx binds to host&#x27;s port 80 directly
# No -p flag needed</code></pre>
<p><strong>Trade-offs</strong>:</p>
<pre><code>Pros:
- Highest performance (no NAT)
- Direct access to host network interfaces
- Lower latency
Cons:
- No network isolation
- Port conflicts between containers
- Linux only (not Mac/Windows)</code></pre>
<p><strong>docker-compose.yml</strong>:</p>
<pre><code class="lang-yaml">services:
monitor:
image: netdata/netdata
network_mode: host # Use host network</code></pre>
<h3>Overlay Network (Multi-Host)</h3>
<p><strong>Purpose</strong>: Span containers across multiple Docker hosts.</p>
<p><strong>Characteristics</strong>:</p>
<ul><li><strong>Requires Swarm</strong>: Docker Swarm or Kubernetes</li><li><strong>Multi-host</strong>: Containers on different hosts communicate</li><li><strong>Encrypted</strong>: Optional encryption</li><li><strong>Use cases</strong>: Swarm services, distributed apps</li></ul>
<p><strong>Create overlay network</strong> (Swarm):</p>
<pre><code class="lang-bash"># Initialize swarm
docker swarm init
# Create overlay network
docker network create -d overlay myoverlay
# Deploy service
docker service create \
--name web \
--network myoverlay \
--replicas 3 \
nginx</code></pre>
<p><strong>Encrypted overlay</strong>:</p>
<pre><code class="lang-bash">docker network create \
-d overlay \
--opt encrypted \
secure-overlay</code></pre>
<h3>Macvlan Network</h3>
<p><strong>Purpose</strong>: Assign MAC address to container (appears as physical device).</p>
<p><strong>Characteristics</strong>:</p>
<ul><li><strong>Direct L2 access</strong>: Container on physical network</li><li><strong>MAC address</strong>: Each container gets unique MAC</li><li><strong>Use cases</strong>: Legacy apps expecting physical network</li></ul>
<p><strong>Create macvlan</strong>:</p>
<pre><code class="lang-bash">docker network create -d macvlan \
--subnet=192.168.1.0/24 \
--gateway=192.168.1.1 \
-o parent=eth0 \
macvlan-net
docker run -d \
--network macvlan-net \
--ip=192.168.1.100 \
nginx</code></pre>
<h3>None Network</h3>
<p><strong>Purpose</strong>: No networking (isolated container).</p>
<pre><code class="lang-bash">docker run -d --network none alpine
# No network interfaces (except loopback)</code></pre>
<hr>
<h2>Port Mapping</h2>
<h3>Publishing Ports</h3>
<p><strong>Basic mapping</strong>:</p>
<pre><code class="lang-bash"># -p HOST_PORT:CONTAINER_PORT
docker run -d -p 8080:80 nginx
# Access via http://localhost:8080</code></pre>
<p><strong>Bind to specific interface</strong>:</p>
<pre><code class="lang-bash"># Localhost only
docker run -d -p 127.0.0.1:8080:80 nginx
# Specific IP
docker run -d -p 192.168.1.10:8080:80 nginx</code></pre>
<p><strong>Dynamic port</strong> (Docker assigns random port):</p>
<pre><code class="lang-bash">docker run -d -p 80 nginx
# Find assigned port
docker port &lt;container_id&gt; 80
# 0.0.0.0:32768</code></pre>
<p><strong>Multiple ports</strong>:</p>
<pre><code class="lang-bash">docker run -d \
-p 8080:80 \
-p 8443:443 \
nginx</code></pre>
<p><strong>UDP ports</strong>:</p>
<pre><code class="lang-bash">docker run -d -p 53:53/udp dns-server</code></pre>
<h3>Expose vs Publish</h3>
<p><strong>EXPOSE</strong> (Dockerfile):</p>
<pre><code class="lang-dockerfile">EXPOSE 80
# Documents intent, doesn&#x27;t publish port</code></pre>
<p><strong>Publish</strong> (runtime):</p>
<pre><code class="lang-bash">docker run -d -p 8080:80 nginx
# Actually maps port to host</code></pre>
<p><strong>docker-compose.yml</strong>:</p>
<pre><code class="lang-yaml">services:
web:
expose:
- &quot;80&quot; # Available to other services only
api:
ports:
- &quot;8080:80&quot; # Published to host</code></pre>
<hr>
<h2>Service Discovery and DNS</h2>
<h3>Automatic DNS Resolution</h3>
<p><strong>Custom bridge networks</strong>: Container names resolve automatically.</p>
<pre><code class="lang-bash"># Create network
docker network create mynet
# Run containers
docker run -d --name db --network mynet postgres
docker run -d --name api --network mynet node
# DNS works automatically
docker exec api ping db
# PING db (172.18.0.2): 56 data bytes</code></pre>
<p><strong>Service name resolution</strong>:</p>
<pre><code class="lang-bash"># Inside &#x27;api&#x27; container
curl http://db:5432
# Resolves &#x27;db&#x27; to container IP</code></pre>
<p><strong>docker-compose.yml</strong> (automatic):</p>
<pre><code class="lang-yaml">services:
web:
image: nginx
api:
image: node
environment:
- DB_HOST=db # Resolves to &#x27;db&#x27; service
db:
image: postgres</code></pre>
<h3>Network Aliases</h3>
<p><strong>Multiple aliases per container</strong>:</p>
<pre><code class="lang-bash">docker run -d \
--name api \
--network mynet \
--network-alias backend \
--network-alias api-server \
node
# Reachable via &#x27;api&#x27;, &#x27;backend&#x27;, or &#x27;api-server&#x27;</code></pre>
<p><strong>docker-compose.yml</strong>:</p>
<pre><code class="lang-yaml">services:
api:
networks:
mynet:
aliases:
- backend
- api-server</code></pre>
<h3>Custom DNS Servers</h3>
<pre><code class="lang-bash">docker run -d \
--dns 8.8.8.8 \
--dns 1.1.1.1 \
nginx</code></pre>
<p><strong>docker-compose.yml</strong>:</p>
<pre><code class="lang-yaml">services:
web:
dns:
- 8.8.8.8
- 1.1.1.1
dns_search:
- example.com</code></pre>
<hr>
<h2>Network Isolation and Segmentation</h2>
<h3>Multiple Networks per Container</h3>
<pre><code class="lang-bash">docker network create frontend
docker network create backend
# Web server on frontend only
docker run -d --name web --network frontend nginx
# API on both networks
docker run -d --name api node
docker network connect frontend api
docker network connect backend api
# Database on backend only
docker run -d --name db --network backend postgres</code></pre>
<p><strong>Result</strong>:</p>
<ul><li><code>web</code> ↔ <code>api</code> (via frontend)</li><li><code>api</code> ↔ <code>db</code> (via backend)</li><li><code>web</code> ✗ <code>db</code> (isolated)</li></ul>
<p><strong>docker-compose.yml</strong>:</p>
<pre><code class="lang-yaml">services:
web:
networks:
- frontend
api:
networks:
- frontend
- backend
db:
networks:
- backend
networks:
frontend:
backend:</code></pre>
<h3>Internal Networks (No External Access)</h3>
<pre><code class="lang-bash">docker network create \
--internal \
isolated-network
docker run -d \
--name secure-db \
--network isolated-network \
postgres
# Can&#x27;t reach internet, only other containers on network</code></pre>
<p><strong>docker-compose.yml</strong>:</p>
<pre><code class="lang-yaml">networks:
internal:
internal: true # No external connectivity
services:
db:
networks:
- internal</code></pre>
<hr>
<h2>Network Inspection and Debugging</h2>
<h3>Inspecting Networks</h3>
<pre><code class="lang-bash"># List networks
docker network ls
# Inspect network
docker network inspect mynetwork
# See containers on network
docker network inspect mynetwork --format=&#x27;{{range .Containers}}{{.Name}} {{end}}&#x27;</code></pre>
<h3>Testing Connectivity</h3>
<p><strong>Ping between containers</strong>:</p>
<pre><code class="lang-bash">docker exec web ping api</code></pre>
<p><strong>Check DNS resolution</strong>:</p>
<pre><code class="lang-bash">docker exec web nslookup api
docker exec web dig api</code></pre>
<p><strong>Test HTTP connectivity</strong>:</p>
<pre><code class="lang-bash">docker exec web curl http://api:3000/health</code></pre>
<p><strong>Check listening ports</strong>:</p>
<pre><code class="lang-bash">docker exec api netstat -tuln
docker exec api ss -tuln</code></pre>
<h3>Common Network Issues</h3>
<p><strong>Issue 1: Container can&#x27;t resolve names</strong></p>
<p><strong>Symptom</strong>: <code>curl: (6) Could not resolve host: api</code></p>
<p><strong>Solution</strong>: Ensure containers on custom bridge network</p>
<pre><code class="lang-bash"># Check network
docker inspect api --format=&#x27;{{.NetworkSettings.Networks}}&#x27;
# Connect to network
docker network connect mynetwork api</code></pre>
<p><strong>Issue 2: Port already in use</strong></p>
<p><strong>Symptom</strong>: <code>Bind for 0.0.0.0:8080 failed: port is already allocated</code></p>
<p><strong>Solution</strong>: Change port or stop conflicting service</p>
<pre><code class="lang-bash"># Find process
lsof -i :8080
# Kill process
kill -9 &lt;PID&gt;
# Or use different port
docker run -d -p 8081:80 nginx</code></pre>
<p><strong>Issue 3: Container can reach internet but not other containers</strong></p>
<p><strong>Symptom</strong>: <code>curl https://google.com</code> works, <code>curl http://api</code> fails</p>
<p><strong>Solution</strong>: Check if on same network</p>
<pre><code class="lang-bash">docker network inspect mynetwork
# Ensure both containers listed</code></pre>
<hr>
<h2>Network Performance Optimization</h2>
<h3>Technique 1: Use Host Network for High Performance</h3>
<pre><code class="lang-bash"># Bypass Docker networking stack
docker run -d --network host nginx</code></pre>
<p><strong>Use cases</strong>: High-throughput apps, low-latency requirements.</p>
<h3>Technique 2: Optimize MTU</h3>
<pre><code class="lang-bash">docker network create \
--opt com.docker.network.driver.mtu=9000 \
jumbo-network</code></pre>
<p><strong>Benefit</strong>: Larger frames, fewer packets (if network supports).</p>
<h3>Technique 3: Disable iptables (Advanced)</h3>
<pre><code class="lang-bash">docker network create \
--opt com.docker.network.bridge.enable_icc=true \
--opt com.docker.network.bridge.enable_ip_masquerade=false \
fast-network</code></pre>
<p><strong>Warning</strong>: Reduces isolation, use carefully.</p>
<hr>
<h2>docker-compose Networking Patterns</h2>
<h3>Pattern 1: Multi-Tier Application</h3>
<pre><code class="lang-yaml">version: &#x27;3.8&#x27;
services:
web:
image: nginx
networks:
- public
ports:
- &quot;80:80&quot;
api:
image: node
networks:
- public
- private
environment:
- DB_HOST=db
db:
image: postgres
networks:
- private
environment:
POSTGRES_PASSWORD: secret
networks:
public: # Internet-facing
private: # Backend only</code></pre>
<h3>Pattern 2: External Network</h3>
<pre><code class="lang-yaml">networks:
existing-net:
external: true # Use pre-existing network
services:
app:
networks:
- existing-net</code></pre>
<h3>Pattern 3: Custom Subnet</h3>
<pre><code class="lang-yaml">networks:
mynet:
driver: bridge
ipam:
config:
- subnet: 172.28.0.0/16
gateway: 172.28.0.1
services:
web:
networks:
mynet:
ipv4_address: 172.28.0.10</code></pre>
<hr>
<h2>Network Security Best Practices</h2>
<h3>Practice 1: Network Segmentation</h3>
<pre><code class="lang-yaml"># Isolate services by function
networks:
frontend: # Public-facing
backend: # Internal only
data: # Database tier
internal: true</code></pre>
<h3>Practice 2: Limit Published Ports</h3>
<pre><code class="lang-yaml">services:
api:
expose:
- &quot;3000&quot; # Available to services only (not host)
web:
ports:
- &quot;80:80&quot; # Published to host (necessary)</code></pre>
<h3>Practice 3: Use Internal Networks</h3>
<pre><code class="lang-yaml">networks:
secure:
internal: true # No internet access
services:
db:
networks:
- secure # Isolated from internet</code></pre>
<hr>
<h2>Network Troubleshooting Checklist</h2>
<pre><code>Connectivity:
[ ] Containers on same network?
[ ] DNS resolution working? (nslookup/dig)
[ ] Firewall blocking ports?
[ ] Correct port mapping?
[ ] Service listening on correct port?
Performance:
[ ] Consider host network for high throughput
[ ] Optimize MTU if using jumbo frames
[ ] Check for network congestion
[ ] Monitor with docker stats
Security:
[ ] Segment networks by tier (frontend/backend)
[ ] Use internal networks for databases
[ ] Minimize published ports
[ ] Use TLS for inter-service communication
Debugging:
[ ] Inspect network: docker network inspect
[ ] Check container IPs: docker inspect
[ ] Test ping/curl between containers
[ ] Review docker logs for network errors</code></pre>
<hr>
<h2>Quick Reference</h2>
<h3>Network Commands</h3>
<pre><code class="lang-bash"># Create network
docker network create mynet
# List networks
docker network ls
# Inspect network
docker network inspect mynet
# Connect container
docker network connect mynet container_name
# Disconnect container
docker network disconnect mynet container_name
# Remove network
docker network rm mynet
# Prune unused networks
docker network prune</code></pre>
<h3>Common Network Drivers</h3>
<p>| Driver | Scope | Use Case | |--------|-------|----------| | <code>bridge</code> | Single host | Default, isolated containers | | <code>host</code> | Single host | High performance, no isolation | | <code>overlay</code> | Multi-host | Swarm, distributed apps | | <code>macvlan</code> | Single host | Legacy apps, L2 access | | <code>none</code> | N/A | Completely isolated |</p>
<hr>
<h2>Related Skills</h2>
<ul><li><code>docker-compose-development.md</code> - Compose networking config</li><li><code>container-security.md</code> - Network isolation for security</li><li><code>kubernetes-networking.md</code> - Advanced multi-host networking</li><li><code>service-mesh.md</code> - Istio/Linkerd for microservices</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2025-10-18 <strong>Format Version</strong>: 1.0 (Atomic)</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/containers-container-networking.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>