跳转至

ComfyS3 插件读写对象存储

ComfyS3 插件通过无缝对接 Amazon S3 及其他 S3 兼容存储服务（如阿里云OSS、腾讯云 COS、MinIO 等），为 ComfyUI 提供了强大的云端存储支持。其可以动态加载云端素材​（S3 Load Image​），​自动保存处理结果（S3 Save Image/Video​ ），在作者的规划中，后续会加入​云端模型加载。

一、安装与配置 ComfyS3 插件

  1. 安装插件

安装方式有两种，一种是通过ComfyUI-Manager界面图形化安装，另一种是通过手动git安装，并安装相关依赖：

1
2
3
4
5
- 通过 ComfyUI-Manager 安装（可选）：搜索 `ComfyS3` 并安装，作者为 TemryL。
- 克隆仓库到 ComfyUI 的 `custom_nodes` 文件夹：  
 ```bash
 git clone https://github.com/TemryL/ComfyS3.git
 ```
  1. 配置环境变量

在 ComfyS3 根目录创建 .env 文件，填写以下参数（根据实际 S3 服务商调整）： 

1
2
3
4
5
6
7
8
S3_REGION="your-region"          # 存储桶所在地域（如 ap-beijing）
S3_ACCESS_KEY="your-access-key"  # 访问密钥
S3_SECRET_KEY="your-secret-key"  # 秘密密钥
S3_BUCKET_NAME="your-bucket"     # 存储桶名称
S3_INPUT_DIR="input/"            # 输入文件路径前缀
S3_OUTPUT_DIR="output/"          # 输出文件路径前缀
S3_ENDPOINT_URL="https://s3.your-provider.com"  # 自定义端点（如阿里云、腾讯云）
S3_ADDRESSING_STYLE="virtual"    # 地址风格（auto/virtual/path）

这里以腾讯云COS为例，对应的配置如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
S3_REGION = "ap-beijing"
S3_ACCESS_KEY = "testak"
S3_SECRET_KEY = "testsk"
S3_BUCKET_NAME = "testbucket"
S3_INPUT_DIR = "input/"
S3_OUTPUT_DIR = "output/"

# Optional Enviroment Variables
S3_ENDPOINT_URL = "https://cos.ap-beijing.myqcloud.com"
S3_ADDRESSING_STYLE="virtual"

二、工作流配置（Image to Image）

comfyui-s3-object

  1. 加载 S3 图像

    使用 S3 Load Image 节点：设置 S3 Key 为输入文件路径（如 input/image.jpg）。自动从 S3 下载图像并输入到后续节点。

  2. 图像处理节点

    添加 Image to Image 节点，连接输入图像。配置参数（如采样方法、分辨率等）。

  3. 保存到 S3

    使用 S3 Save Image 节点：设置 S3 Key 为输出路径（如 output/processed_image.jpg）。 自动将处理后的图像上传至 S3。

三、高级配置

  1. 动态路径控制

    • 通过 Prompt 或 ControlNet 动态指定 S3 路径： 
    1
2
3
4
5
    # 示例：在 API 调用中传递 S3 路径
prompt_data = {
    "prompt": "Load image from S3: input/dynamic_image.jpg",
    "extra": {"s3_key": "output/result.jpg"}
}

    参考 ComfyUI API 调用逻辑。

  2. 多格式支持

    • 视频处理：使用 S3 Save Video 节点保存 VideoHelperSuite 生成的视频。
    • 检查点模型：通过 Load Checkpoint from S3 节点加载预训练模型。

  3. 权限与安全

    • 限制 S3 访问权限：为存储桶设置只读/只写策略。
    • 使用临时密钥：通过 AWS STS 生成临时凭证，避免硬编码密钥。

四、常见问题

  1. 连接失败

    • 检查 .env 文件格式是否正确，密钥是否有权限。
    • 确认 S3_ADDRESSING_STYLE 是否匹配服务商（如 MinIO 需设为 virtual）。

  2. 文件路径错误

    • 使用绝对路径（如 s3://bucket-name/path/to/file）或相对路径（需与 S3_INPUT_DIR/S3_OUTPUT_DIR 组合）。

  3. 性能优化

    • 大文件传输时启用分块上传（需自定义节点扩展）。

通过以上配置，ComfyUI 可无缝对接 S3 存储，实现图像处理全流程的云端管理。如需进一步扩展，可结合 ComfyUI-Login 插件增强安全性。

捐赠本站(Donate)

weixin_pay
如您感觉文章有用，可扫码捐赠本站！(If the article useful, you can scan the QR code to donate))