Guide de configuration ProxyScrape : endpoints et votre première requête vérifiée
Un guide pas à pas adapté aux débutants qui vous mène d’un compte ProxyScrape vide à une requête proxy vérifiée : comment choisir un type de proxy et un protocole, construire une chaîne d’endpoint HTTP ou SOCKS5 correcte, la tester avec curl sur n’importe quel système d’exploitation de bureau, et l’appliquer à un navigateur
Aperçu
Ce guide est un parcours de configuration initiale pour ProxyScrape. Il vous mène d’un compte vide à une requête proxy vérifiée, et il explique les chaînes d’endpoint que vous réutiliserez dans vos scripts, profils de navigateur et paramètres d’application ultérieurs. Aucune expérience préalable des proxies n’est supposée.
À la fin de ce guide, vous serez capable de :
- Choisir entre proxies résidentiels, datacenter et mobiles, et entre HTTP et SOCKS5.
- Construire une chaîne d’endpoint valide à partir des détails de connexion de votre tableau de bord ProxyScrape.
- Confirmer que le trafic sort réellement via le proxy plutôt que via votre propre connexion.
- Appliquer le même endpoint à un navigateur de bureau sans casser HTTPS.
Avant de commencer
- Un forfait ProxyScrape actif. Les proxies résidentiels, datacenter et mobiles sont tous proposés, et la facturation est disponible à l’usage ou au forfait mensuel.
- Vos détails de connexion depuis le tableau de bord ProxyScrape : nom d’hôte du proxy, port, nom d’utilisateur et mot de passe. Ils diffèrent selon le produit, donc copiez-les plutôt que de les deviner.
curl, fourni avec Windows 10 et versions ultérieures, macOS et la plupart des distributions Linux.- Une cible de test. Les exemples utilisent les services publics d’écho d’IP
api.ipify.orgetipinfo.io, donc vous n’avez rien à héberger.
Choisir un type de proxy
| Votre tâche | Type de proxy | Pourquoi cela convient |
|---|---|---|
| Automatisation rapide depuis une machine fixe | Datacenter | Latence plus faible et connexions longue durée stables |
| Un site qui bloque les plages d’hébergement | Résidentiel | Les requêtes semblent provenir de connexions domestiques ordinaires |
| Tests d’application ou au niveau opérateur | Mobile | Les IP de sortie sont liées à des réseaux mobiles |
ProxyScrape annonce un pool de plus de 97 M d’IP. La disponibilité d’un pays ou d’une ville spécifique dépend du produit et du forfait que vous avez choisis, donc confirmez les options de ciblage dans le tableau de bord avant de concevoir un workflow autour d’elles.
Choisir un protocole
- HTTP/HTTPS : la prise en charge la plus large. Tous les navigateurs, la plupart des outils CLI et la plupart des bibliothèques l’acceptent. Les destinations HTTPS sont atteintes via un tunnel CONNECT.
- SOCKS5 : agnostique vis-à-vis du protocole, il transporte donc aussi du trafic TCP non HTTP. Choisissez-le quand un outil ne prend pas en charge le proxy HTTP, et utilisez la forme
socks5h://lorsque vous voulez que le proxy résolve les noms DNS au lieu de votre propre machine.
Formats d’endpoint
Chaque connexion proxy se résume à une chaîne de cette forme :
<scheme>://<username>:<password>@<proxy-host>:<port>
Concrètement :
http://<username>:<password>@<proxy-host>:<port>
socks5://<username>:<password>@<proxy-host>:<port>
socks5h://<username>:<password>@<proxy-host>:<port>
Deux détails piègent les gens :
- Pour les destinations HTTPS, vous écrivez normalement toujours
http://dans le schéma. curl ouvre un tunnel CONNECT et la poignée de main TLS se fait de bout en bout. N’utilisez un schémahttps://que si votre fournisseur vous donne explicitement un endpoint proxy protégé par TLS. - L’hôte et le port sont spécifiques au produit. Ne réutilisez jamais un port trouvé dans un article de blog ; copiez les deux valeurs depuis votre propre tableau de bord.
Étapes
Étape 1 : Récupérer vos identifiants
- Connectez-vous à votre compte ProxyScrape et ouvrez les détails de connexion du forfait que vous voulez utiliser.
- Notez le nom d’hôte du proxy et le port.
- Notez le nom d’utilisateur et le mot de passe, si votre forfait utilise l’authentification par nom d’utilisateur et mot de passe.
- Si votre forfait vous autorise plutôt par adresse IP, enregistrez l’IP publique de la machine qui enverra les requêtes dans le tableau de bord avant de tester.
Étape 2 : Construire la chaîne d’endpoint
- Remplacez les quatre valeurs dans le modèle.
- Gardez le
@entre les identifiants et l’hôte. - Encodez en pourcentage ces caractères s’ils apparaissent dans votre mot de passe :
@,:,/,?,#,%. Par exemple,p@ssdevientp%40ss.
http://<username>:<password>@<proxy-host>:<port>
Étape 3 : Stocker l’endpoint dans une variable d’environnement
Garder l’identifiant hors de vos commandes ponctuelles l’empêche de fuiter dans l’historique du shell, les journaux et les captures d’écran.
export PROXY_URL='http://<username>:<password>@<proxy-host>:<port>'
Étape 4 : Envoyer votre première requête
macOS et Linux
curl -x "$PROXY_URL" -sS https://api.ipify.org
Windows (PowerShell)
$env:PROXY_URL = 'http://<username>:<password>@<proxy-host>:<port>'
curl.exe -x $env:PROXY_URL -sS https://api.ipify.org
Dans PowerShell, curl est un alias pour Invoke-WebRequest, qui n’accepte pas les mêmes options. Appelez toujours curl.exe.
Étape 5 : Prouver que la requête passe par le proxy
Exécutez la même requête sans le proxy et comparez les réponses.
env -u ALL_PROXY -u HTTP_PROXY -u HTTPS_PROXY -u http_proxy -u https_proxy curl -sS https://api.ipify.org
Les deux IP doivent être différentes. Si elles correspondent, le proxy n’a jamais été utilisé : vérifiez le schéma, l’hôte et toute variable proxy globale qui pourrait remplacer votre paramètre.
Étape 6 : Confirmer la localisation et le réseau
curl -x "$PROXY_URL" -sS https://ipinfo.io/json
Vérifiez que ip appartient au proxy, que country et city correspondent au ciblage que vous avez sélectionné, et que org nomme le réseau proxy plutôt que votre propre fournisseur d’accès Internet. Pour SOCKS5 avec DNS distant :
curl -x 'socks5h://<username>:<password>@<proxy-host>:<port>' -sS https://api.ipify.org
Étape 7 : Appliquer l’endpoint à un navigateur
- Windows : Paramètres puis Réseau et Internet puis Proxy puis Configuration manuelle du proxy. Saisissez l’hôte et le port. Windows gère ici les destinations HTTP et HTTPS ; utilisez Firefox ou un client compatible SOCKS pour SOCKS5.
- macOS : Réglages Système puis Réseau puis votre connexion puis Détails puis Proxies. Activez Proxy web (HTTP) et Proxy web sécurisé (HTTPS), ou Proxy SOCKS pour SOCKS5, puis saisissez l’hôte et le port.
- Firefox (toutes les plateformes) : Paramètres puis Paramètres réseau puis Configuration manuelle du proxy. Firefox prend en charge SOCKS v5 nativement et propose une case à cocher pour proxyfier les résolutions DNS lors de l’utilisation de SOCKS v5, ce qui s’associe bien au comportement
socks5h. - Chrome et Edge : ils lisent le proxy du système d’exploitation sous Windows et macOS. L’option de ligne de commande
--proxy-serveraccepte un hôte et un port mais demande généralement les identifiants de manière interactive au lieu de les lire depuis l’URL.
Chargez un site HTTPS après avoir enregistré les paramètres, puis rechargez la page d’écho d’IP pour confirmer que le navigateur, et pas seulement curl, utilise le proxy.
Étape 8 : Gérer correctement les contrôles de session et de rotation
Si votre forfait expose des contrôles de session ou de rotation, ils sont généralement exprimés sous forme de segment supplémentaire dans le nom d’utilisateur, et la syntaxe exacte diffère selon le produit et le forfait. Copiez la valeur textuellement depuis le panneau des détails de connexion plutôt que de la deviner, car un segment de session incorrect est une cause fréquente d’échecs d’authentification.
Étape 9 : Garder les identifiants hors du contrôle de version
# .env - chargez-les à l’exécution, ne validez jamais le fichier
PROXY_URL='http://<username>:<password>@<proxy-host>:<port>'
# .gitignore
.env
Dépannage
| Symptôme | Cause probable | Correctif |
|---|---|---|
curl: (5) Could not resolve proxy |
Faute de frappe dans le nom d’hôte | Copiez à nouveau l’hôte depuis le tableau de bord |
curl: (7) Failed to connect to ... port |
Mauvais port, ou un port associé au mauvais protocole | Confirmez que le port appartient au produit et au protocole que vous avez sélectionnés |
407 Proxy Authentication Required |
Identifiants incorrects, ou segment de session inutile | Recollez le nom d’utilisateur et le mot de passe ; si votre forfait utilise l’autorisation par IP, vérifiez que votre IP publique est enregistrée |
| Les sites HTTP se chargent mais les sites HTTPS échouent | Le proxy n’a pas accepté le tunnel CONNECT, ou vous avez utilisé un mauvais port | Retestez avec curl -x "$PROXY_URL" -I https://example.com |
| Les requêtes SOCKS5 échouent sur les noms d’hôte | Le DNS est résolu localement | Passez de socks5:// à socks5h:// |
| Le site cible renvoie 403 ou 429 | La destination bloque cette plage d’IP, ou vous envoyez trop de requêtes | Passez des IP datacenter aux IP résidentielles ou mobiles, réduisez la concurrence et ajoutez des délais |
| curl fonctionne mais pas le navigateur | Le navigateur n’utilise pas le proxy système | Configurez le proxy dans l’application, ou utilisez Firefox avec des paramètres de proxy manuels |
Résumé
- Choisissez le type de proxy et le protocole adaptés à la tâche, puis copiez exactement l’hôte, le port et les identifiants depuis le tableau de bord ProxyScrape.
- Chaque connexion est une URL :
<scheme>://<username>:<password>@<proxy-host>:<port>. Utilisezsocks5h://lorsque vous voulez que le proxy résolve le DNS. - Validez avant de construire : envoyez une requête via le proxy et une requête directe, et confirmez que les IP diffèrent.
- Traitez les identifiants comme des secrets : variables d’environnement en local,
.envlisté dans.gitignore, jamais codés en dur dans un script partagé.