# Pierwsze kroki: gateway, targetowanie i kod

> Skonfiguruj MENA proxy rezydencjalne: gateway, targetowanie kraju i miasta, sesje stałe, przykłady curl, Python i Playwright. Bez KYC.

- URL: https://menaproxies.com/pl/guides/getting-started/
- Ostatnia aktualizacja: 2026-10-14
- Publisher: MENA Proxies (https://menaproxies.com)

Wszystko, co potrzebne do wysłania pierwszego żądania przez IP domowe z ZEA, Arabii Saudyjskiej lub Egiptu: gateway, format nazwy użytkownika, sesje stałe oraz przykłady do kopiowania dla curl, Python i Playwright.

**Szybka odpowiedź — Jak połączyć się z MENA Proxies?**

Wskaz dowolnego klienta HTTP lub SOCKS5 na `gw.menaproxies.com`, port 7777 dla HTTP i HTTPS lub port 7778 dla SOCKS5, z nazwą użytkownika i hasłem z panelu **MENA Proxies**. Dodaj kraj w nazwie użytkownika, np. `USERNAME-country-ae` dla ZEA, i dodaj ID sesji, aby utrzymać jedno IP. Plany zaczynają się od 1,88 USD za 1 GB, bez KYC.

## Ustawienia połączenia

| Atrybut | Wartość |
| --- | --- |
| Host gateway | `gw.menaproxies.com` |
| Port HTTP i HTTPS | `7777` |
| Port SOCKS5 | `7778` |
| Format nazwy użytkownika | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Kody krajów | `ae`, `sa`, `qa`, `kw`, `bh`, `om`, `il`, `jo`, `iq`, `lb`, `eg`, `ma`, `dz`, `tn` |
| ID miast | Małymi literami, `_` zamiast spacji: `dubai`, `abu_dhabi`, `riyadh`, `cairo`, `casablanca` |
| ASN | `asn-<number>`, na przykład `asn-5384` (e&, ZEA), bez dodatkowych kosztów |
| Uwierzytelnianie | Nazwa użytkownika i hasło w każdym planie lub lista dozwolonych IP (do 10 adresów). Sub-użytkownicy z własnymi poświadczeniami i limitem ruchu. Klucze API, które możesz zablokować w dowolnym momencie |
| Sesje | Każde nowe połączenie otrzymuje IP z puli, zwykle inne; by mieć nowy IP przy każdym żądaniu, wysyłaj jedno żądanie na połączenie (wyłącz keep-alive). Sticky: do 30 minut (IP może się zmienić wcześniej) |

## Od płatności do pierwszego żądania

1. **Doładuj i kup plan** — Doładuj co najmniej 25 USD w BTC, USDT, USDC, ETH, SOL, LTC, następnie kup przynajmniej 1 GB (1,88 USD) ze swojego salda.
2. **Skopiuj swoje dane dostępu** — Panel pokazuje nazwę użytkownika i hasło do proxy. Utwórz sub-użytkownika dla każdego projektu, jeśli chcesz oddzielne limity i statystyki ruchu.
3. **Dodaj kraj do nazwy użytkownika** — USERNAME-country-sa dla Arabii Saudyjskiej, USERNAME-country-eg-city-cairo dla Kairu, gdy IP są dostępne tam online.
4. **Sprawdź exit** — Zamów usługę informacji o IP przez proxy i potwierdź kraj oraz sieć. Zobacz jak zweryfikować lokalizację proxy.

## Jak przetestować za pomocą curl?

Użyj `-x` dla proxy HTTP i `--socks5-hostname` dla SOCKS5; wariant `-hostname` wysyła nazwę hosta do proxy zamiast rozwiązywać ją na twoim urządzeniu.

*curl: rotacja, sticky i SOCKS5*

```bash
# UAE, a new home IP on each new connection (each curl run)
curl -x http://USERNAME-country-ae:PASSWORD@gw.menaproxies.com:7777 https://ipinfo.io/json

# Riyadh, the same IP for 30 minutes (session id r1)
curl -x http://USERNAME-country-sa-city-riyadh-session-r1-ttl-30:PASSWORD@gw.menaproxies.com:7777 https://ipinfo.io/json

# Egypt over SOCKS5, hostname resolved by the proxy
curl --socks5-hostname gw.menaproxies.com:7778 -U USERNAME-country-eg:PASSWORD https://ipinfo.io/json
```

## Jak korzystać z tego w Pythonie, z powtórkami?

Połączenia domowe pojawiają się i znikają, więc czasami żądanie może nie powieść się na wolnym lub rozłączonym IP. Spróbuj ponownie z nowym IP zamiast czekać: bez ID sesji każde powtórzenie dostaje nowe. Zakoduj hasło, jeśli zawiera znaki specjalne.

*Python requests: rotacja kraju z powtórkami*

```python
import time
from urllib.parse import quote
import requests

GATEWAY = "gw.menaproxies.com:7777"
USER, PASSWORD = "USERNAME", quote("PASSWORD", safe="")

def fetch(url, country, session=None, ttl=30, tries=3):
    for attempt in range(1, tries + 1):
        user = f"{USER}-country-{country}"
        if session:  # a new session ID per attempt, so each retry gets a new IP
            user += f"-session-{session}{attempt}-ttl-{ttl}"
        proxy = f"http://{user}:{PASSWORD}@{GATEWAY}"
        try:
            r = requests.get(url, proxies={"http": proxy, "https": proxy}, timeout=30)
            if r.status_code < 500:
                return r
        except requests.RequestException:
            pass
        if attempt < tries:
            time.sleep(2 * attempt)  # back off, then retry on a new IP
    raise RuntimeError(f"{url} failed {tries} times via {country}")

for cc in ["ae", "sa", "eg"]:
    print(cc, fetch("https://ipinfo.io/json", cc).json().get("country"))
```

## Jak użyć tego w przeglądarce z Playwright?

Podaj gateway jako proxy przeglądarki i celowanie w nazwie użytkownika. Ustaw lokalizację i strefę czasową zgodną z krajem, aby strony wyświetlały się tak, jak dla lokalnego użytkownika.

*Playwright (Python): arabska sesja przeglądarki z Rijadu*

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.menaproxies.com:7777",
        "username": "USERNAME-country-sa-city-riyadh-session-pw1-ttl-30",
        "password": "PASSWORD",
    })
    context = browser.new_context(locale="ar-SA", timezone_id="Asia/Riyadh")
    page = context.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.text_content("body"))
    browser.close()
```

## Jakie miasta i operatorów mogę targetować?

Targetowanie miasta działa tam, gdzie pula ma online domowe IP w tym mieście. Lista zmienia się w ciągu dnia, więc sprawdź ją przed uruchomieniem na poziomie miasta: pokazuje ją panel i zwraca API z `GET /v1/catalog/countries/{CC}/cities` (duże litery w API, małe w nazwie użytkownika proxy) (zobacz [dokumentację API](https://menaproxies.com/docs/api/)). Jeśli miasto nie ma online IP, pomiń je i użyj targetowania na kraj.

Aby wybrać operatora, dodaj jego ASN: `USERNAME-country-ae-asn-5384` exits na e& w ZEA. Targetowanie ASN nie kosztuje nic dodatkowego; `GET /v1/catalog/countries/{CC}/asns` pokazuje ASNy online w kraju, dostępność się różni.

Przydatne ID miast: `dubai`, `abu_dhabi`, `sharjah` (ZEA); `riyadh`, `jeddah`, `dammam` (Arabia Saudyjska); `doha` (Katar); `cairo`, `alexandria`, `giza` (Egipt); `casablanca`, `rabat` (Maroko); `amman` (Jordania); `beirut` (Liban).

## Co zwykle idzie nie tak?

- **407 Proxy Authentication Required**: błędna nazwa użytkownika lub hasło albo znak specjalny w haśle, który nie został zakodowany URL.
- **Połączenie odrzucone lub timeout**: zły port; klienci HTTP potrzebują 7777, klienci SOCKS5 7778.
- **Exit w złym kraju**: kod kraju jest brakujący lub błędny w nazwie użytkownika; kody to dwie małe litery.
- **Brak IP w mieście**: miasto nie ma obecnie online domowego IP; użyj targetowania na kraj albo spróbuj później.
- **Żądanie odrzucone na bramce**: cel jest w zablokowanej kategorii (Bankowe, rządowe i portale płatnicze oraz porty SMTP (wysyłka maili) 25, 465 i 587).
- **Plan wyczerpany**: plan zużył wszystkie GB; kup kolejny z salda.

## Pytania dotyczące konfiguracji

### Czy MENA Proxies obsługuje SOCKS5?

Tak. Użyj portu 7778 na `gw.menaproxies.com` z tą samą nazwą użytkownika i hasłem. Korzystaj z zdalnego DNS (np. `--socks5-hostname` w curl lub `socks5h://` w Python), aby nazwa hosta była rozwiązywana przez proxy, a nie na twoim urządzeniu (w Pythonie `socks5h://` wymaga `pip install "requests[socks]"`).

### Czy mogę dodać na białą listę IP mojego serwera zamiast hasła?

Tak. Każdy plan pozwala na listę do 10 dozwolonych IP, zarządzaną w panelu lub przez API; IP z białej listy mogą używać proxy bez nazwy użytkownika i hasła. Targetowanie i sticky sessions ustawiane są w nazwie użytkownika, więc konfiguracje które ich potrzebują zachowują uwierzytelnianie nazwą i hasłem.

### Jak utrzymać to samo IP dla flow zakupowego?

Dodaj `-session-<id>-ttl-<minutes>` do nazwy użytkownika, np. `USERNAME-country-ae-session-cart1-ttl-20`. Każde żądanie z tym samym ID sesji używa tego samego IP dla do 30 minut (IP może się zmienić wcześniej). Używaj nowego ID sesji dla każdego osobnego flow.

### Gdzie jest dokumentacja API?

Pod [/docs/api/](https://menaproxies.com/docs/api/): konto, doładowania, zamówienia, residential traffic, mobilne porty i klucze API, z przykładami curl, Python i Node.js.

---

MENA Proxies: MENA Proxies to dostawca proxy rezydencjalnych na Bliski Wschód i Afrykę Północną, płatne w kryptowalutach bez uploadu dowodu tożsamości: rotujące adresy IP domowe z targetowaniem krajów w Zjednoczonych Emiratach Arabskich, Arabii Saudyjskiej, Katarze, Egipcie, Maroku oraz w 9 innych krajach, rozliczane za GB.