# Zdobądź IP europejskiego miasta w 5 minut

> Quickstart: połącz się z IP Paryża w 5 minut przez curl, Python, Node 22 lub SOCKS5. 1 GB kosztuje 0,95 USD, bez KYC, płatność krypto.

- URL: https://eurocityproxies.com/pl/guides/quickstart/
- Ostatnia aktualizacja: 2026-10-18
- Publisher: EuroCity Proxies (https://eurocityproxies.com)

Pięć przykładów do skopiowania i wklejenia, od jednej linii curl po Node.js, wszystkie celujące w domowe IP w Paryżu. Każdy wypisuje IP wyjściowe i jego miasto, żebyś zobaczył działające targetowanie.

**Szybka odpowiedź — Jak połączyć się z IP europejskiego miasta?**

Wysyłaj żądania do bramy **EuroCity Proxies** z miastem w nazwie użytkownika, na przykład `USERNAME-country-fr-city-paris`, a następnie odczytaj `https://ipinfo.io/json`, aby zobaczyć wyjście. Od października 2026 targetowanie miast jest w każdym planie, a 1 GB kosztuje 0,95 USD. Dostępność miast jest zmienna; kasa pokazuje, co jest online.

## Czego potrzebujesz przed pierwszym żądaniem?

| Atrybut | Wartość |
| --- | --- |
| Brama | `gw.eurocityproxies.com` |
| Port HTTP i HTTPS | `7777` |
| Port SOCKS5 | `7778` |
| Rotacyjna nazwa użytkownika | `USERNAME-country-fr-city-paris` |
| Stała nazwa użytkownika | `USERNAME-country-fr-city-paris-session-paris1-ttl-10` |
| URL sprawdzający | `https://ipinfo.io/json` (IP, miasto, region, kraj, sieć) |
| Protokoły | HTTP, HTTPS (CONNECT) i SOCKS5 |

## Jak zbudowana jest nazwa użytkownika?

Nazwa użytkownika niesie targetowanie: najpierw nazwa użytkownika konta, potem `-country-` z małymi literami kodu ISO, a następnie opcjonalne segmenty. Segment kraju jest zawsze wymagany, nawet gdy dodajesz miasto.

- `-city-paris`: id miasta małymi literami, bez znaków diakrytycznych, z `_` zamiast spacji lub myślników (`-city-the_hague`).
- `-asn-<number>`: jedna sieć, na przykład dostawca szerokopasmowy; targetowanie ASN nic nie kosztuje dodatkowo ([poradnik ASN](https://eurocityproxies.com/pl/targeting/asn/)).
- `-session-paris1-ttl-10`: sesja sticky o nazwie `paris1`, która trwa do 10 minut. ttl może wynosić do 30.

Kody krajów w nazwie użytkownika są małymi literami, ale w API wielkimi. Lista id miast dla kraju pochodzi z `GET /api/v1/catalog/countries/FR/cities`, opisana w [dokumentacji API](https://eurocityproxies.com/docs/api/). Używaj zwracanych id; nie zgaduj pisowni typu `kraków` czy `münchen`.

## Czy rotacyjna nazwa użytkownika zmienia IP przy każdym żądaniu?

Zmienia IP przy każdym nowym połączeniu, nie przy każdym żądaniu. Każde nowe połączenie otrzymuje IP z puli, zwykle inne; aby otrzymać nowe IP przy każdym żądaniu, wysyłaj jedno żądanie na połączenie (wyłącz keep-alive).

To ma znaczenie w kodzie. `requests.Session`, `httpx.Client` lub agent undici utrzymuje tunel otwarty między żądaniami, więc wyjście pozostaje takie samo. Aby mieć jedno IP na żądanie, otwieraj nowego klienta dla każdego żądania lub wysyłaj `Connection: close`. Aby celowo mieć jedno IP przez kilka żądań, użyj sesji sticky, opisanej w [sesje sticky per miasto](https://eurocityproxies.com/pl/guides/city-sessions/).

*curl: wyjścia rotacyjne, sticky i SOCKS5 w Paryżu*

```bash
# Rotating exit in Paris (HTTP proxy, HTTPS target through CONNECT)
curl -s -x "http://USERNAME-country-fr-city-paris:PASSWORD@gw.eurocityproxies.com:7777" https://ipinfo.io/json

# Sticky exit in Paris: session paris1, up to 10 minutes
curl -s -x "http://USERNAME-country-fr-city-paris-session-paris1-ttl-10:PASSWORD@gw.eurocityproxies.com:7777" https://ipinfo.io/json

# SOCKS5 with socks5h: the proxy resolves the hostname, not your machine
curl -s -x "socks5h://USERNAME-country-fr-city-paris:PASSWORD@gw.eurocityproxies.com:7778" https://ipinfo.io/json

# Gateway alone, without a target site: prints only the exit IP
curl -s -x "http://USERNAME-country-fr-city-paris:PASSWORD@gw.eurocityproxies.com:7777" https://api.ipify.org
```

*Python requests: stałe wyjście paryskie (Python 3.9 lub nowszy)*

```python
# pip install requests
from urllib.parse import quote

import requests

HOST = "gw.eurocityproxies.com"
PORT = 7777
USER = "USERNAME-country-fr-city-paris-session-paris1-ttl-10"
PASSWORD = quote("PASSWORD", safe="")  # encodes @, : and / in the password

proxy = f"http://{USER}:{PASSWORD}@{HOST}:{PORT}"
proxies = {"http": proxy, "https": proxy}

# proxies= on each call wins over HTTP_PROXY / HTTPS_PROXY set on your machine
r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30)
r.raise_for_status()
info = r.json()
print(info["ip"], info.get("city"), info.get("country"), info.get("org"))
```

*Python httpx: to samo IP na klienta, nowe IP na klienta*

```python
# pip install httpx
from urllib.parse import quote

import httpx

USER = "USERNAME-country-fr-city-paris"
PASSWORD = quote("PASSWORD", safe="")
PROXY = f"http://{USER}:{PASSWORD}@gw.eurocityproxies.com:7777"

# One client keeps its connection open (keep-alive): the three lines show one IP
with httpx.Client(proxy=PROXY, timeout=30, trust_env=False) as client:
    for _ in range(3):
        print("same client:", client.get("https://ipinfo.io/json").json()["ip"])

# A new client per request opens a new connection: usually a different Paris IP
for _ in range(3):
    with httpx.Client(proxy=PROXY, timeout=30, trust_env=False) as client:
        print("new client: ", client.get("https://ipinfo.io/json").json()["ip"])
```

*Node.js 22 lub nowszy, undici ProxyAgent (zapisz jako paris.mjs)*

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

const user = "USERNAME-country-fr-city-paris-session-paris1-ttl-10";
const password = encodeURIComponent("PASSWORD");
const dispatcher = new ProxyAgent(
  `http://${user}:${password}@gw.eurocityproxies.com:7777`
);

try {
  const res = await fetch("https://ipinfo.io/json", {
    dispatcher,
    signal: AbortSignal.timeout(30000), // stop after 30 s
  });
  const info = await res.json();
  console.log(info.ip, info.city, info.country, info.org);
} finally {
  await dispatcher.close();
}
```

*Python requests przez SOCKS5 z socks5h*

```python
# pip install "requests[socks]"
from urllib.parse import quote

import requests

HOST = "gw.eurocityproxies.com"
SOCKS_PORT = 7778
USER = "USERNAME-country-fr-city-paris"
PASSWORD = quote("PASSWORD", safe="")

# socks5h: the proxy resolves the hostname, not your machine
proxy = f"socks5h://{USER}:{PASSWORD}@{HOST}:{SOCKS_PORT}"
r = requests.get("https://ipinfo.io/json", proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.json())
```

## Jakie szczegóły obsługują te przykłady?

Przykłady obsługują szczegóły, które najczęściej psują pierwsze połączenie:

- **Koduj hasło.** `quote("PASSWORD", safe="")` w Pythonie i `encodeURIComponent` w Node chronią znaki takie jak `@` czy `:` przed zepsuciem URL proxy.
- **Zmienne proxy na Twoim komputerze.** W requests wartość ustawiona w `session.proxies` może zostać nadpisana przez `HTTPS_PROXY`. Podawaj `proxies=` przy każdym wywołaniu lub ustaw `trust_env = False` na sesji.
- **Zawsze timeout.** Każdy przykład zatrzymuje się po 30 sekundach zamiast wisieć.
- **Top-level await wymaga modułu.** Zapisz przykład Node jako `.mjs` i uruchom go Node.js 22 lub nowszym.
- **socks5h, nie socks5.** Przy `socks5://` requests i curl rozwiązują nazwę hosta na Twoim komputerze. Przy `socks5h://` robi to proxy.

## Czy mogę użyć portu SOCKS5 w przeglądarce?

W przeglądarkach używaj zamiast tego portu HTTP `7777`. Dokumentacja proxy Chromium mówi, że Chrome nie obsługuje żadnej metody uwierzytelniania dla SOCKS5. Nazwa użytkownika i hasło na porcie `7778` tam nie zadziałają.

Na iPhone'ie lub iPadzie ustawienia Wi-Fi oferują ręczne proxy HTTP z uwierzytelnianiem. Dla emulatora Android uruchom go z `-http-proxy http://USERNAME-country-fr-city-paris:PASSWORD@gw.eurocityproxies.com:7777`. [Strona testów geo aplikacji](https://eurocityproxies.com/pl/use-cases/app-geo-testing/) omawia urządzenia bardziej szczegółowo.

## Co powinno pokazać wyjście?

JSON z `https://ipinfo.io/json` powinien pokazać `"country": "FR"` oraz, w większości przypadków, `Paris` lub miejscowość w okolicach Paryża jako `city`. Pole `org` zaczyna się od ASN sieci, na przykład francuskiego dostawcy szerokopasmowego.

Pobliska miejscowość zamiast Paryża jest normalna: bazy geolokalizacyjne umieszczają wiele domowych IP przy lokalnym węźle dostawcy. [Poradnik wyjściowego miasta](https://eurocityproxies.com/pl/guides/verify-exit-city/) pokazuje, jak porównać dwa źródła, a [dlaczego IP pokazuje pobliską miejscowość](https://eurocityproxies.com/pl/guides/ip-geolocation-accuracy/) wyjaśnia przyczyny.

> **Sprawdzono składnię, nie uruchamiano na żywym celu** 18 października 2026 r. przykłady w Pythonie sprawdzono z python -I -m py_compile, a przykład w Node z node --check. Zastąp USERNAME i PASSWORD wartościami z panelu.

## Pytania dotyczące szybkiego startu

### Dlaczego moje żądanie kończy się błędem 407 Proxy Authentication Required?

Błąd 407 oznacza, że proxy nie zaakceptowało nazwy użytkownika lub hasła. Sprawdź, czy nazwa użytkownika zaczyna się od nazwy Twojego konta, czy `-country-` jest obecne oraz czy znaki specjalne w haśle są zakodowane w URL. Skopiuj ponownie obie wartości z panelu.

### Dlaczego dostaję niemiecki IP, gdy prosiłem o Paryż?

Zwykle to literówka w nazwie użytkownika, np. `-country-de` pozostałe z innego testu, albo nieistniejący identyfikator miasta. Wyświetl nazwę użytkownika przed wysłaniem żądania. Jeśli `ipinfo.io` i drugie źródło pokazują inny kraj, napisz do pomocy technicznej, podając czas i IP wyjściowe.

### Jak długo może trwać sesja sticky w Paryżu?

Sesja sticky utrzymuje to samo IP przez do 30 minut (IP może zmienić się wcześniej, na przykład gdy urządzenie rezydencjalne przejdzie offline). Ustaw czas trwania za pomocą `-ttl-` w minutach, na przykład `-ttl-10` lub `-ttl-30`. Nie licz na to, że sesja przetrwa dłużej niż ustawione ttl.

### Czy wybór miasta to dodatkowa opłata?

Nie. Targetowanie po kraju i mieście w każdym planie; w Stanach Zjednoczonych także po stanie i kodzie ZIP; targetowanie po ASN bez dodatkowych kosztów. Dostępność miast jest zmienna. Cena za GB jest taka sama z miastem i bez niego. [Strona cennika](https://eurocityproxies.com/pl/pricing/) podaje 0,95 USD za 1 GB i 8 USD za 10 GB.

### Ile ruchu zużywa ten szybki start?

Bardzo mało: każde żądanie do `https://ipinfo.io/json` przenosi kilka kilobajtów, łącznie z nagłówkami i TLS. Użytkowanie liczy wszystkie dane wysłane i odebrane przez proxy (upload i download, wraz z nagłówkami). 1 GB = 1 000 000 000 bajtów. Próby połączenia, które nie dotrą do celu, nie są liczone.

### Czy mogę logować się przez listę dozwolonych IP zamiast hasła?

Tak. Nazwa użytkownika i hasło w każdym planie lub lista dozwolonych IP (do 10 IP). Podużytkownicy z własnymi danymi logowania i limitem ruchu. Klucze API, które możesz unieważnić w każdej chwili. [Dokumentacja](https://eurocityproxies.com/pl/docs/) wyjaśnia, jak ustawić kraj i miasto przy połączeniu z IP z listy dozwolonych. Przykłady na tej stronie używają nazwy użytkownika i hasła, ponieważ działają z dowolnej maszyny.

### Jak zapłacić za pierwszy gigabajt?

Wybierz plan, a następnie doładuj jego cenę w BTC, USDT, USDC, ETH, SOL, LTC (minimum 25 USD). Wyślij dokładną kwotę i kliknij „Wysłałem płatność”; doładowanie jest dopasowywane po dokładnej kwocie i księgowane po potwierdzeniu. Bez KYC: żadnego dowodu, żadnego selfie, żadnych dokumentów przy rejestracji, wpłacie lub zakupie.

## Źródła

1. [strona man curl: --proxy, socks5h:// i --socks5-hostname](https://curl.se/docs/manpage.html) — curl project (checked 2026-10-18)
2. [Requests: Advanced Usage, Proxies i SOCKS](https://requests.readthedocs.io/en/latest/user/advanced/) — Python Software Foundation / Requests (checked 2026-10-18)
3. [HTTPX: Proxies](https://www.python-httpx.org/advanced/proxies/) — Encode (checked 2026-10-18)
4. [dokumentacja undici ProxyAgent](https://github.com/nodejs/undici/blob/main/docs/docs/api/ProxyAgent.md) — Node.js project (checked 2026-10-18)
5. [wydania Node.js (obsługiwane linie wydań)](https://nodejs.org/en/about/previous-releases) — OpenJS Foundation (checked 2026-10-18)
6. [Obsługa proxy w Chrome (uwierzytelnianie SOCKSv5)](https://chromium.googlesource.com/chromium/src/+/HEAD/net/docs/proxy.md) — The Chromium Projects (checked 2026-10-18)
7. [Skonfiguruj proxy dla Android Emulator](https://developer.android.com/studio/run/emulator-networking-proxy) — Google / Android Developers (last updated 2026-03-12, checked 2026-10-18)
8. [Ustawienia ładunku zarządzania urządzeniem Global HTTP Proxy (iOS, iPadOS: ręczne proxy z nazwą użytkownika i hasłem)](https://support.apple.com/guide/deployment/global-http-proxy-payload-settings-dep7ba46fcd/web) — Apple Platform Deployment (checked 2026-10-18)
9. [RFC 9110 HTTP Semantics, sekcja 9.3.6 CONNECT i status 407](https://www.rfc-editor.org/rfc/rfc9110.html) — IETF (June 2022, checked 2026-10-18)
10. [Punkt końcowy JSON IPinfo](https://ipinfo.io/json) — IPinfo (checked 2026-10-18)

---

EuroCity Proxies: EuroCity Proxies to dostawca proxy rezydencjalnych z targetowaniem na poziomie miasta w całej Europie, płatne w kryptowalutach bez przesyłania dokumentów tożsamości: adresy IP z domowych łączy szerokopasmowych rozliczane za GB, z osobną stroną lokalnych danych dla każdego z 103 miast w 35 krajach.