Guía

Tu IP pública desde la terminal: curl ip-db.com/me

Tu IP pública en una línea, los endpoints JSON, país y ASN, un test de velocidad en la terminal y cómo usarlo en Windows.

Equipo de IP-DB 11 min de lectura 118 lecturas 0 comentarios Actualizado

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:

curl ip-db.com/me

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:

Salida de ejemplo
77.245.159.39

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:

EndpointDevuelveFormato
/meDirección IP públicatexto plano
/me.jsonDirección + país, ciudad, ASN, tipo de red, reputaciónJSON
/me/countryCódigo ISO de paístexto plano
/me/asnNúmero de ASN y nombre del operadortexto plano
Salidas de ejemplo
$ curl ip-db.com/me/country TR $ curl ip-db.com/me/asn AS42868 Niobe Bilisim Ltd. Sti. $ curl ip-db.com/me.json { "ip": "77.245.159.39", "version": 4, "isPrivate": false, "countryCode": "TR", "countryName": "Turkey", "city": "Pendik", "asn": 42868, "asnOrg": "Niobe Bilisim Ltd. Sti.", "asnDomain": "trdns.com", "networkType": "residential", "abuseConfidenceScore": 0 }

/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:

curl -s ip-db.com/me.json | jq -r ' "| Campo | Valor |", "| --- | --- |", "| IP | `\(.ip)` |", "| País | \(.countryName) (\(.countryCode)) |", "| Ciudad | \(.city // "—") |", "| ASN | AS\(.asn) — \(.asnOrg) |", "| Tipo de red | \(.networkType) |", "| Abuso | \(.abuseConfidenceScore)/100 |"'
Markdown generado
| Campo | Valor | | --- | --- | | IP | `77.245.159.39` | | País | Turkey (TR) | | Ciudad | Pendik | | ASN | AS42868 — Niobe Bilisim Ltd. Sti. | | Tipo de red | residential | | Abuso | 0/100 |

Si le basta un resumen de una línea:

curl -s ip-db.com/me.json \ | jq -r '"\(.ip) — \(.countryCode) — AS\(.asn) \(.asnOrg) — \(.networkType)"' # 77.245.159.39 — TR — AS42868 Niobe Bilisim Ltd. Sti. — residential

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:

curl -s ip-db.com/me/speed.sh | sh
Salida de ejemplo
ip-db.com terminal speed test ---------------------------------------------- address 77.245.159.39 location Pendik, Turkey network AS42868 Niobe Bilisim Ltd. Sti. measured against Cloudflare latency ################################ 40.0 ms download ################################ 310.1 Mbit/s upload ################################ 674.3 Mbit/s ---------------------------------------------- download 310.1 Mbit/s upload 674.3 Mbit/s latency 40.0 ms

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 -s ip-db.com/me/speed.sh -o speed.sh less speed.sh && sh speed.sh

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:

EntornoComando
Dentro de WSL o Git Bashcurl -s ip-db.com/me/speed.sh | sh
cmd / PowerShell, con WSL instaladowsl sh -c "curl -s https://ip-db.com/me/speed.sh | sh"
cmd / PowerShell, con Git instaladobash -c "curl -s https://ip-db.com/me/speed.sh | sh"
En cualquier sitio, solo informacióncurl 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

MYIP=$(curl -fsS --max-time 5 ip-db.com/me) echo "Esta máquina sale con la dirección $MYIP"

-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:

curl -4 -s ip-db.com/me # salida IPv4 curl -6 -s ip-db.com/me # salida IPv6

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:

curl -s ip-db.com/me.json | jq -r '"\(.ip) \(.countryCode) \(.networkType)"' # VPN apagada: 77.245.159.39 TR residential # VPN activa: 45.132.xxx.xxx NL datacenter

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:

#!/bin/sh # /usr/local/bin/ip-watch.sh STATE=/var/lib/ip-watch.last NEW=$(curl -fsS --max-time 10 ip-db.com/me) || exit 0 OLD=$(cat $STATE 2>/dev/null) if [ "$NEW" != "$OLD" ]; then echo "$NEW" > $STATE [ -n "$OLD" ] && logger -t ip-watch "direccion cambiada: $OLD -> $NEW" fi
*/5 * * * * /usr/local/bin/ip-watch.sh

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:

MYIP=$(curl -fsS --max-time 5 ip-db.com/me) ssh admin@servidor "ufw allow from $MYIP to any port 22"

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 simpleJSONASN + tipo de redReputación
Servicios de eco clásicossícasi nuncanono
ip-db.com/mesí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.

Compartir

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.

Solo texto, sin enlaces. Los comentarios se publican al instante y pueden moderarse. Inicia sesión para comentar como miembro