ngrok

ngrok es una herramienta de red en la nube y para desarrolladores que crea puntos de conexión públicos seguros para aplicaciones, API, sitios web y servicios de red que se ejecutan en un PC local con Windows.



Es particularmente útil para desarrolladores que necesitan compartir proyectos de localhost, probar webhooks, demostrar aplicaciones sin terminar o proporcionar acceso remoto temporal sin configurar routers, firewalls, reenvío de puertos o direcciones IP públicas.

El agente de Windows establece una conexión saliente cifrada entre el ordenador y la red en la nube globalmente distribuida de ngrok.

Las solicitudes entrantes enviadas a la dirección pública generada se reenvían al puerto local seleccionado.

Dado que la conexión se inicia desde el ordenador, ngrok puede operar normalmente detrás de NAT, firewalls corporativos y conexiones IP dinámicas.

Aunque comúnmente se describe como una utilidad de tunelización, también proporciona capacidades de pasarela API, gestión de tráfico, autenticación, inspección de solicitudes, gestión de dominios y entrada de producción.



El equipo de desarrollo de FileHorse recomienda ngrok como una solución práctica para desarrolladores que prueban regularmente aplicaciones web, integraciones y servicios activados externamente.

Características

• Puntos de Conexión Públicos Seguros: Expone servicios locales HTTP, HTTPS, TCP y TLS compatibles a través de direcciones públicas.
• HTTPS Automático: Protege los puntos de conexión web con certificados de cifrado gestionados automáticamente.
• Compartición de Localhost: Hace que los sitios web de desarrollo estén disponibles para clientes, colegas o dispositivos de prueba.
• Prueba de Webhooks: Recibe devoluciones de llamada de plataformas de pago, servicios de mensajería, repositorios y otras API externas.
• Inspector de Tráfico: Muestra las solicitudes HTTP entrantes, encabezados, detalles de respuesta e información de tiempo.
• Reenvío de Solicitudes: Reenvía solicitudes capturadas sin requerir que el servicio externo las active de nuevo.
• Dominios Personalizados: Los planes de pago pueden conectar puntos de conexión a dominios propiedad del usuario.
• Políticas de Tráfico: Aplica autenticación, enrutamiento, modificación de encabezados, redirecciones, controles de tasa y otras reglas de tráfico.
• Protección OAuth y OIDC: Restringe el acceso requiriendo a los visitantes que se autentiquen a través de proveedores de identidad compatibles.
• Reenvío TCP: Proporciona acceso remoto a servicios como SSH, bases de datos, servidores de juegos y dispositivos de desarrollo.
• Gestión de Agentes: Permite monitorear agentes y puntos de conexión conectados desde un panel de control central.
• Soporte de SDK e Infraestructura: Se integra con código de aplicación, API, entornos de Kubernetes y flujos de trabajo de despliegue automatizado.

Interfaz de Usuario

ngrok se opera principalmente a través de Símbolo del sistema, PowerShell o Terminal de Windows.

Su interfaz de línea de comandos es compacta y fácil de entender una vez que se ha configurado el token de la cuenta.

Iniciar un punto de conexión básico normalmente requiere solo un comando que contenga el protocolo y el puerto local.

Un panel de control basado en navegador complementa al agente de Windows al mostrar puntos de conexión, dominios, uso de la cuenta, credenciales, políticas de tráfico y agentes conectados.

La interfaz de inspección local es especialmente útil durante el desarrollo porque organiza las solicitudes y respuestas capturadas en un formato legible.

Los principiantes pueden necesitar tiempo para aprender opciones de línea de comandos, archivos de configuración y conceptos de red. Sin embargo, compartir localhost de forma rutinaria sigue siendo simple.

Instalación y Configuración

Se puede instalar a través de la Microsoft Store, WinGet, Scoop o como un ejecutable de Windows independiente.

La versión independiente no requiere un instalador grande ni un paquete de tiempo de ejecución adicional.

Después de la instalación, los usuarios deben crear una cuenta y añadir su token de autenticación personal al agente.

Esto conecta la instalación de Windows a la cuenta del usuario y habilita los dominios asignados, el seguimiento de uso y la gestión de puntos de conexión.

El comando de configuración básico es:

ngrok config add-authtoken YOUR_TOKEN

Una vez completada la autorización, ngrok está listo para exponer un servicio local.

Cómo Usar

• Instale ngrok en el PC con Windows.
• Abra PowerShell, Símbolo del sistema o Terminal de Windows.
• Añada el token de autenticación de la cuenta usando el comando de configuración.
• Inicie el sitio web local, API o aplicación que desee exponer.
• Identifique el puerto local utilizado por la aplicación, como 3000, 5000, 8000 o 8080.
• Introduzca un comando como ngrok http 8080.
• Copie la dirección de reenvío HTTPS generada que se muestra en el terminal.
• Abra la dirección pública en un navegador o añádala al servicio externo que se está probando.
• Revise las solicitudes entrantes a través de la interfaz de inspección al depurar webhooks o API.
• Presione Ctrl+C en el terminal cuando desee cerrar el punto de conexión.

Preguntas Frecuentes

¿Es ngrok gratuito?
Sí. Un plan Gratuito está disponible para desarrollo y pruebas personales. Incluye un dominio de desarrollo asignado, hasta tres puntos de conexión en línea, 1 GB de transferencia de datos salientes mensual y hasta 20,000 solicitudes HTTP o HTTPS.

¿Puede ngrok exponer un sitio web de localhost?
Sí. Ejecutar un comando como ngrok http 3000 crea una dirección pública que reenvía las solicitudes a la aplicación utilizando el puerto local 3000.

¿Requiere ngrok reenvío de puertos?
No. El agente crea una conexión saliente cifrada, por lo que los usuarios generalmente no necesitan modificar la configuración del router ni obtener una dirección IP pública estática.

¿Se puede usar ngrok para aplicaciones de producción?
Sí, pero las cargas de trabajo de producción normalmente requieren un plan de pago, políticas de tráfico adecuadas, controles de acceso, monitoreo y límites de uso cuidadosamente planificados.

¿Es seguro usar ngrok?
La conexión está cifrada, pero exponer cualquier servicio local crea riesgos de seguridad potenciales. Los usuarios deben proteger los puntos de conexión privados con autenticación, restricciones de acceso y configuraciones seguras de la aplicación.

Precios

Gratis: $0 con tráfico mensual, solicitudes, puntos de conexión y un miembro de cuenta limitados.

Aficionado: $10 al mes o $8 al mes si se factura anualmente, con crédito de uso mensual, límites más altos, dominios adicionales con la marca ngrok y eliminación de la página intersticial del navegador.

Pago por Uso: Comienza en $20 al mes con uso incluido, puntos de conexión en línea ilimitados, soporte para dominios personalizados, miembros de equipo adicionales y cargos basados en el uso más allá de la asignación incluida.

La gestión avanzada de identidades, la conectividad dedicada, el soporte mejorado, los certificados personalizados y las opciones de cumplimiento empresarial pueden tener un costo adicional.

Requisitos del Sistema

• Sistema Operativo: Windows 10 o Windows 11.
• Arquitectura: Dispositivo Windows x86 de 64 bits o ARM64 compatible.
• Procesador: Procesador moderno Intel, AMD o compatible con ARM.
• Memoria: Uso mínimo de RAM para el agente; la memoria adicional depende de la aplicación local.
• Almacenamiento: Pequeña cantidad de espacio libre para el ejecutable y los archivos de configuración.
• Conexión a Internet: Requerida para conectar el agente a la red en la nube.
• Cuenta: Requerida para un token de autenticación y gestión de puntos de conexión.
• Terminal: Se recomienda PowerShell, Símbolo del sistema o Terminal de Windows.

VENTAJAS

• Crea puntos de conexión públicos en segundos.
• No requiere reenvío de puertos del router.
• Incluye cifrado HTTPS automático.
• Excelente para pruebas de webhooks.
• Proporciona inspección y reenvío de solicitudes.
• Funciona detrás de NAT y muchos firewalls.
• Soporta flujos de trabajo de desarrollo y producción.

DESVENTAJAS

• Requiere una cuenta en línea.
• Se controla principalmente a través de una línea de comandos.
• Los límites de uso gratuito pueden ser restrictivos.
• Los puntos de conexión públicos pueden exponer aplicaciones locales inseguras.
• Las características avanzadas requieren planes de pago.
• La tarificación basada en el uso puede ser difícil de estimar.
• Se necesitan algunos conocimientos de red para configuraciones complejas.

Conclusión

ngrok es una potente utilidad de red de Windows para exponer aplicaciones locales, probar webhooks, compartir proyectos de desarrollo y enrutar de forma segura el tráfico externo.

Sus comandos directos hacen que la tunelización básica sea accesible, mientras que las políticas de tráfico, la autenticación, los dominios personalizados y las características de pasarela soportan implementaciones más avanzadas.

Los límites gratuitos son más adecuados para pruebas que para tráfico de producción sostenido.

Traducido por el Equipo de Localización de Filehorse