ComfyUI-Manager离线模式配置：无网络环境使用技巧
【免费下载链接】ComfyUI-Manager 
项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager
你是否曾在没有网络的环境下，急需使用ComfyUI-Manager管理自定义节点和模型？本文将详细介绍如何配置离线模式，让你在断网情况下也能高效使用ComfyUI-Manager的核心功能。读完本文后，你将掌握离线环境的资源准备、配置修改和故障排除方法。
离线模式核心原理
ComfyUI-Manager的离线模式通过缓存机制和本地文件读取实现无网络运行。系统会优先检查本地缓存文件，如果缓存存在且未过期，则直接使用缓存数据，避免网络请求。关键实现位于以下文件：
- 缓存逻辑：glob/manager_util.py 中的
get_data_with_cache函数处理本地缓存的读取和验证 - 下载控制：glob/manager_downloader.py 中的
download_url函数包含网络请求的条件判断
离线模式的工作流程如下：
离线环境准备工作
在有网络时提前做好以下准备，确保离线环境可以正常使用：
1. 缓存核心数据
运行以下命令预缓存必要的元数据和配置文件：
# 仅下载缓存数据而不更新组件
python cm-cli.py --cache-only
该命令会将节点列表、版本信息等关键数据保存到 glob/manager_util.py 定义的缓存目录中，默认路径为：ComfyUI-Manager/.cache/
2. 下载必备模型和节点
通过UI界面或命令行提前下载所需的自定义节点和模型：
# 安装指定节点（在线时）
python cm-cli.py install "ComfyUI-Impact-Pack"
# 下载模型到指定目录
python cm-cli.py download-model --model "SDXL" --dest "models/checkpoints/"
建议将所有必备资源保存在以下标准目录结构中，确保离线时能被正确识别：
ComfyUI/
├── custom_nodes/ # 自定义节点目录
├── models/ # 模型文件目录
│ ├── checkpoints/
│ ├── vae/
│ └── loras/
└── ComfyUI-Manager/
└── .cache/ # 缓存目录
3. 准备本地配置文件
复制模板文件创建本地配置：
# 复制通道配置模板
cp channels.list.template channels.list
# 创建PIP覆盖配置
cp pip_overrides.json.template pip_overrides.json
修改 channels.list 文件，注释掉所有网络通道，只保留本地通道：
# 禁用网络通道
# default = https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main
# 启用本地通道
local = file:///path/to/your/local/channels
离线模式配置修改
1. 设置缓存有效期
修改缓存超时设置，延长缓存有效期（默认为1天）：
在 glob/manager_util.py 中，找到 is_file_created_within_one_day 函数，修改时间判断逻辑：
# 将86400秒（1天）改为604800秒（7天）
return time_difference <= 604800
2. 配置本地通道
- 创建本地通道目录结构：
mkdir -p local_channels/{nodes,models}
- 复制在线通道文件到本地目录：
# 复制节点列表
wget https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/custom-node-list.json -O local_channels/nodes/custom-node-list.json
# 复制模型列表
wget https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/model-list.json -O local_channels/models/model-list.json
- 更新 channels.list 指向本地目录：
local = file:///absolute/path/to/local_channels/
3. 修改配置文件
编辑 glob/manager_core.py 中的默认通道设置：
# 将默认通道修改为本地文件路径
DEFAULT_CHANNEL = "file:///path/to/your/local_channels/"
离线模式使用技巧
1. 安装本地节点
使用以下命令从本地文件安装自定义节点：
# 从本地ZIP文件安装
python cm-cli.py install --local /path/to/custom-node.zip
# 从本地目录安装
python cm-cli.py install --local /path/to/custom-node-folder/
2. 导出/导入配置快照
在线环境导出配置快照：
# 导出当前配置
python cm-cli.py snapshot --export my_snapshot.json
离线环境导入配置快照：
# 导入配置快照
python cm-cli.py snapshot --import my_snapshot.json
快照文件包含所有已安装节点和模型的元数据，保存在 snapshots/ 目录下。
3. 离线更新检查
即使在离线环境，也可以检查本地已安装组件是否有更新（基于缓存数据）：
python cm-cli.py check-updates --offline
常见问题解决
1. 缓存过期问题
症状：提示"缓存已过期"但无法联网更新
解决：修改缓存有效期判断，编辑 glob/manager_util.py：
# 强制返回True，认为缓存始终有效
return True
2. 节点依赖缺失
症状：离线安装节点时提示依赖缺失
解决：提前导出依赖列表并在离线环境安装：
# 在线时导出依赖
python cm-cli.py export-deps > requirements-offline.txt
# 离线时安装依赖
pip install --no-index --find-links=./wheels -r requirements-offline.txt
将所有依赖包下载到本地wheels目录：
pip download -d ./wheels -r requirements-offline.txt
3. 配置文件错误
症状：启动时提示配置文件解析错误
解决：检查 channels.list 文件格式，确保本地路径正确：
# 正确格式示例（使用绝对路径）
local = file:///home/user/ComfyUI/local_channels/
总结与注意事项
ComfyUI-Manager的离线模式通过缓存和本地文件系统实现了无网络环境下的基本功能，但仍有以下限制：
- 无法获取最新的节点和模型更新
- 无法安装新的依赖包
- 缓存数据可能逐渐过时
建议定期（如每周）联网更新一次缓存数据和资源文件，以确保离线环境的可用性。
通过本文介绍的方法，你可以在没有网络连接的环境中继续使用ComfyUI-Manager管理现有资源。如有其他问题，请参考官方文档 docs/ 或提交issue获取帮助。
如果你觉得本文有用，请点赞收藏，并关注后续关于ComfyUI高级技巧的文章！
【免费下载链接】ComfyUI-Manager 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
