proxytoo

Configurer un proxy : du nom d'utilisateur au scraper

Une fois que vous savez à quoi sert chaque partie du nom d'utilisateur, configurer un proxy dans n'importe quel outil prend quelques minutes. Cette page couvre la configuration outil par outil, la résolution des erreurs et la protection de votre jeton.

Obtenir un jeton et commencer

1. Créer un compte et enregistrer le jeton d'accès

Sur la page d'inscription, vous recevez un jeton d'accès. Il sert de mot de passe pour la connexion et pour le proxy. Le serveur ne le garde pas  enregistrez-le dans un fichier .txt.

Commencer

2. Recharger le solde

Choisissez un montant dans la zone de recharge du tableau de bord et envoyez la demande. La recharge commence à $30 et s'ajoute au solde une fois le paiement confirmé.

Voir les tarifs

3. Construire le nom d'utilisateur

Indiquez pays, ville et session dans le nom d'utilisateur pour fixer l'emplacement et la durée de l'IP. Choisissez-les dans la création des infos de connexion du tableau de bord et il est construit pour vous.

Exemples de nom d'utilisateur

Nouvelle IP par requête
user-country-us
Ciblage par ville
user-country-us-city-new_york
Garder la même IP
user-country-us-session-shop1
IP mobile
user-type-mobile-country-us

4. Tester la connexion

Envoyez une requête avec curl et regardez l'IP et le pays dans la réponse.

Format de connexion

HTTP

http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000

SOCKS5

socks5://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000

curl

curl -x http://gate.proxytoo.com:7000 -U "user-country-us:YOUR_TOKEN" https://ipinfo.io/json

5. L'ajouter à vos outils

Saisissez l'hôte, le nom d'utilisateur et le jeton dans Python, Node.js ou votre outil d'automatisation de navigateur.

Exemples de code

Python (requests)

import requests

proxy = "http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000"
res = requests.get("https://ipinfo.io/json",
                   proxies={"http": proxy, "https": proxy})
print(res.json())

Node.js (undici)

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000");
const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());

Puppeteer

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://gate.proxytoo.com:7000"],
});
const page = await browser.newPage();
await page.authenticate({ username: "user-country-us", password: "YOUR_TOKEN" });
await page.goto("https://ipinfo.io/json");

En cas d'erreur de connexion

  • 407 Proxy Authentication Required

    Le nom d'utilisateur ou le jeton ne correspond pas. Vérifiez que vous les avez collés tels quels, sans espace en trop.

  • Délai de connexion dépassé

    Si vous avez ciblé une ville, réessayez avec le pays seul. Vérifiez aussi si le pare-feu de votre entreprise bloque le port 7000.

  • Un site continue de bloquer

    Espacez davantage les requêtes et changez d'IP à chaque requête. Pour les sites très protégés, les proxys résidentiels sont le bon choix.

Comment lire un nom d'utilisateur de proxy ?

Pour configurer un proxy, commencez par le nom d'utilisateur : une courte chaîne de paramètres composée de parties reliées par des traits d'union. Il commence par user, puis ajoute des paires nom et valeur qui fixent la localisation de sortie et la durée de conservation de l'IP. Une fois ces parties connues, vous pouvez écrire n'importe quelle chaîne de connexion à la main sans ouvrir le tableau de bord.

Après country vient un code pays à deux lettres en minuscules. user-country-us signifie une IP américaine et user-country-jp une IP japonaise. Après city vient le nom de la ville en minuscules, les espaces remplacés par des tirets bas, comme dans user-country-us-city-new_york.

Après session vient un nom de session de votre choix. Avec user-country-jp-session-shop1, toutes les requêtes utilisant ce nom gardent la même IP jusqu'à 120 minutes. Ajoutez type-mobile, comme dans user-type-mobile-country-gb, pour sortir par une IP mobile.

Le champ mot de passe reçoit toujours votre jeton d'accès, qui commence par pt_. Pour changer de localisation ou de session, modifiez uniquement le nom d'utilisateur et laissez le jeton tel quel.

  • user marque le début des paramètres.
  • country suivi d'un code à deux lettres choisit le pays.
  • city suivi d'un nom avec tirets bas choisit la ville.
  • session suivi d'un nom conserve la même IP.
  • type-mobile choisit une IP mobile.

Proxy HTTP ou SOCKS5 : lequel utiliser ?

Les proxys HTTP sont le choix simple par défaut pour le web scraping et le travail dans le navigateur, tandis que les proxys SOCKS5 conviennent au trafic hors web ou aux configurations où le DNS doit être résolu côté proxy. ProxyToo accepte les deux sur une même passerelle, gate.proxytoo.com:7000. Gardez le même nom d'utilisateur et le même jeton et changez seulement le schéma au début de l'adresse.

Les proxys HTTP ont été conçus pour les requêtes web : presque toutes les bibliothèques et tous les navigateurs les comprennent d'emblée. Les sites HTTPS fonctionnent aussi, car le proxy ouvre un tunnel chiffré pour la connexion. Pour les outils web comme requests, Scrapy, Puppeteer et Playwright, commencez par le format HTTP.

SOCKS5 relaie la connexion elle-même et peut donc transporter de nombreux types de trafic au-delà du web. En Python, commencer l'adresse par socks5h fait résoudre les noms d'hôte par le proxy dans le pays de sortie, ce qui garde votre localisation cohérente. Les navigateurs basés sur Chromium gèrent mal SOCKS5 avec nom d'utilisateur : HTTP est donc le choix le plus fluide pour l'automatisation de navigateur.

  • HTTP pour le web scraping et l'automatisation de navigateur
  • SOCKS5 pour les programmes qui envoient du trafic hors web
  • Une adresse socks5h pour résoudre le DNS dans le pays du proxy
  • Le même nom d'utilisateur et le même jeton pour les deux

Comment ajouter un proxy à un navigateur ou à un navigateur antidétection ?

Dans un navigateur classique, ouvrez une extension de proxy et saisissez quatre valeurs dans des champs séparés : hôte, port, nom d'utilisateur et jeton. Choisissez le format host:port:user:pass dans Créer les identifiants de connexion du tableau de bord : les quatre valeurs tiennent sur une ligne, prêtes à être copiées champ par champ. Si une fenêtre d'authentification s'affiche au premier chargement, saisissez-y le nom d'utilisateur et le jeton.

Un navigateur antidétection donne à chaque profil son propre environnement : la règle de base est un nom d'utilisateur par profil. Dans le champ proxy du profil, choisissez HTTP ou SOCKS5, puis ajoutez une partie session au nom d'utilisateur avec un nom de session différent pour chaque profil. Chaque profil obtient alors sa propre IP, qui reste la même au sein de ce profil.

Alignez la langue, le fuseau horaire et la localisation du profil sur le pays choisi pour que les pages s'affichent comme pour un visiteur local. Pour un profil qui gère un même compte longtemps, les proxys ISP ou les proxys datacenter dédiés conservent la même IP pendant toute la durée. Commandez l'un ou l'autre dans Acheter des produits du tableau de bord en choisissant une quantité et une durée.

  • Un nom de session par profil
  • Langue et fuseau horaire alignés sur le pays de l'IP
  • Proxys ISP pour les profils de longue durée
  • Nom d'utilisateur et jeton dans la fenêtre d'authentification

Comment utiliser un proxy avec Python requests et Scrapy ?

En Python, écrivez le proxy sur une ligne de la forme http://username:token@gate.proxytoo.com:7000 et passez-la au paramètre proxy de la bibliothèque. Avec requests, l'étape clé consiste à mettre la même adresse dans les entrées http et https. En remplissant les deux, les requêtes HTTPS passent elles aussi par le proxy.

Définissez le proxy une fois sur un objet Session de requests et toutes les requêtes de cette session l'utilisent. Prenez un nom d'utilisateur avec le pays seul pour une nouvelle IP à chaque requête, et un nom d'utilisateur avec une partie session pour les parcours qui s'enchaînent, comme une connexion. Pour SOCKS5, installez l'extension SOCKS de requests et remplacez le début de l'adresse par socks5h.

Dans Scrapy, placez une adresse du même type dans la valeur proxy du meta de chaque requête : le middleware proxy intégré transforme le nom d'utilisateur et le jeton en en-tête d'authentification. Pour appliquer un même réglage à toutes les requêtes, écrivez un petit downloader middleware qui renseigne la valeur proxy. Pour répartir le trafic en sessions, faites attribuer par ce middleware un nom de session différent à chaque lot de requêtes.

Réglez la concurrence et le rythme avec des paramètres comme CONCURRENT_REQUESTS et DOWNLOAD_DELAY. Commencez bas, vérifiez que les réponses sont stables, puis augmentez progressivement pour équilibrer vitesse et taux de réussite. Les proxys résidentiels sont facturés au trafic utilisé : filtrer les images et les polices fait durer votre solde plus longtemps.

Comment configurer un proxy dans Node.js, Puppeteer et Playwright ?

En Node.js, l'approche habituelle consiste à créer un agent proxy et à le transmettre à votre bibliothèque de requêtes. Pour HTTP, utilisez un paquet comme https-proxy-agent ou le ProxyAgent d'undici, et pour SOCKS5 socks-proxy-agent, en passant une adresse qui contient le nom d'utilisateur et le jeton. Créez l'agent une seule fois et réutilisez-le entre les requêtes pour que les connexions soient réutilisées et restent rapides.

Avec Puppeteer, passez uniquement l'adresse de la passerelle dans l'argument de lancement --proxy-server, puis envoyez séparément le nom d'utilisateur et le jeton avec page.authenticate après l'ouverture d'une page. Cette séparation est la configuration la plus fiable dans Chrome. Pour changer de pays ou de session, le plus simple est de lancer un autre navigateur avec le nouveau nom d'utilisateur.

Avec Playwright, renseignez server, username et password dans l'option de lancement proxy et l'authentification se fait en une seule étape. Le champ password reçoit votre jeton d'accès. Vous pouvez aussi lancer un seul navigateur et donner à chaque contexte son propre proxy : en associant un nom de session à chaque contexte, un même script fait tourner plusieurs IP en parallèle.

L'automatisation de navigateur télécharge images, vidéos et polices sur chaque page, ce qui représente beaucoup de trafic. Bloquer les ressources inutiles par interception des requêtes réduit le coût des proxys résidentiels et mobiles, facturés au GB. Ajouter un nom de session garde l'IP stable pendant le chargement d'une page, pour un rendu propre.

Proxys rotatifs ou sessions persistantes : quel est le meilleur choix pour le scraping ?

Pour un scraping où chaque page est lue isolément, utilisez une nouvelle IP par requête, et pour les parcours qui s'enchaînent, comme une connexion ou un panier, utilisez une session. Sans partie session, l'IP change à chaque requête ; avec, l'IP reste la même sous ce nom. Un seul jeton gère les deux : vous choisissez à chaque étape de la tâche.

Le mode rotatif convient aux tâches où les pages n'ont aucun lien entre elles, comme les résultats de recherche, les listes de produits et les tableaux de prix. Les requêtes se répartissent uniformément sur de nombreuses IP et ressemblent, pour le site, au trafic ordinaire de nombreux visiteurs. Même pour de gros crawls d'un seul site, espacer les requêtes garde l'ensemble stable.

Avec les sessions, l'astuce est un nom de session distinct pour chaque unité de travail. Si vous vérifiez cinq comptes de boutique, nommez-les de shop1 à shop5 pour que chaque compte garde sa propre IP. Découper le travail en parcours courts qui se terminent dans la fenêtre de session conserve une seule IP pour tout le parcours.

Si vous avez besoin de la même IP pendant un mois entier, les proxys ISP ou les proxys datacenter dédiés sont les plus adaptés, et pour de gros volumes à faible prix unitaire, les proxys datacenter partagés ou les proxys IPv6 sont de bonnes options. Pour les tâches à fort trafic où le mélange de pays ne pose pas de problème, les proxys résidentiels illimités à $37.58 par jour rendent les coûts faciles à prévoir.

  • Nouvelle IP par requête pour les pages indépendantes
  • Un nom de session conservé pour la connexion et le paiement
  • Un nom de session différent par unité de travail
  • ISP ou datacenter dédié pour une même IP tout le mois

Comment vérifier l'IP de mon proxy et corriger les erreurs de connexion ?

La vérification la plus rapide consiste à envoyer une requête via le proxy vers une page qui affiche votre IP, puis à confirmer que l'IP et le pays correspondent au pays de votre nom d'utilisateur. Choisissez le format curl dans Créer les identifiants de connexion du tableau de bord : vous obtenez une commande de vérification prête à coller dans un terminal. Si vous avez défini une session, envoyez la même commande deux ou trois fois pour confirmer que l'IP reste la même.

Une réponse 407 signifie que le proxy n'a pas accepté vos identifiants, et cela tient généralement à un seul caractère dans le nom d'utilisateur ou le jeton. Vérifiez que le jeton commence par pt_, qu'aucun espace ni saut de ligne n'a été copié avec, et que le nom d'utilisateur commence par user. Si des caractères spéciaux se retrouvent dans l'adresse sur une ligne, les encoder en URL règle le problème.

Les réponses comme 403 ou 429 viennent du site : la connexion au proxy a fonctionné et le site surveille la vitesse ou les schémas des requêtes. Espacez les requêtes, envoyez des en-têtes de type navigateur et passez d'une session à une nouvelle IP par requête.

Les délais dépassés viennent souvent d'un réseau de bureau ou d'école qui bloque le port de la passerelle, d'un ciblage par ville trop étroit ou d'un délai trop court dans votre code. Essayez la même commande depuis un autre réseau, retirez la partie ville pour ne cibler que le pays et accordez un délai plus long à la requête. Vérifiez aussi qu'il vous reste du solde et, pour les produits par IP, que la commande affiche En cours d'utilisation dans Mes commandes.

  • 407 : vérifiez le nom d'utilisateur et le jeton
  • 403 ou 429 : ralentissez et changez d'IP
  • Délai dépassé : vérifiez le réseau, la ville et le délai
  • Lancez la même commande plusieurs fois pour tester une session

Comment protéger mon jeton d'accès aux proxys ?

Votre jeton d'accès est à la fois l'identifiant de votre compte et le mot de passe de vos proxys : quiconque le détient peut utiliser des proxys sur votre solde. Le serveur ne conserve qu'une empreinte du jeton, ce qui fait du fichier enregistré à l'inscription l'unique original. Gardez-en des copies à deux endroits et ajoutez-le à un gestionnaire de mots de passe pour qu'il reste en sécurité et facile à retrouver.

Ne mettez pas le jeton dans votre code : chargez-le depuis une variable d'environnement ou un fichier de configuration séparé. Ajoutez ce fichier à .gitignore pour qu'il reste hors de votre dépôt et, sur un serveur partagé, restreignez les droits du fichier pour que vous seul puissiez le lire. Vous pouvez ainsi partager votre code pendant que le jeton reste sur votre propre machine.

Surveillez aussi vos journaux et vos captures d'écran. Afficher l'adresse complète du proxy lors d'une erreur écrit le jeton directement dans le journal : masquez la partie jeton chaque fois que vous journalisez une adresse. Quand vous publiez une question ou une capture, montrez seulement le nom d'utilisateur et retirez d'abord le jeton.

  • Fichier du jeton conservé à deux endroits
  • Jeton chargé depuis une variable d'environnement
  • Fichier de configuration gardé hors du dépôt
  • Jeton masqué dans les journaux et les captures

Un usage responsable

  • Collectez des informations publiques et n'accédez jamais aux comptes d'autrui sans autorisation.
  • Espacez les requêtes pour ne pas surcharger les sites visités.
  • Les proxys ne peuvent pas servir au spam, à l'accès non autorisé ni à la fraude.

Pages liées

Obtenez un jeton et connectez-vous avec des IP du pays voulu

L'inscription ne demande qu'un jeton. Rechargez dès $30 et utilisez tous les types de proxys avec un seul solde.

Obtenir un jeton et commencer