The ANGLE library used by nodes_glsl.py unnecessarily requires libX11.so.6 on Linux

问题场景

在无 X11 显示服务器的 Linux 系统上运行 ComfyUI 0.27.0 时，启动过程中加载自定义节点模块 nodes_glsl.py 失败，抛出 OSError: libX11.so.6: cannot open shared object file 错误。该错误发生在 ComfyUI 加载自定义节点的阶段（nodes.py 中的 load_custom_node），但由于该模块并非核心依赖，ComfyUI 主体仍能继续运行，只是 GLSL 相关节点功能不可用。

报错原文

OSError: libX11.so.6: cannot open shared object file: No such file or directory

原因分析

在 nodes_glsl.py 中，_preload_angle() 调用时会触发 ANGLE 库的加载。ANGLE（Almost Native Graphics Layer Engine）库在 Linux 上构建时链接了 libX11.so.6（X11 图形库），因此在没有安装 X11 库的无头（headless）Linux 环境中，动态链接器无法找到该共享库，导致导入 nodes_glsl.py 时失败。可能原因：系统的 X11 运行库未安装；或者 ANGLE 库的构建版本本身依赖 X11，而该依赖在当前环境中不存在。

环境排查

• 确认 Linux 系统是否安装了 X11 运行库（如 libX11 包）。
• 确认 nodes_glsl.py 依赖的 ANGLE 库版本（可通过 pip 查看 comfy-angle 或相关 ANGLE 包版本）。
• 确认 ComfyUI 版本（Issue 中为 0.27.0）。
• 确认 Python 版本（Issue 中为 3.13.13）。
• 确认 AMD ROCm 环境中 PyTorch 版本（Issue 中为 2.12.1+rocm7.2）。

解决步骤

1. 尝试安装/升级 comfy-angle 至 v0.1.1 或更高版本（可优先尝试）：根据 Issue 评论，用户确认 comfy-angle v0.1.1 修复了此问题。在 ComfyUI 的虚拟环境中通过 pip 安装或升级 comfy-angle 至该版本。
2. 在无 X11 环境安装 X11 兼容库（备选方案）：如果不想改动 ANGLE 依赖，可尝试安装系统级 libX11 运行库（例如 Debian/Ubuntu 下的 libx11-6 包），但这会增加系统依赖，且不属于 Issue 中已验证的首选方案。
3. 回退到原生驱动模式（未验证）：Issue 评论中有人提出，可以回退到提交 603d891 之前的版本，允许使用原生驱动而非 ANGLE。但此方案未在 Issue 中明确验证，且回退可能会影响其他功能。

验证方法

重启 ComfyUI，观察启动日志中是否仍出现 OSError: libX11.so.6 报错。如果不再出现该错误，说明 nodes_glsl.py 已能正常加载，GLSL 相关节点功能恢复正常。

参考来源

Comfy-Org/ComfyUI #14728

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。