Proxyman: ce este, configurarea și posibilitățile de depanare a traficului

Ce este Proxyman?

Proxyman este un client proxy HTTP/HTTPS creat special pentru ecosistemul Apple. Spre deosebire de soluțiile cross-platform, Proxyman utilizează framework-uri native macOS (Swift, AppKit), ceea ce asigură performanță ridicată și integrare perfectă cu mecanismele de proxy ale sistemului. Instrumentul suportă macOS 11+ și iOS 14+.

Poziționarea pe piață

Proxyman se poziționează ca o alternativă modernă la Charles Proxy pentru dezvoltatorii din ecosistemul Apple. Principalele avantaje: versiune gratuită cu funcționalitate de bază completă, interfață nativă conformă cu sistemul de design macOS, configurare automată pentru simulatorul iOS fără acțiuni suplimentare. Proxyman se dezvoltă activ din 2018 și are un sistem deschis de feedback cu comunitatea de dezvoltatori.

Platforme suportate

Proxyman funcționează pe macOS (aplicație nativă, nu Electron) și oferă o aplicație auxiliară pentru iOS. Dispozitivele fizice (iPhone, iPad) se configurează prin WiFi Proxy similar cu Charles. Aplicația pentru iOS (Proxyman iOS companion) permite vizualizarea traficului direct pe dispozitiv fără computer — această funcție este unică pentru Proxyman.

Cum funcționează Proxyman

Proxyman funcționează conform principiului MITM standard: aplicația este configurată ca proxy de sistem prin care trece tot traficul HTTP/HTTPS. Instrumentul utilizează mecanismele native macOS Network Extension pentru interceptarea traficului fără a fi necesară configurarea manuală a proxy-ului pentru simulatorul iOS.

Mecanismul de interceptare pe macOS

Pe macOS, Proxyman utilizează Apple Network Framework pentru interceptarea transparentă a traficului. La activarea proxy-ului, Proxyman creează o interfață de rețeană virtuală prin care trece traficul tuturor aplicațiilor. Pentru simulatorul iOS, configurarea are loc automat la pornire — Proxyman detectează prin Xcode simulatoarele lansate și redirecționează traficul lor fără setarea manuală a proxy-ului în setări.

Procesarea traficului HTTPS

Pentru decriptarea HTTPS, Proxyman instalează un certificat rădăcină local în setul de chei de sistem macOS. La prima lansare, programul propune instalarea certificatului și acordarea de încredere. Toate certificatele pentru domenii specifice sunt generate din mers și semnate cu certificatul rădăcină Proxyman. Pentru simulatorul iOS, certificatul este instalat automat la pornirea proxy-ului.

// Exemplu de script Proxyman pentru modificarea răspunsului
// Scripting: schimbăm starea răspunsului la 500 pentru testarea erorilor
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;
}

Principalele capacități ale Proxyman

Proxyman oferă un set unic de funcții care îl deosebesc de alte instrumente proxy. Accentul special este pus pe modificarea scriptată a traficului și performanța nativă.

Scripting — modificare prin JavaScript

Caracteristica principală a Proxyman — suport pentru scripturi JavaScript pentru modificarea cererilor și răspunsurilor. În loc să editați manual fiecare cerere prin Breakpoints (ca în Charles), dezvoltatorul poate scrie un script care va fi aplicat automat la URL-uri specifice. Scripturile au acces complet la antete, corpul cererii și răspunsului, codul de stare și metadate. Acest lucru permite automatizarea operațiilor de rutină: înlocuirea tokenului de autorizare, modificarea antetelor, emularea erorilor pentru testare.

Filtrarea și organizarea traficului

Proxyman oferă un sistem flexibil de filtre bazat pe reguli. Puteți crea profile care grupează automat traficul pe domenii, tipuri de conținut sau coduri de stare. De exemplu, toate cererile către API-ul aplicației dvs. ajung automat într-un grup separat, iar elementele statice (CSS, JS, imagini) — într-altul. Acest lucru este deosebit de convenabil la depanare, când trebuie să vă concentrați doar pe anumite endpoint-uri.

Vizualizarea cronologiei

Proxyman afișează cronologia cererilor în stilul unei diagrame temporale, unde fiecare cerere este reprezentată printr-o bandă colorată cu informații despre durată, stare și dimensiune. Cronologia este interactivă: puteți selecta un interval de timp și vedea doar cererile din această perioadă. Pentru fiecare cerere este disponibilă o defalcare pe faze: DNS, Connect, TLS Handshake, Request, Response.

Proxyman iOS Companion

O capacitate unică Proxyman — o aplicație separată pentru iOS care poate fi instalată pe iPhone sau iPad. Aceasta permite vizualizarea traficului de rețeană direct pe dispozitiv fără conexiune la computer. Traficul este afișat în timp real cu posibilitatea de filtrare și căutare. Aplicația este deosebit de utilă în testarea pe teren când nu există acces la computer.

Configurarea Proxyman pentru dispozitive mobile

Proxyman oferă diferite moduri de configurare pentru iOS și Android. Datorită integrării native cu Xcode, configurarea pentru simulatorul iOS are loc aproape automat. Pentru dispozitivele fizice și Android este necesară configurarea manuală.

Configurarea pentru iOS Simulator

Cel mai simplu scenariu: lansați Proxyman, deschideți fila iOS Simulator și faceți clic pe Start. Proxyman va detecta automat simulatoarele lansate prin Xcode și va configura proxy-ul. Certificatul HTTPS este de asemenea instalat automat. Nu sunt necesare acțiuni suplimentare — traficul simulatorului apare imediat în fereastra Proxyman. Acesta este un avantaj semnificativ față de Charles, unde configurarea simulatorului necesită setarea manuală a proxy-ului.

Configurarea pentru dispozitivul iOS fizic

Pentru iPhone sau iPad: conectați dispozitivul la aceeași rețeană WiFi ca și computerul. În setările WiFi ale dispozitivului, specificați HTTP Proxy: adresa IP a computerului și portul 9090 (portul implicit Proxyman). Apoi deschideți Safari și accesați http://proxy.man/ssl pentru instalarea certificatului. Pe iOS 10.3+, activați încrederea certificatului în Settings → General → About → Certificate Trust Settings.

Configurarea pentru Android

Dispozitivele Android se configurează similar cu iOS: WiFi Proxy cu adresa IP a computerului și portul 9090. Pentru HTTPS este necesară instalarea certificatului prin browser la http://proxy.man/ssl. Pe Android 7+, pentru compilarea de debug a aplicației va fi necesar fișierul network_security_config.xml cu încredere în certificatele utilizatorului. Pentru emulatorul Android, utilizați adresa IP a gazdei (de obicei 10.0.2.2) în locul IP-ului computerului.

<!-- network_security_config.xml pentru Android cu 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: comparație

Alegerea între Proxyman și Charles Proxy depinde de nevoile specifice ale echipei și de platforma de dezvoltare. Să analizăm diferențele cheie pentru a ajuta dezvoltatorul să ia o decizie informată.

Performanță și caracter nativ

Proxyman este scris în Swift cu AppKit, ceea ce asigură performanță nativă macOS și consum minim de memorie. Charles este scris în Java (Eclipse RCP), ceea ce oferă cross-platformitate, dar poate duce la un consum ușor mai mare de memorie și o interfață non-nativă pe macOS. Pentru dezvoltatorii din ecosistemul Apple, Proxyman se simte de obicei mai receptiv.

Diferențe funcționale

Charles oferă un set mai matur și mai larg de instrumente: Rewrite Rules cu editor vizual, Repeat pentru repetarea cererilor, Map Local/Remote, Auto Save al sesiunilor. Proxyman răspunde cu funcții mai moderne: Scripting în JavaScript, configurare automată a simulatorului, iOS-companion pentru vizualizarea traficului pe dispozitiv. Charles are avantaj în scenarii complexe de automatizare (Rewrite, Repeat), iar Proxyman — în modificarea rapidă și flexibilă prin scripturi.

Preț și licențiere

Proxyman oferă o versiune gratuită cu funcționalitate de bază fără limită de timp. Versiunea Pro (abonament ~$12/an sau achiziție unică ~$59) deblochează funcții avansate: scripting, filtre, export. Charles — $50 pentru o licență cu trial de 30 de zile. Pentru dezvoltatorii independenți, Proxyman este mai accesibil; pentru mediile corporative, diferența este nesemnificativă.