Generador de direcciones IP en 2026: públicas, privadas y loopback

Para IPv4, el generador produce valores en cuatro ámbitos: público, privado, loopback y link-local. Para IPv6 también produce cuatro ámbitos: global, unique local (ULA), link-local y loopback. El ámbito forma parte de la solicitud, no se deduce de la salida, porque el mismo cuarteto con puntos puede ser privado en un contexto y un host válido en una red privada en otro.

El ámbito es una etiqueta del fixture, no una afirmación de alcanzabilidad. Una dirección generada con ámbito público queda fuera de los bloques privados y de uso especial, pero aun así puede coincidir con una asignación real en algún punto de internet. No envíes tráfico a direcciones generadas. Si una prueba debe tener la certeza de que no se contacta nada real, usa los rangos de documentación descritos más abajo en lugar de la salida de ámbito público.

Los bloques siguientes son los que un validador o un constructor de fixtures debe tratar de forma explícita. El espacio privado es 10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16, lo que da aproximadamente 17,8 millones de direcciones. Loopback es todo el bloque 127.0.0.0/8, no solo 127.0.0.1, y link-local es 169.254.0.0/16, conocido como el rango APIPA cuando falla DHCP.

Además de esos, varios bloques importan para las pruebas. 100.64.0.0/10 es espacio de NAT de nivel de operador y se comporta como espacio privado en muchas redes. 192.0.2.0/24, 198.51.100.0/24 y 203.0.113.0/24 están reservados para documentación, lo que los hace ideales para fixtures que nunca deben alcanzar un host real. 198.18.0.0/15 está reservado para benchmarking. 0.0.0.0/8 significa «este host», 224.0.0.0/4 es multicast y 240.0.0.0/4 está reservado.

Los tres bloques privados están definidos por RFC 1918 y no son enrutables en la internet pública. Cuál usar es cuestión de escala y convención: 10/8 ofrece un único espacio plano lo bastante grande para cualquier cosa, 172.16/12 es común en redes de contenedores y 192.168/16 es el valor por defecto en los routers domésticos. Los bloques no se solapan, así que una prueba que asume que toda dirección privada empieza por 10 se equivoca en dos tercios del espacio.

Una sutileza que rompe pruebas: las direcciones privadas son direcciones ordinarias dentro de la red privada. Si tu runner de CI está en 10.0.0.0/8, una dirección privada generada en ese bloque puede apuntar a un host interno real, incluido un servicio de metadatos o un panel de administración. Genera desde el rango 192.168.0.0/16 o, mejor, desde los rangos de documentación cuando la prueba deba estar aislada.

Las direcciones loopback nunca salen del host. 127.0.0.1 es la habitual, pero todo el bloque 127.0.0.0/8 es loopback en la mayoría de las pilas, y 127.0.0.53 lo usa systemd-resolved para DNS local. Una prueba que fija 127.0.0.1 como dirección de servidor colisionará con cualquier otra cosa de la máquina que use el mismo puerto, por lo que las ejecuciones de prueba en paralelo deberían asignar puertos de forma dinámica.

Las direcciones IPv4 link-local de 169.254.0.0/16 se asignan automáticamente cuando ningún servidor DHCP responde. Ver una en logs de producción casi siempre significa que DHCP falló, no que un cliente esté en una red extraña. En IPv6 el equivalente es fe80::/10 y se comporta distinto: toda interfaz IPv6 tiene una dirección link-local, es necesaria para el descubrimiento de vecinos y no puede usarse sin un índice de zona, porque la misma dirección existe en cada enlace.

IPv6 no tiene broadcast ni requiere NAT, y sus reglas de ámbito van en el prefijo. La unidifusión global vive actualmente en 2000::/3, que es todo el rango de 2000:: a 3fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff. Las direcciones unique local viven en fc00::/7 y convencionalmente se generan desde fd00::/8. Link-local es fe80::/10, y ::1/128 es loopback, con ::/128 como dirección no especificada.

El generador devuelve direcciones en esos cuatro ámbitos. Dos detalles importan para las pruebas: una dirección ULA no es enrutable globalmente y debe tratarse como privada, y una dirección link-local solo tiene sentido con un identificador de zona, por ejemplo fe80::1%eth0. Si tu código almacena una dirección IPv6, guarda la zona por separado en lugar de pegarla al texto, porque el signo de porcentaje en una URL tiene otro significado.

Las direcciones IPv6 mapeadas de IPv4 tienen la forma ::ffff:192.0.2.1 y aparecen cuando un socket de doble pila informa un par IPv4 como IPv6. No son direcciones IPv6 de uso general, y tratarlas como tales produce errores en limitadores de tasa y reglas de acceso que comparan prefijos. Las direcciones 6to4 de 2002::/16 y las de Teredo de 2001::/32 son mecanismos de transición con su propia estructura; no las generes como si fueran direcciones globales ordinarias.

Otras trampas son más antiguas pero siguen presentes. Un cero inicial en un octeto IPv4, como 010.1.1.1, lo interpretan algunos analizadores como octal y otros lo rechazan, así que nunca lo aceptes en un fixture. La forma abreviada 127.1 la aceptan algunas pilas como 127.0.0.1. Los puertos son un campo aparte y nunca deben concatenarse al valor de la dirección.

Para pruebas unitarias que nunca abren un socket, usa rangos de documentación: 192.0.2.0/24, 198.51.100.0/24 y 203.0.113.0/24 para IPv4, y 2001:db8::/32 para IPv6. Están reservados precisamente para que los ejemplos y las pruebas no puedan alcanzar un host real. Un analizador debería aceptarlos como direcciones sintácticamente válidas de ámbito público, lo que también los convierte en una buena prueba de la lógica de clasificación.

Para pruebas de integración que sí abren sockets, enlaza a loopback y asigna el puerto desde el sistema operativo en lugar de fijar 8080. Para pruebas que necesitan un par remoto verosímil, usa los rangos de documentación y haz que cualquier cliente se niegue a marcar hacia ellos. Esa combinación te da valores realistas y la garantía firme de que una mala configuración no puede enviar tráfico a un lugar inesperado.

Toda dirección generada debería pasar el mismo validador que usa la aplicación. Ese es el objetivo de generarla. Comprueba que la familia coincide con el ámbito solicitado, que la dirección está dentro del bloque esperado y que la forma textual vuelve a analizarse a los mismos bits. Una ida y vuelta detecta errores de compresión de ceros en IPv6, donde 2001:db8:0:0:0:0:0:1 debe normalizarse a 2001:db8::1 y a nada más.

Comprueba también lo que la dirección no es. Un fixture de ámbito privado no debe caer dentro de un bloque público, un fixture loopback debe estar en 127.0.0.0/8 o ser exactamente ::1, y ningún fixture debería ser multicast, broadcast ni la dirección no especificada salvo que la prueba trate explícitamente esos casos. Esas aserciones negativas son baratas y detectan los errores de generador más vergonzosos.