ComfyUI Reactor Node 实战指南：三步装好人脸替换节点，跑通完整换脸工作流

ComfyUI Reactor Node 实战指南三步装好人脸替换节点跑通完整换脸工作流【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-nodeComfyUI Reactor Node 是一个为 ComfyUI 打造的快速、简单的人脸替换Face Swap扩展节点把源脸图和目标图接进工作流它会自动完成人脸检测、替换与修复让你低成本地批量产出换脸图片甚至视频。 开箱即用的换脸工作流这个节点移植自 SD-WebUI 的 ReActor 扩展并针对 ComfyUI 的节点化用法重新设计。启动 ComfyUI 后在节点搜索框输入 ReActor你会看到一整组节点核心的ReActorFaceSwap主节点带额外选项输入的ReActorFaceSwapOpt人脸增强节点ReActorFaceBoost以及蒙版辅助节点ReActorMaskHelper。主节点的输入决定了替换行为input_image是待处理的目标图source_image提供要贴上去的脸face_model则让你直接加载提前保存的轻量人脸模型文件。输出端除了IMAGE结果图还会吐出FACE_MODEL人脸嵌入可以接给保存人脸模型节点方便后续反复复用同一张脸。除了基础替换它还提供三个实用能力内置人脸修复下载 GFPGAN、CodeFormer、GPEN 等修复模型即可在节点里勾选、按索引精确指定哪张脸换哪张脸默认按从大到小检测排序、按性别过滤人脸。 三步装好 Reactor 节点并跑起来第一步克隆仓库到 custom_nodes 目录。在 ComfyUI 的custom_nodes文件夹下执行git clone https://gitcode.com/gh_mirrors/co/comfyui-reactor-node这步只是把扩展源码放进 ComfyUI 的插件目录此时还不能用。第二步运行安装脚本。Windows 双击install.batLinux/macOS 执行python install.py。别小看这个脚本——它会先检测你的 CUDA 版本和 PyTorch 情况自动挑选并安装匹配的onnxruntime-gpu或 CPU 版onnxruntime再逐条安装requirements.txt里的依赖insightface0.7.3、opencv-python、ultralytics等最后把核心换脸模型inswapper_128.onnx下载到models/insightface目录。整个过程全自动无需你手动 pip。第三步补齐可选模型。基础换脸只需上面的 ONNX 模型若要用蒙版功能把face_yolov8m.pt放进models/ultralytics/bboxSAM 模型放进models/sams修复模型放入models/facerestore_models首次启动时nodes.py检测到该目录为空会自动下载一批默认模型。重启 ComfyUI看到控制台出现 ReActor 运行日志就说明装好了。 读懂 modules 下四个子模块的分工modules/目录是项目的重工业车间四个子目录各管一段流水线modules/ ├── r_basicsr/ # 移植的 BasicSR 框架修复/超分模型架构、训练数据、损失函数 ├── r_chainner/ # 模型加载工具 GFPGAN/StyleGAN2 的干净架构定义 ├── r_facelib/ # 人脸底层能力检测、对齐、面部解析 └── scripts/ # 换脸核心业务脚本与辅助节点实现modules/r_basicsr/是一套完整的 BasicSR 图像复原框架archs/里堆满了 GFPGAN、ESRGAN、SwinIR 等模型架构ops/里还有 CUDA 核函数它决定了修复节点能调用哪些复原算法。modules/r_chainner/很薄核心是model_loading.py负责把 PyTorch 修复模型安全地加载进 ComfyUI 的显存管理。modules/r_facelib/管认脸这件事detection/下同时内置了 RetinaFace 和 YOLOv5Face 两套检测器parsing/提供面部区域分割utils/里的FaceRestoreHelper负责裁剪、对齐人脸。modules/scripts/是业务逻辑层reactor_faceswap.py写满检测、嵌入、替换的主流程reactor_swapper.py管理换脸模型的加载与卸载r_masking/实现蒙版辅助节点r_faceboost/实现先修复再贴脸的增强节点。 顶层文件各扮演什么角色根目录的__init__.pyComfyUI 加载扩展时最先执行它。它会把 SD-WebUI 环境里同名冲突的模块如modules.images、modules.shared临时挪开注册完节点后再还原保证两个环境互不污染。nodes.py扩展的中枢1200 多行代码里定义了全部节点类并注册NODE_CLASS_MAPPINGS启动时还会自动创建models/reactor/faces目录用来存放你保存的人脸模型safetensors 格式。reactor_patcher.py运行时给 insightface 打补丁让 ONNX 模型能从 ComfyUI 的 models 目录加载、按配置输出加载日志同时提供 CPU 回退逻辑。reactor_utils.py图片与张量互转、人脸模型读写、模型下载等杂活工具。pyproject.toml与requirements.txt前者声明项目元数据、固定依赖版本并供 Comfy Registry 识别后者是install.py逐条安装的依赖清单。其余的LICENSE、README.md英文、README_RU.md俄文是许可与双语文档问题排查章节值得收藏。⚙️ 按需配置与常见坑想让效果更稳重点调两处用ReActorFaceSwapOptReActorOptions组合可以自定义人脸索引顺序例如源脸 0,1,2 对应目标脸 1,0,2并限定只换某一性别把常用脸的模型用保存人脸模型节点存到models/reactor/faces之后任何工作流都能秒加载。遇到报错别慌项目作者在 README 里给过明确答案提示unexpected keyword argument通常是升级后旧节点接口变了从工作流删掉 ReActor 节点重新拖一个即可AttributeError: NoneType object has no attribute get一般是inswapper_128.onnx文件损坏重新下载替换Windows 下若 insightface 编译失败可直接按文档装预编译的 whl 包绕过。换脸只是第一步——把它和修复、蒙版节点串起来你的工作流就能稳定产出可商用的换脸内容。记住两点模型文件注意核对官方给出的哈希值以及始终遵守本地法规、取得真人肖像的授权。【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-node创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考