%20(1).png)
ComfyUI-Minio 插件完整使用教程基于我从 GitHub 仓库获取的信息，我来为你写一篇关于 ComfyUI-Minio 插件的保姆级教程。
ComfyUI-Minio 插件完整使用教程
1. 插件简介
插件地址： https://github.com/prodogape/ComfyUI-Minio
ComfyUI-Minio 是一个专门为 ComfyUI 设计的图片存储插件，就像给你的 ComfyUI 装上了一个"网络硬盘"。你可以把它想象成一个智能的图片管理员，能够帮你把生成的图片存储到远程的服务器上，也能从远程服务器上读取图片来使用。
这个插件能给我们带来什么效果： - 可以把生成的图片自动保存到网络存储空间，不占用本地电脑硬盘 - 可以从网络存储空间读取图片，实现多台电脑之间的图片共享 - 方便团队协作，大家都能访问同一个图片库 - 支持同时保存多张图片，批量操作更高效
2. 如何安装
方法一：使用 ComfyUI Manager（推荐）
- 打开 ComfyUI，点击右侧的 "Manager" 按钮
- 在搜索框中输入 "Minio"
- 找到 "ComfyUI-Minio" 并点击安装
- 重启 ComfyUI
方法二：手动安装
- 下载插件：进入 https://github.com/prodogape/ComfyUI-Minio
- 点击绿色的 "Code" 按钮，选择 "Download ZIP"
- 解压到你的 ComfyUI 目录下的
custom_nodes文件夹 - 打开命令行，进入插件目录，运行：
pip install -r requirements.txt - 重启 ComfyUI
注意： 如果你想显示详细的配置信息，还需要安装 Comfyui-Toolbox 插件。
3. 节点逐一解析
这个插件提供了3个核心节点，每个节点都有各自的用途和参数设置。
3.1 Set Minio Config 节点 - 配置连接信息
这个节点就像是"钥匙管理员"，负责设置你的网络存储空间的登录信息。就像你要登录网盘一样，需要先告诉系统你的账号密码。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 服务器地址 | endpoint | 文本输入 | localhost:9000 | 告诉系统你的存储服务器在哪里，就像填写网站地址 | Minio服务器的访问端点地址 | 填写你的Minio服务器地址，比如 "192.168.1.100:9000" |
| 用户名 | access_key | 文本输入 | minioadmin | 你的登录账号，就像QQ号 | Minio访问密钥ID | 填写你的Minio用户名，默认是 "minioadmin" |
| 密码 | secret_key | 文本输入 | minioadmin | 你的登录密码，用来验证身份 | Minio秘密访问密钥 | 填写你的Minio密码，默认是 "minioadmin" |
| 是否使用加密 | secure | 真/假选择 | False | 决定是否用加密方式连接，就像选择是否用密码锁 | 是否使用HTTPS安全连接 | 本地测试选False，正式环境选True |
3.2 Load Image From Minio 节点 - 从网络存储读取图片
这个节点就像是"图片提取器"，能够从你的网络存储空间中找到并读取图片，就像从网盘下载文件一样。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 存储桶名称 | bucket_name | 文本输入 | images | 告诉系统从哪个"文件夹"读取图片 | Minio存储桶名称 | 填写你创建的存储桶名，比如 "my-images" |
| 图片路径 | object_name | 文本输入 | image.jpg | 指定要读取的图片文件名，就像指定要下载哪个文件 | 存储在Minio中的对象键名 | 填写完整路径，比如 "folder/image.png" |
3.3 Save Image To Minio 节点 - 保存图片到网络存储
这个节点就像是"图片上传器"，能够把你生成的图片自动保存到网络存储空间，就像把照片上传到网盘一样。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片数据 | images | 图片输入 | - | 连接前面节点输出的图片，就像把图片放进上传框 | 要保存的图片数据 | 从其他节点的图片输出连接到这里 |
| 存储桶名称 | bucket_name | 文本输入 | images | 告诉系统把图片保存到哪个"文件夹"里 | Minio存储桶名称 | 填写你创建的存储桶名，比如 "my-images" |
| 文件名前缀 | prefix | 文本输入 | image_ | 给保存的图片起个名字前缀，就像给文件分类 | 文件名前缀 | 填写 "output_" 这样保存的图片就叫 "output_001.jpg" |
| 图片格式 | format | 选择列表 | PNG | 决定保存图片的格式，就像选择保存为jpg还是png | 图片保存格式 | 选择PNG保存质量更好，选择JPEG文件更小 |
| 图片质量 | quality | 数字输入 | 95 | 控制图片的清晰度，数字越大越清晰但文件越大 | JPEG压缩质量 | 填写1-100之间的数字，推荐80-95 |
4. 使用技巧和建议
4.1 首次使用步骤
- 先配置连接：使用 Set Minio Config 节点设置你的服务器信息
- 测试连接：配置成功后，会在 ComfyUI 的 output 目录下生成
minio_config.json文件 - 创建存储桶：在 Minio 管理界面创建一个存储桶（相当于文件夹）
- 开始使用：连接 Load 和 Save 节点来读取和保存图片
4.2 实用技巧
- 批量保存：Save Image To Minio 节点支持同时保存多张图片，非常适合批量处理
- 文件命名：使用有意义的前缀，比如 "portrait_" 或 "landscape_"，方便后续管理
- 格式选择：PNG 适合需要透明背景的图片，JPEG 适合普通照片
- 质量设置：如果网络较慢，可以适当降低质量到 80-85
4.3 性能优化建议
- 本地测试时，secure 设置为 False，能提高连接速度
- 如果图片较大，考虑使用 JPEG 格式和适中的质量设置
- 定期清理不需要的图片，避免存储空间过满
5. 常见问题解答
Q1: 配置后无法连接到 Minio 服务器
A: 检查以下几点： - 确认 Minio 服务器正在运行 - 检查服务器地址是否正确（包括端口号） - 确认用户名和密码是否正确 - 检查防火墙设置是否阻止了连接
Q2: 保存图片时提示"存储桶不存在"
A: 需要先在 Minio 管理界面创建存储桶： - 打开 Minio 网页管理界面 - 点击 "Create Bucket" - 输入存储桶名称并创建
Q3: 图片保存后找不到文件
A: 检查以下几点： - 确认存储桶名称是否正确 - 检查文件名前缀设置 - 在 Minio 管理界面查看是否真的保存成功
Q4: 读取图片时提示"对象不存在"
A: 检查以下几点： - 确认图片路径是否正确（包括文件扩展名） - 检查存储桶名称是否正确 - 确认该图片确实存在于 Minio 中
6. 进阶使用场景
6.1 团队协作
多个人可以使用同一个 Minio 服务器，实现图片素材的共享。团队成员可以： - 共享训练好的模型生成的图片 - 建立统一的素材库 - 实现工作流程的标准化
6.2 多机器部署
如果你有多台电脑用于图片生成，可以： - 在所有机器上使用相同的 Minio 配置 - 实现图片的统一管理 - 避免重复存储相同的图片
6.3 自动化工作流
结合其他 ComfyUI 节点，可以实现： - 自动生成图片并保存到指定位置 - 批量处理历史图片 - 按不同类别自动分类保存
7. 注意事项
- 数据安全：确保你的 Minio 服务器有适当的安全设置，避免数据泄露
- 存储空间：定期检查存储空间使用情况，避免空间不足
- 网络稳定：使用稳定的网络环境，避免上传过程中断
- 备份重要数据：重要的图片建议多地备份，避免意外丢失
这个插件为 ComfyUI 用户提供了强大的图片存储和管理功能，特别适合需要大量图片处理和团队协作的场景。通过合理使用这3个节点，你可以大大提高工作效率，同时实现更好的图片管理。