Passer au contenu principal
Certains réseaux d’entreprise (et, plus largement, les environnements de type entreprise) acheminent le trafic via des proxys HTTP/HTTPS. Le plugin Windsurf dans les IDE JetBrains doit accéder à des services Windsurf externes (pour la connexion et les fonctionnalités d’IA) ; vous devrez donc peut-être configurer un proxy afin d’assurer un fonctionnement fiable.

​
Quand une configuration de proxy peut être nécessaire

Une configuration de proxy peut être nécessaire si :
  • Vous voyez « Failed to connect » ou des erreurs réseau similaires dans Windsurf
  • Le panneau Windsurf dans l’IDE reste vide et ne se charge jamais
  • Cascade ou d’autres fonctionnalités de Windsurf ne parviennent pas à se connecter ou expirent
Ce guide couvre :
  • Vérifier si votre réseau utilise un proxy
  • Configurer le proxy de l’IDE
  • Activer la détection de proxy de Windsurf
  • Configurer les paramètres de proxy pour JetBrains Remote

​
Vérifiez si votre réseau utilise un proxy

Avant de modifier quoi que ce soit : Demandez à votre équipe IT / infra / réseau :
  • Utilisons-nous un proxy HTTP/HTTPS pour le trafic sortant ?
  • Si oui, est-il configuré automatiquement (paramètres système / fichier PAC / gestion des appareils), ou dois-je le configurer manuellement dans les applications ?
Si votre organisation n’utilise pas de proxy, vous n’avez généralement pas besoin de modifier ces paramètres. Si votre organisation en utilise un, rassemblez les informations du proxy (adresse, port et éventuels identifiants). Vous pouvez leur envoyer des captures d’écran des paramètres « JetBrains HTTP Proxy » et de Windsurf afin qu’ils puissent vous indiquer exactement quoi renseigner.

​
Configurer le proxy de l’IDE JetBrains

Commencez par vérifier que l’IDE peut lui-même accéder à Internet via votre proxy — en particulier qu’il peut atteindre windsurf.com.
  1. Ouvrez Settings / Preferences dans votre IDE JetBrains. Par exemple : File → Settings… (Windows/Linux) ou ⌘, → Settings… (macOS).
  2. Accédez à Appearance & Behavior → System Settings → HTTP Proxy.
Paramètres du proxy HTTP JetBrains
  1. Choisissez l’option appropriée selon les recommandations de votre équipe IT :
    • No proxy – si votre réseau n’utilise pas de proxy.
    • Auto-detect proxy settings ou Use system proxy settings – si le proxy est configuré globalement sur votre machine.
    • Manual proxy configuration – si votre équipe IT vous a fourni un hôte/port de proxy spécifique (et éventuellement un nom d’utilisateur et un mot de passe) à saisir ici.
  2. Utilisez Check connection… (si disponible) pour vérifier la configuration — idéalement, testez la connectivité à https://windsurf.com depuis cette boîte de dialogue.
  3. Appliquez les modifications et redémarrez l’IDE si vous y êtes invité.
Si l’IDE ne parvient pas à accéder au réseau (par exemple si l’accès à la place de marché des plugins, aux mises à jour ou aux fonctionnalités web intégrées échoue, ou si vous ne pouvez pas atteindre https://windsurf.com depuis l’IDE), corrigez d’abord ce point ici. Windsurf dépend de cette connectivité.

​
Activer la détection de proxy de Windsurf dans JetBrains

Une fois le proxy au niveau de l’IDE configuré (ou confirmé comme non nécessaire), définissez comment Windsurf utilise ces paramètres. Le plug-in Windsurf dispose de sa propre option Détecter le proxy dans ses paramètres :
  1. Dans votre IDE JetBrains, ouvrez Settings / Preferences.
  2. Accédez à Tools → Windsurf Settings.
  3. Repérez l’option Détecter le proxy.
Paramètres de détection de proxy de Windsurf
  1. Activez Détecter le proxy si :
    • Votre proxy est configuré au niveau du système d’exploitation ou de l’IDE, et
    • Votre équipe IT s’attend à ce que les applications « reprennent automatiquement » ces paramètres.
  2. Cliquez sur Apply puis OK si nécessaire, puis redémarrez l’IDE.
  3. Essayez d’utiliser à nouveau Windsurf :
    • Ouvrez le panneau Windsurf depuis la barre latérale de l’IDE
    • Lancez Cascade ou réessayez l’opération qui échouait avec « Failed to connect » ou affichait un écran vide
Si de nouveaux problèmes de connexion apparaissent après avoir activé Détecter le proxy, vous pouvez :
  • Désactiver à nouveau Détecter le proxy,
  • Revérifier la configuration du proxy HTTP de votre IDE (y compris sa capacité à atteindre https://windsurf.com), et
  • Confirmer auprès de l’équipe IT si une configuration manuelle supplémentaire est nécessaire.

​
Configuration du proxy dans JetBrains Remote

Si vous utilisez JetBrains Remote Development (par exemple via JetBrains Gateway, un backend distant ou un environnement de développement cloud), il y a en pratique deux emplacements où les paramètres de proxy sont importants :
  • Votre machine locale, qui exécute le client léger.
  • La machine distante, où s’exécute le backend de l’IDE (et Windsurf).
Lorsque vous vous connectez avec JetBrains Remote, les requêtes réseau de Windsurf proviennent de la machine distante, et non de votre ordinateur portable local. Cela signifie :
  • La configuration du proxy sur l’IDE distant influe sur la manière dont Windsurf se connecte aux services Windsurf.
  • La machine distante peut nécessiter sa propre configuration de proxy, même si votre machine locale est déjà correctement configurée.
Pour le développement à distance avec JetBrains, vous devez utiliser le plug-in dédié « Windsurf (Remote Development) », et non le plug-in Windsurf standard. Assurez-vous d’avoir installé Windsurf (Remote Development) comme décrit dans la section Développement à distance du guide de démarrage Windsurf pour JetBrains.

​
Configurer le proxy pour l’environnement distant

  1. Connectez-vous à votre backend distant via JetBrains Remote / Gateway.
  2. Ouvrez Settings / Preferences dans la session IDE distante (cela ouvre les paramètres de l’IDE exécuté sur la machine distante).
  3. Configurez le proxy pour l’IDE distant :
    • Accédez à Appearance & Behavior → System Settings → HTTP Proxy sur l’IDE distant.
    • Paramétrez le proxy conformément aux instructions de votre équipe IT (No proxy / Auto-detect / Use system proxy / Manual).
    • Si l’IDE propose un bouton Check connection…, utilisez-le pour tester la connectivité à https://windsurf.com depuis la machine distante.
  4. Configurez Windsurf sur l’IDE distant :
    • Accédez à Tools → Windsurf Settings (toujours dans la session distante).
    • Activez Detect proxy si votre équipe IT souhaite que les applications sur l’hôte distant utilisent les paramètres de proxy système/de l’IDE.
  5. Appliquez les modifications, puis redémarrez le backend de l’IDE distant ou déconnectez-vous et reconnectez votre session distante.
  6. Rouvrez le panneau Windsurf dans l’IDE distant et réessayez l’action qui échouait auparavant.
Dans les environnements d’entreprise, il est fréquent que votre machine locale et la machine distante aient chacune leurs propres règles de proxy. Suivez les consignes de l’équipe IT pour chaque côté ; corriger uniquement le proxy local ne servira à rien si l’hôte distant ne peut pas accéder à Internet (y compris https://windsurf.com) sans sa propre configuration de proxy.

​
Quand changer quoi ?

​
Ne modifiez que le proxy HTTP local de l’IDE

Si :
  • Vous n’utilisez pas JetBrains Remote, et
  • Les autres fonctionnalités JetBrains fonctionnent déjà après l’avoir configuré, et
  • Windsurf fonctionne sans modifier ses propres paramètres, et
  • L’IDE peut accéder à https://windsurf.com.

​
Activer l’option Windsurf « Detect Proxy »

(Local ou distant) si :
  • Le proxy est déjà configuré au niveau du système d’exploitation ou de l’IDE sur cette machine, et
  • Windsurf est le seul élément qui n’arrive pas à se connecter, ou affiche un panneau Windsurf vide.

​
Configurer un proxy sur l’IDE distant

Si :
  • Vous utilisez JetBrains Remote,
  • Vous avez installé le plug-in Windsurf (Remote Development) pour cet environnement, et
  • Des erreurs surviennent uniquement lorsque vous êtes connecté à un backend distant, ou
  • L’équipe IT indique que le serveur distant doit également passer par un proxy pour accéder à Internet (y compris https://windsurf.com).

​
Contactez l’équipe IT / Infra

Si :
  • Vous ne savez pas si votre environnement utilise un proxy, ou
  • Vous avez configuré le proxy HTTP + le proxy de détection Windsurf (en local et/ou à distance) et vérifié la connexion à https://windsurf.com, mais vous voyez toujours des panneaux Windsurf vides ou des échecs de connexion.
Votre équipe IT / infra est la source d’information de référence — elle peut confirmer si vous avez besoin d’un proxy sur votre machine locale, votre machine distante, ou les deux, comment le configurer dans JetBrains, et si l’option de détection Windsurf doit être activée dans votre environnement.