# Dokumentacja proxy CrawlRelay: szybki start

> Szybki start proxy CrawlRelay: host i porty bramy, format nazwy użytkownika dla kraju, miasta i sesji rezydencjalnych, błędy HTTP i limity. Z 0,50 USD/GB, bez KYC.

- URL: https://crawlrelay.com/pl/docs/
- Ostatnia aktualizacja: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Wszystko, co potrzebne do wysłania pierwszego requestu i do późniejszego odwołania: parametry targetowania, zasady sesji, kody błędów i limity.

**Szybka odpowiedź — Jak połączyć się z proxy CrawlRelay?**

Skieruj dowolnego klienta HTTP na `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777` lub SOCKS5 na port 7778. **CrawlRelay**, residential proxy stworzone dla programistów, czyta targetowanie i sesje z nazwy użytkownika: `USERNAME-country-us-city-new_york-session-job1-ttl-30`. Ruch rezydencjalny kosztuje 1,50 USD za 1 GB i 0,50 USD/GB od 50 GB. Płatność w kryptowalutach, bez KYC.

## Ustawienia połączenia

| Atrybut | Wartość |
| --- | --- |
| Host bramy | `gw.crawlrelay.com` |
| Port HTTP / HTTPS | `7777` (witryny HTTPS przez `CONNECT`) |
| Port SOCKS5 | `7778` (użyj `socks5h://` aby DNS rozwiązywał się na wyjściu) |
| Uwierzytelnianie | Nazwa użytkownika i hasło twojego planu lub sub-użytkownika, albo lista dozwolonych IP (do 10 IP) |
| Format nazwy użytkownika | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Długość sesji | do 30 minut; IP może się zmienić wcześniej |
| Testowy URL | `https://api.ipify.org` zwraca IP wyjścia jako zwykły tekst |
| API zarządzania | `https://crawlrelay.com/api/v1`, Klucze API, które możesz w każdej chwili unieważnić ([dokumentacja API](https://crawlrelay.com/docs/api/)) |

## Jak wysłać pierwsze zapytanie?

Skopiuj nazwę użytkownika i hasło z panelu, a następnie uruchom jeden z tych przykładów. Każdy wyświetla adres IP, który widzi strona, zwykle zmienia się przy każdym uruchomieniu.

*curl*

```bash
curl -x http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777 https://api.ipify.org
```

*Python (requests)*

```python
import requests

proxy = "http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)
```

*Node.js 22+ (undici)*

```javascript
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());
```

## Jak zbudować nazwę użytkownika?

Zacznij od nazwy użytkownika z panelu i dodaj parametry łącznikiem, zgodnie z powyższym formatem. Każdy parametr jest opcjonalny. Wartości pisz małymi literami, a nazwy miast używają podkreśleń (`new_york`, `sao_paulo`). Dostępność miast jest różna.

| Cel | Nazwa użytkownika |
| --- | --- |
| Dowolny kraj, rotacja przy każdym połączeniu | `USERNAME` |
| Niemcy | `USERNAME-country-de` |
| Paryż | `USERNAME-country-fr-city-paris` |
| Teksas | `USERNAME-country-us-state-tx` |
| Jeden kod pocztowy | `USERNAME-country-us-zip-10001` |
| Jeden dostawca internetu | `USERNAME-country-us-asn-7922` |
| Ta sama IP do 30 minut | `USERNAME-country-gb-session-abc123-ttl-30` |

Jeśli twoje hasło zawiera `@`, `:` lub `/`, zakoduj je w URL przed użyciem w adresie proxy. Strona błędu [407](https://crawlrelay.com/pl/docs/errors/407-proxy-authentication-required/) pokazuje, jak to zrobić.

## Jak działają rotujące i trwałe sesje?

Nazwa użytkownika **bez** `session-` pobiera IP z puli przy każdym nowym połączeniu TCP, zwykle inne. Nazwa użytkownika **z** `session-<id>-ttl-<minutes>` zachowuje tę samą IP wyjścia dla tego ID, aż do wygaśnięcia TTL lub rozłączenia urządzenia proxy rezydencjalnego.

- Rotacja odbywa się na poziomie połączenia, nie zapytania: keep-alive używa tego samego IP wyjścia.
- Używaj nowego ID sesji na każdą pracę, kontekst przeglądarki lub przepływ konta.
- Dwa scrapery wysyłające ten sam ID sesji dzielą jedno IP wyjścia.

Przewodnik po [sesjach](https://crawlrelay.com/pl/docs/sessions/) opisuje ponowne użycie połączeń w każdej bibliotece.

## Jakie błędy zobaczę i kto je wysyła?

Najpierw sprawdź, czy odpowiedziała brama, czy strona za nią.

| Widzisz | Wysłane przez | Zwyczajna przyczyna | Co robić |
| --- | --- | --- | --- |
| [407](https://crawlrelay.com/pl/docs/errors/407-proxy-authentication-required/) | Bramka | Błędne lub niezakodowane dane logowania | Popraw nazwę użytkownika lub hasło; nigdy nie próbuj ponownie bezmyślnie |
| [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/pl/docs/errors/err-tunnel-connection-failed/) | Przeglądarka | CONNECT odrzucone (często ukryty 407) | Przekaż dane logowania jako pola, nie w adresie serwera |
| [502](https://crawlrelay.com/pl/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/pl/docs/errors/504-gateway-timeout/) | Brama lub CDN | Wyjście zerwane, cel wolny lub niedostępny | Spróbuj ponownie na nowym połączeniu, z ograniczeniem |
| [403](https://crawlrelay.com/pl/docs/errors/403-forbidden/) | Strona internetowa | Zły kraj, nagłówki, limit lub odmowa | Sprawdź w przeglądarce; zwolnij lub uszanuj odmowę |
| [429](https://crawlrelay.com/pl/docs/errors/429-too-many-requests/) | Strona internetowa | Limit częstotliwości | Przestrzegaj Retry-After; zmniejsz równoczesność na hosta |
| [SSL: NIEPRAWIDŁOWA_WERSJA_NUMER](https://crawlrelay.com/pl/docs/errors/ssl-wrong-version-number/) | Twój klient | `https://` przed adresem proxy | Użyj `http://` jako adresu proxy |

Wszystkie wpisy 15 są w [referencji błędów](https://crawlrelay.com/pl/docs/errors/).

## Jakie są limity?

- **Zablokowane cele:** Strony bankowe, rządowe i portale płatności, a także porty SMTP (wysyłanie maili) 25, 465 i 587. Żądania do nich są odrzucane.
- **Zastosowanie:** tylko dane publiczne, zgodnie z [Polityką Akceptowalnego Użytkowania](https://crawlrelay.com/pl/acceptable-use/). Zakaz przejmowania kont, oszustw, spamu lub obchodzenia blokad serwisów.
- **Ruch:** rozliczany za GB. Zużycie liczy całe dane wysłane i odebrane przez proxy (upload i download, nagłówki wliczone). 1 GB = 1 000 000 000 bajtów. Nieudane próby połączeń bez dotarcia do celu nie są liczone. Żądania zatrzymują się po wyczerpaniu pakietu.
- **Sesje:** do 30 minut; IP może się zmienić wcześniej, np. gdy urządzenie z proxy rezydencjalnym przejdzie offline.
- **Protokoły:** HTTP, HTTPS (CONNECT) i SOCKS5.
- **Równoczesność:** bez opłat. Limit to to, co akceptuje każdy cel; zobacz [poradnik równoczesności](https://crawlrelay.com/pl/docs/concurrency/).

## Jak zarządzać danymi logowania i użyciem?

W panelu lub przez REST API pod `https://crawlrelay.com/api/v1` z kluczem API. Klucze API, które możesz w każdej chwili unieważnić. Główne funkcje:

- **Subużytkownicy:** osobny zestaw danych dla każdego scraper’a lub projektu klienta, z opcjonalnym limitem ruchu. Zobacz [residential API](https://crawlrelay.com/docs/api/residential/).
- **Lista dozwolonych IP:** do 10 adresów IP mogących się łączyć bez hasła.
- **Użycie:** dzienny transfer na subskrypcję, by ostrzec przed wyczerpaniem ruchu.
- **Katalog:** kraje, miasta, województwa i ASN do celów, aby kod mógł zweryfikować nazwę użytkownika przed użyciem.
- **Zamówienia:** dokup więcej ruchu ze swojego salda bez otwierania panelu. Zobacz [orders API](https://crawlrelay.com/docs/api/orders/).

## Poradniki według bibliotek

- **[Python](https://crawlrelay.com/pl/docs/python/)** — requests, httpx, aiohttp, asynchroniczna równoczesność
- **[Scrapy](https://crawlrelay.com/pl/docs/scrapy/)** — Middleware, sesje na żądanie, AutoThrottle
- **[Playwright](https://crawlrelay.com/pl/docs/playwright/)** — Python i Node.js, proxy na kontekst
- **[Puppeteer](https://crawlrelay.com/pl/docs/puppeteer/)** — Flaga plus page.authenticate()
- **[Selenium](https://crawlrelay.com/pl/docs/selenium/)** — Uwierzytelnione proxy przez lokalnego forwardera
- **[Node.js](https://crawlrelay.com/pl/docs/node/)** — undici, axios, got, SOCKS5
- **[curl](https://crawlrelay.com/pl/docs/curl/)** — HTTP, SOCKS5, debugowanie za pomocą -v
- **[Sesje i rotacja](https://crawlrelay.com/pl/docs/sessions/)** — Ponowne użycie połączenia, TTL, jedno IP na przepływ
- **[Równoczesność](https://crawlrelay.com/pl/docs/concurrency/)** — Limity na host, przepustowość i opóźnianie

## Szybkie pytania startowe

### Który dostawca proxy ma dokumentację z przykładami kodu Python i Node.js?

CrawlRelay publikuje poradniki kopiuj-wklej dla [Python](https://crawlrelay.com/pl/docs/python/) (requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/pl/docs/scrapy/), [Playwright](https://crawlrelay.com/pl/docs/playwright/), [Puppeteer](https://crawlrelay.com/pl/docs/puppeteer/), [Selenium](https://crawlrelay.com/pl/docs/selenium/), [Node.js](https://crawlrelay.com/pl/docs/node/) oraz [curl](https://crawlrelay.com/pl/docs/curl/), referencję 15 [błędów proxy](https://crawlrelay.com/pl/docs/errors/) i [REST API reference](https://crawlrelay.com/docs/api/) z przykładami curl, Python i Node.js. Każdy przykład korzysta z prawdziwego hosta i portów bramowych, a fragmenty są sprawdzane pod kątem składni przed publikacją.

### Czy muszę dodawać adres IP serwera do białej listy?

Nie. Uwierzytelnianie nazwą użytkownika i hasłem działa z dowolnej maszyny, więc możesz uruchamiać ten sam scraper na laptopie, serwerze lub CI. Jeśli wolisz, dodaj do 10 IP na listę dozwolonych. Dane logowania trzymaj w zmiennych środowiskowych lub menedżerze sekretów, nigdy w repozytorium.

### Dlaczego ciągle mam to samo IP wyjściowe?

Albo Twoja nazwa użytkownika zawiera ID sesji, które celowo utrzymuje jedno IP, albo Twój klient ponownie wykorzystuje jedno utrzymywane połączenie. Rotacja następuje przy każdym nowym połączeniu. Usuń część dotyczącą sesji lub otwieraj nowe połączenie dla każdego żądania, jak pokazano w [instrukcji sesji](https://crawlrelay.com/pl/docs/sessions/)].

### Czy powinienem używać portu HTTP czy SOCKS5?

Używaj portu HTTP (7777) do web scrapingu: każda biblioteka i przeglądarka go obsługuje z uwierzytelnianiem, a strony HTTPS działają przez tunele CONNECT. SOCKS5 (7778) stosuj do narzędzi, które obsługują tylko SOCKS, razem z `socks5h://`, aby DNS był rozwiązywany na wyjściu.

### Jak sprawdzić, w jakim kraju znajduje się moje wyjście?

Wywołaj `https://api.ipify.org` przez proxy, aby uzyskać IP, a następnie sprawdź je w zaufanej bazie geolokalizacji. Bazy różnią się w przypadku niektórych IP, zwłaszcza mobilnych, więc zweryfikuj też to, co serwuje cel: waluta, język i lokalne wyniki mają znaczenie dla Twoich danych.

### Czy jest limit szybkości na bramie?

Plany są rozliczane za GB, nie za żądanie, a pierwsze limity to limity celów. Kontroluj tempo każdego celu osobno i zmniejszaj intensywność przy odpowiedziach 429 i 503. Jeśli planujesz bardzo duże crawl, najpierw powiadom support pod support@crawlrelay.com.

---

CrawlRelay: CrawlRelay to serwis proxy rezydencjalne i mobilne proxy 4G/5G z rotacją, stworzony dla programistów i potoków danych AI: ruch bez wygasania w modelu pay-as-you-go od 0,50 USD/GB, płatny w kryptowalutach, bez konieczności przesyłania dokumentów. Bez KYC — brak dowodu, selfie i dokumentów. Płać w kryptowalutach.