Proxy im Mobile-QA: Emulator, echtes Gerät und adb reverse – Schritt-für-Schritt-Anleitung
Inhalt des Artikels
- Einführung: warum sie als tester einen eigenen proxy zwischen app und server brauchen
- Vorbereitung: tools, zugänge und systemanforderungen
- Grundbegriffe: wie das abfangen von traffic funktioniert
- Schritt 1: abfangenden proxy auf dem computer starten
- Schritt 2: traffic des android-emulators durch den proxy leiten
- Schritt 3: proxy-zertifikat installieren und vertrauensproblem lösen
- Schritt 4: echtes gerät über wlan anbinden
- Schritt 5: portweiterleitung über adb reverse – proxy per usb ohne wlan
- Schritt 6: traffic der testumgebung abfangen und ersetzen
- Ergebnis prüfen: abschließende checkliste
- Typische fehler und lösungen
- Zusätzliche möglichkeiten für fortgeschrittene tester
- Faq: häufige fragen zur proxy-einrichtung im mobile-testing
- Fazit
Einführung: Warum Sie als Tester einen eigenen Proxy zwischen App und Server brauchen
Stellen Sie sich vor: Sie testen eine mobile App, tippen auf eine Schaltfläche und auf dem Bildschirm erscheint eine nichtssagende Fehlermeldung: „Etwas ist schiefgelaufen“. Der Entwickler fragt: „Welche Anfrage wurde gesendet? Welche Antwort kam zurück? Welcher Statuscode?“ Ohne Proxy zucken Sie mit den Schultern. Mit Proxy öffnen Sie die Liste der Anfragen, kopieren den Antworttext des Servers und hängen ihn in 30 Sekunden an den Bug. Das ist der Unterschied zwischen einem Tester, der nur „klickt“, und einem Tester, der versteht, was unter der Haube passiert.
Dieser Artikel unterscheidet sich bewusst von Anleitungen für normale Nutzer, in denen erklärt wird, wie man die Proxy-Adresse in den WLAN-Einstellungen des Telefons einträgt. Hier betrachten wir den Arbeitsablauf eines QA-Ingenieurs: einen abfangenden Proxy auf dem Computer, das Umleiten des Traffics des Android-Emulators dorthin, das Anbinden eines echten Geräts über WLAN und über USB per Portweiterleitung mit dem Befehl adb reverse sowie das Abfangen und Ersetzen des Traffics der Testumgebung. Die benutzerseitige Proxy-Einstellung auf dem Telefon ist nur ein kleiner Baustein in diesem Prozess.
Was Sie am Ende haben werden
- Einen funktionierenden abfangenden Proxy (mitmproxy oder Charles), der jede HTTP- und HTTPS-Anfrage Ihrer App anzeigt.
- Einen Android-Emulator, dessen Traffic über diesen Proxy läuft, einschließlich verschlüsseltem Traffic.
- Ein echtes Smartphone, das auf zwei Arten mit dem Proxy verbunden ist: über WLAN und über USB-Kabel per adb reverse.
- Ein Verständnis dafür, warum die App dem Zertifikat „nicht vertraut“ und wie man das in einem Test-Build löst.
- Die Fähigkeit, Antworten der Testumgebung zu ersetzen, ein langsames Netzwerk und Serverfehler zu simulieren, ohne den Backend-Entwickler einzubeziehen.
Für wen dieser Leitfaden gedacht ist
Für manuelle und automatisierte Tester mobiler Apps, die den Netzwerkverkehr sehen wollen, statt zu raten. Für Junior-Tester, denen im neuen Job gesagt wurde: „Schau mal in Charles“, ohne zu erklären, was das ist und wie es geht. Für Entwickler, die die Testumgebung für das Team einrichten.
Was Sie vorher wissen sollten
Ein grundlegendes Verständnis davon, was eine HTTP-Anfrage, eine Antwort und die Statuscodes 200 und 500 sind. Die Fähigkeit, ein Terminal oder eine Eingabeaufforderung zu öffnen und dort einen Befehl auszuführen. Erfahrung mit der Installation von Apps auf Android. Wenn Sie noch nie einen Emulator gestartet haben – kein Problem, wir gehen diesen Weg gemeinsam.
Wie viel Zeit Sie benötigen
Bei guter Internetverbindung und bereits installiertem Android Studio – eineinhalb bis zwei Stunden für den gesamten Leitfaden. Wenn Sie Android Studio noch nicht haben, rechnen Sie zusätzlich 30–60 Minuten für das Herunterladen der System-Images ein. Nach dem ersten Durchlauf dauert die erneute Einrichtung in einem neuen Projekt etwa zehn Minuten.
Vorbereitung: Tools, Zugänge und Systemanforderungen
Was Sie auf dem Computer installieren müssen
- Android Studio in einer aktuellen Version von 2025–2026. Damit werden das Android SDK, der Android Emulator und das adb-Tool installiert. Das ist das grundlegende Toolset.
- Ein abfangender Proxy. Im Leitfaden werden zwei Optionen gezeigt: das kostenlose mitmproxy (läuft im Terminal und über die Weboberfläche mitmweb) und das kommerzielle Charles Proxy mit kostenlosem Testmodus. Wählen Sie eines, das andere können Sie später erlernen. Alle Anleitungen gelten für beide.
- Java ist nicht separat nötig: Android Studio verwendet ein eingebautes JDK.
- Ein Test-Build der App im APK-Format. Es sollte ein Debug-Build oder ein spezieller QA-Build sein, nicht die Release-Version aus dem Store. Warum das kritisch ist, erklären wir im Abschnitt über Zertifikate.
Systemanforderungen
- Betriebssystem: Windows 10 oder 11 (64-Bit), macOS 12 oder neuer, Linux mit KVM-Unterstützung.
- Arbeitsspeicher: mindestens 8 GB, komfortabel sind 16 GB. Der Emulator allein verbraucht 2–4 GB.
- Freier Speicherplatz: mindestens 20 GB. Ein Android-System-Image wiegt 1,5–2 GB, plus Android Studio selbst.
- Hardware-Virtualisierung im BIOS/UEFI aktiviert (Intel VT-x oder AMD-V). Ohne sie läuft der Emulator quälend langsam oder startet gar nicht.
- Ein echtes Android-Gerät mit Android 8 oder höher und ein USB-Kabel zur Datenübertragung (nicht nur zum Laden).
Zugänge, die Sie vom Team anfordern müssen
- Die Adresse der Testumgebung (z. B. https://api-stage.example-team.ru) und Test-Zugangsdaten.
- Ein Debug-Build der App oder ein Build mit dem Flag „QA build“. Fragen Sie die Entwickler, ob es benutzerdefinierten Zertifikaten vertraut und ob Certificate Pinning deaktiviert ist.
- Wenn die Umgebung per IP gesperrt ist oder eine Verbindung zum Firmennetz erfordert – fragen Sie den Administrator, wie Sie sich von Ihrem Arbeitscomputer aus verbinden. Wir betrachten keine Umgehungen von Beschränkungen: nur die offiziellen Zugänge, die Ihr Team bereitstellt.
Backups und Sicherheit
Proxy-Einstellungen im Emulator und auf dem Gerät sind vollständig umkehrbar. Trotzdem sollten Sie vorher zwei Dinge tun. Erstens: Wenn auf dem echten Telefon bereits funktionierende WLAN-Einstellungen oder Zertifikate vorhanden sind, machen Sie Screenshots der Einstellungsbildschirme – so können Sie alles schnell wiederherstellen. Zweitens: Verwenden Sie besser ein separates Testgerät statt eines privaten Telefons mit Banking-Apps: Ein Root-Zertifikat des Proxys gibt seinem Besitzer die Möglichkeit, verschlüsselten Traffic zu lesen. Auf einem Testgerät ist das normal, auf einem privaten ein Risiko.
Achtung: Installieren Sie niemals ein Root-Zertifikat eines abfangenden Proxys auf einem privaten Gerät mit Banking- und Zahlungs-Apps und geben Sie die Datei mit dem privaten Schlüssel des Proxys nicht über Messenger an Kollegen weiter. Das Zertifikat wird lokal auf Ihrem Computer erzeugt und sollte dort bleiben.
Grundbegriffe: Wie das Abfangen von Traffic funktioniert
Was ist ein abfangender Proxy
Ein normaler Proxy ist ein Vermittler, der eine Anfrage vom Client entgegennimmt und an den Server weiterleitet. Ein abfangender Proxy (auch Debug- oder Man-in-the-Middle-Proxy genannt) tut dasselbe, speichert aber eine Kopie jeder Anfrage und Antwort, zeigt sie Ihnen übersichtlich an und ermöglicht es, sie anzuhalten, zu ändern und zu ersetzen. Für einen Tester ist das wie ein Röntgengerät für einen Arzt.
Warum HTTPS nicht einfach sichtbar ist
Fast der gesamte moderne Traffic ist mit dem TLS-Protokoll verschlüsselt. Der Proxy sieht, dass das Telefon sich mit dem Server api-stage.example-team.ru verbunden hat, aber der Inhalt der Anfragen ist für ihn ein verschlüsselter Datenstrom. Um ihn zu entschlüsseln, erzeugt der Proxy ein eigenes Root-Zertifikat (CA) und stellt für jede Website im Handumdrehen gefälschte Zertifikate aus. Das Telefon muss diesem Root-Zertifikat vertrauen – sonst erkennt die App die Manipulation und bricht die Verbindung mit einem Fehler wie „Trust anchor for certification path not found“ ab. Deshalb ist die Installation des Proxy-Zertifikats auf dem Gerät ein Pflichtschritt.
Benutzer- und Systemzertifikate in Android
Seit Android 7 vertrauen Apps standardmäßig nur Systemzertifikaten und ignorieren die, die der Benutzer über die Einstellungen installiert hat. Chrome ist eine Ausnahme: Er vertraut Benutzerzertifikaten. Damit Ihre App dem Proxy-Zertifikat vertraut, haben Entwickler zwei legitime Wege: Entweder sie fügen im Debug-Build eine Datei network_security_config.xml hinzu, die das Vertrauen in Benutzerzertifikate erlaubt, oder Sie installieren das Zertifikat als Systemzertifikat auf einem gerooteten Emulator. Der erste Weg ist einfacher und richtig für die Teamarbeit.
Certificate Pinning
Manche Apps „pinnen“ zusätzlich ein bestimmtes Serverzertifikat und weigern sich, mit einem anderen zu arbeiten, selbst wenn es vertrauenswürdig ist. Das ist ein guter Schutz in der Produktion, aber für Tests in der Umgebung wird Pinning in Debug-Builds normalerweise deaktiviert. Wenn die App nach allen Einstellungen immer noch nicht über den Proxy läuft, fragen Sie die Entwickler genau nach Pinning.
Wie der Emulator Ihren Computer sieht
Der Android-Emulator ist eine virtuelle Maschine mit eigenem Netzwerk. Darin bedeutet die Adresse 127.0.0.1 den Emulator selbst, nicht Ihren Computer. Um den Computer zu erreichen, verwendet man im Emulator die spezielle Adresse 10.0.2.2. Merken Sie sich diese – sie wird in den folgenden Befehlen auftauchen.
Was ist adb und adb reverse
adb (Android Debug Bridge) ist ein Konsolen-Tool, das ein Android-Gerät vom Computer aus steuert: Apps installiert, Befehle ausführt, Ports weiterleitet. Der Befehl adb reverse sorgt dafür, dass ein Port auf dem Gerät auf einen Port Ihres Computers „zeigt“. Zum Beispiel: Nach adb reverse tcp:8080 tcp:8080 erreicht eine App auf dem Telefon, die auf localhost:8080 zugreift, tatsächlich Port 8080 des Computers, wo der Proxy lauscht. Das funktioniert über USB, erfordert kein gemeinsames WLAN und ist unabhängig von Unternehmensbeschränkungen des Access Points. Der umgekehrte Befehl, adb forward, arbeitet in die andere Richtung: Der Port des Computers führt zum Gerät. Verwechseln Sie sie nicht.
Testumgebung
Die Umgebung (Stage, Staging, Dev-Umgebung) ist eine Kopie des Serverteils der App zum Testen. In der Umgebung kann man Daten verändern, Antworten ersetzen und Logs einsehen. Die App wechselt normalerweise entweder durch einen separaten Build oder über ein verstecktes Menü in die Umgebung. Den gesamten Traffic fangen wir mit der Umgebung ab, nicht mit der Produktion.
Schritt 1: Abfangenden Proxy auf dem Computer starten
Ziel dieses Schritts: Auf dem Computer läuft ein Proxy, der auf einem Port lauscht (8080 für mitmproxy oder 8888 für Charles), und Sie kennen die IP-Adresse des Computers im lokalen Netzwerk.
Option A: mitmproxy
- Laden Sie das Installationsprogramm für mitmproxy für Ihr Betriebssystem von der offiziellen Projektseite herunter oder installieren Sie es über einen Paketmanager. Auf macOS ist Homebrew praktisch, auf Windows das Installationsprogramm im .msi-Format, auf Linux pipx oder ein Binärarchiv.
- Öffnen Sie ein Terminal (unter Windows PowerShell oder Windows Terminal).
- Starten Sie die Web-Version mit dem Befehl:
Im Terminal erscheinen Zeilen über den Start des Proxys auf Port 8080, und im Browser öffnet sich ein Tab mit der Weboberfläche unter der Adresse 127.0.0.1:8081. Genau hier werden die Anfragen erscheinen.mitmweb --listen-port 8080 - Beachten Sie: Die Oberfläche mitmweb läuft auf Port 8081, der Proxy selbst lauscht auf 8080. In den Geräteeinstellungen geben Sie immer 8080 an.
- Beim ersten Start erstellt mitmproxy den Ordner .mitmproxy im Home-Verzeichnis des Benutzers. Darin liegt die Datei mitmproxy-ca-cert.cer – das ist das Root-Zertifikat, das wir später auf den Geräten installieren.
Tipp: Wenn Sie vollständig im Terminal ohne Browser arbeiten möchten, starten Sie den Befehl mitmproxy statt mitmweb. Die Oberfläche ist dann konsolenbasiert: Pfeiltasten zur Navigation, Enter zum Öffnen einer Anfrage, q zum Zurückgehen. Für die Automatisierung gibt es mitmdump, das den Datenstrom in eine Datei schreibt.
Option B: Charles Proxy
- Laden Sie Charles von der offiziellen Website herunter, installieren und starten Sie es. Es erscheint das Hauptfenster mit einer leeren Liste links und den Tabs Overview, Contents rechts.
- Öffnen Sie das Menü Proxy → Proxy Settings. Auf dem Tab Proxies stellen Sie sicher, dass der Port 8888 ist und das Kontrollkästchen „Enable transparent HTTP proxying“ deaktiviert ist. Klicken Sie auf OK.
- Öffnen Sie Proxy → SSL Proxying Settings. Setzen Sie ein Häkchen bei Enable SSL Proxying. Im Block Include klicken Sie auf Add und fügen den Host * mit Port 443 hinzu. So entschlüsselt Charles den gesamten HTTPS-Traffic. Später können Sie die Liste auf die Domain der Umgebung einschränken.
- Wenn Charles anbietet, den Systemproxy von macOS oder Windows einzurichten, lehnen Sie ab: Wir brauchen den Traffic des Telefons, nicht den des Computer-Browsers. Deaktivieren Sie ihn über das Menü Proxy, indem Sie die Häkchen bei macOS Proxy oder Windows Proxy entfernen.
IP-Adresse des Computers herausfinden
Für ein echtes Gerät über WLAN benötigen Sie die Adresse des Computers im lokalen Netzwerk.
- Windows: Führen Sie in PowerShell ipconfig aus und suchen Sie die Zeile IPv4-Adresse beim aktiven WLAN- oder Ethernet-Adapter. Normalerweise sieht sie aus wie 192.168.1.45.
- macOS: Systemeinstellungen → Netzwerk → wählen Sie die aktive Verbindung, die Adresse wird in den Details angezeigt. Oder im Terminal ipconfig getifaddr en0.
- Linux: Befehl ip addr show oder hostname -I.
Notieren Sie sich diese Adresse. Im weiteren Text nennen wir sie beispielhaft 192.168.1.45, setzen Sie Ihre eigene ein.
Port in der Firewall öffnen
Windows fragt beim ersten Start von mitmproxy oder Charles, ob das Programm Verbindungen annehmen darf. Erlauben Sie dies unbedingt für private Netzwerke. Wenn das Fenster nicht erscheint, öffnen Sie „Windows Defender Firewall → App durch Firewall zulassen“ und fügen Sie das Programm manuell hinzu. Auf macOS wird die Erlaubnis beim ersten eingehenden Verbindungsversuch analog abgefragt.
Prüfung: Öffnen Sie den Browser auf dem Computer, geben Sie in seinen Einstellungen vorübergehend den Proxy 127.0.0.1 und den Port 8080 (oder 8888) an und rufen Sie eine beliebige Website auf. In mitmweb oder Charles sollten Anfragezeilen erscheinen. Entfernen Sie danach den Proxy aus dem Browser, damit er nicht stört. Eine Alternative ohne Browser-Einstellung ist der Befehl:
curl -x http://127.0.0.1:8080 -k https://example.comWenn in der Proxy-Oberfläche eine Zeile mit example.com erscheint, funktioniert der Proxy.Mögliche Probleme in diesem Schritt
- Port belegt. Meldung wie „Address already in use“. Das bedeutet, dass auf 8080 bereits etwas lauscht – oft eine lokale Umgebung oder ein anderes Tool. Starten Sie den Proxy auf einem anderen Port, z. B. 8082, und verwenden Sie diesen überall weiter.
- mitmweb öffnet den Browser nicht. Öffnen Sie die Adresse 127.0.0.1:8081 manuell. Im Terminal wird eine Adresse mit Token ausgegeben; kopieren Sie sie vollständig.
- Charles zeigt keine HTTPS-Inhalte, nur CONNECT-Header. SSL Proxying ist nicht aktiviert oder der Host wurde nicht in Include aufgenommen. Kehren Sie zu Punkt 3 von Option B zurück.
Schritt 2: Traffic des Android-Emulators durch den Proxy leiten
Ziel dieses Schritts: Der laufende Emulator sendet alle HTTP- und HTTPS-Anfragen an Ihren Proxy, und Sie sehen sie in der Oberfläche.
Emulator erstellen und starten
- Öffnen Sie Android Studio. Wenn kein Projekt geöffnet ist, wählen Sie auf dem Startbildschirm More Actions → Virtual Device Manager. Innerhalb eines Projekts: Menü Tools → Device Manager.
- Klicken Sie auf die Schaltfläche zum Erstellen eines Geräts (Plus oder Create Virtual Device).
- Wählen Sie ein Modell, z. B. Pixel 8, und klicken Sie auf Next.
- Wählen Sie ein System-Image. Wichtig: Für Tests über einen Proxy ist ein Image mit der Kennzeichnung Google APIs praktischer als Google Play. Bei Google-Play-Images ist der Root-Zugriff gesperrt, und Sie können kein Systemzertifikat installieren, falls es benötigt wird. Für Android 14–16 heißen solche Images etwa „Android 15.0 Google APIs x86_64“ (auf Computern mit Apple-Prozessoren arm64-v8a). Wenn neben dem Image ein Download-Pfeil ist, laden Sie es herunter – das dauert 5–15 Minuten.
- Geben Sie auf dem letzten Bildschirm dem Gerät einen Namen ohne Leerzeichen, z. B. Pixel_8_QA, und klicken Sie auf Finish.
- Starten Sie den Emulator mit der Dreieck-Schaltfläche. Der erste Start dauert 1–3 Minuten.
Methode 1: Einstellung über das Emulator-Panel (am einfachsten)
- Suchen Sie im Fenster des laufenden Emulators die vertikale Leiste rechts. Klicken Sie unten auf die drei Punkte – es öffnet sich das Fenster Extended Controls.
- Wählen Sie im linken Menü Settings, dann den Tab Proxy.
- Entfernen Sie das Häkchen bei „Use Android Studio HTTP proxy settings“.
- Wählen Sie Manual proxy configuration.
- Geben Sie im Feld Host name 127.0.0.1 ein. Hier, anders als in den Einstellungen innerhalb von Android, wendet der Emulator den Proxy auf der Ebene des Host-Rechners an, daher wird die Adresse des Computers als 127.0.0.1 angegeben.
- Geben Sie im Feld Port number 8080 ein (für Charles 8888).
- Klicken Sie auf Apply. Darunter sollte der Status „Proxy status: Success“ erscheinen. Wenn Error steht, läuft der Proxy nicht oder der Port ist falsch.
Methode 2: Einstellung über adb (flexibel, für Skripte geeignet)
- Öffnen Sie das Terminal. Stellen Sie sicher, dass adb verfügbar ist: Der Befehl adb devices sollte eine Zeile wie emulator-5554 device anzeigen. Wenn der Befehl nicht gefunden wird, fügen Sie den Ordner platform-tools im Android SDK zum PATH hinzu (den Pfad finden Sie in Android Studio: Settings → Languages and Frameworks → Android SDK).
- Führen Sie aus:
Hier befinden wir uns bereits „innerhalb“ von Android, daher wird der Computer mit der Adresse 10.0.2.2 bezeichnet.adb shell settings put global http_proxy 10.0.2.2:8080 - Prüfen Sie, ob die Einstellung übernommen wurde:
Es sollte 10.0.2.2:8080 zurückgegeben werden.adb shell settings get global http_proxy - Um den Proxy zu deaktivieren, führen Sie aus:
adb shell settings put global http_proxy :0
Methode 3: Kommandozeilenparameter beim Start
Wenn Sie den Emulator vom Terminal aus starten (z. B. in CI oder Skripten), fügen Sie das Flag hinzu:
emulator -avd Pixel_8_QA -http-proxy http://127.0.0.1:8080Die ausführbare Datei emulator liegt im Ordner emulator innerhalb des Android SDK. Der Proxy wird auf die gesamte Emulator-Sitzung angewendet.
Tipp: Erstellen Sie zwei kleine Skripte – proxy_on und proxy_off – mit den adb-Befehlen aus Methode 2. Während eines Testtages werden Sie den Proxy Dutzende Male ein- und ausschalten, und überflüssige Klicks durch Menüs sind ermüdend.
Prüfen, ob Traffic fließt
- Öffnen Sie im Emulator den Browser Chrome und rufen Sie eine beliebige HTTPS-Website auf.
- In mitmweb oder Charles sollten Anfragen erscheinen. Wahrscheinlich zeigt die Seite in Chrome einen Sicherheitsfehler – das ist normal, das Zertifikat haben wir noch nicht installiert. Wichtig ist, dass die Anfragen als Einträge mit Host und Methode CONNECT sichtbar sind.
Prüfung: In der Proxy-Oberfläche erscheinen Zeilen mit der Domain der Website, die Sie im Emulator geöffnet haben, und der Befehl adb shell settings get global http_proxy gibt Adresse und Port Ihres Proxys zurück. Wenn beide Bedingungen erfüllt sind, ist der Emulator korrekt auf den Proxy ausgerichtet.
Mögliche Probleme
- Proxy status: Error im Emulator-Panel. Der Proxy läuft nicht oder der Port ist anders. Starten Sie mitmweb oder Charles und klicken Sie erneut auf Apply.
- Es erscheinen keine Anfragen, obwohl der Status Success ist. Die App verwendet möglicherweise einen eigenen Netzwerk-Stack, der den Systemproxy ignoriert (z. B. Flutter-Apps standardmäßig). Dazu im Abschnitt typische Fehler.
- Der Emulator hat nach dem Deaktivieren des Proxys kein Internet mehr. Sie haben wahrscheinlich den Wert http_proxy leer gelassen statt „:0“. Wiederholen Sie den Deaktivierungsbefehl mit Doppelpunkt und Null und starten Sie den Emulator neu.
Schritt 3: Proxy-Zertifikat installieren und Vertrauensproblem lösen
Ziel dieses Schritts: Der Emulator und die Test-App vertrauen dem Root-Zertifikat des Proxys, und Sie sehen den entschlüsselten Inhalt von HTTPS-Anfragen: URL, Header, Anfrage- und Antworttexte.
Zertifikat als Benutzerzertifikat installieren
- Stellen Sie sicher, dass der Proxy im Emulator aktiviert ist (Schritt 2).
- Öffnen Sie im Browser Chrome innerhalb des Emulators die Adresse mitm.it (für mitmproxy) oder chls.pro/ssl (für Charles). Das sind spezielle Adressen, die der Proxy abfängt und eine Seite zum Herunterladen des Zertifikats liefert. Wenn Sie statt der Seite eine normale Website oder einen Fehler sehen, läuft der Traffic nicht über den Proxy – kehren Sie zu Schritt 2 zurück.
- Klicken Sie für mitmproxy auf die Android-Schaltfläche und laden Sie die Datei mitmproxy-ca-cert.cer herunter. Bei Charles wird die Datei sofort heruntergeladen.
- Öffnen Sie im Emulator Einstellungen → Sicherheit und Datenschutz → Weitere Sicherheitseinstellungen → Verschlüsselung und Anmeldedaten → Zertifikat installieren → CA-Zertifikat (in manchen Versionen: Sicherheit → Erweiterte Einstellungen → Verschlüsselung und Anmeldedaten). Eine Warnung zu Risiken erscheint – klicken Sie auf „Trotzdem installieren“.
- Wählen Sie die heruntergeladene Datei im Ordner Downloads. Wenn der Emulator nach einem PIN für den Bildschirm fragt, vergeben Sie einen einfachen, z. B. 1234, und merken Sie ihn sich.
- Prüfen Sie nach der Installation: Verschlüsselung und Anmeldedaten → Vertrauenswürdige Zertifikate → Tab Benutzer. Dort sollte ein Eintrag mit mitmproxy oder Charles Proxy CA erscheinen.
Eine alternative Methode ohne Browser – die Datei mit dem Befehl adb push kopieren und dann im Dateimanager auswählen:
adb push ~/.mitmproxy/mitmproxy-ca-cert.cer /sdcard/Download/Jetzt öffnet Chrome im Emulator jede HTTPS-Website ohne Fehler, und im Proxy sehen Sie die entschlüsselten Anfragen des Browsers. Aber Ihre Test-App wird wahrscheinlich weiterhin mit einem Netzwerkfehler abstürzen. Kommen wir zum wichtigsten Punkt.
Warum die App nicht vertraut und was Sie von den Entwicklern anfordern sollten
Wie wir in den Grundbegriffen erläutert haben, ignorieren Apps ab Android 7 Benutzerzertifikate. Die richtige Lösung ist, dass der Debug-Build eine Datei mit der Netzwerksicherheitskonfiguration enthält. Der Entwickler fügt in res/xml/network_security_config.xml etwa folgenden Inhalt ein:
<network-security-config><debug-overrides><trust-anchors><certificates src='system' /><certificates src='user' /></trust-anchors></debug-overrides></network-security-config>Und bindet sie in AndroidManifest.xml über das Attribut android:networkSecurityConfig ein. Der Block debug-overrides funktioniert nur in Debug-Builds, daher bleibt das Release geschützt. Das ist gängige Praxis, und in den meisten Teams existiert diese Datei bereits. Kopieren Sie den obigen Ausschnitt in eine Aufgabe für den Entwickler, falls sie fehlt.
Achtung: Bitten Sie nicht darum, das Vertrauen in Benutzerzertifikate in die Basiskonfiguration ohne debug-overrides aufzunehmen, und stimmen Sie nicht der Deaktivierung der Zertifikatsprüfung im Release zu. Das schwächt den Schutz echter Nutzer. Alle Änderungen sollten nur Debug- und QA-Builds betreffen.
Alternativer Weg: Systemzertifikat auf einem gerooteten Emulator
Wenn der Build für Sie nicht geändert werden kann, können Sie auf einem Emulator mit Google-APIs-Image (nicht Google Play) das Zertifikat in den System-Speicher legen. Dann vertrauen ihm alle Apps ohne Pinning. Kurz die Vorgehensweise für Android 14 und neuer, wo Systemzertifikate im apex-Bereich liegen:
- Starten Sie den Emulator vom Terminal mit dem Flag -writable-system.
- Führen Sie adb root aus, dann adb remount.
- Berechnen Sie den Dateinamen des Zertifikats im Format hash.0 mit dem Befehl openssl x509 -inform PEM -subject_hash_old -in mitmproxy-ca-cert.cer -noout und benennen Sie die Datei in den erhaltenen Wert mit dem Suffix .0 um (z. B. c8750f0d.0).
- Kopieren Sie die Datei über adb push in den System-Zertifikatsspeicher nach /system/etc/security/cacerts/ und starten Sie den Emulator neu. Unter Android 14+ muss zusätzlich das Verzeichnis neu eingebunden werden, in das das System die Zertifikate lädt; in der mitmproxy-Dokumentation gibt es dafür ein fertiges Skript.
Dieser Weg ist mächtiger, aber fragiler: Nach einem Image-Update wird alles zurückgesetzt, und unter Android 14+ sind die Schritte komplexer. Für den täglichen Einsatz empfehlen wir den ersten Weg mit network_security_config.
Test-App installieren
- Legen Sie die APK in einen praktischen Ordner.
- Führen Sie adb install -r Pfad/zur/app-debug.apk aus. Das Flag -r installiert über eine vorhandene Version, wobei Daten erhalten bleiben.
- Nach 10–30 Sekunden erscheint Success, und das App-Symbol erscheint im Emulator.
Prüfung: Öffnen Sie die Test-App, melden Sie sich in der Umgebung an. In mitmweb oder Charles sind Anfragen an die Domain der Umgebung erschienen, und beim Klick auf eine davon sehen Sie Tabs mit Headern, Anfragekörper in JSON und Antwortkörper. Wenn der Antwortkörper lesbar ist, wurde das Zertifikat installiert und die App vertraut ihm. Das ist der wichtigste Kontrollpunkt des gesamten Leitfadens.
Mögliche Probleme
- Chrome öffnet Websites, aber die App zeigt einen Netzwerkfehler. Die App vertraut dem Benutzerzertifikat nicht. Sie benötigen einen Build mit network_security_config oder ein Systemzertifikat.
- In den App-Logs (adb logcat) steht „Certificate pinning failure“. Pinning ist aktiviert. Bitten Sie um einen QA-Build mit deaktiviertem Pinning für die Domain der Umgebung.
- mitm.it zeigt die Seite „If you can see this, traffic is not passing through mitmproxy“. Der Proxy wurde nicht angewendet. Prüfen Sie die Einstellung aus Schritt 2.
Schritt 4: Echtes Gerät über WLAN anbinden
Ziel dieses Schritts: Ein echtes Smartphone im selben WLAN wie der Computer sendet Traffic an den Proxy.
Das ist die Methode, die in normalen Benutzeranleitungen beschrieben wird, aber als Tester haben Sie Ihre eigenen Nuancen: Sie müssen verstehen, wann sie nicht funktioniert, und schnell wechseln können. Der Emulator ersetzt kein echtes Gerät: Er hat keine echte Kamera, Push-Benachrichtigungen kommen anders an, Sensoren und Energieverwaltung verhalten sich anders. Deshalb ist das Testen von Netzwerkszenarien auf einem echten Telefon unerlässlich.
Proxy in den WLAN-Einstellungen konfigurieren
- Verbinden Sie das Telefon mit demselben WLAN wie den Computer. Ein Heimrouter eignet sich. Ein Gast-Firmennetz oft nicht – dazu unten mehr.
- Öffnen Sie Einstellungen → Netzwerk und Internet → WLAN (bei Samsung: Verbindungen → WLAN).
- Tippen Sie auf das Zahnrad neben dem aktuellen Netzwerk oder rufen Sie per langem Drücken auf den Netzwerknamen das Menü auf und wählen Sie „Netzwerk ändern“.
- Klappen Sie „Erweitert“ oder „Erweiterte Einstellungen“ auf.
- Wählen Sie beim Punkt Proxy Manuell.
- Proxy-Hostname: die IP-Adresse Ihres Computers, z. B. 192.168.1.45. Port: 8080 oder 8888. Lassen Sie das Feld „Proxy nicht verwenden für“ leer.
- Speichern. Das Telefon verbindet sich neu mit dem Netzwerk.
Zertifikat auf dem Telefon installieren
- Öffnen Sie Chrome auf dem Telefon und rufen Sie mitm.it oder chls.pro/ssl auf. Laden Sie das Zertifikat herunter.
- Einstellungen → Sicherheit → Verschlüsselung und Anmeldedaten → Zertifikat installieren → CA-Zertifikat → Datei auswählen. Die Bezeichnungen unterscheiden sich leicht bei Samsung, Xiaomi, Huawei, aber die Logik ist dieselbe: Suchen Sie nach den Wörtern „Anmeldedaten“ oder „Zertifikat“.
- Installieren Sie die Test-App über adb install oder direkt aus der Datei.
Tipp: Vergeben Sie dem Computer eine feste IP-Adresse in den Router-Einstellungen (DHCP-Reservierung nach MAC-Adresse). Sonst ändert sich die Adresse nach einem Router-Neustart, und alle Telefone im Team können nicht mehr über den Proxy gehen, während Sie eine halbe Stunde nach der Ursache suchen.
Wann die WLAN-Methode nicht funktioniert
- Client-Isolation (AP-Isolation) im Firmen- oder Gastnetz. Geräte sehen das Internet, aber nicht sich gegenseitig. Symptom: Das Telefon mit Proxy verliert komplett das Internet, und mitm.it öffnet sich nicht. Prüfung: Führen Sie vom Computer aus ping auf die IP-Adresse des Telefons aus (zu finden in den WLAN-Eigenschaften). Keine Antwort – es gibt eine Isolation.
- Computer und Telefon in verschiedenen Subnetzen. Zum Beispiel ist der Laptop im kabelgebundenen Netz 10.10.0.x, das Telefon im WLAN 192.168.1.x.
- Die Firewall des Computers blockiert eingehende Verbindungen. Besonders häufig unter Windows mit dem Netzwerkprofil „Öffentlich“. Stellen Sie das Netzwerkprofil auf „Privat“ um.
In all diesen Fällen ist die Lösung dieselbe – Portweiterleitung über USB, zu der wir jetzt übergehen.
Prüfung: In der Proxy-Oberfläche sind Anfragen vom Telefon erschienen, und in Charles ist in der Spalte Client die IP des Telefons sichtbar, die sich von 127.0.0.1 unterscheidet. Öffnen Sie die Test-App, führen Sie eine Aktion aus – die entsprechende Anfrage an die Umgebung erscheint in der Liste mit entschlüsseltem Text.
Schritt 5: Portweiterleitung über adb reverse – Proxy per USB ohne WLAN
Ziel dieses Schritts: Ein echtes Telefon, das nur über USB-Kabel verbunden ist, leitet Traffic an den Proxy auf dem Computer, unabhängig vom WLAN.
Das ist die zuverlässigste Methode für Büro, Coworking und jedes Netzwerk, in dem Sie den Router nicht verwalten. Die Idee: Mit dem Befehl adb reverse sorgen wir dafür, dass Port 8080 auf dem Telefon auf Port 8080 des Computers führt. Dann sagen wir dem Telefon, es soll den Proxy 127.0.0.1:8080 verwenden – also „sich selbst“, und adb liefert die Pakete unbemerkt an den Computer.
USB-Debugging aktivieren
- Öffnen Sie auf dem Telefon Einstellungen → Über das Telefon und tippen Sie siebenmal auf „Build-Nummer“. Die Meldung „Sie sind jetzt Entwickler“ erscheint. Bei Xiaomi müssen Sie auf „MIUI-Version“ oder „HyperOS-Version“ tippen.
- Gehen Sie zurück zu Einstellungen → System → Für Entwickler (bei Samsung im Hauptmenü der Einstellungen). Aktivieren Sie den Schalter USB-Debugging.
- Verbinden Sie das Telefon per Kabel mit dem Computer. Auf dem Telefon erscheint die Aufforderung „USB-Debugging zulassen?“ mit dem Fingerabdruck des Computers. Setzen Sie ein Häkchen bei „Immer zulassen“ und klicken Sie auf Zulassen.
- Führen Sie auf dem Computer adb devices aus. Es sollte eine Zeile mit Seriennummer und dem Wort device erscheinen. Wenn unauthorized steht, schauen Sie auf den Bildschirm des Telefons, dort hängt die Abfrage. Wenn offline – schließen Sie das Kabel neu an.
Achtung: Verwenden Sie ein Kabel, das Datenübertragung unterstützt. Viele günstige Kabel aus Powerbank-Sets laden nur. Wenn das Telefon lädt, aber adb devices leer bleibt, wechseln Sie zuerst das Kabel, statt Treiber neu zu installieren.
Weiterleitung einrichten
- Stellen Sie sicher, dass der Proxy auf dem Computer läuft und auf Port 8080 lauscht.
- Führen Sie den Befehl aus:
Die erste Zahl ist der Port auf dem Telefon, die zweite der Port auf dem Computer. Als Antwort gibt der Befehl 8080 aus oder nichts – das ist normal.adb reverse tcp:8080 tcp:8080 - Prüfen Sie die Liste der aktiven Weiterleitungen:
Es sollte eine Zeile erscheinen wie host-Nummer tcp:8080 tcp:8080.adb reverse --list - Wenn Sie mehrere Geräte verbunden haben (z. B. Emulator und Telefon), geben Sie die Seriennummer mit dem Flag -s an:
adb -s R58M1234ABC reverse tcp:8080 tcp:8080
Telefon auf Proxy localhost umstellen
Hier gibt es zwei Wege. Der erste – über adb, am schnellsten:
adb shell settings put global http_proxy 127.0.0.1:8080Der zweite – manuell in den WLAN-Einstellungen des Telefons wie in Schritt 4, aber im Feld Host 127.0.0.1 und Port 8080 angeben. Der zweite Weg ist bei manchen Firmware-Versionen nötig, bei denen die globale Einstellung über adb nicht auf alle Apps angewendet wird.
Beachten Sie eine wichtige Nuance. Die globale Einstellung http_proxy wird vom System auf die aktuelle Netzwerkverbindung angewendet. Wenn WLAN ausgeschaltet ist und das Telefon mobile Daten nutzt, wenden einige Firmware-Versionen sie trotzdem an, andere nicht. Am zuverlässigsten ist es, WLAN eingeschaltet zu lassen (irgendein Netzwerk, auch ohne Verbindung zum Computer) und den Proxy 127.0.0.1 in dessen Einstellungen anzugeben. Der Traffic läuft über adb reverse per USB, unabhängig davon, mit welchem WLAN das Telefon verbunden ist.
Zertifikat installieren
Die Vorgehensweise ist dieselbe wie zuvor: Chrome → mitm.it → herunterladen → als CA-Zertifikat installieren. Wenn das Zertifikat auf diesem Telefon bereits in Schritt 4 installiert wurde, ist keine Wiederholung nötig.
Weiterleitung nach der Arbeit deaktivieren
- Entfernen Sie den Proxy: adb shell settings put global http_proxy :0 (oder „Keine“ in den WLAN-Einstellungen).
- Heben Sie die Weiterleitung auf: adb reverse --remove tcp:8080 oder gleich alle: adb reverse --remove-all.
- Beachten Sie, dass beim Trennen des Kabels die Weiterleitungen automatisch zurückgesetzt werden, die Proxy-Einstellung auf dem Telefon aber bleibt. Wenn Sie vergessen, sie zu entfernen, hat das Telefon ohne Kabel kein Internet. Genau so sieht die häufigste Beschwerde von Anfängern aus: „Das Telefon lädt nichts mehr“.
Tipp: Schreiben Sie sich einen Spickzettel mit drei Zeilen: adb reverse tcp:8080 tcp:8080, adb shell settings put global http_proxy 127.0.0.1:8080, adb shell settings put global http_proxy :0. Diese drei Befehle reichen für 90 Prozent der Arbeitssituationen mit einem echten Gerät.
Prüfung: Deaktivieren Sie das WLAN auf dem Computer oder verwenden Sie das Telefon in einem Netzwerk, in dem der Computer nicht erreichbar ist. Führen Sie adb reverse aus, setzen Sie den Proxy 127.0.0.1:8080, öffnen Sie mitm.it in Chrome auf dem Telefon. Die Zertifikat-Downloadseite hat sich geöffnet – die Weiterleitung funktioniert. Öffnen Sie dann die Test-App und stellen Sie sicher, dass ihre Anfragen im Proxy erscheinen.
Mögliche Probleme
- adb reverse gibt „error: closed“ oder „more than one device“ aus. Es sind mehrere Geräte verbunden; geben Sie -s Seriennummer an. Oder das Gerät ist offline – schließen Sie das Kabel neu an.
- Weiterleitung existiert, aber mitm.it öffnet sich nicht. Prüfen Sie, dass der Proxy auf dem Computer genau auf 127.0.0.1 oder allen Schnittstellen lauscht, nicht nur auf der externen IP. Bei mitmproxy sind standardmäßig alle Schnittstellen aktiv. Bei Charles ebenso.
- Nach dem erneuten Anschließen des Kabels ist der Traffic verschwunden. adb reverse wird bei jedem erneuten Anschließen zurückgesetzt. Führen Sie den Befehl erneut aus. Die Proxy-Einstellung auf dem Telefon bleibt dabei erhalten.
Schritt 6: Traffic der Testumgebung abfangen und ersetzen
Ziel dieses Schritts: Sie können Anfragen an die Umgebung filtern, Anfrage- und Antworttexte lesen, eine Anfrage anhalten und die Serverantwort ersetzen, Fehler und ein langsames Netzwerk simulieren sowie die App über adb reverse auf ein lokales Backend umleiten.
Nur das Nötige filtern
Die App sendet Dutzende Hintergrundanfragen: Analytics, Konfigurationsaktualisierung, Versionsprüfung. Um nicht unterzugehen, richten Sie einen Filter nach der Domain der Umgebung ein.
- Geben Sie in mitmweb im oberen Filterfeld einen Ausdruck wie ~d api-stage.example-team.ru ein – es bleiben nur Anfragen an diese Domain. Der Ausdruck ~u /orders filtert nach einem Teil der URL, ~c 500 zeigt nur Antworten mit Code 500, und ~m POST nur POST-Anfragen. Ausdrücke können mit Leerzeichen kombiniert werden.
- Aktivieren Sie in Charles den Focus-Modus: Rechtsklick auf den Host der Umgebung → Focus. Die übrigen Hosts werden in der Gruppe Other Hosts zusammengeklappt. Zusätzlich können Sie im unteren Filterfeld einen Teil der URL eingeben.
Anfrage und Antwort so lesen, dass man sie an den Bug anhängen kann
- Klicken Sie auf die Anfragezeile. In mitmweb erscheinen rechts die Tabs Request, Response, Detail. In Charles – die Tabs Overview, Contents, Summary und unten die Umschalter Headers, JSON Text, Raw.
- Kopieren Sie URL, Methode, Antwortcode und Antworttext in JSON. In mitmweb können Sie mit Rechtsklick auf die Anfrage Export → curl wählen: So erhalten Sie einen Befehl, den der Entwickler in einer Sekunde bei sich reproduziert. In Charles analog: Rechtsklick → Copy cURL Request.
- Ein guter Bug-Report über einen Netzwerkfehler enthält immer: Schritte, URL mit Methode, Code und Antworttext, Zeitpunkt der Anfrage (um sie in den Server-Logs zu finden) und die Request-ID aus den Headern, falls das Backend eine zurückgibt (oft X-Request-Id).
Anfrage anhalten und Antwort ändern
Klassisches Szenario: Sie müssen prüfen, wie die App einen Warenkorb mit hundert Artikeln oder einen negativen Preis anzeigt, aber in der Umgebung gibt es solche Daten nicht. Wir ersetzen die Antwort.
- Geben Sie in mitmweb im Feld Intercept einen Filter ein, z. B. ~u /cart. Jetzt werden alle Anfragen mit dieser URL angehalten. Führen Sie die Aktion in der App aus. Die Anfrage erscheint mit dem Vermerk intercepted. Klicken Sie darauf, bearbeiten Sie die Antwort im Tab Response (Stiftsymbol) und klicken Sie auf Resume. Die App erhält die geänderten Daten.
- Aktivieren Sie in Charles Breakpoints: Rechtsklick auf die Anfrage → Breakpoints. Bei der nächsten solchen Anfrage öffnet sich ein Fenster mit zwei Phasen: zuerst Edit Request, dann Edit Response. Ändern Sie das JSON im Tab Response und klicken Sie auf Execute.
- Beachten Sie, dass Apps ein Timeout haben, normalerweise 10–30 Sekunden. Wenn Sie länger brauchen, um die Antwort zu bearbeiten, zeigt die App einen Netzwerkfehler statt Ihrer Daten. Bereiten Sie das JSON vorher in einem Texteditor vor und fügen Sie es vollständig ein.
Dauerhaftes Ersetzen der Antwort: Map Local
Wenn sich das Szenario wiederholt, sind manuelle Pausen unpraktisch. In Charles gibt es Tools → Map Local: Sie geben eine URL und eine lokale JSON-Datei an, und jede solche Anfrage erhält den Inhalt der Datei statt der Antwort der Umgebung. In mitmproxy ist das Analogon die Option map_local mit Angabe eines URL-Musters und eines Dateipfads sowie kleine Python-Skripte mit der Funktion response, die beliebige Felder ändern kann. Zum Beispiel kann ein Skript aus fünf Zeilen in allen Antworten der Umgebung den Wert des Feldes balance durch die gewünschte Zahl ersetzen.
Serverfehler simulieren
Wie verhält sich die App bei 500, 401 oder einer leeren Antwort? In der Umgebung ist das schwer zu prüfen, über den Proxy leicht. In Charles: Tools → Rewrite → fügen Sie eine Regel für die URL der Umgebung mit dem Typ Response Status und dem Wert 500 hinzu. In mitmproxy: Ändern Sie im Intercept-Modus den Statuscode im Antwort-Editor oder verwenden Sie ein Skript mit flow.response.status_code = 500. Prüfen Sie, dass die App eine verständliche Fehlermeldung anzeigt und nicht abstürzt oder in einem endlosen Ladeindikator hängt.
Langsames Netzwerk simulieren
Aktivieren Sie in Charles Proxy → Throttle Settings, wählen Sie das Preset 3G oder geben Sie eigene Werte ein: Bandbreite, Latenz, Paketverlust in Prozent. Vergessen Sie nicht, Throttle nur auf den Host der Umgebung zu beschränken, sonst werden auch andere Verbindungen langsamer. Testen Sie das Laden von Listen, das Abbrechen von Anfragen beim Verlassen des Bildschirms und das Verhalten bei Timeout. Der Android-Emulator kann das Netzwerk ebenfalls einschränken: Extended Controls → Cellular → Network type, aber der Proxy bietet eine feinere Kontrolle.
App auf ein lokales Backend umleiten
Häufige Aufgabe: Ein Entwickler hat einen Server auf seinem Laptop auf Port 3000 gestartet und bittet darum, ein Feature vor der Auslieferung in die Umgebung zu prüfen. Die App auf einem echten Telefon sieht dessen localhost nicht. Die Lösung ist wieder adb reverse:
adb reverse tcp:3000 tcp:3000Geben Sie nun in der App (über ein verstecktes Umgebungsauswahlmenü oder die Basis-URL-Einstellung im QA-Build) die Adresse http://localhost:3000 an, und die Anfragen gehen an den Computer. Wenn Sie gleichzeitig abfangen möchten, lassen Sie den Proxy aktiviert: mitmproxy sieht die Anfragen an localhost:3000 als normale Anfragen. Im Emulator können Sie statt adb reverse einfach die Adresse http://10.0.2.2:3000 verwenden.
Tipp: Speichern Sie Sitzungen. In Charles – File → Save Session, in mitmproxy – der Befehl mitmdump -w session.mitm oder die Speichern-Schaltfläche in mitmweb. Eine Sitzungsdatei mit der Reproduktion eines Bugs ist wertvoller als jede Beschreibung: Der Entwickler öffnet sie und sieht alle Anfragen in derselben Reihenfolge wie Sie.
Prüfung: Sie können: nur Anfragen an die Umgebung anzeigen; jede Anfrage als curl kopieren; eine Anfrage anhalten und der App geändertes JSON zurückgeben, das auf dem Bildschirm angezeigt wird; die App dazu bringen, den Code 500 zu erhalten, und ihre Reaktion sehen; das Netzwerk verlangsamen und den Ladeindikator sehen. Wenn alle fünf Punkte geklappt haben, beherrschen Sie den Proxy auf dem Niveau eines sicheren Anwenders.
Ergebnis prüfen: abschließende Checkliste
Gehen Sie die Liste durch und haken Sie jeden Punkt ab. Alle müssen erfüllt sein – dann ist die Umgebung vollständig für die tägliche Arbeit bereit.
Proxy auf dem Computer
- mitmweb oder Charles startet ohne Fehler und lauscht auf seinem Port.
- Der Befehl curl -x http://127.0.0.1:8080 -k https://example.com zeigt die Anfrage in der Oberfläche an.
- Die Datei mit dem Root-Zertifikat ist gefunden, und Sie wissen, wo sie liegt.
Emulator
- adb devices zeigt den Emulator mit dem Status device.
- adb shell settings get global http_proxy gibt 10.0.2.2:8080 zurück oder im Panel Extended Controls steht der Status Success.
- Chrome im Emulator öffnet HTTPS-Websites ohne Warnung.
- Das Zertifikat ist im Tab Benutzer in den Sicherheitseinstellungen sichtbar.
- Die Test-App funktioniert, ihre Anfragen an die Umgebung sind mit entschlüsselten Texten sichtbar.
Echtes Gerät
- USB-Debugging ist aktiviert, adb devices sieht das Telefon.
- Über WLAN: Proxy auf die IP des Computers, mitm.it öffnet sich, App-Anfragen sind sichtbar.
- Über USB: adb reverse --list zeigt tcp:8080, Proxy 127.0.0.1:8080 ist gesetzt, mitm.it öffnet sich bei ausgeschaltetem WLAN des Computers.
- Sie können Proxy und Weiterleitung deaktivieren, und nach dem Deaktivieren hat das Telefon wieder normal Internet.
Arbeit mit der Umgebung
- Ein Filter nach der Domain der Umgebung ist eingerichtet.
- Mindestens ein Ersetzen einer Antwort über Pause oder Map Local wurde durchgeführt.
- Die Reaktion der App auf den Code 500 wurde geprüft.
- Eine Sitzung mit einem Beispiel-Traffic wurde gespeichert.
Test-Szenario zur Selbstüberprüfung
- Starten Sie den Proxy, den Emulator und aktivieren Sie den Proxy im Emulator.
- Öffnen Sie die App, melden Sie sich an, öffnen Sie eine beliebige Datenliste.
- Finden Sie im Proxy die Anfrage, die diese Liste zurückgegeben hat. Setzen Sie einen Intercept auf ihre URL.
- Aktualisieren Sie die Liste in der App, löschen Sie in der angehaltenen Antwort die Hälfte der Elemente, lassen Sie sie los.
- Auf dem App-Bildschirm sollten weniger Elemente angezeigt werden. Wenn ja – ist die Umgebung vollständig funktionsfähig.
Typische Fehler und Lösungen
Problem 1: App zeigt Netzwerkfehler, Browser funktioniert
Ursache: Die App vertraut dem Benutzerzertifikat nicht (Standardverhalten ab Android 7), oder Certificate Pinning ist aktiviert. Lösung: Fordern Sie einen Debug-Build mit network_security_config und dem Block debug-overrides an oder einen QA-Build mit deaktiviertem Pinning für die Umgebung. Als vorübergehende Option auf einem Google-APIs-Emulator – ein Systemzertifikat. Die Ursache lässt sich mit adb logcat und einem Filter nach dem Wort Trust oder pinning eingrenzen.
Problem 2: Es gibt überhaupt keine Anfragen, obwohl der Proxy gesetzt ist
Ursache: Die App verwendet eine Netzwerkbibliothek, die den Systemproxy ignoriert. So verhalten sich Flutter-Apps (Client dart:io), einige React-Native-Builds und gRPC-Apps. Lösung: Für Flutter fügt der Entwickler im Debug-Build Unterstützung für den Systemproxy über ein Paket zum Auslesen der Proxy-Einstellungen hinzu oder setzt explizit findProxy auf 10.0.2.2:8080 im Debug-Modus. Das ist eine Standardanfrage, Flutter-Entwickler kennen sie. Alternative – transparenter Proxy-Modus, aber der ist komplexer und wird hier nicht behandelt.
Problem 3: Telefon nach dem Testen ohne Internet
Ursache: Der Proxy ist in den WLAN-Einstellungen oder in der globalen Einstellung http_proxy geblieben, während der Proxy-Server ausgeschaltet oder das Kabel getrennt ist. Lösung: adb shell settings put global http_proxy :0, und in den WLAN-Einstellungen den Proxy auf „Keine“ stellen. Fügen Sie diese Aktion am Ende Ihres Arbeitsrituals hinzu.
Problem 4: adb sieht das Gerät nicht
Ursache: Das Kabel ist nur zum Laden, die Debug-Abfrage wurde nicht bestätigt, unter Windows fehlt der Treiber, das Gerät ist im Modus „Nur Laden“ statt „Dateiübertragung“. Lösung: Wechseln Sie das Kabel, prüfen Sie den Telefonbildschirm, stellen Sie den USB-Modus im Benachrichtigungsbereich auf „Dateiübertragung“, installieren Sie unter Windows den Google USB Driver über den SDK Manager oder den Treiber des Herstellers. Es hilft auch adb kill-server und danach adb start-server.
Problem 5: Charles zeigt nur CONNECT ohne Inhalt
Ursache: SSL Proxying ist nicht aktiviert oder die Domain ist nicht in Include aufgenommen. Lösung: Proxy → SSL Proxying Settings → Enable → Add Host * Port 443. Nach dem Aktivieren öffnen Sie die App neu: Bereits aufgebaute Verbindungen werden nicht rückwirkend entschlüsselt.
Problem 6: Im Emulator-Panel Proxy status: Error
Ursache: Der Proxy auf dem Computer läuft nicht oder der Port ist anders. Manchmal übernimmt Android Studio die Einstellungen mit einem eigenen Proxy. Lösung: Starten Sie den Proxy, entfernen Sie das Häkchen für die Verwendung der Android-Studio-Einstellungen, klicken Sie erneut auf Apply. Wenn es nicht hilft – setzen Sie den Proxy über adb mit der Adresse 10.0.2.2.
Problem 7: mitm.it öffnet sich nicht, aber das übrige Internet funktioniert
Ursache: Der Traffic läuft am Proxy vorbei. Auf einem echten Gerät über WLAN ist oft die Client-Isolation im Netzwerk schuld. Lösung: Prüfen Sie den Ping zum Telefon vom Computer aus. Keine Antwort – wechseln Sie zu adb reverse. Gibt es eine Antwort – prüfen Sie Firewall und Port.
Problem 8: Nach einem Android-Studio-Update ist das Zertifikat verschwunden
Ursache: Sie haben ein Wipe Data des Emulators durchgeführt oder ihn neu erstellt. Lösung: Ein Benutzerzertifikat ist in einer Minute über mitm.it installiert. Um den Zustand nicht zu verlieren, verwenden Sie Emulator-Snapshots (Snapshots in Extended Controls): Speichern Sie einen Snapshot nach der Installation von Zertifikat und App.
Problem 9: Mehrere Geräte und Befehle werden am falschen ausgeführt
Ursache: adb ohne Flag -s verweigert bei zwei oder mehr verbundenen Geräten die Arbeit oder arbeitet mit einem unerwarteten. Lösung: Verwenden Sie immer adb -s Seriennummer, und sehen Sie die Seriennummern mit adb devices ein. Sie können die Umgebungsvariable ANDROID_SERIAL mit der gewünschten Nummer setzen.
Zusätzliche Möglichkeiten für fortgeschrittene Tester
iOS-Simulator und echtes iPhone
Die Logik ist dieselbe, die Tools sind andere. Der iOS-Simulator verwendet die Netzwerkeinstellungen von macOS, daher wird der Proxy in den Systemeinstellungen Netzwerk auf dem Mac gesetzt, und das Zertifikat wird in das Simulator-Fenster gezogen und in Einstellungen → Allgemein → Info → Zertifikatsvertrauen aktiviert. Auf einem echten iPhone wird der Proxy in den WLAN-Eigenschaften gesetzt, das Zertifikat über mitm.it heruntergeladen und über denselben Weg mit Vertrauen aktiviert. Ein Analogon zu adb reverse für iPhone über USB gibt es nicht; in geschlossenen Netzwerken verwendet man die Internetfreigabe vom Mac per Kabel.
Automatisierung mit mitmdump und Skripten
mitmdump arbeitet ohne Oberfläche und akzeptiert Python-Skripte. Beispielaufgabe: In allen Antworten der Umgebung das Feld feature_flags ersetzen, um eine experimentelle Funktion ohne Admin-Zugang zu aktivieren. Das Skript wird mit dem Flag -s script.py gestartet, und der Traffic wird mit dem Flag -w in eine Datei geschrieben. Solche Skripte lassen sich bequem im Test-Repository neben den Autotests aufbewahren.
Integration mit Appium und Autotests
In Autotests wird der Proxy vor dem Start der Sitzung aktiviert: Einstellung über adb, dann Überprüfung von Assertions nicht nur über die UI, sondern auch über den Traffic. Zum Beispiel tippt der Test auf die Schaltfläche „Bezahlen“ und prüft, dass in mitmproxy ein POST an /payments mit dem richtigen Betrag erschienen ist. Das fängt Bugs, die die UI nicht zeigt: doppelte Anfragen, Senden überflüssiger Felder, falsches Datumsformat.
Analytics und Tracking prüfen
Der Proxy ist unverzichtbar für das Testen von Analytics-Events: Sie sehen, welche Events und mit welchen Parametern die App bei jeder Aktion sendet. Ein Filter nach der Domain des Analytics-Systems und eine Spalte mit dem Anfragekörper ersparen langes Warten auf das Erscheinen der Events in Dashboards.
Mehrere Emulatoren mit unterschiedlichen Proxys
Wenn Sie das Verhalten bei unterschiedlichen Antworten der Umgebung vergleichen möchten, starten Sie zwei Proxys auf den Ports 8080 und 8090 und zwei Emulatoren, jeder mit seinem eigenen Proxy über adb -s. So lassen sich bequem A/B-Varianten prüfen: Ein Emulator erhält die ersetzte Antwort über Map Local, der zweite die Originalantwort.
Emulator-Snapshots als saubere Umgebung
Nach der Einrichtung von Proxy, Zertifikat und App speichern Sie einen Snapshot des Emulators. Laden Sie ihn vor jedem Testlauf – und Sie erhalten in Sekunden eine identische Umgebung, ohne erneute Installation.
Trennung von Umgebungen und Sicherheit
Halten Sie separate Charles-Profile oder mitmproxy-Konfigurationen für verschiedene Projekte bereit. Aktivieren Sie nicht systemweit das Abfangen des gesamten Traffics auf dem Computer – nur den Traffic der Geräte. Und prüfen Sie regelmäßig, dass auf den Testgeräten keine persönlichen Konten vorhanden sind, denn deren gesamter Traffic ist im Proxy sichtbar.
FAQ: Häufige Fragen zur Proxy-Einrichtung im Mobile-Testing
Worin unterscheidet sich adb reverse von adb forward?
adb reverse lässt einen Port auf dem Gerät auf den Computer führen: Eine App auf dem Telefon greift auf localhost zu und landet auf dem PC. adb forward ist umgekehrt: Der Port des Computers führt zum Gerät, so verbindet man sich z. B. mit einem Debugger oder Webserver im Telefon. Für Proxy und lokales Backend braucht man genau reverse.
Muss ich das Zertifikat installieren, wenn mich nur die URLs der Anfragen interessieren?
Nein. Ohne Zertifikat sehen Sie Hosts und CONNECT-Anfragen, aber nicht Pfade, Parameter und Texte. Allerdings erhält die App dabei TLS-Fehler, sodass ein normales Testen nicht möglich ist. In der Praxis installiert man das Zertifikat immer.
Warum ist im Emulator die Adresse des Computers 10.0.2.2, aber im Panel Extended Controls muss man 127.0.0.1 schreiben?
Das Emulator-Panel wendet den Proxy auf der Seite des Host-Rechners an, daher ist dort die Adresse des Computers 127.0.0.1. Der Befehl adb shell wird dagegen innerhalb von Android ausgeführt, wo 127.0.0.1 der Emulator selbst ist und der Computer unter 10.0.2.2 erreichbar ist. Merken Sie sich die Regel: innerhalb von Android – 10.0.2.2, außerhalb – 127.0.0.1.
Kann man den Proxy auf einem Gerät ohne Root verwenden?
Ja. Alles, was in diesem Leitfaden beschrieben wird, außer der Installation eines Systemzertifikats, funktioniert ohne Root. Die entscheidende Voraussetzung ist ein Debug-Build der App, der Benutzerzertifikaten vertraut.
Was tun, wenn die App nach einem Build-Update nicht mehr über den Proxy funktioniert?
Wahrscheinlich haben die Entwickler Pinning aktiviert oder die debug-overrides entfernt. Prüfen Sie adb logcat auf Zertifikatsfehler und fragen Sie das Team, was sich in der Netzwerkkonfiguration geändert hat. Oft passiert das beim Wechsel auf eine neue HTTP-Client-Bibliothek.
Wie teste ich die App über den Proxy bei mobiler Internetverbindung statt WLAN?
Verwenden Sie adb reverse über USB und die globale Einstellung http_proxy 127.0.0.1:8080. Auf den meisten Geräten wird der Proxy auch auf mobile Daten angewendet. Wenn nicht – testen Sie über WLAN, und Szenarien des Netzwerkwechsels prüfen Sie separat ohne Proxy.
Kann man den Traffic der Produktionsversion aus dem Store abfangen?
Technisch gesehen vertrauen Release-Builds keinen Benutzerzertifikaten und enthalten oft Pinning, daher funktioniert das ohne Modifikationen nicht. Und das ist richtig: Der Schutz der Nutzer ist wichtiger als der Komfort des Testers. Führen Sie alle Prüfungen mit Test-Builds und in der Umgebung durch.
Wie erkenne ich, dass die Anfrage von der App und nicht von einem Hintergrunddienst oder Browser stammt?
In Charles gibt es unter macOS die Spalte Client Process, auf dem Gerät werden keine Prozessinformationen übertragen. Ein praktischer Trick: Schließen Sie alle anderen Apps, filtern Sie nach der Domain der Umgebung und reproduzieren Sie die Aktion gezielt. In Zweifelsfällen schauen Sie auf den User-Agent-Header – Apps setzen normalerweise ihren Namen und ihre Version ein.
Wie speichere ich den Traffic und gebe ihn an den Entwickler weiter?
In Charles – File → Save Session As im Format .chls oder Export im Format HAR. In mitmproxy – das Flag -w zum Schreiben oder das Speichern aus der Weboberfläche. HAR wird von fast jedem Tool gelesen, einschließlich des Tabs Network in den Entwicklerwerkzeugen des Browsers.
Wie lange dauert die tägliche Einrichtung nach dem ersten Mal?
Proxy starten, Emulator aus dem Snapshot starten und Proxy über adb aktivieren – etwa eine Minute. Echtes Gerät über USB – zwei Befehle und zehn Sekunden. Die Zertifikatsinstallation wird nur nach einem Geräte-Reset wiederholt.
Fazit
Fassen wir zusammen. Sie haben einen abfangenden Proxy auf dem Computer eingerichtet und sich vergewissert, dass er den Traffic sieht. Sie haben den Android-Emulator auf drei verschiedene Arten darauf ausgerichtet und die Adressen 127.0.0.1 und 10.0.2.2 verstanden. Sie haben das Root-Zertifikat installiert und verstanden, warum die App ihm möglicherweise nicht vertraut und was genau Sie von den Entwicklern anfordern sollten. Sie haben ein echtes Gerät über WLAN angebunden, sind auf die Grenzen von Büronetzwerken gestoßen und haben sie mit Portweiterleitung über adb reverse gelöst. Sie haben gelernt, den Traffic der Umgebung zu filtern, Anfragen anzuhalten, Antworten zu ersetzen, Serverfehler und ein langsames Netzwerk zu simulieren sowie die App auf ein lokales Backend eines Kollegen umzuleiten.
Das ist das Skillset, das einen Tester mobiler Apps auszeichnet, der Netzwerk-Bugs selbstständig findet und lokalisiert. Ihre Bug-Reports werden präziser, und die Entwickler werden für fertige curl-Befehle und Sitzungsdateien dankbar sein.
Was Sie als Nächstes tun sollten
- Wiederholen Sie die Einrichtung in Ihrem Arbeitsprojekt und erreichen Sie, dass entschlüsselte Anfragen an die Umgebung erscheinen.
- Erstellen Sie einen persönlichen Spickzettel mit adb-Befehlen und speichern Sie einen Emulator-Snapshot mit der fertigen Umgebung.
- Führen Sie einen vollständigen Testzyklus eines Features mit geöffnetem Proxy durch und zählen Sie, wie viele Bugs dank der Sichtbarkeit des Traffics gefunden wurden.
Wohin Sie sich weiterentwickeln können
Die nächste Stufe sind Skripte für mitmproxy in Python, die Antworten automatisch ersetzen, die Integration von Traffic-Prüfungen in Appium-Autotests und das Testen der API der Umgebung direkt über Postman oder curl parallel zum mobilen Client. Es ist nützlich, die Grundlagen von TLS und die Struktur von Zertifikaten zu lernen, um sicher mit Entwicklern über Pinning und Netzwerksicherheitskonfiguration zu sprechen. Und machen Sie sich unbedingt mit dem iOS-Teil vertraut: Teams, die beide Clients testen, schätzen Spezialisten, die sich auf beiden Plattformen gleichermaßen sicher fühlen. Sie schaffen das – das Schwierigste haben Sie bereits geschafft.