Formato de conexão do proxy: IP:PORTA:USUÁRIO:SENHA

Como converto uma linha em URL de proxy?

Mova o usuário e a senha para a frente, unidos por :, depois adicione @, o IP, : e a porta, e coloque um esquema na frente. A maioria das bibliotecas aceita este formato de URL.

O esquema de um proxy HTTP é http:// mesmo quando o site é https://: o esquema descreve a conexão com o proxy, e sites HTTPS passam por um túnel CONNECT. O guia SOCKS5 vs HTTP explica socks5 e socks5h.

Como faço a codificação URL de caracteres especiais na senha do proxy?

Substitua cada caractere reservado por % e seu código hexadecimal, ou deixe sua linguagem fazer isso: urllib.parse.quote(password, safe='') em Python, encodeURIComponent(password) em JavaScript. O RFC 3986 reserva esses caracteres porque eles separam as partes de uma URL. Um @ não codificado em uma senha, por exemplo, faz a ferramenta ler o restante da senha como o host.

Só o usuário e a senha precisam disso. O IP e a porta nunca contêm caracteres reservados. Na linha IP:PORT:USERNAME:PASSWORD original nada é codificado, então divida-a apenas nos três primeiros dois-pontos: uma senha pode conter : nela mesma.

Posso converter uma lista inteira de uma vez?

Sim. Exporte sua lista como TXT na sua conta, depois execute um dos scripts abaixo. Cada um lê proxies.txt (ou o arquivo que você passar), divide cada linha nos seus três primeiros dois-pontos, codifica o login e imprime uma URL HTTP e uma URL socks5h:// por IP. Se sua conta lista uma porta SOCKS5 separada, use essa porta na URL SOCKS5.

"""Turn IP:PORT:USERNAME:PASSWORD lines into proxy URLs, with safe encoding."""
import sys
from urllib.parse import quote


def to_proxy_url(line, scheme='http'):
    # maxsplit=3 keeps a password that itself contains ':' in one piece
    ip, port, user, password = line.strip().split(':', 3)
    return f'{scheme}://{quote(user, safe="")}:{quote(password, safe="")}@{ip}:{port}'


path = sys.argv[1] if len(sys.argv) > 1 else 'proxies.txt'
with open(path, encoding='utf-8') as handle:
    for line in handle:
        if line.strip():
            print(to_proxy_url(line))                    # HTTP proxy URL
            print(to_proxy_url(line, scheme='socks5h'))  # SOCKS5, DNS on the proxy

// Turn IP:PORT:USERNAME:PASSWORD lines into proxy URLs (Node.js 18 or later).
import { readFileSync } from 'node:fs';

function toProxyUrl(line, scheme = 'http') {
  const [ip, port, user, ...rest] = line.trim().split(':');
  const password = rest.join(':'); // a password may itself contain ':'
  return `${scheme}://${encodeURIComponent(user)}:${encodeURIComponent(password)}@${ip}:${port}`;
}

const lines = readFileSync(process.argv[2] ?? 'proxies.txt', 'utf8').split(/\r?\n/).filter(Boolean);
for (const line of lines) {
  console.log(toProxyUrl(line));
  console.log(toProxyUrl(line, 'socks5h'));
}

http://user-7:p%40ss%3Aw%2Frd%[email protected]:8000
socks5h://user-7:p%40ss%3Aw%2Frd%[email protected]:8000

O que há nas exportações TXT e CSV?

A exportação TXT tem uma linha IP:PORT:USERNAME:PASSWORD por IP e nada mais, o que serve para scripts e ferramentas que importam listas de proxy. A exportação CSV contém ao menos IP, porta, usuário, senha, país e data de término, o que serve para planilhas e inventário.

Antes de ler o CSV em código, abra-o uma vez e confira a linha de cabeçalho para os nomes exatos das colunas; leia as colunas pelo nome, não pela posição. O csv.DictReader do Python faz isso. Mantenha os dois arquivos privados: eles contêm as senhas do seu proxy. Se um arquivo vazar, escreva para o suporte com os IPs afetados, nunca as senhas.

Qual formato minha ferramenta espera?

A maioria das ferramentas quer o formato de URL ou campos separados:

• curl: -x http://USERNAME:PASSWORD@IP:PORT, ou -x http://IP:PORT -U USERNAME:PASSWORD.
• Python requests e aiohttp: o formato de URL; veja os exemplos de código.
• Node.js (undici, https-proxy-agent): o formato de URL.
• Playwright e navegadores: campos separados: server, username, password.
• Frameworks de scraping e gerenciadores de proxy: muitas vezes a linha IP:PORT:USERNAME:PASSWORD bruta ou USERNAME:PASSWORD@IP:PORT; confira a tela de importação deles.

Com a allowlist de IP, todo formato dispensa o usuário e a senha: IP:PORT ou http://IP:PORT. Nome de usuário e senha, ou uma lista de IPs permitidos (até 10 IPs).