Proxyman: Was ist das, Einrichtung und Möglichkeiten zum Traffic-Debugging

Was ist Proxyman?

Proxyman ist ein HTTP/HTTPS-Proxy-Client, der speziell für das Apple-Ökosystem entwickelt wurde. Im Gegensatz zu plattformübergreifenden Lösungen verwendet Proxyman native macOS-Frameworks (Swift, AppKit), was hohe Leistung und nahtlose Integration mit den systemeigenen Proxy-Mechanismen gewährleistet. Das Tool unterstützt macOS 11+ und iOS 14+.

Marktpositionierung

Proxyman positioniert sich als moderne Alternative zu Charles Proxy für Entwickler im Apple-Ökosystem. Hauptvorteile: kostenlose Version mit vollständiger Basisfunktionalität, native Oberfläche, die dem macOS-Designsystem entspricht, und automatische Konfiguration für den iOS-Simulator ohne zusätzliche Schritte. Proxyman wird seit 2018 aktiv entwickelt und verfügt über ein offenes Feedbacksystem mit der Entwickler-Community.

Unterstützte Plattformen

Proxyman läuft auf macOS (native Anwendung, nicht Electron) und bietet eine Begleitanwendung für iOS. Physische Geräte (iPhone, iPad) werden ähnlich wie bei Charles über WiFi Proxy konfiguriert. Die iOS-Begleitanwendung (Proxyman iOS companion) ermöglicht die Anzeige des Traffics direkt auf dem Gerät ohne Computer — diese Funktion ist einzigartig für Proxyman.

Wie Proxyman funktioniert

Proxyman arbeitet nach dem standardmäßigen MITM-Prinzip: Die Anwendung wird als System-Proxy konfiguriert, durch den der gesamte HTTP/HTTPS-Traffic geleitet wird. Das Tool verwendet native macOS Network Extension-Mechanismen zum Abfangen von Traffic, ohne dass eine manuelle Proxy-Konfiguration für den iOS-Simulator erforderlich ist.

Abfangmechanismus unter macOS

Unter macOS verwendet Proxyman das Apple Network Framework für transparentes Traffic-Abfangen. Bei Aktivierung des Proxys erstellt Proxyman eine virtuelle Netzwerkschnittstelle, durch die der Traffic aller Anwendungen geleitet wird. Für den iOS-Simulator erfolgt die Konfiguration automatisch beim Start — Proxyman erkennt laufende Simulatoren über Xcode und leitet deren Traffic ohne manuelle Proxy-Einrichtung in den Einstellungen um.

HTTPS-Traffic-Verarbeitung

Zur HTTPS-Entschlüsselung installiert Proxyman ein lokales Root-Zertifikat im macOS-Systemschlüsselbund. Beim ersten Start fordert das Programm zur Installation und Vertrauensstellung des Zertifikats auf. Alle Zertifikate für bestimmte Domains werden dynamisch generiert und mit dem Proxyman-Root-Zertifikat signiert. Für den iOS-Simulator wird das Zertifikat automatisch beim Start des Proxys installiert.

// Proxyman-Skriptbeispiel zur Antwortmodifikation
// Scripting: Antwortstatus auf 500 ändern zum Fehlertesten
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;
}

Hauptfunktionen von Proxyman

Proxyman bietet eine einzigartige Reihe von Funktionen, die es von anderen Proxy-Tools unterscheiden. Besonderer Schwerpunkt liegt auf der skriptbasierten Traffic-Modifikation und der nativen Leistung.

Scripting — Modifikation über JavaScript

Das Hauptmerkmal von Proxyman ist die Unterstützung für JavaScript-Skripte zum Ändern von Anfragen und Antworten. Anstatt jede Anfrage manuell über Breakpoints zu bearbeiten (wie in Charles), kann der Entwickler ein Skript schreiben, das automatisch auf bestimmte URLs angewendet wird. Skripte haben vollständigen Zugriff auf Header, Anfrage- und Antwortkörper, Statuscodes und Metadaten. Dies ermöglicht die Automatisierung von Routinevorgängen: Token-Ersetzung, Header-Modifikation, Fehlersimulation für Tests.

Traffic-Filterung und -Organisation

Proxyman bietet ein flexibles, regelbasiertes Filtersystem. Sie können Profile erstellen, die Traffic automatisch nach Domains, Inhaltstypen oder Statuscodes gruppieren. Zum Beispiel werden alle Anfragen an die API Ihrer Anwendung automatisch in eine Gruppe einsortiert, während statische Assets (CSS, JS, Bilder) in eine andere Gruppe kommen. Dies ist besonders nützlich beim Debuggen, wenn Sie sich nur auf bestimmte Endpunkte konzentrieren müssen.

Zeitleistenvisualisierung

Proxyman zeigt eine Anfragen-Zeitleiste im Gantt-Diagramm-Stil an, bei der jede Anfrage durch einen farbigen Balken dargestellt wird, der Dauer, Status und Größe angibt. Die Zeitleiste ist interaktiv: Sie können einen Zeitbereich auswählen und nur die Anfragen dieses Zeitraums sehen. Für jede Anfrage ist eine Phasenaufschlüsselung verfügbar: DNS, Connect, TLS Handshake, Request, Response.

Proxyman iOS Companion

Eine einzigartige Fähigkeit von Proxyman ist eine separate iOS-Anwendung, die auf einem iPhone oder iPad installiert werden kann. Sie ermöglicht die Anzeige von Netzwerkverkehr direkt auf dem Gerät ohne Verbindung zu einem Computer. Der Traffic wird in Echtzeit mit Filter- und Suchfunktionen angezeigt. Die App ist besonders nützlich für Feldtests, wenn kein Computer verfügbar ist.

Proxyman für mobile Geräte einrichten

Proxyman bietet verschiedene Einrichtungsmethoden für iOS und Android. Dank der nativen Xcode-Integration ist die Konfiguration für den iOS-Simulator nahezu automatisch. Für physische Geräte und Android ist eine manuelle Konfiguration erforderlich.

Einrichtung für den iOS-Simulator

Das einfachste Szenario: Starten Sie Proxyman, öffnen Sie den Tab iOS Simulator und klicken Sie auf Start. Proxyman erkennt automatisch laufende Simulatoren über Xcode und konfiguriert den Proxy. Das HTTPS-Zertifikat wird ebenfalls automatisch installiert. Es sind keine weiteren Aktionen erforderlich — der Simulator-Traffic erscheint sofort im Proxyman-Fenster. Dies ist ein erheblicher Vorteil gegenüber Charles, bei dem die Simulator-Einrichtung eine manuelle Proxy-Konfiguration erfordert.

Einrichtung für physische iOS-Geräte

Für iPhone oder iPad: Verbinden Sie das Gerät mit dem gleichen WiFi-Netzwerk wie den Computer. Geben Sie in den WiFi-Einstellungen des Geräts den HTTP-Proxy an: die IP-Adresse des Computers und Port 9090 (Standard-Port von Proxyman). Öffnen Sie dann Safari und gehen Sie zu http://proxy.man/ssl, um das Zertifikat zu installieren. Unter iOS 10.3+ aktivieren Sie unbedingt die Zertifikatsvertrauensstellung unter Settings → General → About → Certificate Trust Settings.

Einrichtung für Android

Android-Geräte werden ähnlich wie iOS konfiguriert: WiFi-Proxy mit der IP-Adresse des Computers und Port 9090. Für HTTPS müssen Sie das Zertifikat über den Browser unter http://proxy.man/ssl installieren. Unter Android 7+ für Debug-Builds benötigen Sie eine network_security_config.xml-Datei, die Benutzerzertifikaten vertraut. Für den Android-Emulator verwenden Sie die Host-IP-Adresse (normalerweise 10.0.2.2) anstelle der Computer-IP.

<!-- network_security_config.xml für Android mit 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: Vergleich

Die Wahl zwischen Proxyman und Charles Proxy hängt von den spezifischen Anforderungen Ihres Teams und der Entwicklungsplattform ab. Lassen Sie uns die wichtigsten Unterschiede untersuchen, um Entwicklern eine fundierte Entscheidung zu ermöglichen.

Leistung und native Integration

Proxyman ist in Swift mit AppKit geschrieben, was native macOS-Leistung und minimalen Speicherverbrauch bietet. Charles ist in Java (Eclipse RCP) geschrieben, was plattformübergreifende Kompatibilität ermöglicht, aber zu einem etwas höheren Speicherverbrauch und einer nicht nativen Oberfläche unter macOS führen kann. Für Entwickler im Apple-Ökosystem fühlt sich Proxyman in der Regel reaktionsschneller an.

Funktionale Unterschiede

Charles bietet ein ausgereifteres und breiteres Werkzeugspektrum: Rewrite Rules mit visuellem Editor, Repeat zum Wiederholen von Anfragen, Map Local/Remote, Auto Save von Sitzungen. Proxyman kontert mit moderneren Funktionen: JavaScript Scripting, automatische Simulator-Konfiguration und einem iOS-Begleiter zur Traffic-Anzeige auf dem Gerät. Charles hat Vorteile bei komplexen Automatisierungsszenarien (Rewrite, Repeat), während Proxyman bei der schnellen und flexiblen Modifikation durch Skripte glänzt.

Preis und Lizenzierung

Proxyman bietet eine kostenlose Version mit Basisfunktionalität ohne Zeitbegrenzung. Die Pro-Version (Abonnement ~$12/Jahr oder einmaliger Kauf ~$59) schaltet erweiterte Funktionen frei: Scripting, Filter, Export. Charles kostet 50$ pro Lizenz mit einer 30-tägigen Testversion. Für Indie-Entwickler ist Proxyman erschwinglicher; für Unternehmensumgebungen ist der Unterschied vernachlässigbar.