Exécuter des conteneurs Docker derrière un proxy HTTP authentifié
Par l'équipe d'ingénierie de ProxyV4 · Updated:
La configuration d'un proxy Docker commence par une question : quel trafic doit passer par le proxy ? Docker dispose de trois chemins distincts (votre application à l'exécution, docker build et le démon qui télécharge les images), et chacun lit sa configuration proxy à un endroit différent. Configurez cela correctement, et chaque conteneur d'un même hôte pourra sortir via sa propre adresse IPv4 ProxyV4 sans modifier la table de routage de l'hôte.
ENV HTTP_PROXY=http://user:pass@ip:port HTTPS_PROXY=http://user:pass@ip:port- 1 IP1,85 $US
- 3+ IP1,70 $US
- 10+ IP1,60 $US
- 25+ IP1,50 $US
- 50+ IP1,40 $US
- 100+ IP1,30 $US
- 200+ IP1,20 $US
- 500+ IP1,10 $US
- 1 IP1,85 $US
- 3+ IP1,70 $US
- 10+ IP1,60 $US
- 25+ IP1,50 $US
- 50+ IP1,40 $US
- 100+ IP1,30 $US
- 200+ IP1,20 $US
- 500+ IP1,10 $US
Les trois emplacements où Docker lit la configuration proxy
Définir une variable dans un périmètre n'a aucun effet sur les deux autres. Une surprise fréquente est d'avoir un docker pull fonctionnel alors que l'application dans le conteneur sort toujours avec l'IP de l'hôte, ou inversement.
| Trafic | Emplacement de configuration | Contenu type |
|---|---|---|
| Votre application dans un conteneur en cours d'exécution | docker run -e HTTP_PROXY=... ou le bloc environment: dans Compose | Requêtes de scraping, appels d'API, tâches d'automatisation |
Commandes pendant docker build | --build-arg HTTP_PROXY=http://user:pass@ip:port | Téléchargements apt, pip et npm dans les étapes RUN |
| Le démon Docker lui-même | /etc/systemd/system/docker.service.d/http-proxy.conf | docker pull et docker push vers les registres |
Une adresse IP par conteneur
Comme les variables d'exécution se trouvent dans l'environnement de chaque conteneur, un seul VPS peut exécuter, par exemple, dix workers ayant chacun une valeur http://user:pass@ip:port distincte. Chaque worker présente ainsi sa propre adresse de sortie aux sites consultés, et comme une adresse IPv4 privée ProxyV4 n'est louée qu'à un seul client, aucun autre trafic ne partage cette adresse.
Conservez un fichier .env par service, ou un service Compose par proxy, afin de visualiser immédiatement quelle IP est attribuée à quelle tâche. Lors du renouvellement, vous pouvez conserver les mêmes adresses, ce qui évite toute modification de ces fichiers.
Variables pour assurer le bon fonctionnement de la stack
Si docker pull se fait toujours en direct ou si un conteneur ne parvient pas à joindre sa propre base de données après ces modifications, la page le proxy ne fonctionne pas passe en revue chaque couche Docker dans l'ordre.
- Définissez les noms en majuscules (
HTTP_PROXY,HTTPS_PROXY,NO_PROXY) et en minuscules (http_proxy,https_proxy,no_proxy) ; les différents outils et runtimes ne recherchent pas tous la même casse - Indiquez chaque nom de service Compose appelé par votre application dans
NO_PROXY, par exempleNO_PROXY=localhost,127.0.0.1,redis,postgres, afin que le trafic de la base de données et du cache reste sur le réseau bridge au lieu d'être envoyé vers le proxy - Utilisez également le schéma
http://pourHTTPS_PROXY; le client ouvre un tunnel CONNECT et les sites HTTPS restent chiffrés - N'écrivez pas les mots de passe du proxy dans un
DockerfileavecENV: ils se retrouveraient dans les couches de l'image. Injectez-les à l'exécution depuis un fichier.envou le fichier Compose
Étape par étape
- 1
Convertir la ligne de commande en URL de proxy
Votre commande ProxyV4 indique
ip:port:user:pass; réécrivez-la sous la formehttp://user:pass@ip:port, manuellement ou à l'aide du convertisseur de format de proxy. - 2
Ajouter les variables au service
Dans
docker-compose.yml, sous la sectionenvironment:du service, définissezHTTP_PROXY,HTTPS_PROXY,http_proxy,https_proxyetNO_PROXY=localhost,127.0.0.1,redis,db. - 3
Recréer le conteneur
Les modifications d'environnement ne s'appliquent qu'aux nouveaux conteneurs : exécutez donc
docker compose up -dpour recréer le service. - 4
Vérifier l'IP de sortie depuis l'intérieur
Exécutez
docker exec -it <container> curl -s https://proxyv4.com/api/my-ip. L'adresse renvoyée doit correspondre à l'IP du proxy, et non à celle de l'hôte.
Foire aux questions
Après avoir ajouté HTTP_PROXY, mon application ne peut plus joindre Redis ou Postgres. Pourquoi ?
Le client HTTP envoie désormais les requêtes destinées à redis ou db au proxy externe, qui ne peut pas résoudre ces noms internes. Déclarez-les dans NO_PROXY (et no_proxy), par exemple NO_PROXY=localhost,127.0.0.1,redis,db, puis recréez le conteneur.
Chaque conteneur d'un même serveur peut-il utiliser un proxy différent ?
Oui. Attribuez à chaque service, ou à chaque fichier .env, sa propre valeur http://user:pass@ip:port. Les conteneurs partagent le même hôte mais accèdent à Internet via des IP distinctes.
Pourquoi définir les variables de proxy en double, en majuscules et minuscules ?
Il n'existe pas de standard unique. Les outils reposant sur libcurl lisent http_proxy et https_proxy en minuscules, tandis que de nombreux outils Go et Node lisent les variables en majuscules. Définir les deux couvre l'ensemble des cas dans l'image.
docker pull utilise-t-il les variables définies dans Compose ?
Non. Les téléchargements sont effectués par le démon, qui lit sa configuration proxy dans le fichier drop-in systemd /etc/systemd/system/docker.service.d/http-proxy.conf, et non dans l'environnement des conteneurs.
Sources
Une IPv4 privée distincte pour chaque conteneur
IPv4 privées illimitées dans 7 pays, plus des adresses ISP statiques aux États-Unis et au Vietnam, délivrées automatiquement après paiement. Aucune commande minimale.
Consulter les tarifs en direct pour Singapour