Dépannage

Quelque chose ne fonctionne pas ? La plupart des problèmes correspondent à l’un des huit schémas ci-dessous. Trouvez le symptôme qui correspond, suivez le diagnostic, appliquez le correctif.

Connexion refusée ou délai d’attente dépassé sur la passerelle

Symptômes : Votre client signale « connection refused », « connection timed out », ou « no route to host » lors de l’appel à p.shifter.io:443.

Diagnostic :

1. Confirmez que vous pointez bien vers la nouvelle passerelle : p.shifter.io:443. Les plans hérités utilisent des sous-domaines par port comme apollo.p.shifter.io:<port>.
2. Vérifiez que votre IP source n’est pas derrière un pare-feu qui bloque le port 443 sortant.
3. Testez la connectivité brute : nc -vz p.shifter.io 443.

Correctif : Si la connectivité brute fonctionne mais que le proxy échoue, le problème vient de l’authentification. Voir la section 407 ci-dessous. Si la connectivité brute échoue, vérifiez les règles de pare-feu sortant et réessayez depuis un autre réseau.

HTTP 407 Proxy Authentication Required

Symptômes : Chaque requête renvoie 407 Proxy Authentication Required.

Diagnostic :

• Identifiants incorrects : faute de frappe dans le nom d’utilisateur ou le mot de passe.
• Indicateur inconnu : un code pays mal formé, un slug de ville ou une chaîne de session dans le nom d’utilisateur étendu.
• Mot de passe régénéré : l’ancien mot de passe n’est plus valide après une rotation dans le panel. Correctif :

1. Retirez tous les indicateurs et réessayez d’abord avec le simple nom d’utilisateur et mot de passe. Si cela fonctionne, réajoutez les indicateurs un par un.
2. Consultez shifter.io/panel dans la section Residential Proxies pour confirmer votre mot de passe.
3. Si vous avez récemment changé de mot de passe, déployez la nouvelle valeur sur tous les clients.

Temps de réponse lents depuis les IP résidentielles

Symptômes : Les requêtes prennent 5 à 10 secondes ou plus. Des IP auparavant rapides ont ralenti.

Diagnostic : Les IP résidentielles proviennent de véritables connexions ISP. Une certaine variation de latence est normale. Une lenteur persistante signifie généralement :

• L’utilisateur final de cette IP utilise intensivement la connexion (Netflix, envoi de fichiers volumineux).
• Le site cible limite le débit de l’IP.
• Le filtre de pool est trop restreint et vous obtenez des IP saturées.

Correctif :

• Effectuez une rotation plus agressive (abandonnez la session persistante ou raccourcissez ttl).
• Élargissez votre filtre (supprimez la ville, gardez uniquement le pays).
• Pour les proxies ISP : utilisez Managing IPs → Replace pour remplacer l’IP lente par une nouvelle.

La géolocalisation de l’IP ne correspond pas à ma cible

Symptômes : Vous avez demandé country-us-city-new_york et le site cible pense que vous êtes ailleurs.

Diagnostic :

• Les IP résidentielles sont géolocalisées par des bases de données tierces (MaxMind, IP2Location). Ces bases de données ne sont pas toujours cohérentes avec la propre source de géolocalisation du site cible.
• Les IP des opérateurs mobiles et les plages ISP nouvellement attribuées peuvent être mal classées pendant plusieurs semaines.

Correctif :

• Réessayez la requête. Shifter attribue une nouvelle IP à chaque requête (ou à chaque session persistante) et la suivante peut avoir une géolocalisation plus précise dans la base de données de la cible.
• Si vous avez besoin d’une géographie garantie pour une cible spécifique, contactez le support avec l’URL cible et la localisation souhaitée. Nous pouvons pré-valider des IP par rapport à cette cible.

Erreurs HTTPS, échecs SSL/TLS

Symptômes : SSL handshake failed, certificate verify failed, ou tls: bad record MAC.

Diagnostic :

• Vous utilisez une ancienne version d’OpenSSL ou de Node qui rejette la suite de chiffrement de la passerelle.
• La chaîne de confiance des proxies d’entreprise est rompue.

Correctif :

• Mettez à jour la bibliothèque TLS de votre client. Node 18+, Python requests 2.28+, curl 7.80+ sont connus pour fonctionner correctement.
• Épinglez le certificat de la passerelle pour contourner les problèmes de chaîne si votre environnement exige des hôtes stricts.
• Pour le débogage uniquement : curl --proxy-insecure désactive la vérification de certificat sur le segment proxy. Ne déployez jamais cet indicateur en production.

Le site cible me bloque toujours

Symptômes : Même en passant par des proxies résidentiels avec rotation, une cible spécifique renvoie des CAPTCHAs, des 403, ou des corps de réponse vides.

Diagnostic : La cible dispose d’un système anti-bot en couches (Cloudflare, Akamai, DataDome) qui effectue du fingerprinting au-delà de l’IP. Les signes révélateurs courants :

• Le User-Agent ne correspond pas à l’empreinte TLS (incohérence JA3/JA4).
• Les en-têtes sont envoyés dans un ordre différent de celui d’un vrai navigateur.
• Les API du navigateur (détection WebDriver, indicateur navigator.webdriver) révèlent l’automatisation.
• La rotation d’IP est trop agressive pour le modèle de session de la cible.

Correctif :

• Passez des proxies bruts à l’API de scraping web, qui inclut un mode furtif et la résolution de CAPTCHA.
• Ou bien : ouvrez un ticket avec l’URL cible. De nombreux cas peuvent être ajustés de notre côté.

L’API de scraping web renvoie 509 Bandwidth Limit Exceeded

Symptômes : L’API de scraping renvoie 509 alors qu’il vous reste des crédits sur votre plan.

Diagnostic : 509 signifie que le quota du plan est épuisé. Si vous avez encore des crédits sur le tableau de bord, vérifiez :

• Que vous utilisez la bonne clé API (pas celle d’un ancien plan).
• Que Extra Traffic est activé si vous souhaitez que le dépassement se convertisse en paiement à l’usage.

Correctif :

• Vérifiez que la clé correspond au plan actif dans Web Scraping API → API Keys.
• Activez Billing → Extra Traffic pour convertir automatiquement les dépassements en tarification au crédit.
• Passez à un plan supérieur si vous manquez régulièrement de crédits.

Le paiement a échoué ou l’abonnement ne s’est pas activé

Symptômes : Vous avez payé mais le plan apparaît comme inactif, ou le renouvellement a échoué silencieusement.

Diagnostic :

• L’émetteur de la carte a bloqué la transaction (fréquent avec les paiements internationaux sans carte présente).
• Carte expirée ou défi 3DS non complété.
• Paiement en cryptomonnaie pas encore confirmé (6 confirmations requises).

Correctif :

1. Vérifiez l’historique des transactions de la carte sur votre application bancaire. Si le paiement a été rejeté, réessayez avec une autre carte.
2. Pour les cryptomonnaies, les paiements sont détectés par le processeur après 6 confirmations sur la blockchain. Généralement 15 à 60 minutes pour BTC/ETH.
3. Si le paiement est passé mais que le plan est toujours inactif après 30 minutes, envoyez un e-mail à hi@shifter.io avec l’identifiant de la facture.

Astuce

Pour tout ce qui n’est pas couvert ici, démarrez un chat en direct depuis le panel ou envoyez un e-mail à hi@shifter.io. Indiquez : le produit, le plan, un horodatage, et un message d’erreur exact.

Voir aussi

• Facturation et tarification : remboursements, factures, moyens de paiement.
• Support : canaux de contact, SLA, page de statut.