Guide de connexion proxy : méthodes de configuration SOCKS5/HTTP par langage et outil
Guide Socks5Proxy : configurer SOCKS5/HTTP avec Python requests, Node.js, cURL, Selenium, Puppeteer, Playwright et Scrapy (codes fonctionnels inclus).
Quelles informations sont nécessaires pour se connecter à un proxy ?
Chaque ligne proxy contient une IP, les ports HTTP/SOCKS5, un identifiant et un mot de passe. Consultez ou téléchargez la liste dans l'onglet 'Mes proxies' du dashboard, ou récupérez-la via l'API.
Tous les exemples de ce guide utilisent l'IP 198.51.100.23, le port HTTP 8000, le port SOCKS5 1080, l'identifiant spx_user et le mot de passe spx_pass. 198.51.100.0/24 est une plage réservée pour la documentation et ne se connecte pas réellement. Remplacez par les valeurs de votre liste de proxies.
Deux méthodes d'authentification : envoyer username et password ensemble, ou enregistrer jusqu'à 10 IPv4 de vos serveurs dans le dashboard pour se connecter avec juste ip:port (autorisation par IP). Pratique pour les outils (ex: arguments Chrome) qui ne gèrent pas les mots de passe.
| Article | Valeur exemple | Description |
|---|---|---|
| IP | 198.51.100.23 | Adresse du serveur proxy |
| Port HTTP | 8000 | Connexion HTTP et HTTPS(CONNECT) |
| Port SOCKS5 | 1080 | Connexion TCP SOCKS5 |
| Identifiant | spx_user | Authentification par identifiant/mot de passe |
| Mot de passe | spx_pass | Authentification par identifiant/mot de passe |
Comment se connecter, via HTTP ou SOCKS5 ?
La plupart des tâches de requêtes web et API peuvent être effectuées avec le port HTTP. Les adresses HTTPS sont également transmises de manière chiffrée via la méthode CONNECT, ce qui empêche le proxy de modifier le contenu.
SOCKS5 peut transmettre des connexions TCP non-HTTP et permettre la résolution DNS côté proxy. Avec Python (socks5h) ou cURL (--socks5-hostname), vos requêtes DNS ne seront pas exposées. Chaque IP dispose des deux ports - choisissez simplement le format pris en charge par votre outil.
Comment récupérer la liste via du code ?
Les clés API sont créées dans l'interface des clés API du dashboard et ne sont affichées qu'une seule fois, alors stockez-les dans un endroit sûr. Toutes les requêtes doivent inclure l'en-tête Authorization: Bearer. Le code ci-dessous est un exemple en Python pour obtenir une liste SOCKS5 au format user:pass@ip:port. Les guides suivants expliquent comment connecter cette liste à vos outils.
import requests
API = "https://socks5proxy.io/api/v1"
KEY = "YOUR_API_KEY"
# Download the proxy list as plain text, one proxy per line
r = requests.get(
API + "/proxies/download",
params={"format": "user:pass@ip:port", "protocol": "socks5"},
headers={"Authorization": "Bearer " + KEY},
timeout=30,
)
r.raise_for_status()
proxies = [line.strip() for line in r.text.splitlines() if line.strip()]
print(len(proxies), "proxies loaded")Par quel guide commencer ?
Choisissez un guide adapté à votre langage et outils. Tous les guides incluent des méthodes pour vérifier la connexion, résoudre les erreurs et répartir l'utilisation des IP.
- Python requests: connexion HTTP et SOCKS5 la plus simple et rotation des listes
- Node.js: ProxyAgent(HTTP) et socks-proxy-agent(SOCKS5) d'undici
- cURL : vérification des connexions et mesure des temps de réponse
- Selenium : Chrome avec autorisation par IP et configuration Firefox
- Puppeteer: --proxy-server et page.authenticate
- Playwright: proxy par navigateur et contexte
- Scrapy : meta proxy et middleware de rotation par requête
Quel format de liste choisir ?
Les outils acceptant différents formats, vous pouvez choisir le vôtre au téléchargement. La plupart des librairies prennent http://user:pass@ip:port ou socks5://user:pass@ip:port. Pour les outils demandant IP, port, identifiants séparément, utilisez ip:port:user:pass.
Si vous utilisez l'autorisation IP, choisissez le format ip:port. Pour coller dans des tableurs ou des documents de gestion, le format CSV est pratique. Vous pouvez obtenir des listes séparées pour HTTP et SOCKS5, avec des ports différents.
| Format | Exemple | Cas d'usage |
|---|---|---|
| ip:port:user:pass | 198.51.100.23:8000:spx_user:spx_pass | Écran de configuration divisé à Cannes |
| user:pass@ip:port | spx_user:spx_pass@198.51.100.23:8000 | Assemblage d'adresse dans le code |
| http://user:pass@ip:port | http://spx_user:spx_pass@198.51.100.23:8000 | requests, cURL, Scrapy |
| socks5://user:pass@ip:port | socks5://spx_user:spx_pass@198.51.100.23:1080 | Bibliothèque SOCKS5 |
| ip:port | 198.51.100.23:8000 | Autorisation IP, arguments d'exécution du navigateur |
| CSV | ip,http_port,socks_port,user,pass,country | Calculs de tableaux, documents de gestion |
Comment sécuriser les informations proxy ?
Ne stockez pas les identifiants proxy, mots de passe et clés API dans vos dépôts de code. Utilisez plutôt des variables d'environnement ou un gestionnaire de secrets. Si vous les avez accidentellement exposés, régénérez immédiatement une nouvelle clé API depuis le dashboard pour invalider l'ancienne.
Si votre serveur a une IP fixe, l'autorisation par IP est la méthode la plus sécurisée. Même si la liste fuit, les IP non enregistrées ne pourront pas se connecter. Vous pouvez ajouter jusqu'à 10 IP autorisées et les modifier à tout moment.
Si vous avez plusieurs membres dans votre équipe, il est plus facile de gérer les listes en les téléchargeant via l'API plutôt que de les partager dans un dossier. Les historiques de téléchargement permettent également de vérifier les problèmes.
Que vérifier en cas de problème de connexion ?
Commencez par tester avec cURL pour vérifier si le proxy répond. Une réponse 407 signifie que le nom d'utilisateur ou le mot de passe est incorrect. Si vous utilisez l'autorisation IP, vérifiez que l'IP du serveur envoyant la requête est dans la liste autorisée. Si le délai de connexion expire, vérifiez le port (par exemple, HTTP 8000, SOCKS5 1080).
Si le problème persiste, contactez le support via le tableau de bord. Indiquez la ligne utilisée, l'outil et le message d'erreur pour un diagnostic rapide.