Está conectado por SSH a un servidor y necesita saber con qué dirección sale esa máquina a internet. O está dentro de un contenedor Docker, en un runner de CI, en una red tras NAT. Allí donde no hay navegador, basta una sola línea:
Devuelve exactamente una línea — sin más adorno que el salto final, lista para asignarse a una variable o pasarse por una tubería:
Esa no es la dirección local de la interfaz de su equipo. ip addr suele mostrarle una dirección de un rango privado como 192.168.1.20; lo que los servidores ven de usted es la dirección del NAT o de la salida de VPN. La diferencia entre ambas y cómo se reparten las direcciones se explica en qué es una dirección IP.
Cuatro endpoints
Todos funcionan sin prefijo de idioma, porque el público no es un lector sino un intérprete de comandos:
| Endpoint | Devuelve | Formato |
|---|---|---|
/me | Dirección IP pública | texto plano |
/me.json | Dirección + país, ciudad, ASN, tipo de red, reputación | JSON |
/me/country | Código ISO de país | texto plano |
/me/asn | Número de ASN y nombre del operador | texto plano |
/me.json se enriquece solo desde bases de datos locales: no espera a RDAP ni a DNSBL. Por eso sigue siendo lo bastante rápido como para vivir dentro del bucle de un script de monitorización. Cómo se determina el campo networkType se explica en detección de VPN, proxy y Tor, y el cálculo de abuseConfidenceScore en el artículo sobre reputación.
Generar salida Markdown con jq
La verdadera ventaja del JSON es poder convertirlo al formato que necesite. Una tabla Markdown lista para pegar en un ticket, un pull request o un runbook:
Si le basta un resumen de una línea:
Test de velocidad desde la terminal
La misma familia de endpoints no solo dice cuál es su dirección: también mide su enlace. En un servidor donde no puede abrir un navegador, dentro de un contenedor o en una máquina alcanzada por SSH, la descarga, la subida y la latencia llegan en una sola línea:
Los bytes viajan entre usted y los endpoints públicos de velocidad de Cloudflare, no entre usted e ip-db.com. Hay dos razones. Honestidad, primero: una tasa medida contra un servidor compartido describiría la ruta hasta ese servidor, no su conexión. Coste, después: si cada prueba saliera de nuestro ancho de banda, no podría seguir siendo gratuita. Lo único que sale de aquí es el script, unos 10 KB.
El script toma cinco muestras de latencia, luego descarga bloques de 1, 10 y 25 MB y después sube cuerpos de 2, 10 y 26 MB. El primer bloque de cada dirección es de calentamiento y nunca llega al resultado: el arranque lento de TCP puede por sí solo reportar cerca de la mitad de la tasa real. Los enlaces por debajo de 50 Mbit/s omiten los bloques grandes, de modo que la prueba no se alarga en una línea lenta. La ejecución completa dura unos diez segundos.
Si prefiere leer el script antes de ejecutarlo, divida el comando en dos:
curl ip-db.com/me/speed devuelve texto legible — su dirección y cómo lanzar la prueba — en lugar de código de shell. Existen dos direcciones porque el servidor no puede distinguir curl URL de curl URL | sh: ambas envían exactamente la misma petición.
Cómo usarlo en Windows
Windows incluye curl.exe con el sistema operativo desde la versión 10 1803, así que la descarga funciona sin problemas. Lo que falta es sh: ni cmd.exe ni PowerShell son shells POSIX, de modo que el lado derecho de la tubería no tiene quien lo ejecute. La solución es entregar el comando a una shell POSIX que ya esté en la máquina:
| Entorno | Comando |
|---|---|
| Dentro de WSL o Git Bash | curl -s ip-db.com/me/speed.sh | sh |
| cmd / PowerShell, con WSL instalado | wsl sh -c "curl -s https://ip-db.com/me/speed.sh | sh" |
| cmd / PowerShell, con Git instalado | bash -c "curl -s https://ip-db.com/me/speed.sh | sh" |
| En cualquier sitio, solo información | curl ip-db.com/me/speed |
Las comillas importan: dejar la tubería dentro de comillas dobles evita que cmd la reclame, de modo que llega intacta a WSL o a bash. Sin ellas, cmd intenta ejecutar la tubería por su cuenta y el comando se parte en dos.
PowerShell esconde una trampa más. En PowerShell 5.1, la versión que Windows trae de serie, curl no es curl.exe: es un alias de Invoke-WebRequest, que no entiende -s. Allí llame al programa real por su nombre completo, curl.exe. PowerShell 7 eliminó ese alias, de modo que curl ejecuta directamente curl.exe.
Sin WSL ni Git no hay forma de ejecutar la prueba en Windows, aunque curl ip-db.com/me/speed sigue dándole la salida informativa. Esa salida es ASCII puro, así que se ve bien sea cual sea la página de códigos activa en cmd.
Recetas prácticas
Guardar la dirección en una variable
-f hace que curl devuelva un código de salida distinto de cero ante un error HTTP, -sS silencia la barra de progreso pero sigue mostrando errores, y --max-time evita que su script espere indefinidamente si la red se atasca. Los tres deberían acompañar a cada curl dentro de un script.
Ver IPv4 e IPv6 por separado
En una máquina de doble pila, es usted quien decide qué familia usa curl:
Que difieran es normal: el tráfico IPv6 suele salir directo, sin NAT. Si la llamada con -6 falla, su máquina no tiene una ruta IPv6 operativa — al diagnosticar un problema de conectividad, ese dato ya vale por sí solo.
¿La VPN funciona de verdad?
Que una VPN aparezca como conectada no significa que esté transportando su tráfico. La comparación lo revela en un segundo:
Que networkType pase a datacenter o vpn es el resultado esperado: las VPN comerciales alquilan casi siempre su capacidad de salida a un proveedor de hosting. Si sigue viendo residential, su tráfico está saliendo por fuera del túnel.
Avisar cuando la dirección cambia
Para un servidor tras una línea con IP dinámica, un pequeño cron que detecta el cambio:
Hay dos detalles que importan. || exit 0 impide que un corte de red momentáneo corrompa el fichero de estado. En la primera ejecución $OLD está vacío, así que no se notifica nada; de lo contrario, cada instalación nueva generaría una falsa alerta de cambio de dirección.
Añadir su propia dirección a una regla de cortafuegos
Si accede a un panel de administración desde una línea con dirección variable:
Si automatiza esto, acuérdese de borrar la regla anterior; si no, con el tiempo quedarán decenas de direcciones autorizadas que ya no son suyas, y el agujero que quería cerrar se irá ensanchando.
¿Navegador o terminal? La respuesta depende de quién pregunta
La misma dirección se comporta de forma distinta según el solicitante. Si un navegador abre /me, se le redirige a la página cuál es mi IP; curl recibe texto plano. La distinción se hace con la cabecera Accept: los navegadores nombran text/html explícitamente, mientras que curl solo envía */*.
El matiz está en que un comodín */* técnicamente coincide con text/html. Por eso las funciones auxiliares de tipo «¿quiere HTML?» que traen las librerías responden que sí también para curl y mandan cada terminal a la página HTML, justo lo contrario de lo deseado. La comprobación correcta es si text/html aparece por su nombre en la cabecera.
Diferencia con otros servicios
| IP simple | JSON | ASN + tipo de red | Reputación | |
|---|---|---|---|---|
| Servicios de eco clásicos | sí | casi nunca | no | no |
ip-db.com/me | sí | sí | sí | sí |
La diferencia es que una sola llamada no solo le dice «esta es su dirección», sino también en qué clase de red se encuentra —centro de datos, conexión doméstica, salida Tor conocida— y si aparece en nuestras listas de origen. Si quiere consultar una dirección distinta de la suya, vaya a la documentación de la API.
Al escribir scripts
- Ponga un tiempo límite. Sin
--max-time, una petición colgada deja colgado también al cron que la llamó. - Gestione el error. Con
-f, curl devuelve un código distinto de cero ante errores HTTP; recójalo con||. - Valide la salida. No escriba HTML en su configuración donde espera una dirección: basta una comprobación como
case "$MYIP" in *[!0-9.]*) exit 1 ;; esac. - Reutilice el resultado un rato. La dirección no cambia por segundos; volver a preguntar en cada comando solo añade latencia.
Conviene señalar que los endpoints responden con X-Robots-Tag: noindex: están pensados para la línea de comandos, no para el índice de los buscadores.
Preguntas frecuentes
¿Por qué funciona curl ip-db.com/me sin escribir https://?
Sin esquema, curl se conecta al puerto 80, es decir, por HTTP simple. El resto del sitio redirige esas peticiones a HTTPS con un 301, y curl no sigue redirecciones salvo que se le pase -L: en lugar de una dirección obtendría un cuerpo HTML. Por eso solo las rutas /me quedan exentas de forzar HTTPS. No supone un coste de privacidad: la respuesta es la propia dirección de quien pregunta, que todos los saltos del camino ya han leído en las cabeceras del paquete.
¿Por qué la respuesta no coincide con mi dirección local?
Son dos direcciones distintas. Lo que muestran ipconfig o ip addr es la dirección local de la interfaz de su equipo, casi siempre en un rango privado como 192.168.x.x. /me devuelve la dirección pública con la que la petición salió a internet: la de su NAT, su pasarela corporativa o su salida de VPN. Esa es la que ven los servidores.
¿Se almacena la respuesta en caché?
No, deliberadamente. Los endpoints responden con no-store, no-cache, must-revalidate y Vary: Accept. Que una caché intermedia guardara la respuesta de un visitante y se la sirviera al siguiente sería peor que no responder: repartiría direcciones ajenas.
¿Con qué frecuencia puedo llamarlo desde un script?
Para vigilar un cambio de IP, cada pocos minutos es de sobra; en conexiones domésticas la dirección suele mantenerse días. Llamarlo cada segundo no aporta información nueva. Para un uso intensivo y continuado, use los endpoints de la API, cuya identidad va ligada a la clave y cuyos límites están documentados.
¿Cómo ejecuto el test de velocidad con curl en Windows?
Ni cmd.exe ni PowerShell son shells POSIX, así que el sh a la derecha de la tubería no existe en Windows. Si tiene WSL instalado, delegue el comando con wsl sh -c entre comillas; si tiene Git, use bash -c del mismo modo. Dentro de WSL o Git Bash el comando funciona tal cual. Tenga en cuenta además que en PowerShell 5.1 curl es un alias de Invoke-WebRequest y no entiende -s, por lo que allí debe llamar al programa por su nombre completo, curl.exe.
Si prefiere mirarlo en el navegador, la página cuál es mi IP muestra los mismos datos de forma visual. Para otra dirección use la página de consulta, y para uso masivo la documentación de la API.
Comentarios 0
Comparte una pregunta, tu experiencia o una corrección, registrado o de forma anónima.
Aún no hay comentarios. Sé el primero.