> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies.md). # Residential Proxies Saiba tudo sobre Residential Proxies da Oxylabs, exemplos de código, parâmetros de segmentação de localização e recursos de solução de problemas. Oxylabs [**Residential Proxies**](https://oxylabs.io/products/residential-proxy-pool) usam endereços IP reais fornecidos por Provedores de Serviços de Internet (ISPs) vinculados a dispositivos físicos globalmente. Esses proxies giram automaticamente a cada requisição e oferecem suporte a segmentação granular por país, cidade, estado, CEP, ASN e sessão. {% hint style="info" %} **Conectando via IPs na lista de permissões?** Se você preferir autenticar via whitelisting de IP em vez de `username`/`senha` credenciais, siga nosso [guia de whitelisting de IP e autenticação por subdomínio](/products/pt-br/proxies/residential-proxies/whitelisting-ips.md). {% endhint %} ## Consulta básica {% hint style="info" %} Nossos Residential Proxies suportam `HTTP`, `HTTPS`, `HTTP/3 (MASQUE)`, e `SOCKS5` protocolos. Você pode saber mais sobre como usá-los [**aqui**](/products/pt-br/proxies/residential-proxies/protocols.md). {% endhint %} Fazer uma requisição básica requer apenas informar suas credenciais de usuário do proxy (`username` e `senha`) para o nó de entrada backconnect (`pr.oxylabs.io:7777`). Cada requisição é roteada automaticamente por um endereço IP aleatório. {% tabs %} {% tab title="cURL" %} ```shell curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location ``` {% endtab %} {% tab title="PHP" %} ```php ``` {% endtab %} {% tab title="Python" %} ```python import urllib.request username = 'USERNAME' password = 'PASSWORD' entry = f'http://customer-{username}:{password}@pr.oxylabs.io:7777' query = urllib.request.ProxyHandler({ 'http': entry, 'https': entry, }) execute = urllib.request.build_opener(query) print(execute.open('https://ip.oxylabs.io/location').read()) ``` {% endtab %} {% tab title="Java" %} ```java package example; import org.apache.http.HttpHost; import org.apache.http.client.fluent.*; public class Example { public static void main(String[] args) throws Exception { HttpHost entry = new HttpHost("pr.oxylabs.io", 7777); String query = Executor.newInstance() .auth(entry, "customer-USERNAME", "PASS") .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry)) .returnContent().asString(); System.out.println(query); } } ``` {% endtab %} {% tab title="C#" %} ```csharp using System; using System.Net; class Example { static void Main() { var client = new WebClient(); client.Proxy = new WebProxy("pr.oxylabs.io:7777"); client.Proxy.Credentials = new NetworkCredential("customer-USERNAME", "PASSWORD"); Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location")); } c ``` {% endtab %} {% tab title="Ruby" %} ```ruby require 'uri' require 'net/http' uri = URI.parse('https://ip.oxylabs.io/location') proxy = Net::HTTP::Proxy('pr.oxylabs.io', 7777, 'customer-USERNAME', 'PASSWORD') req = Net::HTTP::Get.new(uri.path) result = proxy.start(uri.host,uri.port) do |http| http.request(req) end puts result.body ``` {% endtab %} {% endtabs %} ### Exemplo de resposta Testando sua conexão com retorna dados do MaxMind, IP2Location, DB-IP e IPinfo.io. Os parâmetros incluem endereço IP, provedor, país, cidade, CEP, ASN, nome da organização e fuso horário. ```json { "ip": "185.220.101.5", "provider": "Comcast Cable", "country": "United States", "country_code": "US", "city": "New York", "zip": "10001", "asn": 7018, "organization": "ATT-INTERNET4", "timezone": "America/New_York" } ``` ## Personalizando suas requisições Depois que uma conexão básica for verificada, personalize suas requisições de acordo com suas necessidades específicas:
Localização e segmentação geográficaAplique parâmetros de país, cidade, estado, continente, CEP, ASN ou coordenadas.
Controle de sessãoSessões persistentes (sessid), duração da sessão (sesstime), vinculação a um único IP (sessid_oneip), e faixas de portas persistentes.
Protocolos e portasConfigure HTTP, HTTPS, HTTP/3, e SOCKS5 conexões.
Filtros avançadosDirecione sistemas operacionais específicos (plataforma) ou versões do protocolo IP.
Lista de permissões de IPConecte sem senhas usando autenticação baseada em IP.
### Parâmetros de consulta Um único proxy backconnect (`pr.oxylabs.io:7777)` permite personalizar seu proxy por meio de parâmetros adicionais no nome de usuário (geolocalização, sessões persistentes etc.). Aqui está um exemplo de credenciais com a divisão:
ParâmetroTipoDescrição
customerObrigatórioPrefixo de cadeia de caracteres do nome de usuário (por exemplo, customer-USERNAME).
ccLocalizaçãocódigo de país ISO 3166-1 de 2 letras, sem distinção entre maiúsculas e minúsculas (por exemplo, cc-DE, cc-US).
cidadeLocalizaçãoNome da cidade em inglês; requer cc (por exemplo, cc-US-city-los_angeles).
stLocalizaçãoNome do estado dos EUA com us_ prefixo (por exemplo, st-us_california).
cnLocalizaçãocódigo de continente de 2 letras (por exemplo, cn-EU, cn-AS).
postalcodeLocalizaçãoCEP dos EUA de 5 dígitos; requer cc-US (por exemplo, postalcode-90210).
ASNLocalizaçãoNúmero do Sistema Autônomo (por exemplo, ASN-21928).
geohashLocalizaçãoDirecione células da grade Geohash de nível 1–4 (por exemplo, geohash-u09 para Paris).
sessidSessãoCadeia de caracteres aleatória para manter o IP entre requisições (padrão de 10 min).
sesstimeSessãoEstenda a duração da sessão em minutos até 1440 min (por exemplo, sesstime-30).
sessid_oneipSessãoVincule a sessão estritamente a um único nó de saída; falha com 502 em caso de queda.
plataformaFiltrarImpressão digital do sistema operacional alvo (windows, macos, linux, android, ios).
ipversionFiltrarRestrinja o conjunto de proxies a ipversion-4 ou ipversion-6.
### Formatos comuns de cadeias de caracteres de proxy Dependendo do seu fluxo de trabalho, software de terceiros ou scripts personalizados, as credenciais de proxy podem ser formatadas de várias maneiras:
FormatoCaso de uso
HOST:PORT:USER:PASS\n(pr.oxylabs.io:7777:customer-john:pass123)Formato de gateway de entrada backconnect usado em ferramentas de automação padrão.
USER:PASS@HOST:PORT\n(customer-john:pass123@pr.oxylabs.io:7777)Formato URI padrão usado por cURL, Python requests, Node.js axios, etc.
IP:PORT:USER:PASS\n(185.220.101.5:8000:john:pass123)Formato IP direto comumente usado em ferramentas de botting e scrapers de desktop.
USER:PASS:IP:PORT\n(john:pass123:185.220.101.5:8000)Formato de cadeia de caracteres invertida usado por ferramentas legadas que exigem análise personalizada.
IP:PORT\n(185.220.101.5:8000)Formato com IP na lista de permissões (não requer nome de usuário/senha).
## Painel e gerenciamento de conta * Acesse seu [Painel da Oxylabs](https://dashboard.oxylabs.io/en) para ver o uso de tráfego em tempo real, estatísticas de requisições e gerenciar subusuários. * Use o automatizado [Gerador de endpoints](/products/pt-br/proxies/residential-proxies/endpoint-generator.md) para gerar e exportar listas personalizadas de servidores proxy em cURL, Python, PHP, Node.js, GO, Java ou detalhes personalizados para integrações. * Gerencie subusuários e acompanhe o uso programaticamente via [Public API](/products/pt-br/proxies/residential-proxies/public-api.md). ## Precisa de assistência técnica? Entre em contato com seu gerente de conta ou com nossa equipe de suporte 24/7 usando uma das opções abaixo: * **Chat ao vivo.** Acesse o chat ao vivo pelo seu painel ou no [**site da Oxylabs**](https://oxylabs.io/) para perguntas rápidas ou relatórios de bugs. * **E-mail**. Você pode entrar em contato conosco via [**support@oxylabs.io**](mailto:support@oxylabs.io). Recomendamos este método para perguntas menos urgentes ou sugestões. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.