¿Cómo funcionan las redes de Docker y el mapeo de puertos?

Question

Accepted Answer

Docker proporciona **redes** para que los contenedores se comuniquen entre sí y con el mundo exterior. El **mapeo de puertos** expone los puertos de un contenedor al host, y las **redes** permiten que los contenedores se comuniquen entre sí por nombre. Comprender los conceptos básicos es esencial para ejecutar aplicaciones conectadas.

## Mapeo de puertos — exponer contenedores al host

```bash
# -p HOST_PORT:CONTAINER_PORT maps a host port to a container port
docker run -p 8080:80 nginx
# → nginx listens on port 80 INSIDE the container;
#   accessing localhost:8080 on the HOST reaches it
# → without -p, the container's ports aren't accessible from outside
```

El **mapeo de puertos** (`-p host:container`) hace que el puerto interno de un contenedor sea accesible desde el host — necesario para acceder a una aplicación web containerizada, una API, etc. desde fuera del contenedor.

## Comunicación de contenedor a contenedor (redes definidas por el usuario)

```bash
# create a network; containers on it can reach each other BY NAME
docker network create mynet
docker run -d --name db --network mynet postgres
docker run -d --name api --network mynet myapi
# → the "api" container can connect to the database at hostname "db" (Docker DNS)
#   e.g. DATABASE_URL=postgres://db:5432/...
```

En una **red definida por el usuario**, los contenedores pueden alcanzarse entre sí por **nombre del contenedor** (Docker proporciona resolución DNS) — así que un contenedor de aplicación se conecta a un contenedor de base de datos usando su nombre como hostname, sin necesidad de direcciones IP.

## Tipos de redes

```text
bridge   → the default; containers on a bridge network communicate; isolated from host
           (user-defined bridge networks add name-based DNS — preferred)
host     → the container shares the host's network directly (no isolation, no mapping)
none     → no networking
overlay  → spans multiple hosts (for Docker Swarm / multi-host clusters)
```

## Por qué es importante

Comprender las redes de Docker y el mapeo de puertos es esencial para ejecutar aplicaciones reales y conectadas en Docker, por lo que es un conocimiento práctico importante. El **mapeo de puertos** (`-p host:container`) es fundamental y se usa constantemente — sin él, una aplicación web o API containerizada no es accesible desde fuera del contenedor, por lo que comprender cómo exponer puertos de contenedor al host es necesario para utilizar realmente servicios containerizados.

Igualmente importante es la **comunicación de contenedor a contenedor**: comprender que en una **red definida por el usuario**, los contenedores pueden alcanzarse entre sí **por nombre** (vía DNS integrado de Docker) es esencial para aplicaciones multi-contenedor — un contenedor de aplicación conectándose a su contenedor de base de datos usando el nombre del contenedor como hostname (p. ej. `postgres://db:5432`) es un patrón casi universal, y comprenderlo es necesario para construir aplicaciones compuestas de múltiples contenedores (app + base de datos + caché, etc.).

Conocer los **tipos de redes** (bridge como el predeterminado con bridges definidos por el usuario agregando DNS basado en nombres, host para compartir la red del host, overlay para clústeres multi-host) proporciona el contexto para configurar la red apropiadamente.

Puesto que las aplicaciones reales implican servicios que se comunican (una aplicación web alcanzando una base de datos, servicios llamándose entre sí) y siendo accedidas desde fuera (puertos expuestos), y puesto que la red de Docker (mapeo de puertos para acceso externo, comunicación de contenedor nombrado en redes) es cómo funciona esta conectividad, comprender los conceptos básicos de redes de Docker es conocimiento esencial y frecuentemente aplicado para ejecutar aplicaciones containerizadas conectadas — necesario para cualquier cosa más allá de un contenedor aislado único, y una habilidad fundamental para las aplicaciones multi-contenedor que son la norma en el uso real de Docker.