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

> Explications des erreurs SOCKS5 : absence de support SOCKS dans requests, erreur curl 97, codes de réponse 0x01 à 0x08, et socks5 vs socks5h DNS. Avec solutions.

- URL: https://crawlrelay.com/fr/docs/errors/socks5-proxy-errors/
- Dernière mise à jour: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

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

**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

| Attribut | Valeur |
| --- | --- |
| 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 ?

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

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

```bash
# 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:PASSWORD@gw.crawlrelay.com: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]")*

```python
import requests

# socks5h:// sends the hostname to the proxy, so DNS resolves at the exit
proxy = "socks5h://USERNAME:PASSWORD@gw.crawlrelay.com: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 ](https://crawlrelay.com/fr/docs/errors/cannot-connect-to-proxy/) · [guide curl ](https://crawlrelay.com/fr/docs/curl/) · [guide Python ](https://crawlrelay.com/fr/docs/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

- [401 Unauthorized vs 407](https://crawlrelay.com/fr/docs/errors/401-unauthorized/)
- [403 Forbidden](https://crawlrelay.com/fr/docs/errors/403-forbidden/)
- [407 Proxy Authentication Required](https://crawlrelay.com/fr/docs/errors/407-proxy-authentication-required/)
- [429 Too Many Requests](https://crawlrelay.com/fr/docs/errors/429-too-many-requests/)
- [502 Bad Gateway](https://crawlrelay.com/fr/docs/errors/502-bad-gateway/)
- [503 Service Unavailable](https://crawlrelay.com/fr/docs/errors/503-service-unavailable/)
- [504 Gateway Timeout](https://crawlrelay.com/fr/docs/errors/504-gateway-timeout/)
- [Cannot connect to proxy (ProxyError)](https://crawlrelay.com/fr/docs/errors/cannot-connect-to-proxy/)
- [Connection reset by peer (ECONNRESET)](https://crawlrelay.com/fr/docs/errors/connection-reset/)
- [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/fr/docs/errors/err-proxy-connection-failed/)
- [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/fr/docs/errors/err-tunnel-connection-failed/)
- [Read timed out (ReadTimeout)](https://crawlrelay.com/fr/docs/errors/read-timeout/)
- [SOCKS5 proxy errors](https://crawlrelay.com/fr/docs/errors/socks5-proxy-errors/)
- [SSL: CERTIFICATE_VERIFY_FAILED](https://crawlrelay.com/fr/docs/errors/ssl-certificate-verify-failed/)
- [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/fr/docs/errors/ssl-wrong-version-number/)

**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](https://crawlrelay.com/fr/pricing/) · [Démarrage rapide](https://crawlrelay.com/fr/docs/)

---

CrawlRelay: CrawlRelay est un service de proxy résidentiel rotatif et proxy mobile 4G/5G pour développeurs, adapté aux scrapers et pipelines de données IA : trafic prépayé sans expiration à partir de 0,50 $US/GB, paiement en crypto, sans téléchargement d’ID. Sans KYC — pas d’ID, pas de selfie, pas de documents. Payer en crypto.