ngrok

ngrok es un agente de línea de comandos que conecta servicios locales o privados a la red en la nube de ngrok mediante una conexión saliente cifrada. Proporciona endpoints públicos sin requerir cambios en el firewall de entrada ni una dirección IP pública en la máquina de origen. Los desarrolladores lo usan para previsualizaciones de aplicaciones, pruebas de webhooks, desarrollo de API y acceso controlado a servicios detrás de NAT o firewalls.

Características principales

• Expone servicios HTTP y HTTPS locales mediante endpoints públicos y reenvía el tráfico a un puerto upstream elegido.
• Crea endpoints TCP o TLS para casos de uso no HTTP compatibles, sujeto a los derechos de tu cuenta.
• Aplica Traffic Policy para autenticar solicitudes, enrutar tráfico, reescribir solicitudes o limitar la tasa de acceso antes de llegar al upstream.
• Inspecciona el tráfico HTTP y reproduce solicitudes capturadas para depurar webhooks y reproducir fallos.
• Configura endpoints y el comportamiento del agente en un archivo de configuración, automatiza comandos compatibles o ejecuta el agente como un servicio del sistema operativo.
• Usa una conexión TLS saliente en el puerto 443 para transportar el tráfico desde la red de ngrok de vuelta al origen.

Instalación y primer uso

Instala brew install --cask ngrok. El paquete instala el ejecutable ngrok y los autocompletados de shell, no una aplicación gráfica de Mac. Crea una cuenta de ngrok, obtén tu propio authtoken de agente y configúralo con ngrok config add-authtoken <YOUR_AUTHTOKEN>. Inicia tu aplicación local y luego ejecuta ngrok http 8080, reemplazando 8080 por su puerto de escucha. Usa el endpoint que imprime el agente. El endpoint creado por este agente existe mientras se ejecuta la sesión del agente; un Cloud Endpoint separado tiene un comportamiento de ciclo de vida diferente.

Requisitos, dependencias y conflictos

El agente independiente no tiene ninguna dependencia de tiempo de ejecución externa. Homebrew no declara ninguna dependencia de fórmula adicional, ni conflictos explícitos de cask, ni una versión mínima explícita de macOS en esta instantánea. Proporciona descargas nativas separadas para Apple Silicon e Intel Macs. Esos metadatos no establecen compatibilidad con todas las versiones históricas de macOS; consulta la página de descargas del proveedor para obtener compilaciones compatibles.

El proveedor documenta 64 MB de memoria mínima, 128 MB recomendados y aproximadamente 25 MB de disco; el uso real de recursos aumenta con el tráfico concurrente. Estas son pautas de tiempo de ejecución, no el tamaño de la descarga comprimida. Tu aplicación upstream debe estar en ejecución y ser accesible desde el agente. Se requiere acceso a Internet y conectividad TLS saliente hacia ngrok para los endpoints en la nube; los controles de proxy corporativo, firewall o cuenta pueden afectar la conectividad.

Las compilaciones oficiales separadas del agente son compatibles con macOS x86-64/arm64, Windows x86-64/x86, Linux en las familias x86, ARM, MIPS, PowerPC y s390x, y FreeBSD x86-64/x86/ARM. Descarga la compilación adecuada en lugar de usar el ZIP para Mac en otro sistema operativo. Los SDK del agente, los contenedores y SSH inverso son opciones de implementación separadas. Las herramientas que utiliza el servicio upstream conservan sus propios requisitos.

Cuentas, costos y licencia

Usar el agente de la nube de ngrok requiere una cuenta y un authtoken de agente. Hay un plan gratuito con límites; los planes de pago o basados en uso ofrecen diferentes cuotas y funciones. Los dominios, las opciones de autenticación, los protocolos de endpoint, la retención de tráfico y los cargos por uso dependen del plan actual. Descargar el binario no hace que todas las funciones del servicio ngrok sean gratuitas o ilimitadas.

El agente actual y el servicio en la nube se rigen por los Términos de servicio de ngrok. El agente distribuido moderno no es el antiguo proyecto de código abierto ngrok v1. El repositorio comunitario oficial se utiliza para comentarios y seguimiento de problemas; no es el código fuente completo de este agente. Los SDK de código abierto y otros componentes de ngrok tienen sus propias licencias.

Referencias: descarga para macOS, instalación y requisitos del agente, descripción general del agente, inspección de tráfico, precios y términos.