For the complete documentation index, see llms.txt. This page is also available as Markdown.

Protocolos

Explore os protocolos suportados por Residential Proxies e aprenda a configurar conexões HTTP, HTTPS, HTTPS/3 e SOCKS5.

suporte a Oxylabs Residential Proxies HTTP, HTTPS, HTTP/3, e SOCKS5 protocolos de conexão. Você pode escolher o protocolo que melhor se adapta à sua pilha de scraping, biblioteca HTTP ou software de terceiros.

Protocolo
Gateway
Transporte
Descrição

HTTP

pr.oxylabs.io:7777

TCP

Método de conexão padrão suportado por todas as bibliotecas e ferramentas.

HTTPS

https://pr.oxylabs.io:7777

TCP / SSL

Conexão totalmente criptografada com o gateway do proxy.

HTTP/3

socks.pr.oxylabs.io:7777

UDP / QUIC

Requer um proxy SOCKS5 com suporte a UDP.

SOCKS5

socks5h://pr.oxylabs.io:7777

TCP / UDP

Proxy de baixo nível. Requer flags de username para segmentação geográfica.

HTTP

O padrão HTTP protocolo é o principal método de conexão para Oxylabs Residential Proxies, com suporte nativo em todas as bibliotecas de cliente HTTP, frameworks de web scraping e ferramentas de terceiros.

Exemplos de código

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

proxies = {
    'http': 'http://customer-USERNAME:PASSWORD@pr.oxylabs.io:7777',
    'https': 'http://customer-USERNAME:PASSWORD@pr.oxylabs.io:7777',
}

response = requests.get('https://ip.oxylabs.io/location', proxies=proxies)
print(response.text)
<?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);
echo $output;
?>

HTTPS

Conectando via HTTPS fornece uma conexão SSL criptografada de ponta a ponta com o nó de entrada do proxy. Para habilitar o proxying HTTPS, adicione https:// ao seu ponto de entrada do proxy (por exemplo, https://pr.oxylabs.io:7777). O mesmo se aplica ao usar HTTPS com nós de entrada específicos por país.

Verifique se o seu HTTP biblioteca cliente ou ferramenta de terceiros suporta HTTPS protocolo antes de usar, pois ferramentas legadas podem usar por padrão conexões de proxy não criptografadas HTTP conexões de proxy.

Exemplos de código

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

proxies = {
    'http': 'https://customer-USERNAME:PASSWORD@pr.oxylabs.io:7777',
    'https': 'https://customer-USERNAME:PASSWORD@pr.oxylabs.io:7777',
}

response = requests.get('https://ip.oxylabs.io/location', proxies=proxies)
print(response.text)
const axios = require('axios');

axios.get('https://ip.oxylabs.io/location', {
  proxy: {
    protocol: 'https',
    host: 'pr.oxylabs.io',
    port: 7777,
    auth: {
      username: 'customer-USERNAME',
      password: 'PASSWORD'
    }
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

HTTP/3 (MASQUE)

Oxylabs Residential Proxies oferecem suporte nativo a UDP e HTTP/3 tunelamento via MASQUE (RFC 9298 CONNECT-UDP).

Proxies tradicionais forçam o tráfego através de TCP conexões (via HTTP CONNECT ou SOCKS5), fazendo com que HTTP/3 as requisições sejam rebaixadas para HTTP/1.1 ou HTTP/2. MASQUE mantém uma conexão de ponta a ponta QUIC através dos nossos nós de saída residenciais, permitindo que seu cliente transmita tráfego nativo UDP diretamente para destinos-alvo modernos.

O serviço MASQUE roda sobre QUIC em uma UDP porta dedicada:

Observação: Garanta que seu firewall permita tráfego de saída UDP na porta 50000.

Casos de uso

  • Web scraping nativo em HTTP/3: Raspe sites-alvo modernos sem acionar sinais de downgrade de protocolo.

  • Resolução de DNS via UDP: Execute consultas DNS diretas (53/udp) via IPs residenciais.

  • Protocolos UDP em tempo real: Roteie tráfego WebRTC, SIP ou de jogos que exija uma conexão UDP real.

Observação: Se sua aplicação de scraping só precisa de HTTP ou HTTPS (TCP) conexões, use nosso endpoint principal de backconnect (pr.oxylabs.io:7777). MASQUE introduz QUIC sobrecarga de configuração de conexão que só é necessária quando você precisa de UDP ou nativo HTTP/3 transporte.

Configuração do MASQUE

Para a configuração completa, detalhes de configuração e autenticação, veja o guia técnico de configuração abaixo.

Setup e configuração do MASQUE

Proxy Endpoint

masque.oxylabs.io:50000

Nó de entrada QUIC dedicado

Transporte

HTTP/3 sobre QUIC

Usa a porta UDP 50000

ALPN

h3

string de negociação de protocolo na camada de aplicação

Suporte a datagramas

EnableDatagrams: true

Deve ser habilitado na configuração QUIC do seu cliente

Tamanho máximo do datagrama

1500 bytes

Datagramas com mais de 1500 bytes são descartados pelo proxy

Verificação de TLS

CA pública padrão

Nenhum certificado CA personalizado ou substituição é necessário

Configuração do endpoint e formatos de URI

Para estabelecer um túnel, seu cliente envia um CONNECT requisição com :protocol = connect-udp para o listener do proxy:

  • Padrão RFC 9298 (recomendado): https://masque.oxylabs.io:50000/.well-known/masque/udp/{target_host}/{target_port}/

  • Formato de consulta legado: https://masque.oxylabs.io:50000/masque?h={target_host}&p={target_port}

Hostnames e IPs: O proxy resolve nomes de host em seu nome por meio do nó de saída residencial. Você pode passar nomes de domínio (example.com) ou endereços IP (1.2.3.4). Endereços IPv6 devem ser codificados em percent-encoding (por exemplo, 2001%3Adb8%3A%3A1).

Autenticação

A autenticação é tratada via standard autenticação HTTP Basic usando o Proxy-Authorization cabeçalho enviado na CONNECT-UDP requisição:

Você usa suas credenciais padrão de proxy da Oxylabs. Configurações de localização e parâmetros de sessão funcionam de forma idêntica a HTTP/HTTPS proxies. Por exemplo:

QUIC aninhado e tamanho do pacote

Ao usar HTTP/3 via MASQUE, uma segunda pilha QUIC roda sobre o túnel do proxy (QUIC aninhado). A conexão externa (cliente-para-proxy) encapsula pacotes da conexão interna (cliente-para-destino), adicionando ~40 bytes de sobrecarga de enquadramento do protocolo.

Para configurar sua conexão corretamente, ajuste o seguinte:

  1. Desative o PMTUD: Desative o Path MTU Discovery em ambas as conexões QUIC externa e interna para impor limites fixos de pacotes.

  2. QUIC externo (cliente para proxy): Defina o tamanho inicial/máximo do pacote para 1392 bytes.

  3. QUIC interno (cliente para destino): Defina o tamanho inicial/máximo do pacote para 1352 bytes.

A diferença de ~40 bytes comporta os cabeçalhos QUIC externos, tags de criptografia AEAD, cabeçalhos de frame DATAGRAM, enquadramento de HTTP-datagram sob a RFC 9297 e IDs de contexto CONNECT-UDP sob a RFC 9298.

Códigos de status de resposta

Código
Status
Descrição

200

OK

Túnel estabelecido. Os datagramas UDP agora podem fluir no fluxo da requisição.

400

Requisição inválida

URI de destino malformada ou parâmetros de requisição inválidos.

407

Autenticação de proxy necessária

Falha na autenticação ou limite de tráfego da conta atingido.

SOCKS5

suporte a Oxylabs Residential Proxies SOCKS5 conexões via TCP e UDP.

A conexão SOCKS5 suporta ambos socks5h:// e socks5://:

  • socks5h passa o hostname

  • socks5 passa o IP resolvido

Para uma conexão SOCKS5 padrão, use socks5h:// com sua string de conexão:

Exemplos de código

Portas de destino de proxy permitidas

A configuração padrão das portas de proxy inclui 80 e 443, projetada para acomodar HTTP e HTTPS protocolos. HTTP/3 (MASQUE) opera na porta UDP 50000.

Protocolo
Transporte
Porta

HTTP

TCP

80

HTTPS

TCP

443

HTTP/3 (MASQUE)

UDP

50000

Para acessar outras portas, é necessário passar por verificação de conformidade, entre em contato com nosso suporte.

Atualizado

Isto foi útil?