ComfyUI-Manager离线安装终极指南：3步掌握无网络节点部署

2026/8/13 9:28:05

ComfyUI-Manager离线安装终极指南：3步掌握无网络节点部署

【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager

ComfyUI-Manager作为ComfyUI的扩展管理器，提供了强大的离线安装功能，让您即使在无网络环境下也能轻松部署自定义节点。本文将深入解析ComfyUI-Manager的离线安装机制，并提供完整的本地ZIP包部署解决方案，彻底解决网络依赖问题。

🚀 为什么需要离线安装？

在企业内网、网络不稳定环境或多台离线机器批量部署场景中，传统的在线安装方式往往面临挑战。ComfyUI-Manager通过其核心模块glob/manager_util.py中的extract_package_as_zip方法，实现了完整的本地ZIP包解析功能，让离线安装变得简单可靠。

📦 准备合规的ZIP包结构

标准节点包要求

一个合格的ComfyUI节点ZIP包必须包含以下核心文件：

your-custom-node.zip ├── __init__.py # 节点核心代码（必需） ├── pyproject.toml # 项目元数据配置 ├── requirements.txt # Python依赖声明 ├── node_list.json # 非标准节点映射 └── README.md # 使用说明文档

ZIP包完整性验证

在安装前务必验证ZIP包完整性：

# Linux/Mac系统验证 unzip -t your-node-package.zip # Windows系统验证 # 右键点击ZIP文件 → 属性 → 检查压缩包状态

🛠️ 三种离线安装方法详解

方法一：图形界面安装（推荐新手）

操作流程：

启动ComfyUI，点击顶部菜单栏的"Manager"按钮
进入「节点管理」→「本地安装」选项卡
点击「选择ZIP文件」，浏览并选择本地节点包
确认安装路径（默认：ComfyUI/custom_nodes/）
点击「安装」按钮，等待完成提示

方法二：命令行批量安装

通过cm-cli.py工具执行高效批量安装：

# 进入ComfyUI-Manager目录 cd custom_nodes/ComfyUI-Manager # 安装单个ZIP包 python cm-cli.py install-zip --path /path/to/your-node-package.zip # 批量安装多个节点 for zip_file in ./offline_packages/*.zip; do python cm-cli.py install-zip --path "$zip_file" done

方法三：手动解压部署

对于高级用户，可以直接使用Python脚本进行安装：

# 使用manager_util模块直接解压 import sys sys.path.append('custom_nodes/ComfyUI-Manager/glob') import manager_util # 解压ZIP包到目标目录 extracted_files = manager_util.extract_package_as_zip( 'your-node-package.zip', 'custom_nodes/' ) # 安装Python依赖 if os.path.exists('custom_nodes/your-node/requirements.txt'): subprocess.run(['pip', 'install', '-r', 'custom_nodes/your-node/requirements.txt'])

🔧 核心模块解析

ZIP包解析引擎

ComfyUI-Manager的核心解压功能位于glob/manager_util.py：

def extract_package_as_zip(file_path, extract_path): import zipfile try: with zipfile.ZipFile(file_path, "r") as zip_ref: zip_ref.extractall(extract_path) extracted_files = zip_ref.namelist() logging.info(f"Extracted zip file to {extract_path}") return extracted_files except zipfile.BadZipFile: logging.error(f"File '{file_path}' is not a zip or is corrupted.") return None

依赖管理系统

安装完成后，系统会自动检查并安装依赖：

# 在prestartup_script.py中的依赖处理逻辑 extracted = manager_util.extract_package_as_zip(download_path, from_path) if extracted and os.path.exists(os.path.join(from_path, 'requirements.txt')): install_dependencies(from_path)

🐛 常见问题排查指南

问题1：ZIP包解析失败

症状：日志显示BadZipFile错误解决方案：

重新下载或获取ZIP包
检查文件权限：chmod 644 your-node-package.zip
使用zip -FF your-node-package.zip --out fixed.zip修复损坏的ZIP文件

问题2：依赖安装失败

症状：节点加载时提示ModuleNotFoundError解决方案：

# 手动安装依赖 pip install -r custom_nodes/your-node/requirements.txt # 使用uv加速安装 python -m pip install --upgrade pip pip install -r custom_nodes/your-node/requirements.txt --no-deps

问题3：版本冲突

症状：节点功能异常或ComfyUI启动失败修复方法：

# 运行依赖修复脚本 python prestartup_script.py --fix-pip # 检查冲突包 pip list | grep -E "torch|transformers|diffusers"

📊 安装日志分析

所有安装过程都会记录在ComfyUI/user/comfyui/ComfyUI-Manager.log中：

# 查看安装日志 tail -f ComfyUI/user/comfyui/ComfyUI-Manager.log # 搜索特定节点安装记录 grep -i "your-node-name" ComfyUI/user/comfyui/ComfyUI-Manager.log # 检查ZIP解压状态 grep "Extracted zip file" ComfyUI/user/comfyui/ComfyUI-Manager.log

🚀 高级部署技巧

批量部署脚本

创建deploy-offline-nodes.sh实现自动化部署：

#!/bin/bash # 批量部署脚本 NODE_DIR="./offline_nodes" INSTALL_DIR="${COMFYUI_PATH:-.}/custom_nodes" echo "开始批量部署离线节点..." for zip_file in "${NODE_DIR}"/*.zip; do if [ -f "$zip_file" ]; then echo "正在安装: $(basename "$zip_file")" python cm-cli.py install-zip --path "$zip_file" # 验证安装 node_name=$(basename "$zip_file" .zip) if [ -d "${INSTALL_DIR}/${node_name}" ]; then echo "✓ ${node_name} 安装成功" else echo "✗ ${node_name} 安装失败" fi fi done echo "批量部署完成！"

企业级部署方案

对于企业环境，建议采用以下最佳实践：

建立本地节点仓库：将所有常用节点ZIP包存储在内部服务器
版本控制：为每个节点包建立版本管理
依赖预下载：提前下载所有依赖到本地pip源
自动化测试：部署后自动验证节点功能

🔒 安全配置建议

安全级别设置

在config.ini中配置安全级别：

[default] security_level = normal allow_git_url_install = false allow_pip_install = false

网络模式配置

根据网络环境选择合适的模式：

[default] network_mode = offline # 离线模式，完全禁用外部连接

🎯 总结

ComfyUI-Manager的离线安装功能为各种网络环境下的节点部署提供了完整解决方案。通过合理利用ZIP包部署、命令行工具和自动化脚本，您可以：

完全摆脱网络依赖：在内网环境中稳定部署
实现批量部署：通过脚本自动化安装多个节点
确保版本一致性：所有机器使用相同的节点版本
快速故障恢复：离线包可作为备份快速恢复系统

掌握这些离线安装技巧，您将能够在任何网络环境下高效管理ComfyUI节点，提升工作流稳定性和部署效率。无论是个人使用还是企业级部署，ComfyUI-Manager都提供了强大的工具支持。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

ComfyUI-Manager离线安装终极指南：3步掌握无网络节点部署