Mostrando el Markdown sin formato: no se pudo cargar el visor.
## Objetivo
Convertir tu propio ordenador en un pequeño servidor web, abrir su página en un navegador y ver cómo el servidor anota cada petición que recibe. Verás con tus propios ojos la petición y la respuesta de la lección.
## Objetivos
- Ejecutar un pequeño servidor web en tu propio ordenador y abrirlo en un navegador.
- Leer una línea de registro de un servidor y decir qué significa cada parte.
- Explicar qué es un `404` y verlo en acción.
## Requisitos previos
- [La lección de este módulo](lesson.es.md).
- Sabes abrir un terminal y moverte entre carpetas ([módulo 02](../02-terminal-basics/README.es.md)).
- **Python 3**. Compruébalo escribiendo `python3 --version` (macOS y Linux) o `python --version` (Windows) en un terminal. Debería mostrar algo como `Python 3.12.3`; vale cualquier versión 3.x.
- Un navegador web y un editor de texto sin formato (Bloc de notas, TextEdit en modo texto sin formato, gedit, VS Code…).
> [!WARNING]
> El servidor que inicias solo es accesible desde **tu propio ordenador**, gracias a `--bind 127.0.0.1`. No quites esa opción y detén el servidor (Paso 5) cuando termines. Windows puede preguntarte si permites que Python atraviese el cortafuegos; con esta opción puedes elegir sin riesgo **cancelar** o **denegar**.
## Arquitectura
<figure class="diagram" style="--dg-w: 1000px"><svg xmlns="http://www.w3.org/2000/svg" class="dg" viewBox="0 0 1000 380" width="1000" height="380" role="img" aria-labelledby="webserver-lab-architecture-es-title webserver-lab-architecture-es-desc" font-family="Inter, system-ui, -apple-system, Segoe UI, Roboto, sans-serif" xml:lang="es">
<title id="webserver-lab-architecture-es-title">Montaje del laboratorio: un servidor web y un navegador en el mismo ordenador</title>
<desc id="webserver-lab-architecture-es-desc">Todo ocurre dentro de una zona, tu ordenador. Un navegador con la dirección http://127.0.0.1:8000 envía una petición, flecha 1, a un servidor web de Python iniciado con python3 -m http.server 8000 --bind 127.0.0.1. El servidor lee el archivo index.html de la carpeta ~/my-website y lo devuelve como respuesta, flecha 2. En el terminal donde se ejecuta el servidor aparece una línea de registro por cada petición, por ejemplo GET barra con estado 200 y GET barra x con estado 404. Una nota dice que 127.0.0.1 significa este ordenador, así que nadie más puede llegar al servidor.</desc>
<rect class="dg-bg" x="0.5" y="0.5" width="999" height="379" rx="16" fill="#ffffff" stroke="#e3e3dd"/>
<g class="dg-l1"><rect class="dg-tint" x="20" y="20" width="960" height="340" rx="16" fill="#f0f6f9" stroke="#9ac3d9" stroke-width="1.2" stroke-dasharray="6 5"/>
<g class="dg-icon" transform="translate(36 33) scale(0.7500)" fill="none" stroke="#0369a1" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20 16V7a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v9m16 0H4m16 0 1.28 2.55a1 1 0 0 1-.9 1.45H3.62a1 1 0 0 1-.9-1.45L4 16"/></g>
<text x="62" y="47" font-size="13" class="dg-ink" fill="#0369a1" font-weight="700">Tu ordenador</text></g>
<rect class="dg-card" x="44" y="70" width="290" height="150" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l1"><g class="dg-icon" transform="translate(60 86) scale(1.2500)" fill="none" stroke="#0369a1" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/></g></g>
<g class="dg-l1"><text x="102" y="107" font-size="15" class="dg-ink" fill="#0369a1" font-weight="700">Tu navegador</text></g>
<text x="62" y="138" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">Barra de direcciones:</text>
<text x="62" y="168" font-size="14" class="dg-text" fill="#17171c" font-weight="600" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">http://127.0.0.1:8000</text>
<rect class="dg-card" x="500" y="70" width="460" height="150" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l2"><g class="dg-icon" transform="translate(516 86) scale(1.2500)" fill="none" stroke="#15803d" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect width="20" height="8" x="2" y="2" rx="2"/><rect width="20" height="8" x="2" y="14" rx="2"/><path d="M6 6h.01"/><path d="M6 18h.01"/></g></g>
<g class="dg-l2"><text x="558" y="107" font-size="15" class="dg-ink" fill="#15803d" font-weight="700">Servidor web de Python</text></g>
<text x="518" y="138" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">Iniciado con:</text>
<text x="518" y="168" font-size="14" class="dg-text" fill="#17171c" font-weight="600" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">python3 -m http.server 8000 --bind 127.0.0.1</text>
<rect class="dg-card" x="688" y="238" width="272" height="104" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l3"><g class="dg-icon" transform="translate(704 254) scale(1.2500)" fill="none" stroke="#b45309" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/></g></g>
<g class="dg-l3"><text x="746" y="275" font-size="14" class="dg-ink" fill="#b45309" font-weight="700">~/my-website</text></g>
<text x="706" y="306" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">index.html</text>
<text x="706" y="326" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">el archivo que envía el servidor</text>
<g class="dg-l3"><path class="dg-stroke" d="M830 222V234" stroke="#b45309" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l3"><path class="dg-stroke" d="M824 229l6 8 6-8" stroke="#b45309" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<text x="842" y="233" font-size="11.5" class="dg-muted" fill="#5c5c68" font-weight="600">lee</text>
<g class="dg-l1"><path class="dg-stroke" d="M338 112H486" stroke="#0369a1" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l1"><path class="dg-stroke" d="M481 106l8 6-8 6" stroke="#0369a1" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l1"><rect class="dg-bg-plain" x="372.8" y="82" width="82.4" height="24" rx="12" fill="#ffffff"/><text x="414" y="98.5" font-size="11.5" class="dg-ink" fill="#0369a1" font-weight="600" text-anchor="middle">1 petición</text></g>
<g class="dg-l2"><path class="dg-stroke" d="M496 180H348" stroke="#15803d" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l2"><path class="dg-stroke" d="M353 174l-8 6 8 6" stroke="#15803d" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l2"><rect class="dg-bg-plain" x="375.58" y="186" width="88.84" height="24" rx="12" fill="#ffffff"/><text x="420" y="202.5" font-size="11.5" class="dg-ink" fill="#15803d" font-weight="600" text-anchor="middle">2 respuesta</text></g>
<rect class="dg-card" x="44" y="238" width="620" height="104" rx="12" fill="#17171c" stroke="#17171c"/>
<text x="62" y="262" font-size="12" class="dg-muted" fill="#b8b8c4" font-weight="700">Aquí aparece una línea por petición</text>
<text x="62" y="290" font-size="12.5" class="dg-text" fill="#e8e8ee" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">127.0.0.1 - - "GET / HTTP/1.1" 200 -</text>
<text x="62" y="312" font-size="12.5" class="dg-text" fill="#e8e8ee" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">127.0.0.1 - - "GET /x HTTP/1.1" 404 -</text>
<text x="960" y="52" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="600" text-anchor="end">127.0.0.1 significa "este ordenador": nadie más puede llegar a tu servidor</text>
</svg></figure>
*Figura 1. El navegador es el cliente, el programa de Python es el servidor y el terminal muestra una línea por cada petición.*
## Pasos
### Paso 1 — Crea una carpeta con una página web (8 min)
Un servidor web necesita archivos que servir. Creas una carpeta llamada `my-website` y pones en ella una página.
En tu terminal, crea la carpeta y entra en ella:
```bash
mkdir ~/my-website
cd ~/my-website
```
En Windows PowerShell, las mismas dos líneas funcionan tal cual.
`mkdir` crea una carpeta, `~` es tu carpeta personal y `cd` entra en ella. Ahora abre tu editor de texto y crea dentro de esta carpeta un archivo llamado **`index.html`** con exactamente este contenido:
```html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Mi primer sitio web</title>
</head>
<body>
<h1>¡Hola desde mi propio servidor!</h1>
<p>Esta página es un archivo de mi ordenador.</p>
</body>
</html>
```
Esto es HTML. `<h1>` marca un título grande y `<p>` un párrafo. El texto de `<title>` aparece en la pestaña del navegador. Guarda el archivo, asegurándote de que el nombre es `index.html` y no `index.html.txt` (Windows oculta las extensiones por defecto; en el Bloc de notas, "Guardar como tipo" debe ser "Todos los archivos").
Comprueba que el archivo está ahí:
```bash
ls
```
En Windows PowerShell, `ls` también funciona.
Salida esperada:
```text
index.html
```
¿Por qué `index.html`? Cuando alguien le pide `/` a un servidor web, el servidor busca un archivo con este nombre. Es la página de inicio por defecto.
### Paso 2 — Inicia el servidor (5 min)
Sin salir de `~/my-website`, ejecuta:
```bash
python3 -m http.server 8000 --bind 127.0.0.1
```
En Windows, usa `python` en lugar de `python3` (o `py` si no se encuentra `python`).
Salida esperada:
```text
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...
```
Línea a línea, el comando significa:
- `python3 -m http.server` ejecuta un pequeño servidor web que viene con Python. Sirve los archivos de la carpeta en la que estás.
- `8000` es el **puerto**, el número de la puerta (la lección explicó los puertos).
- `--bind 127.0.0.1` hace que escuche solo en `127.0.0.1`, la dirección que siempre significa "este ordenador".
El terminal parece ahora "colgado": no aparece ningún prompt nuevo. Es normal. El servidor está en marcha esperando peticiones, y esta ventana de terminal es donde informa. Déjala abierta.
> [!NOTE]
> Si ves `OSError: [Errno 98] Address already in use` (en Windows, un mensaje sobre que la dirección está en uso), otro programa ya usa el puerto 8000. Elige otro puerto, por ejemplo `8001`, y úsalo en todos los sitios donde este laboratorio dice 8000.
### Paso 3 — Visita la página y lee el registro (8 min)
Abre tu navegador web y escribe esta dirección en la barra de direcciones:
```text
http://127.0.0.1:8000
```
Deberías ver una página con el título grande "¡Hola desde mi propio servidor!" y la pestaña titulada "Mi primer sitio web". Acabas de usar tu ordenador como cliente (el navegador) y como servidor (Python) a la vez.
Ahora mira el terminal. Han aparecido líneas nuevas. La fecha y la hora de tu pantalla serán distintas, y es posible que tu navegador muestre también una segunda línea para `/favicon.ico`, el iconito de la pestaña que siempre pide:
```text
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET / HTTP/1.1" 200 -
```
Léela de izquierda a derecha:
| Parte | Significado |
|---|---|
| `127.0.0.1` | Quién ha pedido: la dirección del cliente. Aquí es tu propio ordenador. |
| `- -` | Dos campos que los servidores pueden rellenar con datos de inicio de sesión. Aquí no se usan. |
| `[07/Nov/2026 21:48:34]` | Cuándo llegó la petición. La tuya mostrará la fecha y la hora actuales. |
| `"GET / HTTP/1.1"` | La petición: el método `GET` ("envíame esto"), la ruta `/` (la página de inicio) y la versión de HTTP. |
| `200` | El código de estado: OK, el servidor encontró el archivo y lo envió. |
| `-` | El tamaño de la respuesta, que este servidor tan simple deja vacío. |
Piénsalo antes de abrir la respuesta: nunca escribiste `index.html` en la dirección, así que ¿por qué lo envió el servidor?
<details>
<summary>Mostrar la respuesta</summary>
La ruta de la petición era solo `/`. Un servidor web responde a `/` con la página por defecto de la carpeta, que se llama `index.html`. También podrías escribir `http://127.0.0.1:8000/index.html` y obtener la misma página. Recarga esa dirección y mira el registro: aparece una línea nueva `GET /index.html`.
</details>
### Paso 4 — Cambia la página y luego pide una página que no existe (6 min)
El servidor no guarda la página en memoria: lee el archivo cada vez. Así que puedes cambiar la página sin reiniciar nada.
Abre `index.html` en tu editor, cambia el texto dentro de `<p>…</p>` por algo nuevo, por ejemplo `¡Acabo de editar esta página!`, y guarda. Vuelve al navegador y **recárgalo** (F5, o Cmd+R en un Mac). Aparece el texto nuevo. En el terminal ha aparecido una nueva línea `GET / ... 200`.
Ahora pide un archivo que no existe. En la barra de direcciones escribe:
```text
http://127.0.0.1:8000/about.html
```
El navegador muestra una página de error, "Error response: Error code: 404, Message: File not found". Mira el terminal:
```text
127.0.0.1 - - [07/Nov/2026 21:48:34] code 404, message File not found
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET /about.html HTTP/1.1" 404 -
```
¿Qué ha cambiado respecto a la primera línea de registro, y significa un 404 que el servidor está roto?
<details>
<summary>Mostrar la respuesta</summary>
La ruta ahora es `/about.html` y el código de estado es `404` en lugar de `200`. Un 404 **no** significa que el servidor esté roto: el servidor funciona perfectamente y ha respondido, diciendo "no tengo ningún archivo en esa ruta". En este caso, el archivo no existe en `~/my-website`. Como reto puedes crear `about.html` y recargar; el 404 se convierte en un 200.
</details>
### Paso 5 — Detén el servidor (3 min)
Ve al terminal donde se está ejecutando el servidor y pulsa **Ctrl+C** (mantén pulsada la tecla Ctrl y pulsa C).
Salida esperada:
```text
Keyboard interrupt received, exiting.
```
Vuelve el prompt. Ahora ve al navegador y recarga la página: muestra un error como "No se puede conectar" o "No se puede acceder a este sitio web". Ya no hay nadie escuchando en el puerto 8000, así que la petición no recibe ninguna respuesta. Eso es distinto de un 404, en el que el servidor sí responde.
## Verificación
Has completado el laboratorio si:
- El navegador mostró tu página "¡Hola desde mi propio servidor!" en `http://127.0.0.1:8000` mientras el servidor estaba en marcha.
- El terminal mostró una línea de registro que terminaba en `200` para ella y una línea que terminaba en `404` para la página inexistente.
- Tras pulsar Ctrl+C, el navegador ya no pudo conectarse.
## Resolución de problemas
| Síntoma | Causa probable | Solución |
|---|---|---|
| `python3: command not found` | Python no está instalado, o en Windows se llama `python` | Instala Python 3 desde python.org y, en Windows, escribe `python` o `py` en lugar de `python3` |
| `Address already in use` | Otro programa usa el puerto 8000, o el servidor ya se está ejecutando en otro terminal | Detén el otro, o usa otro puerto como `8001` en el comando y en la dirección |
| El navegador muestra "Directory listing for /" o un 404 para `/` | Iniciaste el servidor en la carpeta equivocada, o el archivo no se llama `index.html` | Pulsa Ctrl+C, ejecuta `cd ~/my-website`, comprueba con `ls` que `index.html` aparece en la lista y vuelve a iniciarlo |
| Los cambios no aparecen | La página está en caché o el archivo no se guardó | Guarda el archivo y fuerza la recarga (Ctrl+F5, o Cmd+Mayús+R en un Mac) |
| `index.html.txt` en el listado | El editor añadió `.txt` | Guarda de nuevo como "Todos los archivos" con el nombre `index.html` |
## Reto (opcional)
1. Añade una segunda página, `about.html`, con tu nombre en un título, y enlázala desde `index.html` con `<a href="about.html">Acerca de</a>`. Haz clic en el enlace y busca la línea correspondiente en el registro.
2. Detén el servidor e inícialo en el puerto 9000. ¿Qué dirección tendrás que escribir ahora en el navegador?
## Limpieza
El laboratorio ha creado una carpeta y nada más. Asegúrate de que el servidor está detenido (Ctrl+C) y luego elimina la carpeta.
En macOS o Linux:
```bash
cd ~
rm -r ~/my-website
```
En Windows PowerShell:
```text
cd ~
Remove-Item -Recurse ~/my-website
```
## Qué has aprendido
- Cualquier ordenador se convierte en servidor cuando ejecuta un programa que responde peticiones; el tuyo lo ha hecho con un solo comando.
- Una petición tiene un método y una ruta, y la respuesta de un servidor empieza con un código de estado: `200` para éxito, `404` para "aquí no hay nada".
- El servidor lee archivos de una carpeta, y `index.html` es la página por defecto de una carpeta.
- Enlazar con `127.0.0.1` mantiene un servidor de pruebas privado para tu propio ordenador, y Ctrl+C lo detiene.