%20(1).png)
ComfyUI S3 文件直传插件保姆级教程
1. 插件简介
这是一个可以让你直接把图片上传到亚马逊云存储(S3)的小工具。简单来说，它就像一个自动快递员，可以把你在 ComfyUI 生成的图片自动打包，然后送到网络上的一个安全仓库里存着。
GitHub 地址：https://github.com/KunmyonChoi/ComfyUI_S3_direct
2. 安装方法
就像安装其他 ComfyUI 插件一样，有三个简单步骤：
- 打开你的 ComfyUI 文件夹
- 进入
custom_nodes文件夹 - 在终端或命令提示符中输入：
git clone https://github.com/KunmyonChoi/ComfyUI_S3_direct
3. 节点详解
3.1 S3DirectSave 节点
这个节点就像一个智能快递员，负责把你的图片安全地送到网络仓库。
参数详解：
| 参数名(界面显示) | 参数名(代码) | 参数值类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 存储桶名称 | bucket_name | 文本 | my-bucket | 就像快递柜的名字 | S3存储桶名称 | 填写你在亚马逊云创建的存储空间名称 |
| 访问密钥 | access_key | 文本 | - | 快递柜的钥匙 | AWS访问密钥ID | 从AWS控制台获取的密钥填在这里 |
| 密钥 | secret_key | 文本 | - | 快递柜的密码 | AWS私有访问密钥 | 和访问密钥配套的秘密密钥 |
| 区域名称 | region_name | 文本 | ap-northeast-2 | 快递仓库所在地 | AWS区域代码 | 选择离你近的区域，如韩国就是ap-northeast-2 |
| 文件夹路径 | folder_path | 文本 | images/ | 快递柜里的小格子 | S3中的文件夹路径 | 比如"test/myimages/" |
| 文件名前缀 | filename_prefix | 文本 | img_ | 给文件起名字的前半部分 | 文件名前缀 | 比如"test_"，最终文件名会是"test_xxx.png" |
| 是否使用当前时间 | use_datetime | 是/否 | 是 | 要不要在文件名里加上时间 | 是否在文件名中包含时间戳 | 选"是"的话，文件名会带上当前时间 |
3.2 S3DirectLoader 节点
这个节点就像一个快递员，但是是负责从网络仓库取东西回来的。
参数详解：
| 参数名(界面显示) | 参数名(代码) | 参数值类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| 存储桶名称 | bucket_name | 文本 | my-bucket | 快递柜的名字 | S3存储桶名称 | 填写你要取图片的存储空间名称 |
| 访问密钥 | access_key | 文本 | - | 快递柜的钥匙 | AWS访问密钥ID | 填写你的AWS访问密钥 |
| 密钥 | secret_key | 文本 | - | 快递柜的密码 | AWS私有访问密钥 | 填写你的AWS私有密钥 |
| 区域名称 | region_name | 文本 | ap-northeast-2 | 快递仓库所在地 | AWS区域代码 | 填写存储桶所在的区域代码 |
| 文件路径 | file_path | 文本 | images/test.png | 要取的文件在哪个格子 | S3中的完整文件路径 | 比如"folder/image.png" |
4. 使用技巧和建议
- 第一次使用前，先测试一下上传小图片，确保设置都正确
- 建议给文件夹路径和文件名前缀设置有意义的名字，方便以后查找
- 记得保管好你的密钥信息，不要分享给别人
- 建议开启"使用当前时间"选项，这样可以避免文件名重复
5. 常见问题解答
Q: 上传失败怎么办？ A: 检查三件事： - 密钥是否正确填写 - 存储桶名称是否正确 - 区域名称是否和你的存储桶实际所在地区匹配
Q: 为什么我看不到上传的图片？ A: 确保你在AWS控制台中已经给这个存储桶配置了正确的访问权限。
Q: 上传速度很慢怎么办？ A: 试试选择离你比较近的区域，这样传输速度会快一些。
6. 补充说明
- 这个插件特别适合需要把生成的图片自动保存到云端的用户
- 可以和其他ComfyUI节点配合使用，组成自动化工作流
- 记得定期检查你的AWS使用量，避免超出免费额度