%20(1).png)
ComfyUI-Login 插件完全教程
1. 插件简介
插件原地址： https://github.com/liusida/ComfyUI-Login
这个插件就像给你的 ComfyUI 装上了一道"安全门"，让只有知道密码的人才能进入使用。想象一下，你的 ComfyUI 就像你家的房子，这个插件就是门锁，只有输入正确的密码才能进门。
主要功能：
- 给 ComfyUI 加上登录验证，就像给手机设置密码锁屏一样
- 提供访客模式，让别人可以体验但不能乱改设置
- 支持隐私图片上传，图片会被加密保护
- 自动释放内存，当你离开时帮你清理垃圾
- 防止别人通过程序接口偷偷使用你的 ComfyUI
能带来什么效果：
- 保护你的 ComfyUI 不被陌生人随意使用
- 让你可以安全地把 ComfyUI 放在网上供朋友使用
- 上传的图片会被加密，更加安全私密
- 系统会自动管理内存，运行更流畅
2. 如何安装
方法一：手动下载安装
- 打开你的 ComfyUI 安装文件夹
- 找到
custom_nodes文件夹（就像一个专门放插件的抽屉） - 在这个文件夹里打开命令行工具
- 输入命令：
git clone https://github.com/liusida/ComfyUI-Login.git - 进入插件文件夹：
cd ComfyUI-Login - 安装依赖：
pip install -r requirements.txt - 重启 ComfyUI
方法二：ComfyUI Manager 安装
- 在 ComfyUI 界面找到 Manager 按钮
- 搜索 "ComfyUI-Login"
- 点击安装
- 重启 ComfyUI
注意事项：
- 第一次使用时会要求设置用户名和密码
- 密码会被加密保存，忘记了需要删除密码文件重新设置
- 插件会自动创建登录相关的文件夹
3. 节点详细解析
3.1 LoadImageIncognito 节点 - 隐私图片上传大师
这个节点就像一个会变魔术的保险箱，你把图片放进去，它会自动给图片加上密码锁，然后上传到服务器。只有你自己才能打开看到原图，别人看到的只是一堆乱码。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 选择图片 | image | 文件选择 | - | 就像选择要放进保险箱的照片，系统会自动给它加密 | 选择要加密上传的图像文件 | 点击"choose file to upload"按钮选择图片文件 |
| 自动删除 | auto_delete | 开关 | True | 就像用完就烧的秘密文件，处理完图片后自动删除加密文件 | 是否在处理完成后自动删除加密的临时文件 | 建议保持开启，这样更安全也节省空间 |
| 上传按钮 | upload | 按钮 | - | 就像保险箱的"存入"按钮，点击后选择要加密的图片 | 触发文件选择对话框的按钮控件 | 点击按钮后会弹出文件选择窗口 |
3.2 FreeMemory 功能模块 - 自动清洁工
这个功能就像一个勤劳的清洁工，当你离开电脑或者长时间不操作时，它会自动帮你清理内存垃圾，让系统保持清爽。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 空闲时间 | idleTimer | 时间 | 30分钟 | 就像设置"多久没动静就自动打扫"，超过这个时间不操作就清理内存 | 用户无操作后触发内存清理的等待时间 | 30分钟没有鼠标键盘操作就自动清理 |
| 卸载模型 | unload_models | 开关 | true | 就像把暂时不用的大件家具收起来，释放更多空间 | 是否卸载当前加载的AI模型以释放显存 | 自动执行，无需手动设置 |
| 释放内存 | free_memory | 开关 | true | 就像倒垃圾，把不用的数据清理掉 | 是否执行内存垃圾回收 | 自动执行，无需手动设置 |
3.3 GuestMode 功能模块 - 访客管理员
这个功能就像一个门卫，专门管理访客。访客可以进来参观和体验，但不能乱动重要的设置和按钮。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 访客模式状态 | guestMode | 开关 | false | 就像"访客"胸牌，告诉系统这个人只是来参观的 | 标识当前用户是否为访客模式 | 在登录页面选择"Guest Mode"按钮 |
| 菜单限制 | comfy-menu | 界面元素 | 受限 | 就像给访客划定活动区域，只能看到和使用基本功能 | 限制访客用户可见的菜单选项 | 访客只能看到队列按钮，其他按钮被隐藏 |
| 允许的操作 | allowed_post_path | 路径列表 | 限定列表 | 就像给访客发放"通行证"，只能去指定的地方 | 访客模式下允许访问的功能路径 | 只能提交任务和上传图片，不能修改设置 |
3.4 LoadImageIncognito JavaScript模块 - 加密上传助手
这个模块就像一个会变魔术的快递员，在你的图片离开电脑之前，先给它穿上"隐身衣"（加密），然后安全送达服务器。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 全局密钥 | globalKey | 密钥 | 随机生成 | 就像保险箱的钥匙，每次都是全新的，别人猜不到 | AES-256加密使用的随机密钥 | 系统自动生成，无需手动设置 |
| 初始向量 | globalIv | 向量 | 随机生成 | 就像密码锁的随机数字，让加密更安全 | AES加密的初始化向量 | 系统自动生成，无需手动设置 |
| 文件扩展名 | extension | 文字 | 自动检测 | 就像文件的"身份证"，告诉系统这是什么类型的图片 | 上传文件的格式后缀 | 支持jpeg、png、webp格式 |
| 随机文件名 | randomFilename | 文字 | 自动生成 | 就像给文件起个化名，让别人不知道原来的名字 | 为上传文件生成的随机名称 | 系统自动生成6位随机字符 |
| 加密文件 | encryptedFile | 文件 | 加密后 | 就像穿上隐身衣的图片，看起来像乱码但实际是你的照片 | 经过AES加密处理的图像文件 | 自动处理，用户无感知 |
3.5 Logout 功能模块 - 安全退出管家
这个功能就像一个贴心的管家，当你要离开时，它会帮你收拾好东西，清理痕迹，然后安全地锁好门。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 登出按钮 | logoutButton | 按钮 | - | 就像房间的"退房"按钮，点击后安全离开 | 触发登出流程的用户界面按钮 | 点击右上角的"Logout"按钮 |
| 工作流保存 | workflowData | 数据 | 保留 | 就像离开前把重要文件收好，下次回来还能继续用 | 保存用户当前的工作流程数据 | 自动保存，无需手动操作 |
| 清理缓存 | localStorage.clear | 操作 | 执行 | 就像离开前清理桌面，把私人物品收起来 | 清除浏览器本地存储的敏感数据 | 自动执行，保护隐私 |
| 会话清理 | sessionStorage.clear | 操作 | 执行 | 就像关闭所有打开的文件，确保没有遗留 | 清除当前会话的临时数据 | 自动执行，确保安全 |
3.6 UpgradeSlotDefaults 功能模块 - 智能推荐助手
这个功能就像一个会学习的小助手，它会记住你经常用哪些节点，然后在你需要时优先推荐这些节点，让工作更高效。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 衰减因子 | decalyFactor | 数字 | 0.9 | 就像记忆会慢慢淡化，旧的使用记录会逐渐减弱影响 | 历史使用记录的权重衰减系数 | 0.9表示每次新记录时，旧记录权重乘以0.9 |
| 推荐数量 | suggestionsNumber | 数字 | 5 | 就像菜单上推荐几道招牌菜，设置显示多少个推荐节点 | 节点连接时显示的推荐选项数量 | 可以在设置中调整为1-100之间的数字 |
| 输入追踪 | slot_types_default_in_trace | 对象 | 动态 | 就像记录本，记住哪些节点经常接收什么类型的数据 | 记录各类型输入的节点使用频率 | 系统自动记录，存储在浏览器本地 |
| 输出追踪 | slot_types_default_out_trace | 对象 | 动态 | 就像另一个记录本，记住哪些节点经常输出什么类型的数据 | 记录各类型输出的节点使用频率 | 系统自动记录，存储在浏览器本地 |
| 搜索过滤 | search_filter_enabled | 开关 | true | 就像给搜索框加上智能提示，输入时会自动过滤匹配的选项 | 启用节点搜索时的智能过滤功能 | 自动启用，让搜索更方便 |
| 中键添加 | middle_click_slot_add_default_node | 开关 | true | 就像快捷键，用鼠标中键点击连接点就能快速添加推荐节点 | 启用鼠标中键快速添加默认节点功能 | 中键点击节点的输入/输出点即可 |
4. 使用技巧和建议
4.1 安全设置技巧
- 密码设置： 选择复杂但好记的密码，避免使用生日等容易猜到的密码
- 定期更换： 建议每隔一段时间更换密码，删除PASSWORD文件重新设置
- 访客模式： 如果要给别人演示，使用访客模式更安全
4.2 隐私图片使用建议
- 敏感图片： 处理私人照片时优先使用LoadImageIncognito节点
- 自动删除： 建议保持自动删除功能开启，避免服务器存储过多临时文件
- 网络环境： 在公共网络环境下使用时，加密上传更安全
4.3 性能优化建议
- 内存管理： 保持FreeMemory功能开启，让系统自动管理内存
- 长时间使用： 如果需要长时间运行，可以适当调整空闲时间设置
- 访客限制： 使用访客模式时，系统资源消耗会更少
4.4 智能推荐优化
- 推荐数量： 新手建议设置5-10个推荐，熟练后可以减少到3-5个
- 使用习惯： 多使用中键点击功能，系统会学习你的使用习惯
- 定期清理： 如果推荐不准确，可以清理浏览器本地存储重新学习
5. 常见问题解答
Q1: 忘记密码怎么办？
A:
- 找到ComfyUI安装目录下的
login文件夹 - 删除里面的
PASSWORD文件 - 重启ComfyUI，系统会要求重新设置密码
Q2: 访客模式怎么开启？
A:
- 在ComfyUI安装目录下的
login文件夹中创建一个名为GUEST_MODE的空文件 - 重启ComfyUI
- 登录页面会出现"Guest Mode"按钮
Q3: 加密图片无法显示怎么办？
A:
- 检查网络连接是否正常
- 确保浏览器支持JavaScript
- 尝试刷新页面重新上传
Q4: 系统运行变慢怎么办？
A:
- 检查FreeMemory功能是否正常工作
- 适当减少空闲时间设置
- 清理浏览器缓存和本地存储
Q5: 无法通过程序接口访问怎么办？
A:
- 查看控制台输出的token信息
- 在请求中添加Authorization Bearer头部
- 或者在URL中添加token参数
Q6: 智能推荐不准确怎么办？
A:
- 清理浏览器localStorage中的推荐数据
- 重新使用一段时间让系统学习
- 调整推荐数量设置
6. 高级功能详解
6.1 程序接口保护
插件不仅保护网页访问，还保护程序接口调用：
- Token验证： 每次登录后会生成唯一的访问令牌
- Bearer认证： 支持标准的HTTP Bearer认证方式
- URL参数： 也可以通过URL参数传递token
6.2 会话管理
- 自动过期： 密钥会定期更新，提高安全性
- 多种存储： 支持Cookie和Session两种会话管理方式
- 跨域支持： 支持CORS跨域访问控制
6.3 文件加密机制
- AES-256加密： 使用军用级别的加密算法
- 随机密钥： 每次上传都生成新的加密密钥
- 内存处理： 密钥只存在内存中，不写入磁盘
6.4 智能学习系统
- 使用频率追踪： 记录每个节点的使用频率
- 权重衰减： 旧的使用记录会逐渐减弱影响
- 个性化推荐： 根据个人使用习惯提供推荐
7. 故障排除指南
7.1 登录相关问题
- 无法访问登录页面： 检查插件是否正确安装
- 密码验证失败： 确认密码输入正确，注意大小写
- 页面显示异常： 清理浏览器缓存，刷新页面
7.2 功能异常问题
- 加密上传失败： 检查网络连接和JavaScript支持
- 内存清理无效： 确认FreeMemory.js文件存在且未被修改
- 推荐功能异常： 清理本地存储数据，重新训练
7.3 性能问题
- 响应速度慢： 检查服务器资源使用情况
- 内存占用高： 调整内存清理间隔时间
- 加密处理慢： 考虑图片大小和服务器性能
8. 总结
ComfyUI-Login 插件是一个功能全面的安全防护工具，它不仅提供了基础的登录验证功能，还包含了隐私保护、智能推荐、自动优化等高级特性。
核心价值：
- 安全防护： 多层次的安全保护机制
- 隐私保护： 图片加密上传，保护敏感内容
- 智能优化： 自动内存管理和智能推荐
- 用户友好： 访客模式和个性化设置
适用场景：
- 需要在公网部署ComfyUI的用户
- 处理敏感图片内容的专业用户
- 需要给他人演示但保护系统安全的用户
- 希望提高工作效率的重度用户
通过本教程，你应该已经掌握了：
- 插件的完整安装和配置方法
- 6个功能模块的详细使用方法
- 各种使用技巧和优化建议
- 常见问题的解决方案
记住，安全永远是第一位的。这个插件就像给你的ComfyUI装上了一套完整的安全系统，让你可以放心地在任何环境下使用！