Skip to main content

模型资产管理

ComfyUI 工作流平台的「模型管理」功能提供了一个集中化平台，用于导入、组织和维护构建工作流所需的各类模型及相关文件。您可以从公网链接或本地导入单个模型文件乃至整个文件夹，系统会将这些资源整合到您的资产库中。通过提供层级化路径树和清晰的状态标识，您可以轻松地为私有环境配置所需的模型，确保模型资源的有序管理和在不同环境下的正确挂载。

功能亮点​

  • 多样的导入来源

    • 您可以从公网导入单个模型或整个模型仓库。支持的白名单站点包括 Hugging Face、ModelScope、CivitAI 等。
    • 添加模型时，您可以添加单个模型文件

  • 直观的层级管理

    • 模型列表页采用「模型列表 + 路径树」的双重展示形式，您可以根据目录结构浏览和定位模型。
    • 选中任一路径时，右侧列表仅展示当前路径下的模型，不包含子路径内容，使视图更加聚焦。

  • 清晰的可用范围

    • 列表中的“可用范围”列会标明模型是“所有环境可用”还是“仅私有环境可用”。
    • 只有满足特定格式（如 safetensors）和存放路径条件的模型，才能在所有环境中使用。

  • 高效便捷的工作流

    • 您可以通过名称、ID 或目标路径对模型进行搜索。

导入模型​

系统支持从公网或本地两种来源，以单个文件或整个文件夹的形式导入模型。

注意
平台已预置少量公共模型。如果上传同名模型，平台将提示是否覆盖。

从公网下载模型​

  • 访问 ComfyUI 工作流平台，点击 从公网下载模型。

  • 平台已根据 ComfyUI 目录结构特点，预置以下目标路径：

    • models：可拼接 ComfyUI 原生二级路径，例如
      `checkpoints / loras / clip / clip_vae / vae /

为什么 custom_nodes 文件夹里会有模型？
这样做可以让用户（尤其是新手）在安装节点后立即使用，无需再手动寻找、下载和放置特定的模型文件。同时，这也确保了节点代码与其依赖的特定模型版本（通常是较小的、专用的模型）绝对兼容，避免因版本不匹配导致的出错。将模型文件直接放入 custom_nodes 目录，是一种在便捷性与规范性之间权衡的做法，有利有弊。

  • 选择下载模型的来源。您可以按需添加多条待下载记录（单次确认下载要求全部是单个模型文件，或全部是模型仓库地址）。

    • 单个模型文件：直接粘贴模型文件链接，支持 HuggingFace、ModelScope、liblibAI、CivitAI。

  • 模型下载说明

    • huggingface

    • ModelScope

    • Liblib

    • CivitAI

Geek网盘上传​

适合将您本地计算机上的模型文件或文件夹上传至平台。

  • 访问 ComfyUI 工作流平台，点击 从本地上传模型。

进入本地上传后：

  • 下载网盘客户端，windows和macOS按需下载

注意

  • 在上传完成页面，点击确认导入，可以将所有的模型导入到模型列表
  • 模型传输上传完成后，需要决定模型存放路径。点击模型记录中的目标路径，选择并填写具体路径。平台已根据 ComfyUI 目录结构特点，预置以下 上传完成后，需要设置模型的目标存放路径。 预置路径包括：
  • models（包含 checkpoints / loras / clip / clip_vae / vae / controlnet 等路径）

管理模型​

模型成功导入后，可在模型列表页进行管理。

浏览与搜索​

  • 查看所有模型：展示所有已上传模型。
  • 按目标路径浏览：通过左侧路径树筛选特定路径模型。
  • 搜索：支持按名称 / ID 搜索模型。

编辑与操作​

  • 移动：将模型或文件夹移动到其他路径。
  • 重命名：可直接修改模型名称（下载/同步中状态无法重命名）。

理解模型的可用范围​

「可用范围」决定模型能够在哪种容器环境中加载运行，是平台安全机制的重要组成部分。

仅私有环境可用（默认）​

  • 用户上传的模型默认仅可在私有容器镜像中加载
  • 可避免含自定义代码或未验证内容的模型影响平台公共镜像环境

注意

  • 所有模型都严格租户隔离，不会被其他租户访问。
  • 如果租户仅使用私有环境，则无需关注可用范围。

使用与校验​

模型管理的最终目的是在环境中成功调用它们。

当您运行工作流时，系统会进行校验，检查所需模型是否存在且路径是否正确。如果校验失败，系统会给出明确的错误提示。

此时，您需要根据错误信息返回模型管理页面进行修正，例如：

  • 补充上传缺失的模型。
  • 将模型移动到正确的路径下。
  • 完成修正后，重新进行环境校验，成功后即可正常启动实例并运行工作流。

常见问题（FAQ）​

如果模型重名或路径重复怎么办？​

系统会进行重复校验。如果您尝试添加的模型在目标路径下已存在同名文件，系统会提示“与（路径/文件名）重复，请删除或取消操作”，阻止您创建重复的资产，确保企业资产的唯一性。

本地上传是否安全？​

该过程在设计上充分考虑了安全性。本地上传使用标准的安全传输协议，确保数据在传输过程中是加密的。系统为您生成的上传凭证是临时的，并且专属于您的上传会话。模型文件会先被上传到一个隔离的沙盒暂存区，经过安全校验后才会导入系统，确保了您数据资产的保密性与安全性

移动或删除正在被工作流使用的模型会发生什么？​

如果您移动或删除了一个模型，那么任何依赖该模型旧路径的工作流在启动时都会因找不到模型而校验失败，从而无法运行。