# Começando: gateway, segmentação e código

> Configure proxies residenciais MENA: gateway, segmentação por país e cidade, sessões fixas, exemplos em curl, Python e Playwright. Sem KYC.

- URL: https://menaproxies.com/pt/guides/getting-started/
- Última atualização: 2026-10-14
- Publisher: MENA Proxies (https://menaproxies.com)

Tudo que você precisa para enviar sua primeira requisição por um IP residencial dos Emirados, Arábia Saudita ou Egito: o gateway, o formato do nome de usuário, sessões fixas e exemplos para curl, Python e Playwright para copiar e colar.

**Resposta rápida — Como me conecto a MENA Proxies?**

Aponte qualquer cliente HTTP ou SOCKS5 para `gw.menaproxies.com`, porta 7777 para HTTP e HTTPS ou porta 7778 para SOCKS5, usando o nome de usuário e senha do seu painel **MENA Proxies**. Coloque o país no nome de usuário, como `USERNAME-country-ae` para os Emirados, e adicione um ID de sessão para manter um IP. Planos a partir de US$ 1,88 por 1 GB, sem KYC.

## Configurações de conexão

| Atributo | Valor |
| --- | --- |
| Host do gateway | `gw.menaproxies.com` |
| Porta HTTP e HTTPS | `7777` |
| Porta SOCKS5 | `7778` |
| Formato do nome de usuário | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Códigos de país | `ae`, `sa`, `qa`, `kw`, `bh`, `om`, `il`, `jo`, `iq`, `lb`, `eg`, `ma`, `dz`, `tn` |
| IDs de cidades | Minúsculas, `_` para espaços: `dubai`, `abu_dhabi`, `riyadh`, `cairo`, `casablanca` |
| ASN | `asn-<number>`, por exemplo `asn-5384` (e&, Emirados), sem custo extra |
| Autenticação | Nome de usuário e senha em todos os planos, ou uma lista de IPs permitidos (até 10 IPs). Subusuários com credenciais próprias e limite de tráfego. Chaves API que você pode revogar a qualquer momento |
| Sessões | Cada nova conexão recebe um IP da pool, geralmente diferente; para obter um IP novo a cada solicitação, envie uma solicitação por conexão (desative keep-alive). Sessão fixa: até 30 minutos (o IP pode mudar antes) |

## Do pagamento ao primeiro pedido

1. **Recarregue e compre um plano** — Recarregue pelo menos US$ 25 em BTC, USDT, USDC, ETH, SOL, LTC, depois compre 1 GB (US$ 1,88) ou mais do seu saldo.
2. **Copie suas credenciais** — O painel mostra o nome de usuário e senha do proxy. Crie um subusuário por projeto se quiser totais de uso separados e limite de tráfego para cada um.
3. **Adicione o país ao nome de usuário** — USERNAME-country-sa para Arábia Saudita, USERNAME-country-eg-city-cairo para Cairo quando os IPs estiverem online lá.
4. **Verifique a saída** — Solicite um serviço de informações de IP através do proxy e confirme o país e a rede. Veja como verificar a localização de um proxy.

## Como faço para testar com curl?

Use `-x` para proxies HTTP e `--socks5-hostname` para SOCKS5; a variante `-hostname` envia o nome do host para o proxy em vez de resolvê-lo na sua máquina.

*curl: rotação, sticky e 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
```

## Como usar com Python, com tentativas?

Conexões residenciais podem falhar ocasionalmente em IPs lentos ou desconectados. Faça tentativas com um novo IP ao invés de esperar: sem um ID de sessão, cada tentativa recebe um novo. Codifique a senha se ela conter caracteres especiais.

*Python requests: rotação de país com tentativas*

```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"))
```

## Como usar no navegador com Playwright?

Passe o gateway como proxy do navegador e o alvo no nome de usuário. Defina o local e o fuso horário para combinar com o país, para que as páginas renderizem como para um visitante local.

*Playwright (Python): uma sessão de navegador árabe de Riade*

```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()
```

## Quais cidades e operadoras posso escolher?

A segmentação por cidade funciona onde o pool tem IPs residenciais online nessa cidade. A lista muda durante o dia, então consulte antes de um uso por cidade: o painel mostra e a API retorna com `GET /v1/catalog/countries/{CC}/cities` (maiúsculo na API, minúsculo no nome de usuário do proxy) (veja a [documentação da API](https://menaproxies.com/docs/api/)). Se uma cidade não tiver IP online, desconsidere a cidade e use a segmentação por país.

Para escolher um operador, adicione seu ASN: `USERNAME-country-ae-asn-5384` são saídas na e& nos Emirados Árabes Unidos. A segmentação por ASN não tem custo extra; `GET /v1/catalog/countries/{CC}/asns` lista os ASNs online em um país, e a disponibilidade varia.

IDs úteis de cidades: `dubai`, `abu_dhabi`, `sharjah` (EAU); `riyadh`, `jeddah`, `dammam` (Arábia Saudita); `doha` (Catar); `cairo`, `alexandria`, `giza` (Egito); `casablanca`, `rabat` (Marrocos); `amman` (Jordânia); `beirut` (Líbano).

## O que costuma dar errado?

- **407 Proxy Authentication Required**: nome de usuário ou senha errados, ou caractere especial na senha não codificado em URL.
- **Conexão recusada ou tempo esgotado**: porta errada; clientes HTTP precisam de 7777, clientes SOCKS5 precisam de 7778.
- **Saída no país errado**: o código do país está faltando ou errado no nome de usuário; códigos têm duas letras, minúsculas.
- **Sem IP na cidade**: a cidade não tem IP residencial online no momento; use segmentação por país ou tente depois.
- **Solicitação recusada no gateway**: o alvo está em uma categoria bloqueada (Sites bancários, governamentais e de portais de pagamento, além de portas SMTP (envio de email) 25, 465 e 587).
- **Plano esgotado**: o plano usou todo seu GB; compre outro com seu saldo.

## Dúvidas sobre configuração

### MENA Proxies suporta SOCKS5?

Sim. Use a porta 7778 em `gw.menaproxies.com` com o mesmo usuário e senha. Use DNS remoto (por exemplo, `--socks5-hostname` no curl ou `socks5h://` em Python) para que o nome do host seja resolvido pelo proxy, não na sua máquina (em Python, `socks5h://` precisa de `pip install "requests[socks]"`).

### Posso liberar o IP do meu servidor em vez de usar senha?

Sim. Todo plano aceita uma whitelist de até 10 IPs, gerenciada no painel ou via API, e IPs na whitelist podem usar proxies sem usuário e senha. Segmentação e sessões sticky são definidas no usuário, então setups que precisam mantêm autenticação por usuário e senha.

### Como manter o mesmo IP para um fluxo de checkout?

Adicione `-session-<id>-ttl-<minutes>` ao nome do usuário, por exemplo `USERNAME-country-ae-session-cart1-ttl-20`. Cada requisição com o mesmo ID de sessão usa o mesmo IP para até 30 minutos (o IP pode mudar antes). Use um novo ID de sessão para cada fluxo independente.

### Onde está a documentação da API?

Em [/docs/api/](https://menaproxies.com/docs/api/): conta, recargas, pedidos, tráfego residencial, portas móveis e chaves API, com exemplos em curl, Python e Node.js.

---

MENA Proxies: MENA Proxies é um provedor de proxy residencial para o Oriente Médio e Norte da África, pago em cripto e sem upload de ID: proxies residenciais rotativos com segmentação por país nos Emirados Árabes Unidos, Arábia Saudita, Catar, Egito, Marrocos e mais 9 países, faturados por GB.