%20(1).png)
ComfyUI-S3-Tools 插件超详细保姆级教程
1. 插件简介
GitHub原地址： https://github.com/kealiu/ComfyUI-S3-Tools
这个插件就像给你的ComfyUI装了一个"云端仓库管理员"。想象一下，你平时做图都是在本地电脑上保存图片，但有时候电脑硬盘不够用，或者想要在不同设备间共享图片，这时候S3就像一个超大的网盘仓库。
能给我们带来什么效果：
- 把生成的图片直接保存到云端仓库（S3），就像把照片自动备份到云盘
- 从云端仓库读取图片来继续处理，就像从云盘下载照片到本地编辑
- 节省本地硬盘空间，图片都存在云端
- 多设备共享，在任何地方都能访问你的图片库
2. 如何安装
方法一：自动安装（推荐新手）
- 打开ComfyUI管理器（ComfyUI Manager）
- 点击"安装自定义节点"
- 搜索"S3-Tools"或"kealiu"
- 点击安装并重启ComfyUI
方法二：手动安装
- 找到你的ComfyUI安装文件夹
- 进入
custom_nodes文件夹 - 下载插件文件并解压到这个文件夹
- 重启ComfyUI
3. 节点逐一解析
3.1 Load From S3 节点是干嘛的？
这个节点就像一个"云端图片提取器"。想象你有一个网盘，里面存了很多图片，这个节点就是帮你从网盘里把指定的图片拿出来，放到ComfyUI里继续处理。
3.2 Load From S3 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 存储桶名称 | bucket_name | 文本输入 | 你的S3桶名 | 就像你网盘的文件夹名字，告诉系统去哪个文件夹找图片 | S3存储桶的唯一标识符 | 比如填写"my-comfyui-images" |
| 访问密钥ID | access_key_id | 文本输入 | 你的AWS密钥 | 就像你网盘的用户名，证明你有权限访问这个文件夹 | AWS身份验证的公钥部分 | 从AWS控制台获取的长字符串 |
| 秘密访问密钥 | secret_access_key | 文本输入 | 你的AWS秘钥 | 就像你网盘的密码，和用户名配合使用 | AWS身份验证的私钥部分 | 从AWS控制台获取的长字符串 |
| 区域 | region | 下拉选择 | us-east-1 | 选择你的网盘服务器在哪个地区，影响访问速度 | S3存储桶所在的AWS区域 | 选择离你最近的区域，如"ap-northeast-1"（东京） |
| 文件路径 | file_path | 文本输入 | 图片完整路径 | 告诉系统要下载网盘里的哪张图片 | 对象在S3存储桶中的键值路径 | 比如"images/my-photo.jpg" |
| 文件名 | filename | 文本输入 | 自定义名称 | 下载后在本地显示的文件名 | 本地保存时使用的文件名 | 比如"downloaded-image.png" |
3.3 Save To S3 节点是干嘛的？
这个节点就像一个"云端图片上传器"。当你在ComfyUI里生成或处理完图片后，这个节点帮你把图片自动上传到云端存储，就像把照片自动备份到网盘一样。
3.4 Save To S3 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片输入 | images | 图片连接 | 前面节点的图片 | 接收要上传的图片，就像选择要备份的照片 | 从前置节点接收的图像数据 | 连接生成图片的节点输出 |
| 存储桶名称 | bucket_name | 文本输入 | 你的S3桶名 | 就像选择要上传到哪个网盘文件夹 | S3存储桶的唯一标识符 | 比如填写"my-comfyui-outputs" |
| 访问密钥ID | access_key_id | 文本输入 | 你的AWS密钥 | 就像你网盘的用户名，证明你有权限上传到这个文件夹 | AWS身份验证的公钥部分 | 从AWS控制台获取的长字符串 |
| 秘密访问密钥 | secret_access_key | 文本输入 | 你的AWS秘钥 | 就像你网盘的密码，和用户名配合使用 | AWS身份验证的私钥部分 | 从AWS控制台获取的长字符串 |
| 区域 | region | 下拉选择 | us-east-1 | 选择你的网盘服务器在哪个地区 | S3存储桶所在的AWS区域 | 选择离你最近的区域 |
| 文件路径前缀 | path_prefix | 文本输入 | 文件夹路径 | 就像在网盘里选择保存到哪个子文件夹 | 上传文件的路径前缀 | 比如"outputs/2024/" |
| 文件名格式 | filename_format | 文本输入 | 自定义格式 | 决定上传后的文件名格式 | 文件命名的模板规则 | 比如"image_{timestamp}.png" |
| 图片质量 | image_quality | 滑块(0-100) | 95 | 就像调节相机的画质，数字越大图片越清晰但文件越大 | JPEG压缩质量参数 | 一般设置90-95就够用了 |
| 图片格式 | image_format | 下拉选择 | PNG | 选择保存的图片格式 | 图像文件的编码格式 | PNG保真度高，JPEG文件小 |
4. 使用技巧和建议
新手友好设置：
- 第一次使用建议选择离你最近的区域（比如中国用户选择ap-northeast-1）
- 文件名格式建议加上时间戳，避免重名覆盖
- 图片质量设置90-95就够用，太高会浪费空间和上传时间
节约成本技巧：
- 不经常访问的图片可以设置到便宜的存储类型
- 定期清理不需要的图片
- 合理设置图片压缩质量
效率提升：
- 把常用的配置保存成模板
- 使用统一的文件夹结构管理不同类型的图片
- 可以设置自动删除本地文件，只保留云端副本
5. 常见问题解答
Q: 我没有AWS账号怎么办？
A: 需要先注册AWS账号，新用户通常有一年的免费使用额度。
Q: 上传失败怎么办？
A: 检查网络连接、密钥是否正确、存储桶名称是否存在。
Q: 图片上传很慢怎么办？
A: 选择离你更近的区域，或者降低图片质量减少文件大小。
Q: 会不会很贵？
A: AWS S3按使用量计费，一般个人使用每月几美元就够了。
Q: 安全吗？
A: AWS S3有很好的安全机制，但建议不要把密钥写在工作流文件里分享。
6. 进阶用法
批量处理：
结合其他节点可以实现批量上传多张图片，每张图片自动生成不同的文件名。
工作流集成：
可以在图片处理完成后自动上传到S3，然后删除本地文件，实现全自动的云端存储工作流。
多设备协作：
团队成员可以共享同一个S3存储桶，实现图片素材的共享和协作。
备份策略：
可以设置重要图片同时保存到多个区域，提高数据安全性。
这个插件虽然简单，但对于需要云端存储的用户来说非常实用。就像给你的ComfyUI装了一个智能的云端管家，让你再也不用担心本地硬盘空间不够或者图片丢失的问题！