ComfyUI : accéder et résoudre les erreurs sur 127.0.0.1 8188

Pour accéder à ComfyUI sur votre ordinateur, ouvrez http://127.0.0.1:8188 dans un navigateur pendant que le serveur Python est lancé. Si la page affiche « connexion refusée », le navigateur n’est généralement pas en cause : le serveur local est arrêté, utilise un autre port ou n’écoute pas à l’adresse demandée.

Nous pouvons isoler le problème en quelques vérifications : repérer le port réellement utilisé, consulter le journal des erreurs, puis examiner le pare-feu et les extensions si le démarrage échoue. Ces étapes s’appliquent aux installations portables et manuelles ; ComfyUI Desktop peut employer un autre port, souvent le 8000 selon sa configuration.

• Adresse locale habituelle : http://127.0.0.1:8188 pour une installation portable ou manuelle.
• Premier diagnostic : vérifier que la fenêtre du serveur reste ouverte et qu’aucune erreur n’interrompt le lancement.
• Accès depuis un autre appareil : configurer explicitement l’écoute réseau avec –listen et protéger l’accès.

Nous allons suivre le trajet d’une requête, du terminal à l’interface web, pour distinguer un souci de démarrage d’un blocage réseau ou d’une extension défectueuse. Prenons l’exemple de Léa, qui lance ComfyUI pour ouvrir un workflow téléchargé : chaque vérification lui permet de cibler une cause plutôt que de réinstaller toute son installation.

Accéder à ComfyUI sur 127.0.0.1:8188

ComfyUI n’est pas une page web hébergée en permanence sur Internet. Au lancement, un programme Python démarre un serveur local sur l’ordinateur ; le navigateur se connecte ensuite à ce programme pour afficher le canevas, les nœuds et les commandes de génération.

Sur une installation portable Windows, le démarrage passe souvent par un fichier comme run_nvidia_gpu.bat, ou son équivalent adapté au matériel. Dans une installation manuelle, on lance le serveur depuis le dossier ComfyUI avec l’environnement Python prévu pour l’application ; Desktop, lui, gère ce lancement au sein de son interface.

Vérifier le port utilisé

Le port 8188 est le réglage courant des installations portables et manuelles. Une installation Desktop peut utiliser le port 8000 ; le terminal ou les journaux de l’application indiquent alors l’adresse à ouvrir, et c’est cette indication qui fait foi.

Pour Léa, l’adresse 127.0.0.1:8188 ne répond pas. Elle repère dans le terminal une adresse contenant :8000 ; en ouvrant http://127.0.0.1:8000, elle retrouve immédiatement son interface. Le nom « localhost » désigne généralement la même machine que 127.0.0.1, mais un port différent mène à un autre service, ou à aucun service.

Situation	Vérification	Action
Page inaccessible au port 8188	Lire l’adresse affichée au démarrage	Ouvrir le port annoncé
Serveur arrêté	Contrôler la fenêtre de lancement	Relancer ComfyUI et lire les premières lignes
Port déjà occupé	Repérer l’erreur de liaison	Choisir un autre port, par exemple avec –port 8190
Usage depuis un autre appareil	Vérifier l’option d’écoute réseau	Configurer –listen et sécuriser le réseau

Pour imposer un port sur une installation manuelle, on peut ajouter –port 8190 à la commande de lancement, puis ouvrir http://127.0.0.1:8190. Cette modification ne répare pas un serveur qui ne démarre pas : elle sert à éviter un conflit ou à adopter un port choisi.

Une page blanche ou un message de connexion refusée ne signifie donc pas automatiquement que ComfyUI est corrompu. Avant de toucher aux modèles ou aux nœuds, vérifions que le serveur est actif et que le navigateur vise la bonne adresse.

Résoudre une connexion refusée

Le message connexion refusée indique habituellement que le navigateur a tenté de joindre une adresse où aucun programme n’accepte la connexion. Cette distinction aide à ne pas confondre une panne du serveur avec un défaut d’affichage du navigateur ou un problème de modèle d’image.

Commençons par la fenêtre de lancement. Si elle a été fermée, si le processus Python s’est arrêté ou si une erreur Python a interrompu l’initialisation, l’interface web ne peut pas apparaître, même si l’adresse est exacte.

Lire le journal des erreurs

Les premières lignes du terminal confirment le démarrage ; les dernières révèlent souvent l’échec. Cherchons notamment une mention du port, une erreur d’importation, un module manquant ou un message indiquant qu’une adresse est déjà utilisée.

Si la fenêtre défile rapidement, évitons de la fermer avant d’avoir copié la trace pertinente. Dans Desktop, les journaux sont accessibles depuis les options d’aide ou le dossier de logs de l’application ; le fichier du serveur contient les informations comparables à celles du terminal.

Un cas courant est un port déjà occupé. Une seconde instance de ComfyUI, ou une autre application, écoute déjà sur 8188 ; le nouveau processus échoue alors à réserver cette adresse. Fermer l’instance inutilisée ou lancer ComfyUI avec un autre port permet de vérifier cette hypothèse.

Tester sans modifier l’installation

Nous pouvons suivre une séquence simple avant toute réinstallation :

1. Relancer ComfyUI et laisser la fenêtre du serveur ouverte.
2. Lire l’adresse locale annoncée dans le terminal ou les journaux.
3. Ouvrir cette adresse exacte dans un nouvel onglet du navigateur.
4. Si l’accès échoue, noter la dernière erreur utile et le port choisi.

Si le serveur indique qu’il fonctionne, mais que le navigateur n’atteint pas la page, essayons un autre navigateur ou une fenêtre privée. Désactivons temporairement un proxy, un VPN ou une extension de navigateur susceptible de modifier les requêtes locales ; ces outils peuvent perturber l’accès à la boucle locale ou la connexion persistante utilisée par l’interface.

Le pare-feu est rarement la première cause d’un échec sur le même ordinateur, car 127.0.0.1 reste une adresse locale. Il devient plus pertinent lorsqu’on ouvre ComfyUI à d’autres appareils, lorsqu’une règle bloque Python ou lorsque des outils de sécurité filtrent les connexions.

Une fois l’interface retrouvée, nous pouvons déterminer si les erreurs viennent du réseau ou d’un composant chargé par ComfyUI. Le journal reste le meilleur point de départ : il décrit ce que le serveur a réellement tenté de faire.

Configurer l’accès local et réseau

Par défaut, ComfyUI est généralement accessible depuis l’ordinateur qui l’exécute, via 127.0.0.1. Cette configuration limite l’accès au poste local et convient à une utilisation classique : l’interface web et le serveur Python communiquent sur la même machine.

Une adresse comme 127.0.0.1 n’est pas une adresse à saisir sur le smartphone ou le second PC. Sur ces appareils, elle désigne leur propre système. Pour un véritable accès local en réseau, le serveur doit écouter sur une interface réseau et le navigateur distant doit utiliser l’adresse IP privée de l’ordinateur hôte.

Activer l’écoute réseau

Sur une installation manuelle, l’option –listen 0.0.0.0 demande au serveur d’accepter des connexions sur les interfaces réseau disponibles. On peut aussi préciser un port, par exemple –listen 0.0.0.0 –port 8188, puis accéder à l’adresse IP locale du PC depuis l’autre appareil.

Il faut distinguer l’écoute de l’accessibilité. L’option ouvre la possibilité de joindre le service, mais le pare-feu du système peut encore bloquer Python ou le port choisi. Sur un réseau domestique de confiance, une règle limitée au réseau privé est préférable à une autorisation générale appliquée à tous les profils.

Imaginons que Léa utilise une tour fixe et souhaite charger un workflow depuis sa tablette. Elle lance ComfyUI avec l’écoute réseau, repère l’adresse privée de la tour, par exemple 192.168.1.42, puis ouvre http://192.168.1.42:8188 sur la tablette. Les deux appareils doivent être sur un réseau qui autorise les communications entre clients ; certains réseaux invités les isolent.

Éviter l’exposition publique

Le fait d’ouvrir un port sur le réseau local ne signifie pas qu’il faut le rendre accessible depuis Internet. ComfyUI et ses extensions peuvent exécuter du code et manipuler des fichiers ; une instance exposée sans authentification offre une surface de risque inutile.

Pour un usage hors domicile, préférons un VPN ou un accès distant protégé plutôt qu’une redirection directe du port 8188 sur le routeur. Un reverse proxy avec authentification peut aussi servir de barrière, à condition d’être correctement configuré et maintenu.

En cas d’erreur sur le réseau local, vérifions dans l’ordre l’option –listen, l’adresse IP de l’hôte, le port utilisé et la règle du pare-feu. Un test sur le PC lui-même permet de séparer un problème du serveur d’un problème de réseau entre appareils.

Le bon principe est simple : garder l’accès local par défaut et n’activer l’accès réseau que pour un besoin précis, avec une protection adaptée à l’environnement.

Diagnostiquer les extensions ComfyUI

Si ComfyUI démarre, mais qu’un workflow affiche des nœuds rouges ou que l’interface devient instable après une installation, le souci peut venir d’un custom node. Ces extensions ajoutent des fonctions comme des préprocesseurs, des outils vidéo ou des traitements avancés ; elles s’exécutent avec le serveur Python et peuvent dépendre de paquets spécifiques.

ComfyUI Manager facilite la recherche, l’installation et la mise à jour des extensions. Selon la méthode d’installation de ComfyUI, le Manager peut déjà être présent ou nécessiter une activation ; avant d’ajouter un autre dépôt, vérifions la barre supérieure de l’interface.

Traiter les nœuds manquants

Lorsqu’un workflow contient des nœuds absents, l’option Install Missing Custom Nodes peut comparer leurs noms internes à un catalogue connu. Après l’installation, un redémarrage complet du serveur est nécessaire : actualiser la page du navigateur ne recharge pas le code Python.

Un nœud reste absent ? Le catalogue ne reconnaît peut-être pas l’extension, le workflow utilise un nom ancien, ou le nœud appartient à une version plus récente du cœur de ComfyUI. Dans ce dernier cas, mettre à jour ComfyUI peut être plus pertinent que d’installer une extension supplémentaire.

Comprendre les erreurs d’import

La mention IMPORT FAILED dans le terminal indique qu’une extension n’a pas pu être chargée. Une erreur ModuleNotFoundError signale souvent une dépendance manquante ; une incompatibilité de version peut, elle, concerner des bibliothèques comme Torch, NumPy ou Transformers.

Les dépendances doivent être installées dans l’environnement Python utilisé par ComfyUI, pas nécessairement dans le Python général du système. Pour la version portable Windows, il faut employer le Python intégré à l’installation ; sur une installation manuelle, activons l’environnement virtuel avant d’utiliser pip.

Pour localiser une extension fautive, nous pouvons démarrer ComfyUI sans nœuds personnalisés avec –disable-all-custom-nodes. Si le lancement redevient stable, désactivons la moitié des extensions, testons, puis répétons l’opération : avec dix extensions, quelques cycles suffisent généralement à réduire la recherche à un seul dossier.

Il vaut mieux installer peu d’extensions, issues de dépôts identifiables, et conserver un instantané avant une mise à jour générale. Chaque nouveau custom node ajoute du code et des dépendances ; une installation compacte est souvent plus facile à dépanner et à restaurer.

Stabiliser le serveur et éviter les pannes

Une installation qui fonctionnait hier peut rencontrer un problème après la mise à jour du cœur ou d’une extension. Les versions des bibliothèques Python évoluent, et deux dépôts peuvent demander des versions incompatibles d’un même paquet ; une mise à jour groupée rend alors plus difficile l’identification du changement responsable.

Avant une opération importante, le Snapshot Manager permet de conserver l’état des extensions et des composants associés. Si un workflow devient inutilisable juste après une mise à jour, cet instantané offre un point de retour plus clair qu’une série de modifications manuelles.

Mettre à jour avec méthode

Commençons par mettre à jour une extension dont nous avons réellement besoin, puis ouvrons le workflow concerné et effectuons un test. Cette méthode prend quelques minutes de plus qu’un bouton global, mais elle permet de repérer immédiatement la mise à jour qui a modifié le comportement.

Le bouton Update All reste pratique sur une installation simple, à condition d’avoir créé un instantané auparavant. Sur Desktop, l’application gère la mise à jour du cœur, tandis que le Manager concerne principalement les extensions ; sur une installation portable ou manuelle, prenons soin de sauvegarder les workflows et l’environnement avant de modifier plusieurs éléments.

Protéger les fichiers et l’accès

Un custom node est du code Python exécuté par l’utilisateur qui lance ComfyUI. Il peut donc accéder aux fichiers et aux ressources disponibles à ce compte ; le catalogue ou le Manager ne constitue pas une garantie absolue de sécurité et ne remplace pas la vérification d’un dépôt.

Avant d’installer une extension inconnue, regardons son auteur, l’historique des modifications, les retours d’utilisateurs et le fichier requirements.txt. Un dépôt récent sans historique clair, un nom qui imite une extension connue ou une installation recommandée depuis un lien isolé mérite davantage de prudence qu’un projet suivi et documenté.

Si le catalogue distant ne se charge pas, le serveur ComfyUI lui-même peut ne pas avoir accès à Internet, même si le navigateur en a un. Un proxy, un DNS, une restriction réseau ou une limite temporaire des requêtes vers GitHub peut empêcher la récupération de la liste ; patienter, vérifier la connexion depuis la machine hôte ou utiliser une liste locale sont des pistes de dépannage.

Pour garder une installation réparable, conservons les journaux lors d’une panne, notons le port utilisé et archivons les versions qui font fonctionner nos workflows. Quand l’interface web disparaît, cette trace permet de déterminer rapidement si la cause se trouve dans le serveur local, le réseau ou une extension.