Référence d’erreur proxy · Erreurs de connexion et TLS

Erreurs proxy SOCKS5 : codes de réponse, support manquant et DNS

Q: Quelle est la différence entre socks5:// et socks5h:// ?

Avec socks5://, votre client résout lui-même le nom d'hôte en une adresse IP et envoie l'IP au proxy. Avec socks5h://, il envoie le nom d'hôte, et le proxy le résout. Utilisez socks5h:// pour le scraping : la résolution DNS se fait alors à la sortie, ce qui vous donne les mêmes réponses régionales que les visiteurs locaux.

Erreur de protocole ou client SOCKS5 : message exact dans chaque outil, causes probables par ordre, et solution efficace.

Dernière mise à jour: 13 octobre 2026 · 5 min de lecture

Réponse rapide

Que signifie SOCKS5 proxy errors avec un proxy ?

Les erreurs SOCKS5 sont de trois types : votre client manque de support SOCKS, le serveur a rejeté votre identifiant et mot de passe, ou le serveur n’a pas atteint la cible et a renvoyé un code. Avec CrawlRelay, installez d'abord le support SOCKS (pour Python requests : requests[socks]), utilisez le port SOCKS5, et préférez socks5h:// pour que la résolution DNS se fasse à la sortie, pas chez vous.

SOCKS5 proxy errors en un coup d'œil

Erreur	SOCKS5 proxy errors
Type	Erreur de protocole ou client SOCKS5
Envoyé par	Le serveur SOCKS5 (codes de réponse) ou votre bibliothèque cliente (support manquant)
Défini dans	SOCKS5: RFC 1928; username/password authentication: RFC 1929
Réessayer ?	Selon le code de réponse
Vérification initiale	Confirmez que le client supporte SOCKS5 avec authentification, puis lisez le code de réponse

Que signifie SOCKS5 proxy errors ?

SOCKS5, défini par la RFC 1928, relaie les connexions TCP sans lire HTTP. L’authentification par identifiant et mot de passe est un échange séparé défini par la RFC 1929. Après authentification, le client demande une connexion à un hôte et port, et le serveur répond par un code 1 octet.

La réponse 0x00 signifie succès. Les codes 0x01 à 0x08 décrivent des échecs, d’un échec général à un type d’adresse non supporté. Les clients traduisent ces codes en messages propres.

À quoi ressemble a SOCKS5 error en Python, curl, Node.js et navigateurs ?

La même erreur s'affiche différemment selon chaque outil. Voici les messages à rechercher dans vos logs :

Python requests sans PySocks : InvalidSchema: Missing dependencies for SOCKS support.
curl, identifiants rejetés : curl: (97) User was rejected by the SOCKS5 server
Réponse 0x01 : « échec général du serveur SOCKS »
Réponse 0x04 / 0x05 : « Hôte inaccessible » / « Connexion refusée » par la cible
Réponse 0x08 : « Type d’adresse non supporté »

Quelles sont les causes de a SOCKS5 error ?

Probablement en premier lieu :

Support SOCKS non installé dans la bibliothèque cliente.
Identifiants incorrects ou non encodés URL.
Port HTTP utilisé pour SOCKS, ou port SOCKS utilisé pour HTTP.
Une cible refusée ou inaccessible depuis la sortie.
DNS local avec socks5:// : le client résout le nom lui-même, ce qui peut échouer ou retourner une mauvaise adresse régionale.

Comment diagnostiquer a SOCKS5 error étape par étape ?

Confirmez le support SOCKS : en Python, pip show pysocks ; dans Node.js, un package agent SOCKS.
Faites le test curl ci-dessous sur le port SOCKS5 avec --socks5-hostname.
Lisez le code ou message de réponse.
Comparez socks5:// et socks5h:// pour la même cible.

Tester l'URL en échec avec curl (port HTTP, mode verbeux)

# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:[email protected]:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL

Comment résoudre a SOCKS5 error ?

Installez le support : pip install "requests[socks]" ; dans Node.js, utilisez un agent proxy SOCKS.
Utilisez le port SOCKS5 pour les URL socks5h:// et le port HTTP pour les URL http://.
Préférez socks5h:// pour que la sortie fasse la résolution DNS, ce qui correspond à ce que voient les visiteurs locaux.
Pour les réponses 0x04 ou 0x05, testez la cible sans proxy ; elle peut être hors ligne ou refuser.
Pour les navigateurs, utilisez le port HTTP : Chromium ne supporte pas l’authentification SOCKS5.

Python requests via SOCKS5 (pip install "requests[socks]")

import requests

# socks5h:// sends the hostname to the proxy, so DNS resolves at the exit
proxy = "socks5h://USERNAME:[email protected]:7778"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.status_code, r.text)

Dois-je réessayer après a SOCKS5 error ?

Retentez uniquement les échecs côté cible, comme hôte inaccessible ou connexion refusée, et seulement une fois sur une nouvelle sortie. Les erreurs d’authentification et l’absence de support client se répètent jusqu’à correction de la configuration.

Quelle est l'incidence de SOCKS5 proxy errors sur CrawlRelay ?

CrawlRelay propose SOCKS5 sur son propre port, indiqué ci-dessous, avec le même format d’identifiant et le même mot de passe que le port HTTP. Le ciblage et les sessions fonctionnent de la même façon sur les deux ports.

Passerelle : gw.crawlrelay.com, port 7777 (HTTP, HTTPS via CONNECT) et port 7778 (SOCKS5). Format du nom d'utilisateur : USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}. Voir aussi : Impossible de se connecter au proxy · guide curl · guide Python .

SOCKS5 proxy errors : questions fréquentes des développeurs

Quelle est la différence entre socks5:// et socks5h:// ?

Avec socks5://, votre client résout lui-même le nom d'hôte en une adresse IP et envoie l'IP au proxy. Avec socks5h://, il envoie le nom d'hôte, et le proxy le résout. Utilisez socks5h:// pour le scraping : la résolution DNS se fait alors à la sortie, ce qui vous donne les mêmes réponses régionales que les visiteurs locaux.

Dois-je utiliser des proxies SOCKS5 ou HTTP pour le scraping ?

Pour les pages web, les deux fonctionnent, et les proxies HTTP sont plus simples : toutes les bibliothèques HTTP et navigateurs les supportent avec authentification. Utilisez SOCKS5 pour les protocoles non-HTTP ou pour des outils qui ne parlent que SOCKS. Les navigateurs basés sur Chromium ne peuvent pas s’authentifier auprès de SOCKS5, utilisez donc le port HTTP dans ce cas.

Pourquoi curl affiche-t-il 'L'utilisateur a été rejeté par le serveur SOCKS5' ?

Le serveur SOCKS5 a refusé l’échange du nom d’utilisateur et du mot de passe. Vérifiez les identifiants, encodez en URL les caractères spéciaux et confirmez que vous utilisez le port SOCKS5. Les mêmes identifiants doivent fonctionner sur le port HTTP si le compte est actif.

Autres erreurs de proxy dans cette référence

Codes d'état HTTP

Erreurs du navigateur et du client

Erreurs de connexion et TLS

Proxies résidentiels avec documentation couvrant les cas de défaillance

Proxies résidentiels CrawlRelay de 0,50 $US/GB, trafic sans expiration.

Voir les tarifs Démarrage rapide