Configurer un proxy sur Ubuntu et Debian, couche par couche
Par l'équipe d'ingénierie de ProxyV4 · Updated:
La configuration d'un proxy sur Ubuntu se compose en réalité de quatre étapes distinctes, car Linux ne possède aucun commutateur proxy global. Votre shell lit des variables d'environnement, APT utilise son propre répertoire de configuration, les services systemd lisent des fichiers drop-in d'unité et le bureau GNOME s'appuie sur gsettings. Ne configurez que les couches dont vous avez besoin ; les exemples ci-dessous s'appliquent à un proxy HTTP(S) ProxyV4 avec identifiant et mot de passe.
export 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
Configuration du proxy APT avec identifiant et mot de passe
Pour qu'apt utilise un proxy authentifié, créez /etc/apt/apt.conf.d/80proxy avec le nom d'utilisateur et le mot de passe dans l'URL du proxy. APT lit ce fichier à chaque exécution, avec ou sans sudo, et ignore les variables de votre shell :
sudo tee /etc/apt/apt.conf.d/80proxy > /dev/null << 'EOF'
Acquire::http::Proxy "http://USER:PASS@IP:PORT/";
Acquire::https::Proxy "http://USER:PASS@IP:PORT/";
EOF
sudo chmod 600 /etc/apt/apt.conf.d/80proxy
# check what APT will use, then try it
apt-config dump | grep -i proxy
sudo apt updateChaque ligne doit se terminer par un point-virgule, et un mot de passe contenant @, : ou # doit être encodé en pourcent (@ devient %40). Si apt update s'arrête ensuite sur 407 Proxy Authentication Required, les identifiants dans le fichier sont incorrects ; consultez la page sur l'erreur 407.
APT via un proxy SOCKS5
Les versions récentes d'APT (Ubuntu 18.04 et ultérieures) acceptent également une URL SOCKS5 pour ces mêmes clés, par exemple Acquire::http::Proxy "socks5h://USER:PASS@IP:PORT";. La commande doit être en mode SOCKS5 ou double mode, ce qui exclut les adresses IP du Vietnam (HTTP uniquement). Si votre version d'APT refuse ce schéma, utilisez le format HTTP ci-dessus.
Proxy pour une seule commande
Pour tester sans modifier la configuration, passez l'option en ligne de commande : sudo apt -o Acquire::http::Proxy="http://USER:PASS@IP:PORT/" update. Rien n'est enregistré.
Quel fichier contrôle quel programme
La plupart des signalements « mon proxy est ignoré » sous Linux proviennent d'une valeur correcte définie au mauvais endroit. Deux règles expliquent presque tous les cas : sudo supprime l'environnement utilisateur par défaut, et les services systemd ne lisent jamais ~/.bashrc.
| Couche | Emplacement | Lecteurs | Durée de validité |
|---|---|---|---|
| Shells de connexion | ~/.bashrc ou /etc/profile.d/proxy.sh | curl, wget, python, git, node | Chaque nouveau shell de connexion |
| Sessions PAM | /etc/environment | Toutes les sessions utilisateur | Persiste après redémarrage |
| APT | /etc/apt/apt.conf.d/80proxy | apt update, apt install | De façon permanente pour APT |
| Unités systemd | /etc/systemd/system/<svc>.service.d/proxy.conf | Démon Docker, vos propres services | Après daemon-reload et redémarrage |
Variables de shell pour curl, wget et les scripts
Définissez les variables en minuscules et en majuscules : curl et wget consultent http_proxy, tandis que d'autres environnements vérifient uniquement HTTP_PROXY. La liste no_proxy exclut le bouclage local et les plages privées du proxy.
# /etc/profile.d/proxy.sh - shells and CLI tools
sudo tee /etc/profile.d/proxy.sh > /dev/null << 'EOF'
export http_proxy="http://USER:PASS@IP:PORT"
export https_proxy="http://USER:PASS@IP:PORT"
export HTTP_PROXY="http://USER:PASS@IP:PORT"
export HTTPS_PROXY="http://USER:PASS@IP:PORT"
export no_proxy="localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"
export NO_PROXY="$no_proxy"
EOF
source /etc/profile.d/proxy.shEncodez également les caractères spéciaux du mot de passe en pourcent ici. APT utilise son propre fichier, décrit plus haut.
Services gérés par systemd
Un démon démarré par systemd ne voit que les variables déclarées dans son unité. Placez-les dans un fichier drop-in, rechargez et redémarrez le service. Le guide Docker détaille la configuration du démon Docker et des conteneurs.
# /etc/systemd/system/<svc>.service.d/proxy.conf
[Service]
Environment="HTTP_PROXY=http://USER:PASS@IP:PORT"
Environment="HTTPS_PROXY=http://USER:PASS@IP:PORT"
Environment="NO_PROXY=localhost,127.0.0.1"
sudo systemctl daemon-reload
sudo systemctl restart <svc>sudo, serveurs partagés et bureau
- sudo : exécutez
sudo -E curl ...pour conserver vos variables exportées, ou rendez cette règle permanente en ajoutantDefaults env_keep += "http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY"viasudo visudo. - Identifiants sur machines multi-utilisateurs : ces fichiers contiennent le mot de passe du proxy en texte brut. Verrouillez leurs accès, par exemple avec
sudo chmod 600 /etc/apt/apt.conf.d/80proxy. - Bureau GNOME : Paramètres → Réseau → Serveur mandataire → Manuel, ou
gsettings set org.gnome.system.proxy mode 'manual'avec les clés d'hôte et de port sousorg.gnome.system.proxy.http.
Tests et dépannage
Après avoir chargé le profil avec source, curl -s https://api.ipify.org doit afficher l'IP du proxy plutôt que l'adresse propre du serveur. Pour obtenir un rapport complet sur le pays et le propriétaire, collez l'IP dans Recherche d'IP. Les guides pour curl et Python requests présentent des solutions par commande si vous préférez ne pas router tout le shell via le proxy.
- `407 Proxy Authentication Required` : identifiants incorrects ou caractère spécial non encodé dans le mot de passe ; consultez la page sur l'erreur 407.
- apt fonctionne uniquement avec sudo -E : le fichier 80proxy est manquant ou contient une erreur de syntaxe (chaque ligne se termine par un point-virgule).
- Les connexions se figent : l'accès sortant vers le port du proxy est peut-être bloqué par le pare-feu du serveur ; vérifiez les causes liées au pare-feu.
Étape par étape
- 1
Créer un fichier proxy dédié pour APT
Puisque sudo apt update ignore les variables de votre shell, créez /etc/apt/apt.conf.d/80proxy avec Acquire::http::Proxy et Acquire::https::Proxy, puis vérifiez avec apt-config dump.
- 2
Écrire /etc/profile.d/proxy.sh
Exportez http_proxy, https_proxy et no_proxy en minuscules ainsi que HTTP_PROXY, HTTPS_PROXY et NO_PROXY en majuscules pour que tous les outils CLI les détectent.
- 3
Ajouter des drop-ins systemd selon les besoins
Pour chaque démon devant passer par le proxy, créez un drop-in proxy.conf avec les directives Environment, puis appliquez daemon-reload et redémarrez-le.
- 4
Confirmer l'IP de sortie
Exécutez
source /etc/profile.d/proxy.shpuiscurl -s https://api.ipify.org; l'adresse IP affichée doit être celle de votre proxy.
Foire aux questions
Faut-il vraiment définir à la fois http_proxy et HTTP_PROXY ?
Oui. Certains outils comme curl et wget lisent la variable en minuscules, d'autres uniquement en majuscules. Définir les deux évite tout comportement imprévisible.
Pourquoi sudo apt update n'utilise-t-il pas mon proxy ?
sudo réinitialise l'environnement sauf si l'option -E est fournie. Un fichier dans /etc/apt/apt.conf.d/ oblige APT à utiliser le proxy dans tous les cas.
Comment configurer le proxy dans l'interface graphique d'Ubuntu ?
Ouvrez Paramètres → Réseau → Proxy réseau et choisissez Manuel, ou configurez-le avec gsettings sous org.gnome.system.proxy.
Un proxy statique est-il utile sur un serveur Linux ?
Oui, lorsqu'une API distante ou un partenaire autorise votre IP sur une liste blanche. Une IPv4 dédiée conserve la même adresse tant qu'elle est renouvelée, garantissant l'accès permanent.
Sources
Proxys à IP fixe pour serveurs et scripts
HTTP(S) avec identifiant et mot de passe, bande passante illimitée sur IPv4 dédiée, et adresse identique à chaque renouvellement.
Comparer les tarifs