Tutorial de Debian 13 / Diagnosticar DNS, puertos y fallos de conexión HTTP

Cuando no se puede acceder a un servidor Debian 13, revise las direcciones y rutas, la resolución de nombres mediante DNS (Domain Name System), el socket de escucha y la respuesta HTTP (Hypertext Transfer Protocol) por separado. Una solicitud que funciona dentro del invitado no prueba que un host pueda alcanzarlo a través de NAT. Un HTTP 404 significa que un servidor HTTP respondió a la solicitud, así que inspeccione la ruta solicitada y el servidor que responde en lugar de tratarlo como una falla básica de conexión.

Identificar la ruta de conexión que se está probando

Este tutorial utiliza una máquina virtual Debian 13 conectada a VirtualBox NAT (Network Address Translation, traducción de direcciones de red) y un host Windows. La dirección del invitado es 10.0.2.15, y la puerta de enlace es 10.0.2.2 en una configuración de un solo adaptador NAT. Verifique las direcciones reales del entorno con los resultados de la consulta a continuación, y no aplique las direcciones de ejemplo a otras redes.

ip -br address
ip route
ip route get 10.0.2.2
getent ahostsv4 deb.debian.org
sudo ss -lntp

ip route get verifica la ruta, la interfaz y la dirección de origen que el kernel selecciona al enviar al destino especificado. No es un comando para verificar que el paquete realmente llegó al destino. getent utiliza la configuración de resolución de nombres del sistema, y la dirección de la red de entrega de contenido (CDN) resuelta puede variar dependiendo del momento. En ss, -l se refiere a escuchar, -n a dirección numérica y puerto, -t a TCP, y -p a información del proceso.

Resultados de la Prueba Objetivos a Verificar Primero
No se puede resolver el nombre a dirección Error tipográfico en el nombre, configuración de DNS y de búsqueda de nombres del sistema
No hay ruta hacia el destino Dirección de interfaz, ruta de conexión y puerta de enlace predeterminada
Solo exitoso dentro del invitado Dirección de escucha, objetivo de reenvío de puerto, cortafuegos
Respuesta HTTP 404 Ruta URL, ubicación del archivo, host virtual y enrutamiento de aplicación
Tiempo de espera de conexión Verifique nuevamente el destino, el puerto, la ruta y el filtrado; no puede determinarse una causa basándose solo en este resultado.

Las direcciones 127.0.0.1 del host y 127.0.0.1 del invitado son direcciones de loopback de diferentes computadoras. Para permitir que un invitado NAT reciba conexiones normales del host, se requiere un camino como el reenvío de puertos. Mientras se mantienen las reglas existentes de reenvío SSH, agregaremos reglas separadas para la práctica de HTTP. Para identificar las herramientas responsables, consulte la gestión de la red y del DNS. Para cambiar direcciones en el entorno identificado, siga la configuración IPv4 estática y recuperación DHCP.

Preparar archivos de prueba y un servidor solo de loopback

Prepare dos terminales Debian y la PowerShell del host. El servidor HTTP de Python se utiliza únicamente para la verificación de la conexión y no como un servidor web de producción. Si un servicio existente usa el puerto 8080, no lo detenga; seleccione un puerto de práctica no utilizado y aplíquelo de manera consistente en todos los comandos y reglas de reenvío posteriores.

sudo ss -lntp 'sport = :8080'
sudo apt update
sudo apt install --no-install-recommends python3 curl
python3 --version
curl --version

Si ss no muestra ninguna fila de escucha más allá de su encabezado, no se listó ningún oyente TCP para ese puerto en ese momento. Revise los cambios de dependencias y paquetes antes de confirmar la instalación. La VM del curso original utilizó Python 3.13.5 y curl 8.14.1; las actualizaciones de seguridad de Debian pueden cambiar esas versiones de los paquetes.

Ejecute lo siguiente en un terminal de usuario regular A. mkdir está escrito para fallar si existe una carpeta con el mismo nombre. No sobrescriba la carpeta existente; primero verifique su contenido.

mkdir "$HOME/lf-net-demo" &&
printf 'debian-network-lab\n' > "$HOME/lf-net-demo/probe.txt" &&
python3 -m http.server 8080 --bind 127.0.0.1 --directory "$HOME/lf-net-demo"

Si la creación de la carpeta falla, no ejecute el comando del servidor. Si se inicia normalmente, el terminal A permanece en el estado de ejecución del servidor. Dado que la raíz del documento está restringida a una carpeta dedicada, no se proporciona todo el directorio de inicio. El puerto 8080 es un puerto al que un usuario regular puede vincularse, por lo que no se requiere sudo para ejecutar el servidor.

Ejecute lo siguiente en el terminal de invitado B. Haga solicitudes después de que el servidor muestre el mensaje de inicio.

sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8081/probe.txt

La primera solicitud genera debian-network-lab. La dirección local de ss es 127.0.0.1:8080. Si no hay otro servicio en el 8081, la segunda solicitud fallará al conectar. El ensayo original produjo el código de salida 7 de curl. Esta comparación muestra la importancia del puerto del servicio en ejecución, y puede haber servicios en puertos donde espera un fallo; dé prioridad a los resultados de sus propias consultas.

--noproxy '*' permite que esta solicitud omita las variables de entorno del proxy. --connect-timeout es una limitación en el paso de conexión, y --max-time es una limitación en el tiempo total de operación. Esta excepción solo se aplica a la solicitud; conserve la configuración global de proxy que necesite su organización.

Comparar el acceso desde el anfitrión cambiando solo la dirección de escucha

En VirtualBox, abra la máquina virtual de destino, vaya a Configuración → Red → Adaptador NAT → Avanzado → Reenvío de puertos . La ubicación en la interfaz de usuario puede variar según la versión. Solo agregue la nueva regla a continuación y deje la regla SSH existente como está. Si el puerto del host 18080 está en uso, seleccione un puerto libre.

Elemento Configuración
Nombre / Protocolo lf-debian13-http15 / TCP
IP / Puerto del Host 127.0.0.1 / 18080
IP / Puerto del Invitado Si usa la dirección predeterminada de un invitado NAT único, deje la IP en blanco / 8080

Si especifica una dirección de invitado, debe coincidir con la dirección de invitado actual. Este ejercicio utiliza la dirección NAT predeterminada 10.0.2.15, y las máquinas virtuales con direcciones cambiadas deben tener sus objetivos de reenvío verificados nuevamente. Restringir la IP del host a loopback evita que otras computadoras en la LAN accedan al servidor de práctica. Para operaciones detalladas, consulte la documentación de NAT y reenvío de puertos de VirtualBox.

Ejecute esto en el PowerShell del host. curl.exe se especifica para distinguirlo de los alias de Windows PowerShell.

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:18080/probe.txt
$LASTEXITCODE

La solicitud dentro del invitado tuvo éxito, pero la solicitud del anfitrión falló porque el servidor escuchaba solo en el bucle del invitado, no en la dirección de la interfaz de red (NIC) del invitado que recibía el tráfico reenviado por NAT. El ensayo original produjo un restablecimiento de conexión (connection reset) y el estado de salida de curl 56. Otras versiones de virtualización o estados de conexión pueden producir errores o tiempos de espera diferentes; coincidir exactamente con el 56 no es un requisito.

En el terminal A del invitado, detenga el servidor con Ctrl+C . Mantenga el mismo archivo, puerto y regla de reenvío, y cambie solo la dirección de escucha.

python3 -m http.server 8080 --bind 0.0.0.0 --directory "$HOME/lf-net-demo"

Después de confirmar el mensaje de inicio del servidor, compruebe la dirección de escucha que muestra ss y realice la solicitud desde el terminal B del invitado a la dirección de su interfaz de red.

sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://10.0.2.15:8080/probe.txt

0.0.0.0:8080 significa escuchar en todas las direcciones IPv4 locales; no proporciona automáticamente escucha en IPv6. Después de que la solicitud a la dirección NIC del invitado tenga éxito, repita el mismo comando curl.exe en el anfitrión para verificar el contenido del archivo y el estado de salida 0. Si una solicitud falla inmediatamente después del inicio, primero confirme que el proceso aún se está ejecutando y que el socket de escucha existe.

Esta comparación aísla el efecto de la dirección de escucha. Si su solicitud aún falla, inspeccione el reenvío, la dirección del invitado, el socket de escucha y las reglas de filtrado en lugar de simplemente desactivar el firewall. La falla de ping por sí sola puede reflejar la política del Protocolo de Mensajes de Control de Internet (ICMP); no prueba que todos los servicios de Protocolo de Control de Transmisión (TCP) estén no disponibles.

Distinguir el estado HTTP del estado de salida de curl

El servidor se está ejecutando en todas las direcciones IPv4 y el host PowerShell solicita un archivo que no existe. -w genera el código de respuesta, y -o NUL descarta el cuerpo en Windows.

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --fail -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE

El código HTTP para la primera solicitud es 404, pero el código de salida de curl es 0. Por defecto, curl no considera los estados de error HTTP como fallos de transmisión. La segunda solicitud recibe el mismo HTTP 404 y devuelve el código de salida 22 debido a --fail. En comprobaciones automáticas, si se debe mirar solo el código de salida o también juzgar el estado HTTP debe determinarse según el propósito. No reemplace las comprobaciones operativas que requieren confirmar redirección, autenticación o el contenido real de la respuesta únicamente verificando que sea 200.

En esta prueba controlada, el código 404 junto con la entrada correspondiente en el registro del servidor Python confirma el intercambio de una solicitud HTTP y su respuesta. Verifique la ruta URL y la raíz del documento, y compare el registro del servidor para GET /missing.txt y el estado 404. En una implementación real, también confirme qué servidor o proxy devolvió la respuesta. El manual oficial de curl documenta el manejo de HTTP y los códigos de salida de transferencia por separado.

Aislar el DNS con una dirección para una sola solicitud

Las reglas de nombres de uso especial en RFC 6761 reservan .invalid para nombres que se espera que no se resuelvan con éxito. Mantenga el servidor y la regla de reenvío sin cambios y solicite el nombre de host de prueba a continuación desde el equipo Windows.

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --resolve "lf-debian13-net15.invalid:18080:127.0.0.1" http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE

En la ruta de consulta general, la primera solicitud devuelve un fallo de búsqueda de nombre y el código de salida 6. La segunda solicitud especifica la dirección para ese nombre de host y puerto solo para esta ejecución de curl, por lo que recibe el archivo y devuelve el código de salida 0. --resolve no modifica el servidor DNS ni el archivo hosts y conserva el nombre de host en la URL. En HTTPS, la verificación del certificado para el nombre de host de la URL todavía es requerida, por lo que no debe confundirse esta opción con omitir la verificación del certificado.

Si solo la segunda solicitud tiene éxito, indica que la ruta de transmisión hacia la dirección especificada funciona y proporciona motivos para examinar más a fondo la ruta de búsqueda del nombre original. Especificar una dirección arbitraria sin verificar si es la IP correcta en un servicio real podría resultar en verificar otro servidor. Tampoco se debe asumir que el proxy, la caché o el método de búsqueda de nombres de un determinado programa sea el mismo que el resultado del sistema getent.

Limpiar y registrar los resultados del diagnóstico

  1. En el terminal invitado A, detenga el servidor HTTP con Ctrl+C.
  2. En la tabla de reenvío de puertos de VirtualBox, elimine únicamente la regla lf-debian13-http15 creada esta vez. Mantenga la regla SSH.
  3. En el invitado, revise el estado de escucha y el archivo siguiente, y elimine solo los archivos y carpetas vacías creados esta vez.
sudo ss -lntp 'sport = :8080'
cat "$HOME/lf-net-demo/probe.txt"
rm -- "$HOME/lf-net-demo/probe.txt"
rmdir -- "$HOME/lf-net-demo"

La fila de escucha del servidor debería desaparecer, y las solicitudes HTTP de práctica del host tampoco deberían tener éxito. Si rmdir falla, verifique si hay otros archivos en la carpeta y no elimine de manera forzada de forma recursiva. Las herramientas curl y Python instaladas pueden usarse para otras tareas de gestión, por lo que no se debe realizar una eliminación masiva sin comprobar la necesidad.

Al registrar problemas, es útil incluir la ubicación de la inspección (host/invitado), la URL de la solicitud, la dirección y el puerto de destino reales, la dirección de escucha, el código de salida de curl y el código HTTP. La consulta de direcciones y rutas se puede verificar en la documentación Debian 13 ip-route, los sockets de escucha en la documentación ss, y las opciones del servidor de prueba en la documentación Python 3.13 http.server.