帮助中心
开发
EdgeComfy

EdgeComfy

EdgeComfy 旨在赋能开发者，通过智能管理AI 生成内容任务，优化算力与任务的执行效率。

🚩 核心四步导览

步骤 1：部署EdgeComfy

部署 EdgeComfy工作站，可有效管理 AIGC 任务，提升工作站与任务的执行效率

步骤 2：整合多台工作站

通过 EdgeComfy 工作站，可快速构建多台标准工作站环境，支持动态管理

步骤 3：服务对接

获取EdgeComfy的服务地址作为 API 请求的目标地址，将自有服务无缝接入 EdgeComfy

步骤 4：智能任务管理与优化

服务应用下发任务，EdgeComfy 会将任务智能地分派给多个工作站，任务可高效、经济地完成

一、创建工作站

1.1 基于 EdgeComfy 镜像部署工作站

  1. 在「内容社区」页面中，找到 EdgeComfy 镜像卡片
  2. 点击卡片右上角的「部署工作站」按钮
  3. 按向导填写工作站名称、规格等配置，提交后等待工作站创建完成

二、初始化 EdgeComfy

2.1 首次进入 EdgeComfy 并设置访问密码

  1. 在「工作站」列表中找到刚创建完成的 EdgeComfy 工作站

  1. 点击卡片上的 「EdgeComfy」按钮，进入 EdgeComfy 后台

  1. 第一次进入时会提示设置访问密码：
  • 设置一个易记且安全的密码
重要

密码无法找回，请务必妥善保存

  1. 设置完成后进入 EdgeComfy 首页

三、配置访问令牌（打通 EdgeComfy 与无影灵构平台）

3.1 在灵构控制台创建访问令牌

  1. 打开 灵构控制台，进入「访问令牌」页面
  2. 点击右上角「新增令牌」按钮

  1. 在弹出的窗口中，输入一个便于识别的令牌名称，点击创建

  1. 在令牌列表中，找到刚创建的令牌，点击「查看」按钮，复制令牌内容

  1. 回到 EdgeComfy 后台，在「访问令牌管理」页面中，将该令牌添加到 EdgeComfy 中

四、配置EdgeComfy

4.1 进入 EdgeComfy 管理并创建新 EdgeComfy

  1. 在 EdgeComfy 后台，进入「EdgeComfy 管理」页面
  2. 点击右上角「创建新 EdgeComfy」按钮

4.2 配置 EdgeComfy 参数

  1. 在「创建新 EdgeComfy」页面中填写：

    • 名称（例如：aigc-demo）；
    • 工作站数量：设定EdgeComfy启动时默认的工作站数量
    • 单工作站最大分配任务数：设定每台工作站能分配到的最大任务数量
    • 任务等待时间：定义任务在队列中排队等待的“忍受时限”
    • 等待任务数量：当待处理任务积累到一定数量时触发扩容，与“任务等待时间”结合使用
    • 扩容数量：每次 EdgeComfy 判断需要扩容时，会自动增加工作站的数量
    • 描述信息（可选）

  2. 在镜像配置项中，填写已经制作好的镜像码或者镜像ID（可运行comfyui）

    • 说明：该镜像为运行工作流的母镜像

  3. 配置磁盘容量：要求不低于镜像系统盘和数据盘容量

  4. 确认配置无误后，点击「创建 EdgeComfy」按钮完成创建

4.3 查看EdgeComfy 详情并等待工作站创建完成

  1. 返回「EdgeComfy 管理」页面
  2. 点击刚创建的EdgeComfy卡片标题，进入「详情」页面
  3. 在EdgeComfy详情中查看各工作站的状态，等待工作站创建完成并进入运行状态

五、配置 EdgeComfy 服务地址

5.1 在 EdgeComfy 中复制 EdgeComfy 对外服务 URL

  1. 打开 EdgeComfy 后台，进入目标 EdgeComfy 的「EdgeComfy 详情」页面
  2. 找到该 EdgeComfy 的「对外服务 URL」
  3. 点击复制，将该 URL 复制出来

5.2 在第三方服务中配置EdgeComfy服务地址

  1. 在提交任务时，需要将上一步获取的 EdgeComfy 对外服务 URL 作为 API 请求的目标地址
  2. 对于需要上传图片与视频的工作流，尽量使用url方式传递，避免使用 /upload 接口
  3. 对于任务输出的视频与图片，需要及时保存到本地或者在工作流中直接上传到OSS中，避免工作站被销毁后输出丢失

六、运行与验证

6.1 验证任务执行与结果回传

  1. 向 EdgeComfy 下发多个生成任务
  2. 进入 EdgeComfy 后台，可在任务页面查看任务的分发与运行情况
  3. 运行完成后，在第三方用户服务中可查看 20 次任务的运行结果

6.2 验证自动扩缩容

  1. 配置扩缩容策略，测试 EdgeComfy 的自动扩缩容策略

  2. 根据扩缩容策略（可自行配置）：

    • 当存在 5 个及以上等待中的任务，且等待时间超过 60 秒时，系统会自动扩容 1 台工作站
    • 新创建的节点会响应缩容策略
    • 最初创建的节点不会响应缩容策略，会始终存在

  1. 工作站（新）创建完成后，任务会自动分配到新的工作站上

  1. 在全部任务运行完成后：

    • 当满足缩容策略（参与扩缩容的工作站空闲时间超过 300s）时，系统会自动销毁该工作站，实现缩容。

七、接入成功标准

当满足以下条件时，可以认为整个 EdgeComfy 接入成功：

  1. 第三方用户服务与 EdgeComfy 入口连通正常
    • 可正常通过第三方服务发起任务
    • EdgeComfy 能收到并显示对应任务列表
    • 任务结果能回传并在第三方服务中展示
  2. 任务分派正常
    • 多个任务能被分发到 EdgeComfy 内的工作站执行
    • 任务状态（等待、运行、完成）在 EdgeComfy 中可清晰观测
  3. 自动扩缩容策略生效
    • 在大批量任务发起时，达到触发条件后自动扩容新工作站
    • 任务会自动分配到新工作站
    • 所有任务完成且工作站空闲超过阈值后，新工作站会按策略自动被销毁