Passer au contenu principal
Certains réseaux d’entreprise acheminent le trafic via des proxys HTTP/HTTPS. L’éditeur Windsurf doit accéder à quelques services externes (pour la connexion et les fonctionnalités d’IA) ; vous devrez donc peut-être configurer un proxy pour que tout fonctionne de manière fiable. En particulier, une configuration de proxy peut être nécessaire si :
  • Vous voyez « Échec de la connexion » ou des erreurs réseau similaires
  • L’éditeur ou le panneau Cascade affiche un écran vide et ne se charge jamais
  • Cascade ou d’autres fonctionnalités cloud ne parviennent pas à se charger ou à se connecter
  • Les processus de connexion ou d’activation échouent de manière inattendue
Toutes les options de proxy se trouvent dans les Paramètres Windsurf. Vous pouvez les ouvrir depuis le menu déroulant en haut à droite → Paramètres Windsurf, ou via la palette de commandes (Ctrl/⌘+Maj+P) → « Open Windsurf Settings Page ».

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

Avant de modifier quoi que ce soit dans l’éditeur :
  1. 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) ou dois-je le configurer manuellement dans les applications ?
  2. Si votre organisation n’utilise pas de proxy, vous n’avez généralement pas besoin de modifier ces paramètres.
  3. Si votre organisation en utilise un, récupérez les informations du proxy (adresse, port et éventuels identifiants) auprès de votre équipe IT.
Vous pouvez leur partager une capture d’écran des paramètres de proxy de Windsurf afin qu’ils vous indiquent exactement quoi renseigner.

​
2. Utiliser le proxy système (« Detect proxy »)

Si votre proxy est déjà configuré sur votre machine (par exemple via les réglages réseau du système ou un fichier PAC), vous pouvez laisser Windsurf le détecter et le réutiliser :
  1. Ouvrez les paramètres de Windsurf.
  2. Dans la barre de recherche des paramètres, saisissez « proxy ».
  3. Repérez le commutateur Detect proxy (voir capture d’écran).
  4. Activez Detect proxy (ON).
  5. Fermez la page des paramètres et redémarrez Windsurf Editor.
  6. Réessayez :
    • Rechargez l’éditeur / Cascade
    • Relancez la connexion ou toute opération qui échouait auparavant
Si cela ne fonctionne plus après l’activation, vous pouvez désactiver Detect proxy (OFF) et utiliser les paramètres manuels à la place (voir la section suivante), ou suivre les recommandations de votre équipe informatique.

​
3. Configurer manuellement un proxy dans Windsurf Editor

Si votre organisation vous demande de spécifier manuellement le proxy dans les applications :
  1. Récupérez les informations nécessaires auprès de votre équipe IT/infra :
    • Protocole et adresse du proxy (par exemple http://proxy.company.com:8080 ou https://proxy.company.com:8443)
    • Indication si le proxy requiert une authentification
    • Votre nom d’utilisateur et mot de passe du proxy ou d’autres identifiants, si nécessaire
  2. Ouvrez les Paramètres Windsurf.
  3. Dans la barre de recherche des paramètres, tapez « proxy » pour ouvrir la section de configuration du proxy (voir capture d’écran).
  4. Renseignez les champs :
    • URL/adresse du proxy – incluez le protocole et le port (p. ex. http://proxy.company.com:8080)
    • Authentification – si votre proxy l’exige, saisissez le nom d’utilisateur et le mot de passe dans les champs prévus à cet effet
  5. (Optionnel, si recommandé par l’IT) Activez Détecter le proxy si votre configuration s’appuie encore sur la détection système/PAC en complément des paramètres manuels.
  6. Fermez la page des paramètres et redémarrez Windsurf Editor afin d’appliquer entièrement la nouvelle configuration du proxy.
  7. Réessayez :
    • Rechargez l’éditeur ou Cascade si vous aviez précédemment un écran blanc
    • Relancez l’opération qui échouait avec « Failed to connect » ou des erreurs similaires

​
4. Paramètres de proxy pour le développement à distance (SSH / conteneurs de dev)

Si vous utilisez le développement à distance (par exemple un conteneur de dev ou une session SSH distante Windsurf), un jeu distinct de paramètres de proxy contrôle le trafic entre votre Windsurf Editor local et l’environnement distant. Vous devrez peut-être ajuster ces paramètres si :
  • La connexion à un conteneur de dev ou à un hôte SSH distant échoue ou expire
  • La fenêtre distante s’ouvre, mais les outils qui dépendent du réseau ne fonctionnent pas comme prévu
  • Votre équipe IT/infra indique que l’hôte distant doit également passer par un proxy
Pour configurer le proxy pour les environnements distants :
  1. Ouvrez les Paramètres Windsurf.
  2. Dans la barre de recherche, saisissez “proxy”.
  3. Sous User → Extensions → Windsurf Remote…, repérez :
    • Remote › Windsurf SSH: Http Proxy
    • Remote › Windsurf SSH: Https Proxy
  4. Saisissez l’adresse (ou les adresses) du proxy fournie par votre équipe IT/infra (généralement avec le protocole et le port, par exemple http://proxy.company.com:8080).
  5. Redémarrez la session distante (fermez la fenêtre distante et reconnectez-vous, ou redémarrez le conteneur de dev) et réessayez.
Ces paramètres de proxy distants sont indépendants des options de proxy générales / Détection de proxy décrites ci-dessus. Dans certains environnements, vous devrez peut-être configurer à la fois le proxy de l’éditeur local et les valeurs de proxy Windsurf Remote SSH.

​
5. Quand utiliser quelle option

  • Utilisez uniquement « Detect proxy » si :
    • Votre organisation configure les proxys de manière centralisée sur votre appareil (paramètres réseau du système, fichier PAC), et
    • L’équipe IT vous indique que les applications doivent « simplement utiliser le proxy système ».
  • Utilisez la configuration manuelle (avec ou sans Detect proxy) si :
    • L’équipe IT vous fournit une URL de proxy spécifique et des identifiants à saisir dans chaque application, ou
    • La détection automatique dans votre environnement est peu fiable ou non prise en charge.
Si vous ne savez pas laquelle de ces options s’applique à vous, votre équipe IT/infra fait foi — elle peut confirmer si vous avez besoin de paramètres de proxy, quoi renseigner, et si le commutateur Detect proxy doit être activé ou désactivé.