ComfyUI配置时需要注意什么

ComfyUI 配置关键注意事项
一 环境与版本匹配

• 使用独立虚拟环境（venv/conda），避免与系统或其他项目依赖冲突。
• Python 版本以稳定为主：多数教程与实践推荐 Python 3.10.x；也有教程使用 3.11.x 成功；个别文章建议 3.12.x。若遇到依赖冲突，优先回退到 3.10.x 再试。
• 组件版本建议：CUDA 11.8 或 12.1、cuDNN 与 CUDA 对应、PyTorch 与 CUDA 匹配（用官方命令安装对应 CUDA 版本的 PyTorch）。
• NVIDIA 驱动需支持所选 CUDA；Windows 建议安装 VS Build Tools 以满足部分编译依赖。
• macOS（Apple Silicon）可用，但需确认 PyTorch 对 M 系列的支持与相应通道。

二 硬件与显存规划

• 最低可用：显存 ≥ 4GB（能跑但分辨率与模型受限）；推荐 ≥ 8GB；复杂工作流/高清建议 12–16GB+。
• 代表显卡参考：基础创作 RTX 3060 12GB / RTX 4060；高清 RTX 4070 / RTX 3090；复杂多控 RTX 4080 / RTX 4090。
• 系统内存建议 ≥ 16GB，存储建议 SSD 并预留 40–100GB+（模型与缓存增长很快）。
• 非 NVIDIA 方案：AMD 可用 ROCm（通常性能略低），Intel 可用 CPU 模式或相应加速方案。

三 安装路径与模型放置

• 安装与项目路径务必使用纯英文路径，避免中文或特殊字符导致加载失败。
• 模型目录规范：
• 大模型（Checkpoint）：放入 ComfyUI/models/checkpoints/（常见后缀 .ckpt / .safetensors）。
• 其他资源按类型放入对应子目录（如 VAE、LoRA、ControlNet 等），自定义节点放入 ComfyUI/custom_nodes/。
• 已有 Stable Diffusion WebUI 的用户，可通过 extra_model_paths.yaml 复用现有模型库，减少重复下载。
• 启动后在界面加载默认工作流，确认 Load Checkpoint 节点能正确显示模型名称。

四 启动参数与访问安全

• 常用启动方式：
• 本地访问：运行 python main.py，浏览器打开 http://127.0.0.1:8188。
• 局域网访问：运行 python main.py --listen 0.0.0.0，并在防火墙放行端口 8188。
• 显存与性能优化：
• 低显存可加 --force-fp16 降低精度占用。
• 分辨率与步数从低开始：如 512×512、步数 20–50，再按显存与效果逐步上调。
• 更新与维护：定期执行 git pull 与 pip install -r requirements.txt，或使用 ComfyUI-Manager 的“Update All”。

五 常见问题快速排查

• 启动日志显示 CUDA not available：检查显卡是否支持 CUDA、驱动是否匹配、CUDA 与 PyTorch 是否对应，必要时重装匹配版本的 PyTorch。
• 模型不出现在下拉框：确认文件在 models/checkpoints/、后缀为 .ckpt/.safetensors、文件未损坏、路径无中文。
• 自定义节点无效：确认节点放在 custom_nodes、依赖已安装、所需模型/权重在正确子目录。
• 生成模糊或无内容：提高 步数（Steps）、调整 CFG Scale（如 7–12）、分辨率与模型训练尺度匹配（如 SD1.5 常用 512×512）、使用合适的 负提示词。
• Windows 无法访问：在防火墙中允许 8188 端口入站。
• 合规与备份：注意模型与资源的许可协议；定期备份 models 与 custom_nodes 目录。