Proxyman: qué es, configuración y capacidades para la depuración de tráfico

¿Qué es Proxyman?

Proxyman es un cliente proxy HTTP/HTTPS creado específicamente para el ecosistema Apple. A diferencia de las soluciones multiplataforma, Proxyman utiliza frameworks nativos de macOS (Swift, AppKit), lo que garantiza un alto rendimiento y una integración perfecta con los mecanismos de proxy del sistema. La herramienta es compatible con macOS 11+ y iOS 14+.

Posicionamiento en el mercado

Proxyman se posiciona como una alternativa moderna a Charles Proxy para desarrolladores del ecosistema Apple. Ventajas principales: versión gratuita con funcionalidad básica completa, interfaz nativa que coincide con el sistema de diseño de macOS y configuración automática para el simulador de iOS sin pasos adicionales. Proxyman se desarrolla activamente desde 2018 y cuenta con un sistema abierto de retroalimentación con la comunidad de desarrolladores.

Plataformas compatibles

Proxyman funciona en macOS (aplicación nativa, no Electron) y proporciona una aplicación complementaria para iOS. Los dispositivos físicos (iPhone, iPad) se configuran mediante WiFi Proxy de forma similar a Charles. La aplicación complementaria para iOS (Proxyman iOS companion) permite ver el tráfico directamente en el dispositivo sin necesidad de un ordenador — esta función es exclusiva de Proxyman.

Cómo funciona Proxyman

Proxyman opera según el principio MITM estándar: la aplicación se configura como un proxy del sistema a través del cual pasa todo el tráfico HTTP/HTTPS. La herramienta utiliza los mecanismos nativos de Network Extension de macOS para interceptar el tráfico sin necesidad de configuración manual de proxy para el simulador de iOS.

Mecanismo de interceptación en macOS

En macOS, Proxyman utiliza Apple Network Framework para la interceptación transparente del tráfico. Al activar el proxy, Proxyman crea una interfaz de red virtual a través de la cual pasa el tráfico de todas las aplicaciones. Para el simulador de iOS, la configuración se realiza automáticamente al iniciar — Proxyman detecta los simuladores en ejecución a través de Xcode y redirige su tráfico sin configuración manual de proxy en los ajustes.

Gestión del tráfico HTTPS

Para el descifrado HTTPS, Proxyman instala un certificado raíz local en el llavero del sistema de macOS. Al primer inicio, el programa solicita instalar y confiar en el certificado. Todos los certificados para dominios específicos se generan sobre la marcha y se firman con el certificado raíz de Proxyman. Para el simulador de iOS, el certificado se instala automáticamente al iniciar el proxy.

// Ejemplo de script de Proxyman para modificar respuesta
// Scripting: cambiar el estado de la respuesta a 500 para pruebas de errores
function onResponse(request, response) {
    if (request.url.includes("/api/users")) {
        response.statusCode = 500;
        response.body = JSON.stringify({
            error: "Internal Server Error",
            code: "SERVER_TIMEOUT"
        });
    }
    return response;
}

Principales funciones de Proxyman

Proxyman proporciona un conjunto único de funciones que lo distinguen de otras herramientas proxy. Se hace especial hincapié en la modificación del tráfico mediante scripts y el rendimiento nativo.

Scripting — modificación mediante JavaScript

La principal característica de Proxyman es la compatibilidad con scripts JavaScript para modificar solicitudes y respuestas. En lugar de editar manualmente cada solicitud mediante Breakpoints (como en Charles), el desarrollador puede escribir un script que se aplicará automáticamente a URL específicas. Los scripts tienen acceso completo a cabeceras, cuerpo de la solicitud y respuesta, códigos de estado y metadatos. Esto permite automatizar operaciones rutinarias: sustitución de tokens, modificación de cabeceras, simulación de errores para pruebas.

Filtrado y organización del tráfico

Proxyman ofrece un sistema de filtros flexible basado en reglas. Puedes crear perfiles que agrupen automáticamente el tráfico por dominios, tipos de contenido o códigos de estado. Por ejemplo, todas las solicitudes a la API de tu aplicación se agrupan automáticamente, mientras que los archivos estáticos (CSS, JS, imágenes) van a otro grupo. Esto es especialmente útil al depurar cuando necesitas centrarte solo en endpoints específicos.

Visualización de la línea de tiempo

Proxyman muestra una línea de tiempo de solicitudes al estilo de un diagrama de Gantt, donde cada solicitud se representa con una barra de color que indica duración, estado y tamaño. La línea de tiempo es interactiva: puedes seleccionar un rango de tiempo y ver solo las solicitudes de ese período. Para cada solicitud, está disponible el desglose por fases: DNS, Connect, TLS Handshake, Request, Response.

Proxyman iOS Companion

Una capacidad única de Proxyman es una aplicación iOS independiente que se puede instalar en un iPhone o iPad. Permite ver el tráfico de red directamente en el dispositivo sin necesidad de conectarlo a un ordenador. El tráfico se muestra en tiempo real con capacidades de filtrado y búsqueda. La aplicación es especialmente útil para pruebas de campo cuando no se dispone de un ordenador.

Configurar Proxyman para dispositivos móviles

Proxyman ofrece diferentes métodos de configuración para iOS y Android. Gracias a la integración nativa con Xcode, la configuración para el simulador de iOS es casi automática. Para dispositivos físicos y Android, se requiere configuración manual.

Configuración para el Simulador de iOS

El escenario más sencillo: inicia Proxyman, abre la pestaña iOS Simulator y haz clic en Start. Proxyman detecta automáticamente los simuladores en ejecución a través de Xcode y configura el proxy. El certificado HTTPS también se instala automáticamente. No se requieren acciones adicionales — el tráfico del simulador aparece inmediatamente en la ventana de Proxyman. Esta es una ventaja significativa sobre Charles, donde la configuración del simulador requiere configuración manual del proxy.

Configuración para dispositivos iOS físicos

Para iPhone o iPad: conecta el dispositivo a la misma red WiFi que el ordenador. En la configuración WiFi del dispositivo, especifica el Proxy HTTP: la dirección IP del ordenador y el puerto 9090 (puerto predeterminado de Proxyman). Luego abre Safari y ve a http://proxy.man/ssl para instalar el certificado. En iOS 10.3+, asegúrate de habilitar la confianza del certificado en Settings → General → About → Certificate Trust Settings.

Configuración para Android

Los dispositivos Android se configuran de forma similar a iOS: WiFi Proxy con la dirección IP del ordenador y el puerto 9090. Para HTTPS, debes instalar el certificado a través del navegador en http://proxy.man/ssl. En Android 7+ para compilaciones de depuración, necesitarás un archivo network_security_config.xml que confíe en los certificados de usuario. Para el emulador de Android, usa la dirección IP del host (generalmente 10.0.2.2) en lugar de la IP del ordenador.

<!-- network_security_config.xml para Android con Proxyman -->
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <debug-overrides>
        <trust-anchors>
            <certificates src="user" />
            <certificates src="system" />
        </trust-anchors>
    </debug-overrides>
    <base-config cleartextTrafficPermitted="false">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

Proxyman vs Charles Proxy: comparativa

La elección entre Proxyman y Charles Proxy depende de las necesidades específicas de tu equipo y la plataforma de desarrollo. Examinemos las diferencias clave para ayudar a los desarrolladores a tomar una decisión informada.

Rendimiento e integración nativa

Proxyman está escrito en Swift con AppKit, lo que proporciona un rendimiento nativo de macOS y un consumo mínimo de memoria. Charles está escrito en Java (Eclipse RCP), lo que permite compatibilidad multiplataforma, pero puede llevar a un consumo de memoria ligeramente mayor y una interfaz no nativa en macOS. Para los desarrolladores del ecosistema Apple, Proxyman generalmente se siente más receptivo.

Diferencias funcionales

Charles ofrece un conjunto de herramientas más maduro y amplio: Rewrite Rules con editor visual, Repeat para repetir solicitudes, Map Local/Remote, Auto Save de sesiones. Proxyman responde con funciones más modernas: Scripting en JavaScript, configuración automática del simulador y un compañero iOS para ver el tráfico en el dispositivo. Charles tiene ventaja en escenarios complejos de automatización (Rewrite, Repeat), mientras que Proxyman destaca en la modificación rápida y flexible mediante scripts.

Precio y licencias

Proxyman ofrece una versión gratuita con funcionalidad básica sin límite de tiempo. La versión Pro (suscripción ~$12/año o compra única ~$59) desbloquea funciones avanzadas: scripting, filtros, exportación. Charles cuesta $50 por licencia con un trial de 30 días. Para desarrolladores independientes, Proxyman es más asequible; para entornos empresariales, la diferencia es insignificante.