# curl z proxy: składnia -x, uwierzytelnianie, SOCKS5 i przepisy debugowania Jedna flaga kieruje curl przez dowolny proxy — następnie uwierzytelnianie, tunele CONNECT, DNS SOCKS5 i zmienne środowiskowe decydują, czy to faktycznie działa. Każdy przepis, którego potrzebujesz, gotowy do wklejenia. Używanie curl z proxy to jedna flaga: `-x`. Ale pomiędzy tą flagą a działającym poleceniem scrapingowym znajduje się pięć szczegółów, które generują większość ruchu na Stack Overflow w tym temacie — składnia uwierzytelniania, tunele CONNECT, zachowanie DNS SOCKS5, zmienne środowiskowe, które cicho przechwytują żądania, oraz kody błędów, które wyglądają podobnie, dopóki nie przeczytasz szczegółowego wyniku. To kompletny, gotowy do wklejenia przewodnik: każda wariant składni, każda metoda uwierzytelniania i przepisy, które faktycznie wykorzystasz. ## Flaga -x: składnia proxy curl ```bash # route one request through an HTTP proxy curl -x http://residentialboson.quantumproxies.io:PORT https://ifconfig.me # identical, long form curl --proxy http://residentialboson.quantumproxies.io:PORT https://ifconfig.me ``` Dwa domyślne ustawienia warte poznania, prosto z dokumentacji curl: jeśli pominiesz schemat, curl zakłada proxy HTTP, a jeśli pominiesz port, zakłada 1080 — czysto historyczny wybór, który nie pasuje do prawie żadnego rzeczywistego proxy, więc zawsze pisz port jawnie. Prefiks schematu wybiera protokół proxy: `http://` dla standardowego proxy HTTP, `https://` do szyfrowania połączenia z samym proxy, `socks5://` lub `socks5h://` dla SOCKS. ## curl uwierzytelnianie proxy: trzy sposoby przesyłania poświadczeń ```bash # 1) credentials inline in the proxy URL curl -x http://USER:PASS@residentialpremium.quantumproxies.io:8080 https://ifconfig.me # 2) separate flag -- keeps the URL readable curl -x http://residentialpremium.quantumproxies.io:8080 -U USER:PASS https://ifconfig.me # 3) special characters must be percent-encoded (p@ss! -> p%40ss%21) curl -x "http://USER:p%40ss%21@residentialpremium.quantumproxies.io:8080" https://ifconfig.me ``` `-U` (wielka litera) to uwierzytelnianie proxy; mała litera `-u` uwierzytelnia się w docelowej witrynie — pomylenie ich to klasyczny błąd. `407 Proxy Authentication Required` zawsze oznacza, że proxy odrzuciło twoje poświadczenia, nigdy cel. Sprawdź literówki, niezakodowane symbole lub dostawcę oczekującego uwierzytelniania przez białą listę IP zamiast użytkownik:hasło. Z [QuantumProxies residential proxies](https://quantumproxies.io/residential-proxies) działają oba tryby — dodaj IP swojego komputera do białej listy i pomiń poświadczenia całkowicie lub osadź użytkownik:hasło w URL. Pełna lista kontrolna 407 znajduje się w [naszym przewodniku rozwiązywania problemów 407](https://quantumproxies.io/blog/fix-407-proxy-authentication-required). ![curl -x prosi proxy o CONNECT ifconfig.me:443, proxy odpowiada 200 Connection established, a curl przeprowadza handshake TLS z celem przez ten tunel. Karta: TLS działa od końca do końca, proxy tylko przekazuje zaszyfrowane dane, których nie może odczytać, a cokolwiek innego niż 200 po CONNECT wskazuje miejsce awarii.](https://res.cloudinary.com/dmqliab0t/image/upload/f_auto,q_auto,w_1200/v1785335145/blog/generated/qp-b9-006-diag1.png) *Dla celów HTTPS curl prosi proxy o tunel CONNECT, a następnie uruchamia TLS end-to-end wewnątrz niego — proxy przekazuje bajty, których nie może odczytać.* ## Cele HTTPS i tunel CONNECT Gdy docelowy URL to `https://`, curl nie prosi proxy o pobranie strony. Wysyła żądanie `CONNECT host:443`, proxy otwiera surowy tunel TCP, a curl wykonuje handshake TLS bezpośrednio z celem przez niego. Dlatego proxy HTTP może przenosić ruch HTTPS bez łamania szyfrowania — przekazuje zaszyfrowane dane, których nie może odczytać ani zmodyfikować. W wyniku `-v` zobaczysz linię `CONNECT` po której następuje `200 Connection established`; cokolwiek innego na tym etapie to twój punkt awarii. Dla protokołów nie-HTTP przez proxy HTTP, `-p` (`--proxytunnel`) wymusza takie samo zachowanie tunelowe. ## SOCKS5: jeden znak zmienia miejsce, w którym odbywa się DNS ```bash # SOCKS5, hostname resolved on YOUR machine curl -x socks5://USER:PASS@residentialpremium.quantumproxies.io:1080 https://ifconfig.me # SOCKS5h, hostname resolved BY THE PROXY -- use this for scraping curl -x socks5h://USER:PASS@residentialpremium.quantumproxies.io:1080 https://ifconfig.me # dedicated flag, same as socks5h curl --socks5-hostname residentialpremium.quantumproxies.io:1080 -U USER:PASS https://ifconfig.me ``` Z prostym `socks5://`, twoja maszyna wykonuje lokalne wyszukiwanie DNS — docelowa nazwa hosta wycieka do lokalnego resolvera, a możesz otrzymać IP, które geograficznie nie pasuje do twojego wyjścia. `socks5h://` przenosi rozwiązywanie do proxy, więc odpowiedzi DNS pochodzą z sieci wyjścia. Każdy [plan QuantumProxies obejmuje SOCKS5](https://quantumproxies.io/socks5-proxies) obok HTTP na tej samej bramie. Jeśli nie jesteś pewien, którego protokołu potrzebuje dane narzędzie, nasz [porównanie SOCKS5 vs HTTP](https://quantumproxies.io/blog/socks5-vs-http-proxy-difference) wyjaśnia to szczegółowo. ![Dwa schematy SOCKS5 w curl obok siebie: socks5:// rozwiązuje nazwę hosta na twojej maszynie, ujawniając ją lokalnemu resolverowi i ryzykując niezgodność lokalizacji, a socks5h:// rozwiązuje DNS na wyjściu proxy. Karta zaleca socks5h:// lub --socks5-hostname jako domyślne ustawienie do scrapingu.](https://res.cloudinary.com/dmqliab0t/image/upload/f_auto,q_auto,w_1200/v1785335145/blog/generated/qp-b9-006-diag2.png) *socks5h:// rozwiązuje DNS na wyjściu — brak lokalnego wycieku nazw hostów, brak geograficznego niedopasowania. Domyślnie używaj go do scrapingu.* ## Zmienne środowiskowe i .curlrc ```bash # proxy every curl (and most CLI tools) in this shell export http_proxy="http://USER:PASS@residentialpremium.quantumproxies.io:8080" export https_proxy="http://USER:PASS@residentialpremium.quantumproxies.io:8080" export NO_PROXY="localhost,127.0.0.1,.internal.example" curl https://ifconfig.me # proxied automatically curl --noproxy "*" https://ifconfig.me # bypass for one call # permanent default: add to ~/.curlrc # proxy = "http://USER:PASS@residentialpremium.quantumproxies.io:8080" ``` Jedna osobliwość opisana w man page curl w końcu zaskoczy każdego: zmienne mogą być pisane wielkimi lub małymi literami, a małe litery wygrywają, z wyjątkiem `http_proxy`, które curl honoruje tylko w małych literach — `HTTP_PROXY` jest celowo ignorowane ze względów bezpieczeństwa. Na Windows składnia `-x` jest identyczna w cmd i PowerShell; ustaw zmienne za pomocą `set http_proxy=...` lub `$env:http_proxy="..."`, a plik konfiguracyjny to `%APPDATA%\_curlrc`. Pamiętaj, że te zmienne wpływają też na inne narzędzia — zapomniany eksport w CI to klasyczne źródło tajemniczego ruchu. ## Debugowanie z -v: czytaj handshake, nie fusy Dodaj `-v`, a curl opowie całą rozmowę proxy. Dopasuj to, co widzisz, do przyczyny: - `Connected to residentialpremium.quantumproxies.io` — dotarłeś do proxy; każda awaria po tym to problem z uwierzytelnianiem lub po stronie celu. - `curl: (7) Failed to connect` — błędny host/port, martwe proxy lub zapora blokująca port zanim proxy w ogóle odpowie. - `407 Proxy Authentication Required` — brakujące, błędne poświadczenia lub niezakodowane znaki specjalne w URL. - `curl: (56) CONNECT aborted` — proxy odmówiło tunelu, zwykle dlatego, że docelowy port nie jest dozwolony (większość proxy pozwala na 443 i niewiele więcej). - Tunel otwiera się, ale strona zwraca 403 — to cel cię blokuje, nie proxy; przetestuj wyjście za pomocą [darmowego narzędzia do sprawdzania jakości IP](https://quantumproxies.io/ip-checker) i zobacz [dlaczego curl dostaje 403, gdy przeglądarka działa bez problemu](https://quantumproxies.io/blog/curl-403-but-browser-works). ## Przetestuj proxy zanim mu zaufasz Dwa trzydziestosekundowe testy oszczędzą godziny zdezorientowanego debugowania później. Po pierwsze, potwierdź anonimowość: prześlij żądanie do `https://httpbin.org/headers` przez proxy i sprawdź, co faktycznie otrzymuje cel — czysta brama nie dodaje nagłówków `Via` ani `X-Forwarded-For`, które reklamowałyby proxy, podczas gdy tanie lub darmowe proxy często wstrzykują oba. Po drugie, zmierz narzut za pomocą zmiennych czasu `-w` (przepis poniżej): skok rezydencyjny zwykle dodaje kilkaset milisekund w porównaniu do bezpośredniego żądania, co jest normalne; wielosekundowe czasy połączenia oznaczają zatłoczone wyjście, od którego warto się oddalić. Wbuduj oba testy w CI dla każdej linii, która zależy od proxy, a złapiesz źle skonfigurowany punkt końcowy, zanim cicho spali sesję scrapingu — lub twój budżet na przepustowość, ponieważ rachunki za użycie są naliczane za GB, niezależnie od tego, czy odpowiedzi były użyteczne, czy nie. ## Szybkie przepisy ```bash # confirm the exit IP curl -x http://USER:PASS@residentialpremium.quantumproxies.io:8080 https://ifconfig.me # geo-target: choose the exit country in the username curl -x "http://USER-country-de:PASS@residentialpremium.quantumproxies.io:8080" https://ifconfig.me # sticky session: keep the same exit IP across calls curl -x "http://USER-sid-a1b2c3-ttl-30m:PASS@residentialpremium.quantumproxies.io:8080" https://example.com # POST JSON through the proxy curl -x http://USER:PASS@residentialpremium.quantumproxies.io:8080 \ -H "Content-Type: application/json" -d '{"q":"test"}' https://httpbin.org/post # fetch a page: follow redirects, browser UA, save to file curl -x http://USER:PASS@residentialpremium.quantumproxies.io:8080 -L -A "Mozilla/5.0" \ -o page.html https://example.com # measure the proxy overhead curl -x http://USER:PASS@residentialpremium.quantumproxies.io:8080 -s -o /dev/null \ -w "connect: %{time_connect}s total: %{time_total}s\n" https://example.com ``` Triki z przyrostkiem nazwy użytkownika działają, ponieważ brama analizuje cel z poświadczeń: wybór kraju z ponad 200 lokalizacji, rotacja na żądanie domyślnie, lepkie sesje, gdy przepływ potrzebuje jednej tożsamości. Gdy twoje jednolinijkowce rozrastają się w skrypt, ten sam punkt końcowy można bezpośrednio użyć w Pythonie — nasz [przewodnik po proxy Python Requests](https://quantumproxies.io/blog/python-requests-proxy-guide) kontynuuje dokładnie tam, gdzie curl się kończy. ## Często zadawane pytania ### Jak używać proxy SOCKS5 z curl? Przekaż je do `-x` ze schematem SOCKS: `curl -x socks5h://user:pass@host:port https://target`. Preferuj `socks5h://` nad `socks5://`, aby DNS rozwiązywał się na proxy, a nie na twojej maszynie. Starsze flagi `--socks5` i `--socks5-hostname` nadal działają i robią to samo. ### Jak sprawić, by curl ignorował proxy? Dla jednego żądania dodaj `--noproxy "*"`. Dla powłoki, odznacz `http_proxy` i `https_proxy`. Aby na stałe wykluczyć określone hosty, wymień je w `NO_PROXY` jako domeny oddzielone przecinkami. Jeśli curl korzysta z proxy, mimo że nigdy tego nie prosiłeś, prawdopodobnie winna jest zmienna środowiskowa lub linia w `~/.curlrc`. ### Dlaczego curl zwraca 407 Proxy Authentication Required? Proxy odrzuciło twoje poświadczenia. Zweryfikuj użytkownika i hasło, upewnij się, że użyłeś `-U` (nie `-u`, które celuje w witrynę), i zakoduj procentowo znaki specjalne, takie jak `@` lub `!`. Jeśli twój dostawca uwierzytelnia przez białą listę IP, autoryzuj IP twojego komputera w panelu i nie wysyłaj żadnych poświadczeń. ### Czy składnia proxy curl działa na Windows? Tak — `-x`, `-U` i schematy SOCKS są identyczne, ponieważ curl jest dostarczany z Windows 10 i nowszymi. Różni się tylko środowisko: ustaw zmienne za pomocą `set` w cmd lub `$env:` w PowerShell, i używaj `%APPDATA%\_curlrc` zamiast `~/.curlrc` dla ustawień trwałych. ### Jak ustawić stałe proxy dla curl? Dodaj linię `proxy = "http://user:pass@host:port"` do `~/.curlrc` (lub `_curlrc` na Windows) i każde wywołanie curl użyje go. Alternatywnie, eksportuj `http_proxy` i `https_proxy` z profilu powłoki, aby objąć inne narzędzia. Składnia `-x` z linii poleceń zawsze nadpisuje oba, więc jednorazowe wyjątki pozostają łatwe. To cała powierzchnia: `-x` plus schemat, poświadczenia zakodowane poprawnie, `socks5h` gdy używasz SOCKS, zmienne środowiskowe ustawione celowo i `-v` gdy cokolwiek nie działa. Powyższe polecenia działają bez zmian na każdej bramie — połącz je z czystymi wyjściami rezydencyjnymi, a curl stanie się naprawdę zdolnym narzędziem do scrapingu. [Przetestuj te przepisy na QuantumProxies residential proxies](https://quantumproxies.io/residential-proxies)