Formato de conexión del proxy: IP:PORT:USERNAME:PASSWORD

¿Cómo convierto una línea en una URL de proxy?

Mueve el usuario y la contraseña al principio, unidos por :, luego añade @, la IP, : y el puerto, y pon un esquema delante. La mayoría de las librerías aceptan esta forma de URL.

El esquema de un proxy HTTP es http:// incluso cuando el sitio web es https://: el esquema describe la conexión al proxy, y los sitios HTTPS pasan por un túnel CONNECT. La guía SOCKS5 vs HTTP explica socks5 y socks5h.

¿Cómo codifico en URL los caracteres especiales de una contraseña de proxy?

Sustituye cada carácter reservado por % y su código hexadecimal, o deja que tu lenguaje lo haga: urllib.parse.quote(password, safe='') en Python, encodeURIComponent(password) en JavaScript. La RFC 3986 reserva estos caracteres porque separan las partes de una URL. Un @ sin codificar en una contraseña, por ejemplo, hace que la herramienta lea el resto de la contraseña como el host.

Solo el usuario y la contraseña necesitan esto. La IP y el puerto nunca contienen caracteres reservados. En la línea IP:PORT:USERNAME:PASSWORD original nada está codificado, así que divídela solo por los tres primeros dos puntos: una contraseña puede contener : en sí misma.

¿Puedo convertir una lista entera a la vez?

Sí. Exporta tu lista como TXT desde tu cuenta y luego ejecuta uno de los scripts de abajo. Cada uno lee proxies.txt (o el archivo que le pases), divide cada línea por sus tres primeros dos puntos, codifica el login e imprime una URL HTTP y una URL socks5h:// por IP. Si tu cuenta muestra un puerto SOCKS5 separado, usa ese puerto en la 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

¿Qué contienen las exportaciones TXT y CSV?

La exportación TXT tiene una línea IP:PORT:USERNAME:PASSWORD por IP y nada más, lo que encaja con scripts y herramientas que importan listas de proxies. La exportación CSV contiene al menos IP, puerto, usuario, contraseña, país y fecha de fin, lo que encaja con hojas de cálculo e inventario.

Antes de leer el CSV en código, ábrelo una vez y revisa la fila de encabezado para conocer los nombres exactos de las columnas; lee las columnas por nombre, no por posición. El csv.DictReader de Python lo hace. Mantén ambos archivos privados: contienen las contraseñas de tus proxies. Si un archivo se filtra, escribe a soporte con las IPs afectadas, nunca con las contraseñas.

¿Qué formato espera mi herramienta?

La mayoría de las herramientas prefieren la forma de URL o campos separados:

• curl: -x http://USERNAME:PASSWORD@IP:PORT, o -x http://IP:PORT -U USERNAME:PASSWORD.
• Python requests y aiohttp: la forma de URL; consulta los ejemplos de código.
• Node.js (undici, https-proxy-agent): la forma de URL.
• Playwright y navegadores: campos separados: server, username, password.
• Frameworks de scraping y gestores de proxies: a menudo la línea IP:PORT:USERNAME:PASSWORD sin procesar o USERNAME:PASSWORD@IP:PORT; revisa su pantalla de importación.

Con la lista de IP permitidas, todos los formatos eliminan el usuario y la contraseña: IP:PORT o http://IP:PORT. Usuario y contraseña, o una lista de IPs permitidas (hasta 10 IPs).