Format de connexion proxy : IP:PORT:USERNAME:PASSWORD

Comment convertir une ligne en URL proxy ?

Placez l'identifiant et le mot de passe devant, reliés par :, puis ajoutez @, l'IP, : et le port, et mettez un schéma devant. La plupart des bibliothèques acceptent cette forme d'URL.

Le schéma d'un proxy HTTP est http:// même quand le site est en https:// : le schéma décrit la connexion au proxy, et les sites HTTPS passent par un tunnel CONNECT. Le guide SOCKS5 vs HTTP explique socks5 et socks5h.

Comment encoder en URL les caractères spéciaux d'un mot de passe proxy ?

Remplacez chaque caractère réservé par % suivi de son code hexadécimal, ou laissez votre langage le faire : urllib.parse.quote(password, safe='') en Python, encodeURIComponent(password) en JavaScript. La RFC 3986 réserve ces caractères car ils séparent les parties d'une URL. Un @ non encodé dans un mot de passe, par exemple, fait lire au outil le reste du mot de passe comme hôte.

Seuls l'identifiant et le mot de passe en ont besoin. L'IP et le port ne contiennent jamais de caractères réservés. Dans la ligne IP:PORT:USERNAME:PASSWORD d'origine, rien n'est encodé : découpez-la donc seulement sur les trois premiers deux-points, car un mot de passe peut lui-même contenir :.

Puis-je convertir toute une liste d'un coup ?

Oui. Exportez votre liste en TXT depuis votre compte, puis lancez l'un des scripts ci-dessous. Chacun lit proxies.txt (ou le fichier que vous indiquez), découpe chaque ligne sur ses trois premiers deux-points, encode l'identifiant et affiche une URL HTTP et une URL socks5h:// par IP. Si votre compte indique un port SOCKS5 séparé, utilisez ce port dans l'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

Que contiennent les exports TXT et CSV ?

L'export TXT contient une ligne IP:PORT:USERNAME:PASSWORD par IP et rien d'autre, ce qui convient aux scripts et aux outils qui importent des listes de proxies. L'export CSV contient au minimum IP, port, identifiant, mot de passe, pays et date de fin, ce qui convient aux tableurs et à l'inventaire.

Avant de lire le CSV en code, ouvrez-le une fois et vérifiez la ligne d'en-tête pour les noms de colonnes exacts ; lisez les colonnes par nom, pas par position. Le csv.DictReader de Python le fait. Gardez les deux fichiers privés : ils contiennent vos mots de passe proxy. Si un fichier fuite, écrivez au support avec les IP concernées, jamais les mots de passe.

Quel format attend mon outil ?

La plupart des outils attendent soit la forme URL, soit des champs séparés :

• curl : -x http://USERNAME:PASSWORD@IP:PORT, ou -x http://IP:PORT -U USERNAME:PASSWORD.
• Python requests et aiohttp : la forme URL ; voir les exemples de code.
• Node.js (undici, https-proxy-agent) : la forme URL.
• Playwright et navigateurs : champs séparés : server, username, password.
• Frameworks de scraping et gestionnaires de proxies : souvent la ligne brute IP:PORT:USERNAME:PASSWORD ou USERNAME:PASSWORD@IP:PORT ; vérifiez leur écran d'import.

Avec la liste d'autorisation IP, tous les formats suppriment l'identifiant et le mot de passe : IP:PORT ou http://IP:PORT. Nom d'utilisateur et mot de passe, ou une liste d'IP autorisées (jusqu'à 10 IP).