Índice del contenido

Ngrok, tu localhost accesible desde internet

Ngrok, tu localhost accesible desde internet

Me topé con Ngrok (frecuentemente mal escrito como ngrock o negrok) intentando redirigir la notificación de un pago de Mercado Pago a mi localhost, para hacer pruebas. Funcionaba más o menos así: Mercado pago te otorgaba una dirección url a donde redigir al comprador para efectuara el pago. Una vez terminado el pago, Mercado Pago hacía una petición HTTP a cualquier dirección url que tú le indicaras y mandaba por POST los resultados del intento de pago. El problema es que mercado libre no manda notificaciones a localhost.

¿Qué es ngrok?

Ngrok es una aplicación que te permite conectar tu localhost con internet.

Lo que hace Ngrok (Recuerda que ngrock y negrok están mal escritos) es servir como un túnel que redirige cualquier petición web, a través de sus propias urls, a tu localhost. Esto puede usarse para probar un webhook o recibir notificaciones, una tarea bastante común en pasarelas de pago, compartir tu localhost con colaboradores sin necesidad de un dominio propio, etc.

Esquema del funcionamiento de ngrok

Instalación de Ngrok

Para instalar Ngrok entra directamente en su sitio web y creemos una cuenta o iniciemos sesión. Puedes usar Github o Gmail si no quieres registrarte.

Uso básico de ngrok

Para ejecutar ngrok en GNU/Linux basta con correr el ejecutable, seguido de la opción http y un número de puerto. Yo usé 8080 pero puedes usar el que prefieras.

./ngrok http 8080

Si todo funcionó correctamente verás algo parecido a est en tu terminal

Información de Ngrok en la terminal

¿Qué significa la pantalla de arriba? Significa que todas las peticiones que se hagan a http://fc2ca35fd170.ngrok.io ; es decir, al subdominio fc2ca35fd170 del dominio de ngrok, se redirigirán a tu localhost, específicamente al puerto 8080. Y es todo, así de simple y fácil de usar.

¿Cómo usar ngrok con Django?

Para este ejemplo redigirí una aplicación de Django en el puesto 8000, en lugar del puerto 8080.

Si no tienes idea de como usar Django tengo algunas recomendaciones de libros: Django la guia definitiva y Django by example .

Recuerda agregar el dominio, con su subdominio a la variable ALLOWED_HOSTS del archivo de configuración.

# tu_proyecto/settings.py
ALLOWED_HOSTS = ['8da947737113.ngrok.io']

Corramos el servidor de Django, por default correrá en el puerto 8000

python manage.py runserver

Si ahora ejecutamos ngrok, especificamos el puerto 8000 y accedemos a la dirección que nos indica, visualizaremos nuestra aplicación.

ngrok http 8000

Información de la información de Ngrok para el ejemplo de Django

Observa el dominio en el que se ejecuta nuestra aplicación de Django.

Aplicación de Django corriendo en el dominio de Ngrok

¡Logramos poner nuestra aplicación al acceso de cualquier persona que tenga la url que ngrok nos provee!

Eduardo Zepeda
Desarrollador web, entusiasta de los sistemas GNU/Linux y el Software Libre. Py, Ts y Go, pero abierto a otras opciones como el Rustaceanismo. Creo en las bondades de las criptodivisas más allá de la especulación monetaria.
Leer más