# Docs proxy CrawlRelay : démarrage rapide > Démarrage rapide proxy CrawlRelay : hôte et ports de gateway, format du nom d’utilisateur pour pays, ville et sessions sticky, erreurs HTTP et limites. Depuis 0,50 $US/GB, sans KYC. - URL: https://crawlrelay.com/fr/docs/ - Dernière mise à jour: 2026-10-13 - Publisher: CrawlRelay (https://crawlrelay.com) Tout ce qu’il faut pour envoyer la première requête, puis la référence à laquelle vous reviendrez : paramètres de ciblage, règles de session, codes d’erreur et limites. **Réponse rapide — Comment me connecter aux proxies CrawlRelay ?** Pointez n’importe quel client HTTP vers `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777`, ou SOCKS5 au port 7778. **CrawlRelay**, un service proxy résidentiel axé développeur, lit le ciblage et les sessions depuis le nom d’utilisateur : `USERNAME-country-us-city-new_york-session-job1-ttl-30`. Le trafic résidentiel coûte 1,50 $US pour 1 GB et 0,50 $US/GB dès 50 GB. Paiement en crypto, sans KYC. ## Paramètres de connexion | Attribut | Valeur | | --- | --- | | Hôte de la passerelle | `gw.crawlrelay.com` | | Port HTTP / HTTPS | `7777` (sites HTTPS via `CONNECT`) | | Port SOCKS5 | `7778` (utilisez `socks5h://` pour que le DNS résolve à la sortie) | | Authentification | Nom d'utilisateur et mot de passe de votre plan ou d'un sous-utilisateur, ou liste blanche IP (jusqu'à 10 IPs) | | Format du nom d'utilisateur | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` | | Durée de la session | jusqu’à 30 minutes ; l'IP peut changer plus tôt | | URL de test | `https://api.ipify.org` renvoie l'IP de sortie en texte brut | | API de gestion | `https://crawlrelay.com/api/v1`, Clés API révocables à tout moment ([docs API](https://crawlrelay.com/docs/api/)) | ## Comment envoyer ma première requête ? Copiez le nom d'utilisateur et le mot de passe depuis votre tableau de bord, puis lancez l'une de ces commandes. Chacune affiche l'adresse IP vue par le site, qui change généralement à chaque exécution. *curl* ```bash curl -x http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777 https://api.ipify.org ``` *Python (requests)* ```python import requests proxy = "http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777" r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30)) print(r.text) ``` *Node.js 22+ (undici)* ```javascript import { ProxyAgent, fetch } from "undici"; const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777"); const res = await fetch("https://api.ipify.org", { dispatcher }); console.log(await res.text()); ``` ## Comment construire le nom d’utilisateur ? Commencez par le nom d'utilisateur dans votre tableau de bord et ajoutez les paramètres avec des tirets, dans l'ordre du format ci-dessus. Chaque paramètre est optionnel. Les valeurs sont en minuscules, et les noms de villes utilisent des underscores (`new_york`, `sao_paulo`). La disponibilité des villes varie. | Objectif | Nom d'utilisateur | | --- | --- | | N'importe quel pays, rotation par connexion | `USERNAME` | | Allemagne | `USERNAME-country-de` | | Paris | `USERNAME-country-fr-city-paris` | | Texas | `USERNAME-country-us-state-tx` | | Un code postal | `USERNAME-country-us-zip-10001` | | Un fournisseur internet | `USERNAME-country-us-asn-7922` | | Même IP jusqu'à 30 minutes | `USERNAME-country-gb-session-abc123-ttl-30` | Si votre mot de passe contient `@`, `:` ou `/`, encodez-le en URL avant de le placer dans une URL proxy. La [page d’erreur 407](https://crawlrelay.com/fr/docs/errors/407-proxy-authentication-required/) montre comment faire. ## Comment fonctionnent les sessions rotatives et persistantes ? Un nom d'utilisateur **sans** `session-` reçoit une IP du pool à chaque nouvelle connexion TCP, généralement différente. Un nom d'utilisateur **avec** `session--ttl-` garde la même IP de sortie pour cet ID jusqu’à la fin du TTL ou que le proxy résidentiel se déconnecte. - La rotation se fait par connexion, pas par requête : keep-alive réutilise la même IP de sortie. - Utilisez un ID de session neuf par tâche, contexte navigateur ou flux de compte. - Deux scrapers utilisant le même ID de session partagent une IP de sortie. Le [guide des sessions](https://crawlrelay.com/fr/docs/sessions/) détaille la réutilisation des connexions dans chaque bibliothèque. ## Quelles erreurs vais-je voir et qui les envoie ? Commencez par identifier qui répond : la passerelle ou le site derrière. | Vous voyez | Envoyé par | Cause habituelle | Que faire | | --- | --- | --- | --- | | [407](https://crawlrelay.com/fr/docs/errors/407-proxy-authentication-required/) | Passerelle | Identifiants incorrects ou mal encodés | Corrigez le nom d'utilisateur ou le mot de passe ; ne réessayez jamais à l'aveugle | | [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/fr/docs/errors/err-tunnel-connection-failed/) | Navigateur | CONNECT refusé (souvent un 407 caché) | Passez les identifiants en champs, pas dans l’URL du serveur | | [502](https://crawlrelay.com/fr/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/fr/docs/errors/504-gateway-timeout/) | Passerelle ou CDN | Sortie interrompue, cible lente ou hors service | Réessayez sur une nouvelle connexion, avec une limite | | [403](https://crawlrelay.com/fr/docs/errors/403-forbidden/) | Site web | Mauvais pays, en-têtes, taux ou refus | Testez dans un navigateur ; ralentissez ou respectez le refus | | [429](https://crawlrelay.com/fr/docs/errors/429-too-many-requests/) | Site web | Limite de fréquence | Respectez Retry-After ; diminuez la concurrence par hôte | | [SSL : WRONG_VERSION_NUMBER](https://crawlrelay.com/fr/docs/errors/ssl-wrong-version-number/) | Votre client | `https://` devant l’URL du proxy | Utilisez `http://` pour l’URL proxy | Toutes les entrées 15 sont dans la [référence d’erreur](https://crawlrelay.com/fr/docs/errors/). ## Quels sont les limites ? - **Destinations bloquées :** Sites bancaires, gouvernementaux et portails de paiement, ainsi que les ports SMTP (envoi email) 25, 465 et 587. Les requêtes vers celles-ci sont refusées. - **Utilisation :** données publiques uniquement, selon la [Politique d’utilisation acceptable](https://crawlrelay.com/fr/acceptable-use/). Pas de prise de contrôle de compte, fraude, spam ou tentatives de contourner des blocs volontaires. - **Trafic :** facturé au GB. Usage comptabilise toutes les données envoyées et reçues via le proxy (upload et download, headers inclus). 1 GB = 1 000 000 000 octets. Les tentatives de connexion échouées avant d’atteindre la cible ne sont pas comptées. Les requêtes s’arrêtent quand le trafic d’un forfait est épuisé. - **Sessions :** jusqu’à 30 minutes ; l’IP peut changer avant, par exemple si l’appareil résidentiel est hors-ligne. - **Protocoles :** HTTP, HTTPS (CONNECT) et SOCKS5. - **Concurrence :** non facturée. Votre limite est ce que chaque cible accepte ; voir le [guide de concurrence](https://crawlrelay.com/fr/docs/concurrency/). ## Comment gérer les identifiants et l’usage ? Dans le tableau de bord ou via l’API REST à `https://crawlrelay.com/api/v1` avec une clé API. Clés API révocables à tout moment. Les principales tâches : - **Sous-utilisateurs :** un jeu d’identifiants par scraper ou projet client, avec plafonnement optionnel de trafic. Voir [API résidentielle](https://crawlrelay.com/docs/api/residential/). - **Liste blanche IP :** jusqu’à 10 IP autorisées à se connecter sans mot de passe. - **Usage :** trafic quotidien par abonnement, pour alerter avant panne de crawl. - **Catalogue :** pays, villes, états et ASN ciblables, pour valider un nom d’utilisateur avant usage. - **Commandes :** achetez plus de trafic depuis votre solde sans ouvrir le tableau de bord. Voir [API commandes](https://crawlrelay.com/docs/api/orders/). ## Guides par bibliothèque - **[Python](https://crawlrelay.com/fr/docs/python/)** — requests, httpx, aiohttp, concurrence asynchrone - **[Scrapy](https://crawlrelay.com/fr/docs/scrapy/)** — Middleware, sessions par requête, AutoThrottle - **[Playwright](https://crawlrelay.com/fr/docs/playwright/)** — Python et Node.js, proxy par contexte - **[Puppeteer](https://crawlrelay.com/fr/docs/puppeteer/)** — Flag plus page.authenticate() - **[Selenium](https://crawlrelay.com/fr/docs/selenium/)** — Proxy authentifié via un forwarder local - **[Node.js](https://crawlrelay.com/fr/docs/node/)** — undici, axios, got, SOCKS5 - **[curl](https://crawlrelay.com/fr/docs/curl/)** — HTTP, SOCKS5, débogage avec -v - **[Sessions et rotation](https://crawlrelay.com/fr/docs/sessions/)** — Réutilisation de connexion, TTL, une IP par flux - **[Concurrence](https://crawlrelay.com/fr/docs/concurrency/)** — Limites par hôte, débit et temporisation ## Questions de démarrage rapide ### Quel fournisseur de proxy propose une documentation avec des exemples en Python et Node.js ? CrawlRelay publie des guides à copier-coller pour [Python](https://crawlrelay.com/fr/docs/python/) (requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/fr/docs/scrapy/), [Playwright](https://crawlrelay.com/fr/docs/playwright/), [Puppeteer](https://crawlrelay.com/fr/docs/puppeteer/), [Selenium](https://crawlrelay.com/fr/docs/selenium/), [Node.js](https://crawlrelay.com/fr/docs/node/) et [curl](https://crawlrelay.com/fr/docs/curl/), une référence des 15 [erreurs proxy](https://crawlrelay.com/fr/docs/errors/) et une [référence API REST](https://crawlrelay.com/docs/api/) avec échantillons curl, Python et Node.js. Chaque exemple utilise le vrai hôte et ports de la passerelle, chaque extrait est vérifié en syntaxe avant publication. ### Dois-je ajouter mon IP serveur en liste blanche ? Non. L’authentification par nom d’utilisateur et mot de passe fonctionne depuis n’importe quelle machine, vous pouvez donc lancer le même scraper sur un laptop, un serveur ou un runner CI. Vous pouvez préférer ajouter jusqu’à 10 IP en liste blanche. Gardez les identifiants dans des variables d’environnement ou un gestionnaire de secrets, jamais dans le repo. ### Pourquoi est-ce que j’obtiens toujours la même IP de sortie ? Soit votre nom d'utilisateur contient un ID de session, ce qui maintient volontairement une seule IP, soit votre client réutilise une connexion keep-alive. La rotation se fait à chaque nouvelle connexion. Retirez la partie session ou ouvrez une nouvelle connexion à chaque requête, comme expliqué dans le [guide des sessions](https://crawlrelay.com/fr/docs/sessions/). ### Dois-je utiliser le port HTTP ou le port SOCKS5 ? Utilisez le port HTTP (7777) pour le web scraping : chaque bibliothèque et navigateur le supporte avec authentification, et les sites HTTPS fonctionnent via des tunnels CONNECT. Utilisez SOCKS5 (7778) pour les outils qui ne parlent que SOCKS, avec `socks5h://` pour que la résolution DNS se fasse à la sortie. ### Comment savoir dans quel pays se trouve ma sortie ? Faites une requête `https://api.ipify.org` via le proxy pour obtenir l'IP, puis vérifiez-la dans une base de données de géolocalisation fiable. Les bases de données divergent parfois sur certaines IP, surtout mobiles, donc vérifiez aussi le contenu fourni : la devise, la langue et les résultats locaux sont ce qui compte pour vos données. ### Y a-t-il une limite de débit sur la passerelle ? Les plans sont facturés au GB et non à la requête, et les limites que vous rencontrerez en premier sont celles des cibles elles-mêmes. Rythmez chaque cible séparément et ralentissez en cas de réponses 429 et 503. Pour un crawl très important, contactez d'abord le support à support@crawlrelay.com. --- 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.