Conectar a um proxy residencial é uma tarefa de cinco minutos que regularmente toma uma tarde inteira, geralmente porque a documentação de um provedor assume convenções de outro. Existem apenas quatro partes móveis: um host, uma porta, um nome de usuário e uma senha. O que varia entre provedores é quanto significado é embutido no nome de usuário, e em um gateway como este é aí que está quase tudo.
Aqui está o formato, o que cada parte faz, e como interpretar os erros quando algo não está certo.
As quatro partes
| Parte | Valor |
|---|---|
| Host | p.shifter.io |
| Porta | 443 |
| Nome de usuário | customer-USERNAME mais flags opcionais de segmentação |
| Senha | do painel |
O host e a porta nunca mudam. Não para um país diferente, não para uma sessão sticky, não para SOCKS5 em vez de HTTP. Toda requisição vai para o mesmo endpoint, e o que você quer é expresso no nome de usuário. Essa é a coisa mais importante de entender, porque é o que mais difere de produtos mais antigos baseados em porta, em que cada configuração significava um endereço diferente.
Tanto HTTP(S) quanto SOCKS5 falam com o mesmo host e porta. Suas credenciais estão no painel em Residential Proxies.
A requisição mais simples possível
Comece por aqui e confirme que funciona antes de adicionar qualquer coisa:
curl -x customer-USERNAME:PASSWORD@p.shifter.io:443 https://ipinfo.io/jsonIsso retorna um JSON descrevendo o endereço de saída que foi atribuído a você. Execute duas vezes e você deve ver dois endereços diferentes, porque a rotação é o padrão. Se isso funcionar, suas credenciais estão corretas e todo o resto é configuração.
Adicionando segmentação ao nome de usuário
As flags são anexadas ao nome de usuário com hífens. A ordem não importa, os valores são em minúsculas, e valores com múltiplas palavras usam underscores.
customer-USERNAME # rotação, sem geo
customer-USERNAME-country-de # saída na Alemanha
customer-USERNAME-country-us-city-new_york # nível de cidade
customer-USERNAME-country-us-asn-7922 # rede específica
customer-USERNAME-sid-abc123 # sessão sticky
customer-USERNAME-sid-abc123-ttl-600 # sticky por 10 minutos
customer-USERNAME-country-gb-sid-abc123-ttl-600 # combinadoOs códigos de país são ISO 3166-1 alpha-2, então o Reino Unido é gb em vez de uk, que é o erro de digitação mais comum de todos. sid é qualquer string que você escolher e mantém o mesmo endereço de saída para requisições subsequentes; ttl define por quanto tempo em segundos e só é válido junto com sid, com padrão de 120. A referência completa está na documentação de geo-targeting e na documentação de sessões, e a diferença conceitual está em sticky versus rotativo.
Um extra útil: por padrão, se nada corresponder a um filtro muito restrito naquele momento, o gateway recorre a um pool mais amplo para que sua requisição ainda seja concluída. Adicione strict-true quando uma correspondência geográfica exata importar mais do que o sucesso da requisição, e você receberá um 502 em vez de um fallback silencioso.
Os dois formatos que você vai encontrar
As credenciais de proxy são escritas de duas formas, e converter entre elas costuma confundir as pessoas.
Forma de URL, usada pela maioria das bibliotecas e pelo curl:
http://customer-USERNAME-country-de:PASSWORD@p.shifter.io:443Forma separada por dois-pontos, usada por muitas ferramentas de desktop e extensões de navegador, que normalmente pedem as partes em campos separados:
p.shifter.io:443:customer-USERNAME-country-de:PASSWORDElas carregam informação idêntica. Se uma ferramenta pedir quatro campos, use o segundo layout; se pedir uma única string, use o primeiro.
No código
import requests
USER = "customer-USERNAME-country-de"
PROXY = f"http://{USER}:PASSWORD@p.shifter.io:443"
r = requests.get("https://ipinfo.io/json",
proxies={"http": PROXY, "https": PROXY}, timeout=20)
print(r.json())Defina tanto a entrada http quanto a https. Definir apenas uma delas é uma causa comum de “funciona para algumas requisições e para outras não”, porque requisições simples e seguras seguem caminhos diferentes.
Se sua senha contiver caracteres que têm significado em uma URL, como @, :, / ou #, faça o percent-encoding antes de incorporá-la, ou a URL será interpretada de forma errada e você receberá um erro de autenticação com credenciais totalmente corretas.
Para SOCKS5, mantenha o mesmo host, porta e credenciais e mude apenas o esquema. Use a variante que resolve nomes de host no proxy em vez de localmente, já que a outra vaza seu DNS e pode retornar resultados regionalmente incorretos, assunto tratado em prevenindo vazamentos de DNS.
Configurações funcionais para outras stacks estão na documentação de integrações e, especificamente para Python, em usando proxies residenciais com Python.
Interpretando os erros
Quatro respostas cobrem quase todo problema de configuração, e cada uma aponta para um lugar diferente.
407 Proxy Authentication Required significa que o gateway rejeitou suas credenciais. Ou elas estão erradas, ou uma flag no seu nome de usuário está malformada, porque um valor não reconhecido torna todo o nome de usuário impossível de interpretar. Remova todas as flags e teste primeiro o nome de usuário puro: se funcionar, o problema está nas flags, e você pode adicioná-las de volta uma de cada vez até encontrar o erro. O caminho completo de diagnóstico está em corrigindo erros 407 e de credenciais.
502 Bad Gateway significa que suas credenciais estavam corretas, mas nada correspondeu ao seu filtro naquele momento. Amplie-o, mude de cidade para país, ou remova strict-true.
509 Bandwidth Limit Exceeded significa que a alocação do plano está esgotada com o excedente desabilitado. Não há nada de errado com a conexão.
Conexão recusada ou tempo limite excedido significa que você nunca alcançou o gateway. Verifique se você está apontando para p.shifter.io:443 em vez de um host legado baseado em porta, e teste a conectividade bruta com nc -vz p.shifter.io 443 antes de presumir um problema de proxy.
Verificando se realmente está funcionando
Duas verificações que vale a pena fazer uma vez no início.
Confirme a rotação: envie a mesma requisição várias vezes sem sid e confirme que o endereço muda. Se não mudar, a causa usual é o seu cliente HTTP reutilizando uma conexão em vez de o proxy falhar em rotacionar, assunto tratado em IP não rotacionando.
Confirme a geografia: solicite um país e verifique se o endereço retornado geolocaliza ali, e mais significativamente que um destino sensível à geolocalização se comporte como se você estivesse lá. O método mais completo está em testando velocidade, taxa de sucesso e precisão de localização.
Conclusão
Um host, uma porta, todo o resto no nome de usuário. Primeiro, faça funcionar uma requisição pura, depois adicione as flags de segmentação uma de cada vez, e lembre-se de que os códigos de país são ISO, então o Reino Unido é gb. Defina tanto a entrada de proxy HTTP quanto a HTTPS, faça o percent-encoding de uma senha com caracteres especiais, e use a variante SOCKS5 que resolve remotamente se for por esse caminho. Quando algo falhar, o código de status indica onde olhar: 407 é credenciais ou uma flag malformada, 502 é um filtro sem nada por trás, 509 é largura de banda, e conexão recusada significa que você não está nem se comunicando com o gateway.
Esse gateway é a porta de entrada para os proxies residenciais, onde país, cidade, ASN e sessão são todos parâmetros na mesma conexão, cobrados por GB, então nada na sua configuração muda o quanto você paga. Se você é novo em tudo isso, comece com proxies residenciais para iniciantes.