ComfyUI 面部交换：Reactor 节点安装部署与调优完整指南
【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-node
ComfyUI Reactor Node 是一款面向 ComfyUI 的面部交换节点，脱胎于 SD-WebUI 上久经考验的 ReActor 换脸扩展。它在一条工作流里串起人脸检测、交换、复原整条链路，出图快、参数少，对新手非常友好。本文带你走通从安装部署到效果调优的全流程，并附上高频报错速查表，帮你少踩坑。
Reactor 节点安装：克隆、脚本、验证三步走
安装流程很短，但每一步都有容易翻车的点。
第 1 步：把仓库克隆到正确的目录。停掉正在运行的 ComfyUI 服务器，在ComfyUI/custom_nodes目录下执行：
git clone https://gitcode.com/gh_mirrors/co/comfyui-reactor-node克隆完成后确认comfyui-reactor-node文件夹真的出现在ComfyUI/custom_nodes里——路径放错是"节点加载不出来"最常见的原因。
第 2 步：运行安装脚本。进入comfyui-reactor-node目录，Windows 用户双击运行install.bat，Linux/Mac 用户执行python install.py。脚本会安装 insightface、onnxruntime、opencv 等一整套依赖，耐心等待它跑完，中途不要关终端。
第 3 步：重启并验证。重新启动 ComfyUI 服务器，先看控制台是否出现 ReActor 加载成功的提示；再回到画布，右键菜单找ReActor分组或在搜索框里输入 "ReActor"，能搜到 ReActorFaceSwap 主节点就说明装好了。
模型文件应该放哪里
换脸主模型一般由脚本自动就位，但几个辅助模型需要你手动归位，记住这三个目录：
ComfyUI/models/ultralytics/bbox：放人脸检测模型face_yolov8m.pt。如果识别不到人脸、定位漂移，先回来检查这个文件在不在这个目录。ComfyUI/models/facerestore_models：放人脸复原模型（GPEN、CodeFormer、GFPGAN 等）。放进去之后在节点下拉框里直接选。ComfyUI/models/sams：放 SAM 模型sam_vit_b_01ec64.pth，给 MaskHelper 蒙版节点使用，用不到可以不装。
换脸效果调优：四项对照检查
- 选对复原模型：GPEN、CodeFormer、GFPGAN 风格各有差异，支持 1024/2048 高分辨率的 GPEN 在细节上更占优，多试几个再定。
- 对齐 face_size 参数：复原模型按自身
face_size重建人脸，目标图分辨率高时优先选更大规格的模型，避免放大后糊成一片。 - 加 ReActorFaceBoost 节点：它会先把换好的脸复原、放大，再贴回目标图，低清源图下提升肉眼可见。
- 多张脸时控制顺序：默认按"从大到小"检测、索引从 0 开始。要精确指定哪张脸换哪张脸，用 ReActorFaceSwapOpt 配合 ReActorOptions 设置索引即可。
高频问题速查：节点加载不出来怎么办
| 问题 | 常见原因 | 处理办法 |
|---|---|---|
| 节点加载不出来 | 没克隆到指定目录，或没跑安装脚本 | 克隆到ComfyUI/custom_nodes，进目录跑安装脚本，重启服务器再验证 |
| 检测不到人脸 | 缺少face_yolov8m.pt检测模型 | 下载后放入ComfyUI/models/ultralytics/bbox，重启生效 |
| 换脸结果模糊 | 没启用复原模型，或 face_size 不匹配 | 向ComfyUI/models/facerestore_models添加复原模型，必要时加 FaceBoost 节点 |
AttributeError: 'NoneType' object has no attribute 'get' | inswapper_128.onnx损坏或未下载完整 | 重新下载该模型放入ComfyUI/models/insightface覆盖旧文件 |
unexpected keyword argument 'reference_image' | 版本升级后节点输入接口变更 | 删掉工作流里的旧节点，重新添加一次 |
| ControlNet Aux IMPORT failed | opencv 版本冲突 | 卸载现有 opencv 包后固定安装 4.7.0.72 版本 |
ReActor 把 WebUI 生态里最成熟的面部交换能力搬进了 ComfyUI，让换脸成为工作流里一个普通节点。需要提醒的是，该项目不做内容过滤，请自行承担使用风险。
【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-node
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
