企业官网建设流程全解析

ComfyUI 换脸节点避坑指南：3 类高频故障一次讲清

【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-node

装 ComfyUI Reactor Node 时模型文件找不到、装完却在节点列表里搜不到节点、换出来的脸发虚发糊——这些坑基本覆盖了所有新手都会踩的路径。这篇文章按"装前检查 → 安装就位 → 排障 → 调效果"的顺序，把每一步都写成可直接照做的清单和动作。

ComfyUI Reactor Node 是 ComfyUI（一款基于节点连线搭工作流的 AI 绘图工具）里的换脸功能节点，源自 SD-WebUI 的 ReActor 面部交换扩展，不用额外开网页界面，在工作流里直接接上就能完成换脸。

部署前准备：动手前自查两个目录

正式安装之前，先确认机器上有这两个目录，能省掉后面一半的返工：

1. ComfyUI\models\ultralytics\bbox：放人脸检测模型的位置，不存在就手动新建。
2. ComfyUI\custom_nodes：所有扩展节点的存放目录，装完后这里应出现comfyui-reactor-node文件夹。

顺手确认 Python 环境能正常执行 pip 安装，很多"安装报错"其实只是依赖没装上。

安装与模型就位：四步把节点跑起来

🔧第 1 步：把节点放进 custom_nodes。如果已有 ComfyUI Manager，可以直接通过管理器安装；否则在ComfyUI\custom_nodes目录下执行：

git clone https://gitcode.com/gh_mirrors/co/comfyui-reactor-node

第 2 步：跑安装脚本。进入comfyui-reactor-node目录执行install.bat（Windows），Linux/macOS 下运行同目录的install.py，依赖与核心模型会一并处理。

第 3 步：补上人脸检测模型。安装日志若提示缺少face_yolov8m.pt，从 Ultralytics 官方模型发布页下载该文件，放进ComfyUI\models\ultralytics\bbox目录。

第 4 步：重启验证。重新启动 ComfyUI 服务器，在工作流界面搜索节点确认已加载。

排障实操：两类高频故障按"现象 → 原因 → 动作"拆

face_yolov8m.pt 放在哪个目录才算对

现象：日志提示模型缺失，人脸检测环节直接失效。原因：文件没下载，或放错了位置（比如丢进了扩展自己的目录、ComfyUI 根目录）。动作：把文件移动到ComfyUI\models\ultralytics\bbox，重启服务器后看日志确认加载成功。

节点不显示？按这三步排查

现象：安装脚本跑完没有任何报错，但工作流里就是搜不到节点。原因：仓库没放到custom_nodes下、依赖没装全、或装完没重启服务器，三选一。动作：依次检查——①ComfyUI\custom_nodes里有没有comfyui-reactor-node文件夹，没有就重新克隆；② 进文件夹重跑一次install.bat；③ 重启 ComfyUI 并翻一下启动日志里的红色报错。

故障速查表

换脸效果模糊怎么调：质量优化的关键在哪

现象：换完的脸发虚、有伪影，或与周围肤色衔接生硬。动作：从 Hugging Face 上的面部恢复模型（facerestore_models）资源区下载更高质量的模型，放到ComfyUI\models\facerestore_models目录；工作流中可接上 ReActorFaceBoost 节点增强输出，并按目标图像的分辨率调整face_size参数——分辨率高就把数值调大，避免小脸被放大糊掉。

风险提示：使用这个功能请有数

⚠️ 该节点不带 NSFW 内容过滤，属于未经审查（uncensored）的功能，使用后果需自行承担。请遵守所在地区法律法规，尊重肖像权与个人信息保护，勿用于生成或传播涉及他人、未经同意的内容。

改完目录或参数后，记得重启 ComfyUI 服务器再验证——多数"改了没生效"的情况，都卡在漏重启这一步。

【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-node