---
title: "Como criar e configurar um proxy residencial: passo a passo"
description: "Um proxy residencial é criado no painel em Proxy Create > Residential > Create. Mostramos a configuração, a geração do endpoint e o teste com curl."
url: https://proxynet.io/pt-br/blog/create-residential-proxy
date: 2026-09-26
author: "Enver Kaya"
category: "Produtos, Tutoriais, Proxy 101"
lang: pt-BR
---

# Como criar e configurar um proxy residencial: passo a passo

Neste guia, criamos um proxy residencial do zero no painel da Proxynet, pegamos os dados de conexão e enviamos a primeira requisição para confirmar que ele funciona; os mesmos passos aparecem no vídeo abaixo.

[Como criar e testar um proxy residencial no painel da Proxynet](https://www.youtube.com/watch?v=JhZgTN66IYk)

> **Nota: Resposta rápida**
>
> No painel, abra a aba **Proxy**, clique no botão **Proxy Create** no canto superior direito, escolha **Residential**, dê um nome se quiser e clique em **Create**. Na seção **Access Details** da página que se abre, o endereço, a porta, o nome de usuário e a senha já estão prontos. Na aba **Endpoint Generator**, escolha o país e o tipo de sessão e copie a linha. Para testar, cole no terminal o exemplo de curl da mesma página ou coloque a linha na extensão do navegador e abra uma página de verificação de IP: se o IP retornado estiver no país que você escolheu, o proxy está funcionando.

## Antes de começar

Você precisa de uma conta Proxynet e de saldo na conta. No proxy residencial, a cobrança não é um pacote mensal: ela é feita por GB, sobre o tráfego usado. Para criar o gate, basta um valor pequeno de saldo. O preço atual do GB aparece na página [Proxies residenciais](https://proxynet.io/pt-br/residential-proxy) e na tela de pedido.

Você tem três decisões a tomar: o país de destino, o tipo de sessão (um IP novo a cada requisição ou o mesmo IP por um tempo) e o programa que vai usar o proxy. Essas três escolhas definem o que você seleciona no Endpoint Generator. O que é um proxy residencial está em [Proxies residenciais: como funcionam e qual escolher](/pt-br/blog/what-are-residential-proxies-how-it-works), e como estimar quantos GB você precisa está em [O que observar ao comprar um proxy: 10 perguntas](/pt-br/blog/proxy-buying-guide).

As capturas de tela deste guia vêm do painel em inglês, por isso os nomes de botões e abas aparecem em inglês no texto.

## Como criar um proxy residencial no painel?

No painel, cada pedido de proxy aparece na lista como um **gate** (gateway). Um gate residencial dá acesso ao pool inteiro por um único endereço; as escolhas de país e de sessão são feitas depois, dentro do nome de usuário.

### Passo 1: Abra o menu Proxy Create

Vá para a aba **Proxy**. A lista mostra os gates existentes com nome, tipo, custo, tráfego usado e status. Clique no botão azul **Proxy Create** no canto superior direito.

![Aba Proxy do painel, com o botão Proxy Create destacado no canto superior direito](/blog-images/create-residential-proxy/01-proxy-list.webp)

### Passo 2: Escolha o tipo Residential

O menu que se abre lista cinco tipos de proxy; clique em **Residential**, o primeiro da lista. A diferença entre os tipos está em [Proxy ISP ou residencial: diferenças e qual escolher](/pt-br/blog/isp-vs-residential-proxy).

![Menu Proxy Create aberto, com a opção Residential destacada](/blog-images/create-residential-proxy/02-choose-residential.webp)

### Passo 3: Dê um nome ao gate e crie

Na página **Create Gate**, a aba **Residential** já vem selecionada. Se quiser, troque o nome sugerido na caixa **Gate Name** por um que descreva o trabalho ("Monitoramento de preços TR", por exemplo); o nome também pode ser alterado depois. O cartão **Order Summary**, à direita, mostra o tipo de proxy, o nível da sua conta e o preço por GB. Preste atenção ao aviso embaixo do cartão: se você foi adicionado como membro de um espaço de trabalho, a cobrança sai do saldo do dono da conta, não do seu. Marque a caixa dos termos de uso e clique em **Create**.

![Página Create Gate, com a caixa Gate Name e o botão Create destacados](/blog-images/create-residential-proxy/03-create-gate.webp)

O gate residencial não tem prazo (**Duration: Lifetime**). No mês em que você não usa tráfego, não paga nada; o gate fica na lista até você excluí-lo.

### Passo 4: Pegue os dados de conexão em Access Details

Assim que você clica em Create, a página do gate se abre. Ela tem quatro abas: **Access Details**, **Endpoint Generator**, **Statistics** e **Logs**. O cartão **Access Details**, na primeira aba, traz tudo o que a conexão exige.

![Aba Access Details da página do gate, com as linhas de hostname, nome de usuário e senha destacadas](/blog-images/create-residential-proxy/04-access-details.webp)

- **Hostname:** o endereço e a porta do gateway (`gate-res.proxynet.io:8000`). Todo o tráfego residencial vai para esse endereço.
- **Username / Password:** credenciais exclusivas do gate. O ícone de olho mostra a senha, e o ícone de copiar a envia para a área de transferência.
- **Protocol:** "Auto". A mesma porta aceita conexões HTTP e SOCKS5.
- **IP Whitelist:** lista de IPs autorizados, para dispositivos que não conseguem pedir senha. Os detalhes estão em [Autenticação de proxy: user:pass ou whitelist de IP](/pt-br/blog/proxy-authentication-methods).
- **Traffic Limit:** o máximo de GB que o gate pode gastar. Um teto para um gate de teste ou compartilhado protege o saldo.
- **Target Host / Block Host:** domínios permitidos ou bloqueados. Se você reservou o proxy para um único site, coloque esse site em Target Host.

O cartão **Code Examples**, à direita, traz os mesmos dados como comandos prontos para curl e para linguagens como Python; o cartão **Tools** leva à extensão do Chrome. O cartão **Summary** mostra o número do pedido, o preço do GB, o limite de tráfego e o gasto total.

### Passo 5: Escolha país e sessão no Endpoint Generator

Os dados de Access Details usam o gate sem escolher país, em modo "global". Para país, cidade e tipo de sessão, vá para a aba **Endpoint Generator**. Cada escolha é gravada dentro do nome de usuário; o endereço e a senha não mudam.

![Aba Endpoint Generator, com a seleção de Country e a linha Session Type destacadas](/blog-images/create-residential-proxy/05-endpoint-generator.webp)

1. **Gateway:** deixe em "Auto".
2. **Country:** o país que o site de destino deve ver. Se ficar em "Global", o IP pode vir de qualquer país. A cobertura de Türkiye está na página [proxy de Türkiye](/pt-br/locations/turkiye).
3. **State / City:** escolha só se o trabalho depender da cidade. Se não houver IP disponível na cidade escolhida naquele momento, a requisição é atendida no nível do país.
4. **Protocol Preference:** **HTTP/HTTPS** para navegadores, celulares e a maioria das ferramentas; **SOCKS5** para programas que pedem SOCKS5 ou que vão passar UDP ([Proxies SOCKS5](https://proxynet.io/pt-br/socks5-proxy)).
5. **Session Type:** **None** dá um IP novo a cada requisição (rotativo). Se você escolhe uma duração, o mesmo IP fica com você durante esse tempo (sticky); as opções vão de 30 segundos a 1 dia. Quando usar cada uma está na tabela mais abaixo.

O painel à direita transforma as escolhas em uma linha. O formato mais comum é `host:port:user:pass`; deixe a chave **DNS / IP** em nome de domínio; o contador define quantas linhas serão geradas (em sessão sticky, 10 linhas = 10 IPs diferentes). Copie com **Copy** ou baixe várias linhas com **Download**. Não digite a linha à mão: um único caractere errado devolve o erro 407. Como colocar a linha no navegador, no celular, em um perfil antidetect ou no código está em [Como usar proxy residencial: do painel à primeira requisição](/pt-br/blog/how-to-use-residential-proxy).

## Como testar um proxy residencial?

Testar é abrir uma página de verificação de IP pelo proxy e olhar o endereço retornado. Se o IP exibido não for o seu e pertencer a uma conexão doméstica do país que você escolheu, o proxy está funcionando.

### Passo 6: Envie a primeira requisição

**No navegador:** instale a extensão Proxynet para Chrome pelo cartão **Tools**, coloque a linha copiada do Endpoint Generator e abra `https://ipinfo.io/json`. Se o campo `country` mostrar o código do país que você escolheu, o teste passou. Em vez da extensão, também dá para usar a configuração de proxy do sistema operacional; os passos estão em [Seu proxy está funcionando? Como testar um proxy](/pt-br/blog/how-to-test-a-proxy).

**No terminal:** o cartão **Code Examples** em Access Details traz um comando curl já preenchido com os dados do gate. Copie e cole no terminal.

![Comando curl no cartão Code Examples](/blog-images/create-residential-proxy/06-curl-test.webp)

A forma geral do comando (o nome de usuário e a senha são trocados pelos seus):

```bash
curl -x gate-res.proxynet.io:8000 -U user:pass https://ipinfo.io/json
```

`-x` informa o endereço do proxy, e `-U`, as credenciais do proxy ([documentação do curl](https://curl.se/docs/manpage.html#-x)). Um teste bem-sucedido devolve uma resposta parecida com esta:

```json
{
  "ip": "188.3.185.162",
  "city": "Istanbul",
  "region": "Istanbul",
  "country": "TR",
  "org": "AS9121 Turk Telekom"
}
```

Três coisas a conferir: se `country` é o país escolhido, se a linha `org` mostra uma operadora doméstica ou móvel e se o IP muda quando você roda o comando duas vezes (no rotativo, deve mudar; no sticky, deve continuar igual até o tempo acabar). Se em vez da resposta vier `407`, as credenciais não foram aceitas; o código está definido na [RFC 9110](https://httpwg.org/specs/rfc9110.html#status.407), e a solução está na tabela de erros abaixo. Se o comando não responde nada, veja [Servidor proxy não está respondendo: como resolver o erro](/pt-br/blog/proxy-server-not-responding); para testes mais avançados com curl, há [cURL com proxy: como configurar proxy HTTP e SOCKS5](/pt-br/blog/curl-proxy).

### Passo 7: Veja o tráfego em Statistics

As três caixas no alto mostram dados ao vivo: **Used** é o tráfego total gasto, **Total Requests** é o número de requisições e **Active Connections** é o número de conexões abertas. Alguns segundos depois da requisição de teste, você vê Used subir alguns kilobytes; essa é a segunda prova de que o proxy funciona. O gráfico embaixo mostra o tráfego ao longo do tempo.

![Aba Statistics, com as caixas Used e Total Requests destacadas](/blog-images/create-residential-proxy/07-statistics.webp)

### Passo 8: Analise as requisições em Logs

Cada conexão é uma linha: data, código de status, protocolo, domínio, IP de origem e duração. O filtro **Level**, à esquerda, separa os registros: **Connect** são as conexões bem-sucedidas, **Error** as que falharam, **Quota** as que bateram no limite de tráfego e **Auth** as que tiveram as credenciais recusadas. Quando o proxy "não funciona", é aqui que você olha primeiro: sem linha, a requisição não chegou ao gate; com linha Auth, a credencial está errada; com linha Connect, o problema está no site de destino. A coluna **Host** mostra quais domínios estão gastando GB.

![Aba Logs, com a coluna Status destacada mostrando códigos 200](/blog-images/create-residential-proxy/08-logs.webp)

A configuração termina aqui. As seções abaixo tratam em detalhe da escolha do tipo de sessão e dos erros que aparecem na primeira hora.

## Sessão rotativa ou sticky: qual usar?

A escolha na caixa Session Type depende da natureza do trabalho. Faça a si mesmo uma única pergunta: o site espera que as suas requisições venham do mesmo IP? Em trabalhos em que cada requisição faz sentido sozinha, como ler páginas de produto, verificar resultados de busca ou visualizar anúncios, ele não espera. Em trabalhos como fazer login, encher um carrinho ou enviar um formulário de várias etapas, ele espera, porque guarda o cookie de sessão junto com o seu IP e, se o IP muda no meio do caminho, manda você de volta para a tela de login.

| Critério | Rotativo (Session Type: None) | Sticky (30 s - 1 dia) |
|---|---|---|
| Quando o IP muda? | A cada nova conexão | Quando o tempo acaba ou o IP fica offline |
| Trabalhos adequados | Monitoramento de preços, coleta de listas de produtos, verificação de anúncios, checagem de SERP | Login em contas, etapas de carrinho e pagamento, sessões de redes sociais, formulários de várias páginas |
| Comportamento com bloqueio | Se um IP é bloqueado, a próxima requisição já sai de outro IP | O IP bloqueado fica com você até o tempo acabar; é preciso gerar uma linha nova |
| Simultaneidade | Conexões ilimitadas, cada uma com um IP diferente | Cada linha mantém um IP separado; 10 linhas geradas = 10 sessões paralelas |
| Consumo de GB | Igual | Igual; o preço não muda com o tipo de sessão |
| Escolha da duração | Não se aplica | Um pouco maior que a duração do trabalho: 30m para um login de 5 minutos, 1d para uma conta que fica aberta o dia todo |
| Página do produto | [Proxies rotativos](https://proxynet.io/pt-br/rotating-proxy) | [Proxies de sessão fixa](https://proxynet.io/pt-br/sticky-proxy) |

Mais duas regras. Se você escolheu rotativo, verifique se o seu programa reaproveita a conexão: quando um cliente HTTP mantém a conexão aberta, o IP continua o mesmo durante toda essa conexão. Se uma conta precisa ficar no mesmo IP por dias ou semanas, use o [Proxies ISP](https://proxynet.io/pt-br/static-isp-residential-proxy), que tem endereço fixo, em vez do residencial; a sessão sticky dura no máximo o tempo escolhido, e se a conexão doméstica ficar offline nesse intervalo, o IP muda. Por que uma conexão continua no mesmo IP explicamos em [O que é rotação de IP e como ela funciona?](/pt-br/blog/ip-rotation-explained).

## Como resolver os erros de configuração mais comuns?

A tabela abaixo cobre quase todas as dúvidas da primeira hora. Em cada linha, você encontra primeiro o sintoma, depois o que aparece na aba Logs e o que fazer.

| Sintoma | O que aparece em Logs | Causa | Solução |
|---|---|---|---|
| `407 Proxy Authentication Required` | Linha Auth | Nome de usuário ou senha errados, ou a linha foi encurtada | Copie a linha de novo no Endpoint Generator; não apague a parte do nome de usuário que começa com `-country-`. Veja a senha pelo ícone de olho e compare |
| A conexão expira, sem nenhuma resposta | Nenhuma linha | Endereço ou porta errados, ou a sua rede bloqueia a porta 8000 | Copie o Hostname de Access Details. Se estiver em uma rede corporativa, teste em outra rede (o roteador do celular); se a porta estiver fechada, peça ao administrador da rede para liberar a porta 8000 |
| Você adicionou o IP à whitelist, mas a senha continua sendo pedida | Linha Auth | O IP que você colocou na lista está desatualizado; em conexões domésticas e móveis, o IP externo muda | Pegue o seu IP externo atual em uma página de verificação de IP e atualize a lista. Em dispositivos cujo IP muda com frequência, conecte com nome de usuário e senha |
| O IP retornado não está no país escolhido | Linha Connect | Você está usando a linha global de Access Details, ou o código do país caiu do nome de usuário | Escolha o país no Endpoint Generator, gere a linha de novo e copie |
| Você escolheu uma cidade, mas o IP é de outra | Linha Connect | Não há IP disponível nessa cidade naquele momento; o painel passa para o nível do país | Tente de novo alguns minutos depois ou escolha a cidade grande mais próxima. Se a cidade for obrigatória, mantenha com uma sessão sticky o IP certo que você conseguir |
| Você escolheu sticky, mas o IP muda a cada requisição | Linha Connect | O Session Type ficou em "None", ou uma linha nova é gerada para cada requisição | Escolha uma opção com duração e use a mesma linha; se o identificador de sessão da linha muda, o IP também muda |
| O saldo acabou mais rápido que o esperado | Domínios que você não reconhece na coluna Host | O proxy está configurado no sistema operacional inteiro; atualizações e sincronização com a nuvem também passam por ele | Dê o proxy só ao app que precisa dele. Coloque um Traffic Limit no gate e, se necessário, um Target Host |
| Linhas `Quota`, requisições recusadas | Linha Quota | O valor de Traffic Limit do gate foi atingido | Aumente ou remova o limite em Access Details |
| O navegador não pede usuário e senha, e a página não abre | Nenhuma linha | A configuração de proxy do próprio navegador não aceita proxy com senha | Use a extensão do Chrome ou a configuração de proxy do sistema operacional; como alternativa, a whitelist de IP |
| O programa que pede SOCKS5 não conecta | Nenhuma linha ou Error | O protocolo selecionado no programa é HTTP | Escolha SOCKS5 no Endpoint Generator e coloque a linha gerada no campo SOCKS5 do programa |

Se nenhuma linha da tabela se aplica, veja para qual domínio vai a linha Error em Logs e tente abrir o mesmo endereço sem proxy; se a página também não abre sem proxy, o problema não está no proxy.

## Guia de decisão

| Necessidade | Recomendação |
|---|---|
| Criar o primeiro gate residencial no painel | Proxy > Proxy Create > Residential > Create; dar nome é opcional |
| Sair por um país específico | Escolher o Country no Endpoint Generator e gerar a linha de novo |
| Um IP novo a cada requisição | Session Type: None |
| Conta com login, carrinho, formulário | Session Type com duração; tempo maior que o do trabalho |
| O mesmo IP por semanas | [Proxies ISP](https://proxynet.io/pt-br/static-isp-residential-proxy) |
| Testar sem escrever código | Extensão do Chrome + `ipinfo.io/json` |
| Testar pelo terminal | O comando curl do cartão Code Examples |
| Dispositivo que não pede senha | IP whitelist em Access Details |
| Proteger o saldo | Traffic Limit no gate e, se necessário, Target Host |
| Diagnosticar um "não funciona" | Aba Logs, filtro Level |

## Perguntas frequentes

### Criar um proxy residencial é pago?

Criar o gate não gera cobrança; você paga só pelo tráfego usado, por GB. As poucas requisições de teste são medidas em kilobytes. O preço atual do GB aparece no cartão Order Summary da tela de pedido e na página [Proxies residenciais](https://proxynet.io/pt-br/residential-proxy).

### Posso usar mais de um país com o mesmo gate?

Sim. No Endpoint Generator, você gera uma linha separada para cada país; o endereço e a senha continuam os mesmos, só o nome de usuário muda. Você pode usar ao mesmo tempo a linha da Alemanha em um perfil de navegador e a linha de Türkiye em um script. Se quiser acompanhar os países separadamente, também dá para abrir gates separados; Statistics e Logs são registrados por gate.

### Posso mudar o nome do gate depois?

Sim. Na página do gate, clique no ícone de lápis ao lado do título e digite o novo nome. O nome aparece só no painel e não afeta os dados de conexão.

### Qual IP a requisição de teste deve mostrar?

Um IP do país que você escolheu, registrado em uma operadora doméstica ou móvel. O nome da operadora aparece na linha `org` da resposta de `ipinfo.io/json`. Se você vê o seu próprio IP, a requisição não passou pelo proxy; em geral, a extensão do navegador ficou desligada ou o proxy não foi configurado no programa.

### Posso ver ou mudar a minha senha?

Na linha Password de Access Details, o ícone de olho mostra a senha, e o ícone de copiar a envia para a área de transferência. Se você suspeita que a senha vazou, o caminho mais curto é excluir o gate e criar outro; o novo gate vem com nome de usuário e senha novos, e o saldo não é afetado.

### Fui adicionado como membro de um espaço de trabalho. Posso criar um gate?

Sim, mas, como diz o aviso da tela de pedido, a cobrança sai do saldo do dono do espaço de trabalho, e o preço segue o nível dele. A coluna **Created by** da lista mostra quem abriu cada gate.

## Em resumo

Criar um proxy residencial no painel leva três cliques: aba Proxy, Proxy Create, Residential, Create. A seção Access Details da página do gate entrega o endereço, o nome de usuário e a senha prontos; as escolhas de país, cidade e sessão são gravadas no nome de usuário pelo Endpoint Generator. Para testar, use o comando curl do painel ou a extensão do Chrome, confira o código do país e a operadora em uma página de verificação de IP e depois veja o tráfego subir em Statistics. O resto está em Logs: sem linha, é o endereço; com Auth, é a senha; com Connect, é o site de destino. Se você ainda não tem um gate, pode começar pela página [/pt-br/proxy](/pt-br/proxy).