Charles Proxy — co to jest, konfiguracja i przechwytywanie ruchu HTTPS

Czym jest Charles Proxy?

Charles Proxy — to proxy HTTP i monitor HTTP, działający jako pośrednik między klientem a serwerem. Wszystkie żądania i odpowiedzi przechodzą przez Charles, co pozwala przeglądać ich zawartość, analizować strukturę, modyfikować dane w czasie rzeczywistym i symulować różne warunki sieciowe. Dostępny dla Windows, macOS i Linux.

Historia i pozycjonowanie

Charles Proxy został stworzony w 2004 roku przez Karla von Randow i pozostaje jednym z najpopularniejszych narzędzi do debugowania ruchu sieciowego. W przeciwieństwie do darmowych alternatyw, Charles oferuje płatną licencję z 30-dniowym okresem próbnym. Narzędzie jest pozycjonowane jako profesjonalne rozwiązanie dla programistów aplikacji mobilnych, web-developerów i inżynierów QA, którzy potrzebują pełnej kontroli nad komunikacją HTTP.

Zgodność z platformami

Charles działa jako systemowe proxy na komputerze i może przechwytywać ruch z dowolnych urządzeń w tej samej sieci: Android, iOS, symulatorów, emulatorów, przeglądarek internetowych i urządzeń IoT. Do przechwytywania HTTPS należy zainstalować certyfikat główny Charles na każdym urządzeniu. Ruch jest obsługiwany na HTTP/1.1 i HTTP/2 (częściowo). HTTP/3 (QUIC) nie jest obsługiwany na poziomie przechwytywania.

Jak działa Charles Proxy

Charles działa na zasadzie MITM (Man-in-the-Middle) proxy: gdy klient wysyła żądanie przez Charles, narzędzie przechwytuje to żądanie, przekierowuje do docelowego serwera, otrzymuje odpowiedź i przekazuje ją z powrotem do klienta. Cały ruch przechodzi przez Charles, co pozwala go analizować i modyfikować.

Architektura proxy

Po uruchomieniu Charles tworzy lokalne proxy HTTP na porcie 8888 (domyślnie). System operacyjny lub aplikacja jest konfigurowana do korzystania z tego proxy. Wszystkie żądania HTTP są najpierw wysyłane do Charles, który następnie działa jako pełnoprawny klient dla docelowego serwera. Dla HTTPS Charles używa własnej techniki SSL-proxy: generuje certyfikat w locie dla każdej domeny, podpisany certyfikatem głównym Charles. Jeśli certyfikat główny jest zainstalowany na urządzeniu jako zaufany, Charles może odszyfrowywać i przeglądać ruch HTTPS.

Tryby pracy

Charles obsługuje dwa tryby: Proxy (klasyczny serwer proxy) i SOCKS Proxy (dla ruchu UDP i TCP). Do tworzenia stron internetowych używa się standardowego HTTP-proxy. Dla urządzeń mobilnych — konfiguracja WiFi Proxy na urządzeniu z podaniem adresu IP komputera, na którym uruchomiono Charles. MacOS obsługuje automatyczną konfigurację proxy dla symulatora iOS.

<!-- Konfiguracja network_security_config.xml dla Android z obsługą Charles -->
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <debug-overrides>
        <trust-anchors>
            <!-- Zaufać certyfikatowi Charles w kompilacji Debug -->
            <certificates src="user" />
        </trust-anchors>
    </debug-overrides>
</network-security-config>

Główne funkcje Charles Proxy

Charles Proxy udostępnia zestaw profesjonalnych narzędzi do analizy i modyfikacji ruchu, wykraczający daleko poza zwykłe przechwytywanie żądań.

Rewrite i Breakpoints

Narzędzie Rewrite umożliwia automatyczną zmianę określonych części żądań lub odpowiedzi: nagłówków, parametrów URL, treści odpowiedzi. Na przykład można zastąpić nagłówek User-Agent wartością z innego urządzenia lub usunąć określone cookies. Breakpoints działają jak debugger: żądanie jest zatrzymywane na wybranym etapie (przed wysłaniem lub przed otrzymaniem), a programista może ręcznie zmienić jego zawartość, zanim pójdzie dalej. Jest to przydatne do testowania obsługi błędnych odpowiedzi lub niestandardowych stanów.

Map Local i Map Remote

Map Local umożliwia zastąpienie zasobu sieciowego (CSS, JS, JSON) lokalnym plikiem z dysku. Jest to niezastąpione przy tworzeniu frontendu: można modyfikować CSS/JS i natychmiast widzieć wynik bez wdrażania na serwer. Map Remote przekierowuje żądania z jednego URL na inny — na przykład z serwera produkcyjnego na staging do testowania. Oba narzędzia działają na wzorcach URL z obsługą wildcards.

Throttle i symulacja warunków sieciowych

Narzędzie Throttle umożliwia symulację różnych typów połączeń sieciowych według predefiniowanych profili: 3G, EDGE, GPRS, DSL, WiFi. Można skonfigurować ograniczenie prędkości (download/upload), opóźnienie, utratę pakietów i stabilność. Jest to krytycznie ważne do testowania zachowania aplikacji przy wolnym lub niestabilnym połączeniu — prawidłowa obsługa timeoutów, ponawianie prób, tryb offline.

Auto Save i Recording

Charles może automatycznie zapisywać sesje ruchu do plików .chls, co pozwala analizować je później lub przekazywać współpracownikom. Recording Control umożliwia elastyczne skonfigurowanie, który ruch ma być zapisywany: według domen, typów treści, kodów statusu. Jest to wygodne do długoterminowego monitorowania działania API.

Konfiguracja Charles Proxy dla urządzeń mobilnych

Do debugowania ruchu aplikacji mobilnych Charles jest konfigurowany jako WiFi Proxy: wszystkie urządzenia w tej samej sieci co komputer mogą kierować ruch przez Charles. Prawidłowa konfiguracja HTTPS wymaga instalacji certyfikatu Charles na urządzeniu mobilnym.

Konfiguracja na Android

Dla Android należy: otworzyć Ustawienia → WiFi → Zaawansowane → Proxy, wybrać Manual i podać adres IP komputera z portem 8888. Następnie otworzyć przeglądarkę na urządzeniu i przejść pod adres http://chls.pro/ssl w celu pobrania certyfikatu Charles. Na Android 7+ (API 24+) wymagany jest network_security_config.xml do zaufania certyfikatom użytkownika w kompilacji Debug — w przeciwnym razie aplikacja może nie przepuszczać ruchu przez Charles.

Konfiguracja na iOS

Dla iOS: Ustawienia → WiFi → skonfiguruj proxy na IP i port 8888. Następnie Safari → http://chls.pro/ssl → zainstaluj profil certyfikatu. W iOS 10.3+ należy dodatkowo włączyć zaufanie do certyfikatu: Ustawienia → Ogólne → Informacje → Ustawienia zaufania certyfikatów → włączyć Charles Proxy. iOS jest bardziej rygorystyczny w kwestii certyfikatów: niektóre aplikacje mogą używać SSL Pinning, blokując ruch przez Charles nawet z zaufanym certyfikatem.

Rozwiązywanie problemów z SSL Pinning

Jeśli aplikacja używa SSL Pinning (przypięcie certyfikatu serwera), standardowe proxy przez Charles nie zadziała — aplikacja odrzuci certyfikat Charles. Rozwiązania: wyłączyć SSL Pinning w kompilacji Debug przez ustawienia OkHttp lub URLSession, użyć Fridy do obejścia pinning w runtime, lub zastosować Android Emulator z dostępem root.

Praktyczne scenariusze użycia Charles Proxy

Charles Proxy rozwiązuje konkretne zadania programistyczne i testowe. Rozważmy najczęstsze scenariusze, w których narzędzie jest niezastąpione.

Debugowanie integracji z API

Najczęstszy scenariusz — sprawdzanie poprawności żądań API. Charles pokazuje dokładny URL żądania, nagłówki, treść, parametry. Jeśli serwer zwraca nieoczekiwaną odpowiedź, od razu widać: strukturę JSON, kod błędu, nagłówki odpowiedzi. Pozwala to odróżnić błąd po stronie klienta od błędu po stronie serwera bez logów z obu stron.

Testowanie z wolnym połączeniem

Używając profili Throttle, można sprawdzić, jak aplikacja zachowuje się przy niskiej prędkości połączenia: czy wyświetlany jest wskaźnik ładowania, czy timeout jest prawidłowo obsługiwany, czy UI nie zawiesza się przy utracie połączenia. Szczególnie ważne jest testowanie buforowania — jeśli dane są już załadowane, aplikacja powinna wyświetlać je z pamięci podręcznej, a nie wchodzić w nieskończone ładowanie.

Edycja odpowiedzi serwera

Za pomocą Breakpoints można zmienić odpowiedź serwera przed jej wysłaniem do aplikacji. Na przykład zwrócić pustą tablicę zamiast danych, zmienić kod statusu na 500, dodać nowe pole do JSON. Pozwala to sprawdzić obsługę przypadków brzegowych bez modyfikacji kodu serwera — jedno z najpotężniejszych zastosowań Charles w programowaniu mobilnym.