导入与管理 ComfyUI 模型

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

功能亮点

• 多样的导入来源：
  • 您可以从公网导入单个模型或整个模型仓库。支持的白名单站点包括 Hugging Face、ModelScope、CivitAI 等。
  • 支持通过 SCP 或 FileZilla 等工具从本地上传文件或文件夹。
  • 添加模型时，您可以选择是添加单个模型文件，还是整个模型仓库。
• 直观的层级管理：
  • 模型列表页采用「模型列表+路径树」的双重展示形式，您可以根据目录结构浏览和定位模型。
  • 选中任一路径时，右侧列表仅展示当前路径下的模型，不包含子路径内容，使视图更加聚焦。
• 清晰的可用范围：
  • 列表中的“可用范围”列会标明模型是“所有环境可用”还是“仅私有环境可用”。
  • 只有满足特定格式（如 safetensors）和存放路径条件的模型，才能在所有环境中使用。
• 高效便捷的工作流：
  • 本地上传任务的站点信息有效期为7天，为您提供充足的操作时间。
  • 未完成的表单会自动保存为草稿，当您下次进入时可恢复编辑，避免信息丢失。
  • 您可以通过名称、ID 或目标路径对模型进行搜索。

导入模型

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

注意

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

从公网下载模型

此方式适合添加托管在公共服务上的模型或代码仓库。

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

   模型管理

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

   • models，后续可拼接 checkpoints/loras/clip/clip_vae/vae/controlnet 或自定义二级路径。
   • custom_nodes，后续可拼接自定义二级路径。

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

   • 单个模型文件：您可以直接粘贴单个模型文件的下载链接。系统支持来自 HuggingFace、ModelScope、liblibAI 和 CivitAI 的直接链接。
   • 模型仓库：您可以粘贴整个模型仓库的链接。系统支持来自 HuggingFace、ModelScope 仓库地址，实现批量下载并导入模型。在下载时，您还可以指定需要下载的特定分支 (Branch)。当您输入合法的 URL 后，系统会解析并展示仓库中包含的模型文件列表，供您确认后导入。

   注意

   我们在界面上添加了清晰图文指引，帮助您获取 HuggingFace、ModelScope、liblibAI 和 CivitAI 的模型文件或仓库链接。

从本地上传

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

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

   模型管理

2. 选择本地上传后，系统会生成专用的传输凭据信息，包括主机地址、用户名、密码等。您可以使用 scp/sftp 或 FileZilla 工具。

   注意

   • 在传输时您无须担心模型存放路径。在传输完成后，可以在页面编辑模型存放路径。
   • 在传输开始后，页面将展示正在传输的模型。如果传输时间较长，您可以离开或关闭该页面。后续再次点击从本地上传模型进入本地传输页面后，平台将列出当前正在传输的文件。

3. 模型传输上传完成后，需要决定模型存放路径。点击模型记录中的目标路径，选择并填写具体路径。平台已根据 ComfyUI 目录结构特点，预置以下

   • models，后续可拼接 checkpoints/loras/clip/clip_vae/vae/controlnet 或自定义二级路径。
   • custom_nodes，后续可拼接自定义二级路径。

4. 配置模型路径后，点击确认，开始导入。导入时，系统仅会处理上传进度为 100% 的文件。未导入的文件将被丢弃。

   注意

   • 建议您在模型上传完成后，尽快配置路径并导入模型。
   • 如果需要等待多个模型传输完毕，请注意上传页面上的有效期。在此期间，您填写的表单信息会被自动保存为草稿，即使意外关闭页面，下次进入时也能恢复。在达到过期时限后，平台将清理上传数据记录。

管理模型

模型成功导入后，您可以在模型列表页进行全面的管理操作。

浏览与搜索

• 查看所有模型： 展示租户上传至 ComfyUI 工作流平台的所有模型。
• 按目标路径浏览：通过点击界面左侧的路径树，可以筛选并只查看特定路径下的模型文件。
• 搜索：顶部的搜索框支持按名称/ID 进行模糊搜索，帮助您快速找到所需模型。

编辑与操作

• 移动：在模型列表的操作列中，点击移动模型，可以将该模型或文件夹移动到其他路径下。
• 重命名：您可以直接编辑模型名称，以避免模型文件名冲突。当模型处于下载中或同步中等中间状态时，名称不可编辑。

理解模型的可用范围

为了保障 ComfyUI 工作流平台的稳定与安全，系统对模型的适用范围进行了划分。

在模型列表中，「可用范围」列明确标识了每个模型的使用权限：

• 仅私有环境可用：默认情况下，所有用户上传的模型都属于此范围，仅能在您自己的私有环境中使用。
• 所有环境可用：只有同时满足以下两个条件的模型，才会被系统判定为可在所有环境（包括预置的公共环境）中使用：
  1. 模型文件格式为 .safetensors。
  2. 模型必须存放在系统预设的特定公共路径下
     • models/checkpoints
     • models/loras
     • models/clip
     • models/clip_vision
     • models/vae
     • models/controlnet
     • models/embeddings

理解模型的可用范围

ComfyUI 工作流平台的「可用范围」是一个核心的安全分类机制，旨在确保平台的稳定性并实现严格的模型租户隔离。它定义了租户上传的模型可以被加载到哪种类型的容器环境中运行。

在模型列表中，可用范围列明确了每个模型的使用权限：

• 仅私有环境可用

  此为用户上传模型的默认范围。这类模型只被允许加载到运行租户私有环境（私有容器镜像）的环境中。这样做可以确保即使用户模型包含自定义或未经验证的代码，其影响范围也严格限制在用户自己的隔离环境内，不会影响到平台的公共基础服务。

• 所有环境可用

  此范围表示模型已经过平台验证，被认为是安全可靠的，可以加载到运行标准预置环境（公共容器镜像）的环境中。要获得此资格，模型必须同时满足以下两个严苛的条件：

  1. 模型文件格式必须为 .safetensors。
  2. 模型必须存放在系统预设的特定公共路径下，例如：
     • models/checkpoints
     • models/loras
     • models/clip
     • models/clip_vision
     • models/vae
     • models/controlnet
     • models/embeddings

简而言之，该机制通过限制潜在风险模型的运行环境，在给予用户高度灵活性的同时，有效保障了共享资源环境的安全与稳定。

注意

• 租户上传的任何模型均与其他租户隔离，与可用范围无关。
• 如果您的租户仅使用私有环境，则无须关心模型的可用范围。

使用与校验

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

当您创建新环境或为工作流关联环境时，系统会进行一次校验，检查所需模型是否存在且路径是否正确。如果校验失败，系统会给出明确的错误提示。

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

• 补充上传缺失的模型。
• 将模型移动到正确的路径下。

完成修正后，重新进行环境校验，成功后即可正常启动实例并运行工作流。

常见问题

如果我上传的模型和已有的模型重名或路径重复了怎么办？

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

本地上传过程是否安全？我的模型数据会暴露吗？

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

我如何追踪团队成员添加的模型？是否有审计日志？

模型列表视图提供了基础的资产追溯能力。在模型列表的列中，包含了“创建者”和“创建时间”字段。通过这些信息，您可以清晰地了解到每个模型是由哪位团队成员在何时导入的，为资产管理和审计提供了支持。

注意

本地上传时，生成上传凭证的用户将作为模型的「创建者」。租户下任何用户使用该上传凭证，创建者均为生成上传凭证的用户。

如果我移动或删除了一个正在被线上工作流使用的模型，会发生什么？

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