Diagnóstico del gestor de extensiones de ComfyUI y la política de seguridad

¿Alguna vez has abierto el gestor de extensiones de ComfyUI y te enfrentado a una lista completamente vacía? Es una situación frustrante que puede dejar al usuario en la incertidumbre sobre qué está fallando. Al principio, es fácil asumir que se trata de un problema general con la red o con la base de datos del gestor.

Al investigar las causas iniciales, podemos identificar varios factores comunes que suelen provocar este comportamiento. Primero, el gestor podría no estar logrando acceder al servidor remoto del Registry debido a problemas de DNS, firewalls o bloqueos de seguridad como un antivirus o una VPN. Además, si estás probando diferentes versiones del software, una combinación de ComfyUI antiguo con una versión muy reciente del Manager puede causar incompatibilidades en la interfaz.

También es posible que el gestor esté consultando una base de datos local corrupta, como los archivos almacenados dentro de `/__manager/`. Un error JSON mal formado o una configuración antigua podría impedir que la lista se cargue correctamente desde el inicio. Todo esto sugiere un problema generalizado en la infraestructura del gestor.

Technical diagram of the ComfyUI Manager architecture with security blocks highlighted.
Diagrama de la arquitectura del gestor ComfyUI, mostrando el bloqueo de seguridad CSP que impide acceder al registro externo.

Es importante entender que, durante esta fase de transición hacia el Comfy Registry (CNR), hay problemas reales reportados donde paquetes publicados no son visibles en la lista. Sin embargo, una vez que se analizan los errores específicos del navegador, el diagnóstico cambia drásticamente.

El verdadero culpable: La política de seguridad CSP

A medida que profundizamos en el análisis de los registros de red y la consola del navegador, encontramos un detalle crucial. El gestor está intentando establecer una conexión a un dominio externo, pero el navegador bloquea esta acción. Esto se debe a una directiva de Política de Seguridad de Contenido (CSP) demasiado restrictiva.

Browser console and network tab showing CSP violation error messages.
Vista de las herramientas del navegador mostrando los errores de política de seguridad y el código 404 detectados en la consola.

La página de ComfyUI tiene una configuración que solo permite conexiones al propio servidor (`’self’`) y a datos locales (`data:`). Como resultado, la petición para cargar el gestor se bloquea antes de llegar siquiera al servidor remoto. Esto explica por qué ves errores como `Failed to load resource: the server responded with a status of 404` o mensajes sobre violaciones de CSP en las herramientas de desarrollador.

Illustration of the __manager user directory with faded cache files.
El directorio de usuario del gestor ComfyUI, con archivos de caché que pueden estar corruptos o desalineados.

El problema no es que la base de datos esté vacía, sino que el navegador está actuando como un guardián estricto al intentar cargar los nodos externos. Al identificar esta restricción de seguridad, podemos ver claramente cómo la interfaz intenta comunicarse con el registro y falla en el primer paso.

Conclusión

El diagnóstico final nos lleva a una solución más precisa que las simples reiniciaciones o reinstalaciones. Al comprender que es una restricción de seguridad del navegador la que impide la carga de los paquetes, el problema se vuelve mucho más fácil de resolver.