mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
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]>
685 lines
29 KiB
HTML
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
|
|
# 'web' and 'api' 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'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
|
|
|
|
# 'web' can reach 'api' 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'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'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 <container_id> 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'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:
|
|
- "80" # Available to other services only
|
|
|
|
api:
|
|
ports:
|
|
- "8080:80" # 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 'api' container
|
|
curl http://db:5432
|
|
# Resolves 'db' 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 'db' 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 'api', 'backend', or 'api-server'</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'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='{{range .Containers}}{{.Name}} {{end}}'</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'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='{{.NetworkSettings.Networks}}'
|
|
|
|
# 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 <PID>
|
|
|
|
# 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: '3.8'
|
|
|
|
services:
|
|
web:
|
|
image: nginx
|
|
networks:
|
|
- public
|
|
ports:
|
|
- "80:80"
|
|
|
|
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:
|
|
- "3000" # Available to services only (not host)
|
|
|
|
web:
|
|
ports:
|
|
- "80:80" # 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> |