Configuration des proxy dans PyCharm, IntelliJ IDEA et WebStorm : guide complet pour les développeurs

```html

Si les plugins dans les IDE JetBrains ne s'installent pas, Maven ou pip ne peuvent pas télécharger les dépendances, et le Marketplace ne s'ouvre tout simplement pas — il y a probablement un problème de restrictions réseau. Un proxy résout cela en quelques minutes. Dans cet article, nous examinerons toutes les méthodes de configuration : via l'interface intégrée de l'IDE, via des variables système et via des fichiers de configuration — pour PyCharm, IntelliJ IDEA, WebStorm, GoLand et d'autres produits JetBrains.

Pourquoi un proxy est-il nécessaire pour un développeur dans un IDE

Les IDE JetBrains accèdent activement au réseau : ils téléchargent des plugins depuis le Marketplace, mettent à jour les index, récupèrent des dépendances via Maven Central, PyPI, npm et d'autres dépôts, vérifient les licences, synchronisent les paramètres via le compte JetBrains. Si l'une de ces requêtes est bloquée, le travail ralentit ou s'arrête complètement.

Voici des situations concrètes où un proxy est indispensable :

• Réseau d'entreprise avec pare-feu. De nombreuses entreprises ne laissent passer le trafic externe que via un serveur proxy d'entreprise. Sans sa configuration dans l'IDE, les plugins ne s'installeront pas et les dépendances ne seront pas téléchargées.
• Géoblocages. Certaines dépôts et CDN sont limités géographiquement. Un proxy avec la localisation appropriée supprime cette restriction.
• Travail depuis un pays avec un internet limité. JetBrains Marketplace, GitHub Packages, Maven Central peuvent être inaccessibles directement.
• Développement et test d'applications réseau. Il est nécessaire de diriger le trafic de l'IDE via un nœud spécifique pour vérifier le comportement de l'application depuis une autre région.
• Sécurité dans les réseaux publics. Lors du travail depuis un café ou un espace de coworking, un proxy chiffre le trafic de l'IDE et protège les tokens et clés contre l'interception.
• Contourner les restrictions de sanctions. Après 2022, plusieurs dépôts externes et services ont introduit des restrictions par IP — un proxy permet de continuer à travailler sans changer d'outils.

Contrairement à un navigateur, où le proxy est configuré une fois et fonctionne globalement, dans les IDE JetBrains, le proxy doit être configuré séparément — et parfois à plusieurs endroits : dans l'IDE lui-même, dans le gestionnaire de dépendances et dans l'interpréteur de langage. Examinons chaque niveau dans l'ordre.

Quel type de proxy choisir pour JetBrains

Les IDE JetBrains prennent en charge trois types de proxy : HTTP, HTTPS et SOCKS5. Pour la plupart des tâches des développeurs, les proxies HTTP/HTTPS conviendront — ils fonctionnent de manière transparente avec toutes les requêtes de l'IDE, Maven, Gradle et pip. SOCKS5 offre plus de flexibilité et fonctionne au niveau TCP, ce qui est utile pour des protocoles non standards.

Type de proxy	Support dans l'IDE	Convient pour	Caractéristiques
HTTP/HTTPS	✅ Natif	Plugins, dépendances, licence	Le plus facile à configurer
SOCKS5	✅ Natif	Toute connexion TCP	Supporte l'authentification
Fichier PAC	✅ Via les paramètres système	Réseaux d'entreprise	Routage flexible
Proxy système	✅ Auto-détection	Quand déjà configuré dans l'OS	Ne nécessite pas de configurations supplémentaires

Si vous travaillez avec un proxy d'entreprise, il est probable qu'il soit HTTP/HTTPS avec une authentification par nom d'utilisateur et mot de passe. Si vous connectez un service proxy externe pour contourner les blocages, faites attention aux proxies de centres de données — ils offrent une vitesse élevée et une stabilité de connexion, ce qui est critique lors du téléchargement de grandes dépendances et index.

Configuration du proxy via l'interface de l'IDE (HTTP/HTTPS)

C'est la méthode la plus simple et recommandée. Les paramètres s'appliquent à toutes les requêtes réseau de l'IDE : Marketplace, mises à jour, vérification de licence, synchronisation des plugins. L'instruction est identique pour PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider, CLion et d'autres produits de la gamme.

Étape 1. Ouvrez les paramètres de l'IDE

Sur Windows et Linux : File → Settings (ou Ctrl+Alt+S).
Sur macOS : PyCharm → Preferences (ou Cmd+,).

Étape 2. Trouvez la section proxy

Dans le panneau de gauche des paramètres, allez à : Appearance & Behavior → System Settings → HTTP Proxy. Ou commencez simplement à taper le mot proxy dans la barre de recherche des paramètres — l'IDE affichera immédiatement la section requise.

Étape 3. Sélectionnez le type de proxy et remplissez les informations

Dans la section HTTP Proxy, vous verrez trois options :

• No proxy — connexion directe (par défaut).
• Auto-detect proxy settings — l'IDE prendra les paramètres du système d'exploitation.
• Manual proxy configuration — configuration manuelle. Sélectionnez cette option.

En choisissant Manual proxy configuration, remplissez les champs :

• Host name — adresse IP ou domaine du serveur proxy. Par exemple : proxy.example.com ou 192.168.1.100.
• Port number — port du proxy. Valeurs standards : 8080, 3128, 8888.
• No proxy for — hôtes qui doivent être accessibles directement (sans proxy). On ajoute généralement localhost, 127.0.0.1, domaines internes de l'entreprise.
• Proxy authentication — si le proxy nécessite un nom d'utilisateur et un mot de passe, cochez la case et entrez les informations d'identification.

Étape 4. Vérifiez la connexion

Cliquez sur le bouton Check connection et entrez n'importe quelle URL — par exemple, https://plugins.jetbrains.com. Si tout est configuré correctement, l'IDE affichera le statut Connection successful. Ensuite, cliquez sur OK et redémarrez l'IDE.

Configuration d'un proxy SOCKS5 dans les IDE JetBrains

SOCKS5 est un protocole plus flexible qui fonctionne non seulement avec HTTP/HTTPS, mais aussi avec toutes les connexions TCP. Cela est utile si votre fournisseur de proxy propose SOCKS5, ou si vous utilisez un tunnel SSH.

Dans l'interface des IDE JetBrains, la section SOCKS se trouve au même endroit : Appearance & Behavior → System Settings → HTTP Proxy. Dans le bloc Manual proxy configuration, changez le bouton radio de HTTP à SOCKS.

Remplissez les champs de la même manière que pour le proxy HTTP :

• Host name — adresse du serveur SOCKS5.
• Port number — port (généralement 1080 ou 1081).
• Proxy authentication — nom d'utilisateur et mot de passe, si nécessaires.

Un point important : le client SOCKS intégré des IDE JetBrains fonctionne au niveau de la JVM et intercepte uniquement les connexions que l'IDE établit directement via Java. Les processus externes — Maven Wrapper, Gradle Daemon, pip, npm — sont lancés comme des processus distincts et ne héritent pas des paramètres proxy de l'interface de l'IDE. Pour eux, une configuration séparée est nécessaire (voir les sections ci-dessous).

Configuration via les paramètres JVM (vmoptions)

Si les paramètres via l'interface ne fonctionnent pas (par exemple, dans certaines versions de l'IDE ou lors de l'utilisation de plugins non standards), vous pouvez définir le proxy directement via les paramètres JVM. C'est une méthode fiable de bas niveau qui s'applique à toutes les connexions JVM.

Comment ouvrir le fichier vmoptions

Dans le menu de l'IDE, allez à : Help → Edit Custom VM Options.... Le fichier pycharm64.vmoptions (ou idea64.vmoptions pour IntelliJ IDEA) s'ouvrira dans le répertoire des paramètres utilisateur.

Ajoutez les lignes suivantes à la fin du fichier pour un proxy HTTP :

-Dhttp.proxyHost=your.proxy.host
-Dhttp.proxyPort=8080
-Dhttps.proxyHost=your.proxy.host
-Dhttps.proxyPort=8080
-Dhttp.proxyUser=username
-Dhttp.proxyPassword=password
-Dhttps.proxyUser=username
-Dhttps.proxyPassword=password
-Dhttp.nonProxyHosts=localhost|127.0.0.1|*.local

Pour un proxy SOCKS5, utilisez d'autres paramètres :

-DsocksProxyHost=your.socks.host
-DsocksProxyPort=1080
-DsocksProxyVersion=5

Après avoir enregistré le fichier, redémarrez l'IDE. Les paramètres s'appliqueront à toutes les connexions JVM, y compris le téléchargement des index, le travail avec des plugins et le client Git intégré.

Proxy via des variables d'environnement système

Cette méthode est particulièrement pratique sur Linux et macOS, ainsi que dans les environnements CI/CD. Les variables d'environnement sont héritées non seulement par la JVM, mais aussi par les processus enfants — c'est-à-dire que Maven, Gradle, pip, npm les récupéreront également automatiquement.

Variables standards pour un proxy HTTP :

export HTTP_PROXY=http://username:[email protected]:8080
export HTTPS_PROXY=http://username:[email protected]:8080
export NO_PROXY=localhost,127.0.0.1,::1

Ajoutez ces lignes dans ~/.bashrc, ~/.zshrc ou ~/.profile selon votre shell. Ensuite, redémarrez le terminal et lancez l'IDE depuis celui-ci — il récupérera les variables d'environnement.

Sur Windows, les variables sont définies via l'interface système :

1. Ouvrez Panneau de configuration → Système → Paramètres système avancés → Variables d'environnement.
2. Dans le bloc « Variables utilisateur », cliquez sur Créer.
3. Ajoutez les variables HTTP_PROXY et HTTPS_PROXY avec la valeur http://username:[email protected]:8080.
4. Redémarrez l'IDE.

Notez que les IDE JetBrains sous Windows s'exécutent comme un processus distinct via le lanceur, et les variables d'environnement définies dans la session actuelle du terminal peuvent ne pas être transmises à l'IDE. Il est plus fiable de les définir via l'interface système ou via le fichier vmoptions.

Proxy pour Maven et Gradle dans IntelliJ IDEA

Maven et Gradle sont des outils distincts avec leurs propres fichiers de configuration. Même si le proxy est configuré dans l'interface de l'IDE, Maven Wrapper et Gradle Daemon peuvent ignorer ces paramètres, car ils sont lancés comme des processus JVM autonomes.

Proxy pour Maven

Ouvrez le fichier ~/.m2/settings.xml (créez-le s'il n'existe pas) et ajoutez la section <proxies> :

<settings>
  <proxies>
    <proxy>
      <id>main-proxy</id>
      <active>true</active>
      <protocol>https</protocol>
      <host>proxy.example.com</host>
      <port>8080</port>
      <username>your_username</username>
      <password>your_password</password>
      <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

Si vous devez configurer le proxy séparément pour HTTP et HTTPS, ajoutez deux blocs <proxy> avec des id et protocol différents.

Proxy pour Gradle

Pour Gradle, les paramètres du proxy sont définis dans le fichier ~/.gradle/gradle.properties (globalement) ou dans le fichier gradle.properties à la racine du projet (pour un projet spécifique) :

systemProp.http.proxyHost=proxy.example.com
systemProp.http.proxyPort=8080
systemProp.http.proxyUser=your_username
systemProp.http.proxyPassword=your_password
systemProp.http.nonProxyHosts=localhost|127.0.0.1

systemProp.https.proxyHost=proxy.example.com
systemProp.https.proxyPort=8080
systemProp.https.proxyUser=your_username
systemProp.https.proxyPassword=your_password

Après avoir enregistré le fichier, IntelliJ IDEA récupérera automatiquement les nouveaux paramètres lors de la prochaine synchronisation du projet Gradle. Cliquez sur le bouton Reload All Gradle Projects (icône de mise à jour dans le panneau Gradle à droite) — et les dépendances commenceront à être téléchargées via le proxy.

Proxy pour pip et conda dans PyCharm

PyCharm est l'IDE principal pour les développeurs Python. L'installation de paquets via pip et conda se fait via des processus distincts qui ne lisent pas les paramètres proxy de l'interface de PyCharm. Voici comment configurer le proxy pour chaque gestionnaire de paquets.

Proxy pour pip

Méthode 1 — via l'argument de ligne de commande lors de l'installation d'un paquet :

pip install requests --proxy http://username:[email protected]:8080

Méthode 2 — via le fichier de configuration pip (s'applique en permanence). Ouvrez ou créez le fichier :

• Linux/macOS : ~/.config/pip/pip.conf
• Windows : %APPDATA%\pip\pip.ini

[global]
proxy = http://username:[email protected]:8080

Méthode 3 — via des variables d'environnement (fonctionne pour pip et d'autres outils Python) :

export HTTP_PROXY=http://username:[email protected]:8080
export HTTPS_PROXY=http://username:[email protected]:8080

Proxy pour conda

Conda utilise son propre fichier de configuration .condarc. Ouvrez-le dans votre répertoire personnel et ajoutez :

proxy_servers:
  http: http://username:[email protected]:8080
  https: http://username:[email protected]:8080

Ou exécutez la commande dans le terminal PyCharm :

conda config --set proxy_servers.http http://proxy.host:8080
conda config --set proxy_servers.https http://proxy.host:8080

Si vous travaillez avec des miroirs PyPI (par exemple, le miroir de Yandex ou Nexus d'entreprise), vous pouvez simplement passer pip à un index alternatif au lieu d'utiliser un proxy. Mais si le miroir est également inaccessible, le proxy reste la seule solution. Pour un fonctionnement stable avec PyPI, les proxies résidentiels conviennent bien — ils ressemblent à des requêtes utilisateur ordinaires et ne sont pas bloqués par les fournisseurs CDN de PyPI.

Problèmes fréquents et solutions

Même avec une configuration correcte, parfois quelque chose ne va pas. Examinons les problèmes les plus courants et comment les résoudre.

Problème 1 : «Connection refused» ou «Unable to connect to proxy»

Cause : hôte incorrect, port ou proxy inaccessible.
Solution : vérifiez l'adresse et le port du proxy. Essayez de vous connecter au proxy via curl dans le terminal :

curl -x http://proxy.host:8080 https://plugins.jetbrains.com

Si curl ne se connecte pas non plus, le problème vient du proxy lui-même, et non des paramètres de l'IDE.

Problème 2 : Le proxy est configuré, mais les plugins ne s'installent toujours pas

Cause : l'IDE a mis en cache les anciens paramètres ou les paramètres ne se sont pas appliqués à tous les composants.
Solution :

1. Fermez complètement l'IDE (assurez-vous que le processus ne reste pas en arrière-plan).
2. Videz le cache : File → Invalidate Caches → Invalidate and Restart.
3. Vérifiez que le fichier vmoptions ne contient pas de paramètres conflictuels.

Problème 3 : Erreur SSL/TLS lors de l'utilisation via un proxy

Cause : le proxy d'entreprise effectue une inspection SSL (MITM) et remplace les certificats. La JVM ne fait pas confiance au certificat remplacé.
Solution : demandez à l'administrateur système de fournir le certificat racine du CA d'entreprise et importez-le dans le Java KeyStore :

keytool -import -alias corporate-ca -keystore $JAVA_HOME/lib/security/cacerts \
  -file corporate-ca.crt -storepass changeit

Dans les IDE JetBrains, il existe un outil intégré : Settings → Tools → Server Certificates — vous pouvez y ajouter un certificat de confiance via l'interface graphique.

Problème 4 : Le proxy avec authentification n'accepte pas le mot de passe

Cause : caractères spéciaux dans le mot de passe non échappés, ou le proxy utilise l'authentification NTLM/Kerberos (proxies d'entreprise Microsoft).
Solution : pour les proxies NTLM, la JVM le prend en charge nativement, mais il faut définir des paramètres supplémentaires :

-Djdk.http.auth.tunneling.disabledSchemes=""
-Djdk.http.auth.proxying.disabledSchemes=""

Problème 5 : Git dans l'IDE ne fonctionne pas via un proxy

Cause : le client Git intégré de JetBrains utilise Git système, et non les connexions JVM. Les paramètres proxy de l'IDE ne l'affectent pas.
Solution : configurez le proxy directement dans Git :

git config --global http.proxy http://username:[email protected]:8080
git config --global https.proxy http://username:[email protected]:8080

Symptôme	Cause probable	Méthode de correction
Les plugins ne s'installent pas	Le proxy n'est pas configuré dans l'IDE	Settings → HTTP Proxy
Maven ne télécharge pas les dépendances	Pas de paramètres dans settings.xml	~/.m2/settings.xml → proxies
pip ne télécharge pas les paquets	pip ne lit pas les paramètres de l'IDE	pip.conf ou variables ENV
Erreurs SSL	Inspection MITM sur le proxy	Importer le certificat d'entreprise
Git ne fonctionne pas via le proxy	Git ne lit pas les paramètres JVM	git config --global http.proxy
Gradle ne se synchronise pas	Pas de paramètres dans gradle.properties	~/.gradle/gradle.properties

Conclusion

La configuration d'un proxy dans les IDE JetBrains n'est pas un simple bouton, mais plusieurs niveaux de configuration. La principale chose à retenir : l'IDE lui-même (plugins, licence, Marketplace) se configure via Settings → HTTP Proxy ou via les paramètres JVM dans vmoptions. Les gestionnaires de dépendances — Maven, Gradle, pip, conda — nécessitent une configuration séparée dans leurs fichiers de configuration. Git dans l'IDE se configure via git config global.

Si vous utilisez un proxy pour contourner les géoblocages ou les restrictions du réseau d'entreprise, il est important de choisir un serveur proxy stable et rapide. Pour travailler avec des dépôts, le Marketplace et télécharger des dépendances, les proxies de centres de données conviennent bien — ils offrent une vitesse élevée et des latences minimales, ce qui est critique lors de la synchronisation de grands projets avec des centaines de dépendances. Si vous avez besoin de la compatibilité maximale avec des services qui bloquent les IP de serveur, envisagez des proxies résidentiels — ils utilisent de vraies adresses utilisateur et ne suscitent pratiquement aucun soupçon auprès des systèmes de protection CDN et des dépôts.