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 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.

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.

Consulta básica

Nossos Residential Proxies suportam HTTP, HTTPS, HTTP/3 (MASQUE), e SOCKS5 protocolos. Você pode saber mais sobre como usá-los aqui.

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.

cURL

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location

PHP

<?php
$username = 'USERNAME';
$password = 'PASSWORD';
$proxy = 'pr.oxylabs.io:7777';
$query = curl_init('https://ip.oxylabs.io/location');
curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
curl_setopt($query, CURLOPT_PROXYUSERPWD, "customer-$username:$password");
$output = curl_exec($query);
curl_close($query);
if ($output)
    echo $output;
?>

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

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);
    }
}

C#

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

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

Exemplo de resposta

Testando sua conexão com https://ip.oxylabs.io/location 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.

{
  "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áfica	Aplique parâmetros de país, cidade, estado, continente, CEP, ASN ou coordenadas.
Controle de sessão	Sessões persistentes (sessid), duração da sessão (sesstime), vinculação a um único IP (sessid_oneip), e faixas de portas persistentes.
Protocolos e portas	Configure HTTP, HTTPS, HTTP/3, e SOCKS5 conexões.
Filtros avançados	Direcione sistemas operacionais específicos (plataforma) ou versões do protocolo IP.
Lista de permissões de IP	Conecte 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âmetro	Tipo	Descrição
customer	Obrigatório	Prefixo de cadeia de caracteres do nome de usuário (por exemplo, customer-USERNAME).
cc	Localização	có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).
cidade	Localização	Nome da cidade em inglês; requer cc (por exemplo, cc-US-city-los_angeles).
st	Localização	Nome do estado dos EUA com us_ prefixo (por exemplo, st-us_california).
cn	Localização	código de continente de 2 letras (por exemplo, cn-EU, cn-AS).
postalcode	Localização	CEP dos EUA de 5 dígitos; requer cc-US (por exemplo, postalcode-90210).
ASN	Localização	Número do Sistema Autônomo (por exemplo, ASN-21928).
geohash	Localização	Direcione células da grade Geohash de nível 1–4 (por exemplo, geohash-u09 para Paris).
sessid	Sessão	Cadeia de caracteres aleatória para manter o IP entre requisições (padrão de 10 min).
sesstime	Sessão	Estenda a duração da sessão em minutos até 1440 min (por exemplo, sesstime-30).
sessid_oneip	Sessão	Vincule a sessão estritamente a um único nó de saída; falha com 502 em caso de queda.
plataforma	Filtrar	Impressão digital do sistema operacional alvo (windows, macos, linux, android, ios).
ipversion	Filtrar	Restrinja 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:

Formato	Caso 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:[e-mail]: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 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 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.

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 para perguntas rápidas ou relatórios de bugs.
• E-mail. Você pode entrar em contato conosco via [e-mail]. Recomendamos este método para perguntas menos urgentes ou sugestões.