Guia de conexão de proxy, métodos de configuração SOCKS5·HTTP por linguagem e ferramenta

O guia de conexão da Socks5Proxy explica como configurar proxies SOCKS5 e HTTP em 7 ferramentas (Python requests, Node.js, cURL, Selenium, Puppeteer, Playwright, Scrapy) com exemplos de código funcionando.

Começar Ver preços

Python requestsOrganizamos como conectar proxies HTTP e SOCKS5 (socks5h) no Python requests, incluindo autenticação, rotação, retentativas e gerenciamento de sessão com exemplos.

Node.jsOrganizamos como conectar proxy HTTP via ProxyAgent e SOCKS5 via socks-proxy-agent no fetch(undici) do Node.js, além de código para rotacionar listas.

cURLGuia completo: como usar proxies HTTP (-x) e SOCKS5 (--socks5-hostname) com cURL, incluindo autenticação, medição de latência e scripts para teste em massa.

SeleniumExplicamos como conectar proxies HTTP e SOCKS5 no Chrome e Firefox via Selenium, por que a autorização por IP é útil no Chrome e como executar vários navegadores em paralelo.

PuppeteerOrganizamos como conectar proxies HTTP/SOCKS5 no Puppeteer via --proxy-server e page.authenticate, além de separar IPs por navegador.

PlaywrightOrganizamos como conectar proxies HTTP/SOCKS5 via proxy option no Playwright, usar IPs diferentes por contexto e exemplos em Python/Node.js.

ScrapyExplicamos como conectar proxies no Scrapy usando HttpProxyMiddleware e meta proxy, middleware de download para rotacionar IPs por requisição e configurações de velocidade.

Quais informações são necessárias para conectar ao proxy?

Cada linha do proxy contém um IP, portas HTTP e SOCKS5, nome de usuário e senha. Veja a lista na tela Meus Proxies do dashboard, baixe no formato desejado ou obtenha via API.

Todos os exemplos usam IP 198.51.100.23, porta HTTP 8000, porta SOCKS5 1080, usuário spx_user e senha spx_pass. A rede 198.51.100.0/24 é reservada para documentação - substitua pelos valores da sua lista de proxies.

Há dois métodos de autenticação: enviar nome de usuário e senha juntos ou registrar até 10 endereços IPv4 do seu servidor no dashboard e acessar apenas com ip:port. Ferramentas que não aceitam senhas (por exemplo, argumentos de execução do Chrome) funcionam melhor com autenticação por IP.

Item	Valor de exemplo	Descrição
IP	198.51.100.23	Endereço do servidor proxy
Porta HTTP	8000	Conexão HTTP e HTTPS (CONNECT)
Porta SOCKS5	1080	Conexão TCP SOCKS5
Usuário	spx_user	Autenticação por usuário/senha
Senha	spx_pass	Autenticação por usuário/senha

Como conectar: HTTP ou SOCKS5?

A maioria das tarefas de requisição a páginas e APIs pode ser feita com a porta HTTP. URLs HTTPS também são transmitidas criptografadas via CONNECT, sem alteração de conteúdo pelo proxy.

O SOCKS5 pode transmitir conexões TCP além de HTTP e permite que a resolução de nomes de domínio seja feita pelo lado do proxy. No Python, use socks5h, e no cURL, use --socks5-hostname para evitar que suas consultas DNS sejam expostas. Cada IP tem ambas as portas, então você pode escolher o método suportado pela sua ferramenta.

Como receber a lista via código?

Crie chaves API na seção 'Chaves API' do dashboard - elas são exibidas apenas uma vez, então armazene em local seguro. Inclua o cabeçalho 'Authorization: Bearer' em todas as requisições. Este código Python obtém a lista SOCKS5 no formato user:pass@ip:port. Os guias mostram como conectar esta lista às ferramentas.

import requests

API = "https://socks5proxy.io/api/v1"
KEY = "YOUR_API_KEY"

# Download the proxy list as plain text, one proxy per line
r = requests.get(
    API + "/proxies/download",
    params={"format": "user:pass@ip:port", "protocol": "socks5"},
    headers={"Authorization": "Bearer " + KEY},
    timeout=30,
)
r.raise_for_status()
proxies = [line.strip() for line in r.text.splitlines() if line.strip()]
print(len(proxies), "proxies loaded")

Por qual guia começar?

Escolha o guia conforme sua linguagem e ferramentas. Todos incluem verificação de conexão, solução de erros e distribuição de IPs.

Python requests: conexões HTTP/SOCKS5 simples e rotação de listas
Node.js: ProxyAgent(HTTP) e socks-proxy-agent(SOCKS5) do undici
cURL: verificação de conexão e medição de tempo de resposta
Selenium: Chrome com autorização por IP e configuração do Firefox
Puppeteer: --proxy-server e page.authenticate
Playwright: proxy por navegador e contexto
Scrapy: meta proxy e middleware de rotação por requisição

Qual formato de lista escolher?

Como cada ferramenta aceita formatos diferentes, você pode escolher o formato ao baixar a lista. A maioria das bibliotecas aceita o formato de endereço (http://user:pass@ip:port ou socks5://user:pass@ip:port). Para programas com campos separados para IP, porta, usuário e senha, o formato ip:port:user:pass facilita a inserção.

Para autorização por IP, escolha o formato ip:port. Para planilhas e documentos, CSV é mais prático. Liste HTTP e SOCKS5 separadamente - só as portas diferem.

Formato	Exemplo	Combinações ideais
ip:port:user:pass	198.51.100.23:8000:spx_user:spx_pass	Tela de configuração dividida em Cannes
user:pass@ip:port	spx_user:spx_pass@198.51.100.23:8000	Montando endereços no código
http://user:pass@ip:port	http://spx_user:spx_pass@198.51.100.23:8000	requests, cURL, Scrapy
socks5://user:pass@ip:port	socks5://spx_user:spx_pass@198.51.100.23:1080	Biblioteca SOCKS5
ip:port	198.51.100.23:8000	Autorização por IP, argumentos de execução do navegador
CSV	ip,http_port,socks_port,user,pass,country	Cálculo de tabela, documentos de gerenciamento

Como armazenar as informações do proxy com segurança?

Não armazene nome de usuário, senha e chave API do proxy em repositórios de código. Use variáveis de ambiente ou cofres de segredos. Se expostos acidentalmente, gere uma nova chave API no dashboard para invalidar a anterior.

Se o servidor tem IP fixo, usar autorização por IP é o mais seguro. Mesmo que a lista vaze, conexões de IPs não autorizados serão bloqueadas. Você pode registrar até 10 IPs e alterá-los a qualquer momento.

Para equipes, compartilhar listas via API é mais prático que arquivos em pasta comum. O histórico de downloads facilita a solução de problemas.

O que verificar quando a conexão falha?

Primeiro teste com cURL para verificar se o proxy responde. Código 407 indica credenciais incorretas. Se usar autorização por IP, verifique se o IP do servidor está na lista permitida. Se houver timeout, confira a porta (cada linha tem valores diferentes como HTTP 8000 ou SOCKS5 1080).

Se o problema persistir, você pode entrar em contato pelo suporte no dashboard. Inclua a linha usada, a ferramenta e a mensagem de erro para uma verificação mais rápida.