Sobre el proyecto
Visión general
Whistle (pronunciado /ˈwisəl/) es una herramienta de depuración y captura de paquetes de red basada en Node.js, publicada como un paquete de npm bajo la licencia MIT. El README indica que es compatible con versiones de Node.js >= 8.
Características principales
- Captura y modificación: Admite la captura de paquetes HTTP, HTTPS, HTTP/2, WebSocket y TCP, con la capacidad de modificar el contenido de las solicitudes y respuestas.
- Modos de proxy: Soporta proxy HTTP, HTTPS, Socks y reverso.
- Herramientas de depuración integradas: Incluye Weinre (inspección remota de DOM), Console (visualización de logs de consola) y Composer (reproducción y edición de solicitudes).
- Configuración de reglas: Permite modificar solicitudes/respuestas a través de la configuración de reglas.
- Interfaz de gestión unificada: Centraliza la captura de paquetes, reglas, plugins y herramientas como Weinre/Console/Composer en una sola interfaz.
- Extensibilidad: Admite la extensión de reglas e interfaz mediante plugins, y puede ser utilizado como un módulo de NPM en proyectos.
- Compatibilidad multiplataforma: Funciona en sistemas de escritorio como macOS, Windows y Linux (Ubuntu/Fedora), así como en entornos de servidor Linux sin interfaz gráfica.
Instalación y puesta en marcha
- Para usuarios de escritorio, se recomienda el cliente Whistle (avwo/whistle-client), que simplifica la instalación y configuración.
- En entornos Linux/servidor sin interfaz, se debe instalar primero Node.js, luego ejecutar npm i -g whistle. También es posible instalarlo con Homebrew (brew install whistle).
- Inicio: w2 start.
- Instalación del certificado raíz (para captura de HTTPS): w2 ca. Durante la instalación, puede ser necesario confirmar manualmente, por ejemplo, seleccionando “Sí (Y)” en Windows o ingresando la contraseña de inicio de sesión en macOS.
- Configuración del proxy: w2 proxy; también se puede especificar una dirección, como w2 proxy "10.x.x.x:8888", o desactivar el proxy del sistema con w2 proxy 0.
- Otras opciones de proxy: Extensión de Chrome ZeroOmega (para cambiar de proxy entre navegadores), configuración de proxy en el navegador o herramientas de desarrollo (como Firefox o WeChat Developer Tools), y Proxifier para aplicaciones que no admiten configuración de proxy directa (Windows/macOS).
Comandos comunes
start (iniciar), stop (detener), restart (reiniciar), status (ver estado), ca (instalar certificado), proxy [host:port] (configurar proxy, proxy 0 para desactivar).
Documentación y licencia
Para obtener una guía de uso detallada y ejemplos, consulte la documentación oficial en https://wproxy.org/docs/getting-started.html. El proyecto está licenciado bajo MIT, como se detalla en el archivo LICENSE.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.