^{支持本项目}

---

英文 | 俄文

ComfyUI 的 ReActor 节点
_{^{-=适合所有年龄段=-}}

基于被封禁的 ReActor的快速简单人脸替换扩展节点——现在内置了色情内容检测器，以避免将此软件用于含有成人内容的场景。

使用本节点即表示您已接受并承担免责声明

• 新增对 FaceFusion Labs 的 HyperSwap 模型的支持（感谢 @Buumcode 的贡献）
  您可以从这里下载：
  huggingface.co/facefusion/models-3.3.0/tree/main
  文件包括：hyperswap_1a_256.onnx、hyperswap_1b_256.onnx 和 hyperswap_1c_256.onnx。
  请将其放入 ComfyUI\models\hyperswap 目录中。

Inswapper、Reswapper 和 HyperSwap 的对比图：
github.com/Gourieff/Assets/blob/main/comfyui-reactor-node/0.6.2_swapmodels_compare.png

• 修复与改进

0.6.2 _{^{ALPHA2、ALPHA3、ALPHA4}}

• 一些小但重要的修复

0.6.2 _^ALPHA1

• 【实验性功能】终于实现了！面部修复过程仅作用于被替换的人脸。

• 【实验性功能】新增“高级面部修复”节点，配备面部修复滤镜。感谢 @Buumcode 实现了“面部修复滤镜”。
  此节点可帮助您对指定的脸部应用修复处理。

• 为“加载人脸模型”节点新增 FACE_MODEL_NAME 输出。

0.6.1

• 改进了多张人脸和多个索引下的性别检测逻辑。
• MaskHelper 节点速度提升至原来的两倍——虽未完全完美，但相比之前快了1.5到2倍。
• 为不同步骤引入了 ComfyUI 原生进度条。
• 主要节点新增 ORIGINAL_IMAGE 输出。
• 其他修复与改进（例如修复 GitHub 问题 #25；移除了 NSFW 检测器的临时文件；NSFW 检测器速度略有提升）。

0.6.0

• 新增节点 ReActorSetWeight——现在您可以为 source_image 或 face_model 设置 0% 至 100% 的人脸替换强度，步长为 12.5%。

历史版本

0.5.2

• 支持 ReSwapper 模型。尽管 Inswapper 仍具有最佳相似度，但 ReSwapper 正在不断发展——感谢 @somanchiu 及其 ReSwapper 项目！这对社区来说是创建 Inswapper 替代方案的重要一步！

您可在此下载 ReSwapper 模型：
huggingface.co/datasets/Gourieff/ReActor/tree/main/models
只需将其放入 “models/reswapper” 目录即可。

• 引入 NSFW 检测器，以遵守 GitHub 规则。
• 新增“卸载 ReActor 模型”节点——在复杂工作流中，当需要释放 ReActor 占用的显存时非常有用。

• 支持 ORT CoreML 和 ROCM EP，只需安装所需的 onnxruntime 版本。
• 安装脚本优化，可自动安装最新版本的 ORT-GPU。

• 修复与改进

0.5.1

• 支持 GPEN 1024/2048 恢复模型（可在 HF 数据集 https://huggingface.co/datasets/Gourieff/ReActor/tree/main/models/facerestore_models 中找到）
• ReActorFaceBoost 节点——旨在提升换脸后的画质。其核心思想是在将换脸结果贴合到目标图像之前（通过 inswapper 算法），先对换脸区域进行修复并按恢复模型的 face_size 参数进行缩放。更多信息请参见 这里（PR#321）。

完整尺寸演示预览

• 按字母顺序对人脸模型进行排序
• 大量修复与改进

0.5.0 _^BETA4

• 支持 GFPGAN 的 Spandrel 库

0.5.0 _^BETA3

• 修复了“内存问题”和 MaskingHelper 的“未检测到”问题。

0.5.0 _^BETA2

• 现在可以从已有的多个人脸模型中构建一个混合人脸模型。只需在工作流中添加“Make Face Model Batch”节点，并通过“Load Face Model”连接多个模型即可。
• 图像分析模块性能大幅提升！速度提升了10倍！现在处理视频变得非常流畅！

0.5.0 _^BETA1

• Masking Helper 节点新增 SWAPPED_FACE 输出
• 修复：移除了 Masking Helper IMAGE 输出中的空 A 通道（该问题会导致某些节点报错）。

0.5.0 _^ALPHA1

• ReActorBuildFaceModel 节点新增 “face_model” 输出，可直接为主节点提供混合人脸模型：

基础工作流 💾

• 现已支持人脸遮罩功能。只需在工作流中添加“ReActorMaskHelper”节点，并按如下方式连接：

如果您没有 Ultralytics 的 “face_yolov8m.pt” 模型，可以从 Assets 下载，并将其放置在 “ComfyUI\models\ultralytics\bbox” 目录下； 同样地，“sam_vit_b_01ec64.pth” 模型也可下载（如尚未拥有），并放入 “ComfyUI\models\sams” 目录中。

使用此节点可以获得最佳的换脸效果：

• ReActorImageDublicator 节点——对于制作视频的用户非常实用。它可以帮助将一张图片复制到多个帧上，以便与 VAE 编码器配合使用（例如用于实时头像）：

• ReActorFaceSwapOpt（主节点的简化版本）+ ReActorOptions 节点，用于设置一些附加选项，例如（新增）“输入/源人脸的单独顺序”。是的！现在您可以按照自己想要的方式设置索引中人脸的顺序（默认为“从大到小”）！

• 在分析目标图像时略有提速（不过相比换脸和修复过程，速度仍然较慢……）

0.4.2

• 支持 GPEN-BFR-512 和 RestoreFormer_Plus_Plus 人脸修复模型 您可以在以下链接下载这些模型：https://huggingface.co/datasets/Gourieff/ReActor/tree/main/models/facerestore_models 然后将它们放入 ComfyUI\models\facerestore_models 文件夹中。

• 因应广泛需求，现在可以将多张包含人物的图片混合成一个单一的人脸模型文件，并将其用于“Load Face Model”节点或 SD WebUI 中； 尽情尝试创建新面孔，或将同一个人的不同面部特征混合，以获得更高的准确性和相似度！

只需将 ImpactPack 的“Make Image Batch”节点作为输入连接到 ReActor 节点，并加载您希望混合成一个模型的图片即可：

结果示例（新面孔由四位不同女演员的面部特征混合而成）：

基础工作流 💾

0.4.1

• 支持 CUDA 12——请务必运行 Windows 版本的 install.bat 或 Linux/MacOS 版本的 install.py 来安装 ComfyUI 的 Python 环境；或者手动为 CU12 安装 ORT-GPU（https://onnxruntime.ai/docs/install/#install-onnx-runtime-gpu-cuda-12x）。

• 修复了 issue comfyui-reactor-node/issues/173。

• 新增专门用于人脸修复后处理的节点（FR comfyui-reactor-node/issues/191），可在 ReActor 菜单中找到（RestoreFace 节点）。

• Windows 系统下，Python 可直接从系统 PATH 进行安装。

• 其他多项修复与改进。

• 现已提供人脸修复可见性及 CodeFormer 权重（保真度）选项！请别忘了在现有工作流中重新加载该节点。

0.4.0

• 现在“input_image”输入端口排在首位，这样可以正确绕过，并且将主输入放在前面也是合理的；
• 您现在可以将人脸模型保存为“safetensors”文件（ComfyUI\models\reactor\faces），并将其加载到ReActor中，以实现不同的场景需求，同时保持所用面孔的超轻量级模型：

• 现在可以直接从一张图片构建并保存人脸模型：

• 这两个输入都是可选的，您可以根据工作流只连接其中一个；如果两个都已连接，则“image”具有优先权。
• 其他多项修复使此扩展更加完善。

感谢所有发现错误、提出新功能建议以及支持本项目的朋友！

安装

模型

• buffalo_l：首次启动时会自动下载到 ComfyUI\models\insightface\models\buffalo_l，您也可以从这里手动下载。
• inswapper_128：安装过程中会自动下载到 ComfyUI\models\insightface，您也可以从这里手动下载。
• reswapper_128/256：来自这里，请将其放入 ComfyUI\models\reswapper。
• hyperswap_256：来自这里（hyperswap_1a_256.onnx、hyperswap_1b_256.onnx、hyperswap_1a_256.onnx），请将其放入 ComfyUI\models\hyperswap。
• 人脸修复模型：来自这里，您可以将任何喜欢的模型放入 ComfyUI\models\facerestore_models。
• Ultralytics 模型：来自这里，请将其放入 ComfyUI\models\ultralytics\bbox。
• SAM 模型：来自这里，请将其放入 ComfyUI\models\sams。

使用方法

您可以在菜单 ReActor 中或通过搜索找到 ReActor 节点（只需在搜索栏中输入“ReActor”即可）。

节点列表：

• ••• 主要节点 •••
  • ReActorFaceSwap（主节点）
  • ReActorFaceSwapOpt（带有附加选项输入的主节点）
  • ReActorOptions（ReActorFaceSwapOpt 的选项节点）
  • ReActorFaceBoost（面部增强节点）
  • ReActorMaskHelper（遮罩辅助节点）
  • ReActorSetWeight（设置换脸权重）
• ••• 人脸模型相关操作 •••
  • ReActorSaveFaceModel（保存人脸模型）
  • ReActorLoadFaceModel（加载人脸模型）
  • ReActorBuildFaceModel（构建混合人脸模型）
  • ReActorMakeFaceModelBatch（批量制作人脸模型）
• ••• 其他节点 •••
  • ReActorRestoreFace（面部修复）
  • ReActorImageDublicator（将单张图像复制到图像列表）
  • ImageRGBA2RGB（将 RGBA 转换为 RGB）
  • ReActorUnload（从显存中卸载 ReActor 模型）

连接所有必要的插槽并运行查询。

主节点输入

• input_image —— 是待处理的图像（目标图像，类似于 SD WebUI 扩展中的“target image”）；
  • 支持的节点： “Load Image”、“Load Video”或其他输出图像的节点；
• source_image —— 是包含要交换到 input_image 中的人脸的图像（源图像，类似于 SD WebUI 扩展中的“source image”）；
  • 支持的节点： “Load Image”或其他输出图像的节点；
• face_model —— 是用于“Load Face Model”节点或其他 ReActor 节点的输入，提供您之前通过“Save Face Model”节点创建的人脸模型文件（人脸嵌入）；
  • 支持的节点： “Load Face Model”、“Build Blended Face Model”；
• options —— 用于连接 ReActorOptions；
  • 支持的节点： “ReActorOptions”；
• face_boost —— 用于连接 ReActorFaceBoost；
  • 支持的节点： “ReActorFaceBoost”。

主节点输出

• IMAGE —— 是最终生成的图像输出；
  • 支持的节点：任何接受图像作为输入的节点；
• FACE_MODEL —— 是在换脸过程中构建的源人脸模型输出；
  • 支持的节点： “Save Face Model”、“ReActor”、“Make Face Model Batch”；
• ORIGINAL_IMAGE —— 是 input_image 的旁路输出。

人脸修复

自 0.3.0 版本起，ReActor 节点内置了人脸修复功能。
只需下载您想要的模型（参见安装说明），并在换脸过程中选择其中一种来修复生成的人脸。这将增强面部细节，使您的结果更加精确。

人脸索引

默认情况下，ReActor 会从“大”到“小”检测图像中的所有人脸。
您可以通过添加带有 ReActorOptions 的 ReActorFaceSwapOpt 节点来更改此选项。

如果您需要指定特定的人脸，可以为源图像和输入图像设置索引。

第一个检测到的人脸索引为 0。

您可以按照所需的顺序设置索引。
例如：源图像为 0,1,2；输入图像为 1,0,2。
这意味着：第二个输入图像的人脸（索引 = 1）将被第一个源图像的人脸（索引 = 0）替换，以此类推。

性别

您可以指定在图像中要检测的性别。
ReActor 只有在人脸符合给定条件时才会进行交换。

人脸模型

自 0.4.0 版本起，您可以将人脸模型保存为 “safetensors” 文件（存储在 ComfyUI\models\reactor\faces 目录下），并将其加载到 ReActor 中，以实现不同的场景需求，同时保持所用人脸模型的轻量化。

要使新模型出现在“加载人脸模型”节点的列表中，请刷新您的 ComfyUI Web 应用程序页面。
（建议您使用 ComfyUI Manager——否则，如果您未提前保存工作流，在刷新页面后可能会丢失工作流。）

掩码辅助工具

自 0.5.0 版本起，面部掩码功能可用。只需将“ReActorMaskHelper”节点添加到工作流中，并按如下所示连接：

如果您没有 Ultralytics 的 “face_yolov8m.pt” 模型，可以从 Assets 下载，并将其放入 “ComfyUI\models\ultralytics\bbox” 目录中。

此外，还可以下载 “sam_vit_b_01ec64.pth” 或 “sam_vit_l_0b3195.pth”（遮挡效果更好），如果尚未拥有，则下载后放入 “ComfyUI\models\sams” 目录中。

使用此节点可以获得最佳的人脸交换效果：

人脸交换权重

您可以通过 ReActorSetWeight 节点，将 source_image 或 face_model 的人脸交换强度设置为 0% 至 100%，步长为 12.5%。

故障排除

1. （ComfyUI Portable）从根目录检查 Python 版本：
   打开 CMD 并输入 python_embeded\python.exe -V
2. 根据上一步显示的 Python 版本下载预编译的 Insightface 包：适用于 Python 3.10，适用于 Python 3.11，适用于 Python 3.12，适用于 Python 3.13——并将它们放入 ComfyUI Portable 的根目录。
3. 更新您的 PIP：
   python_embeded\python.exe -m pip install -U pip
4. 然后安装 Insightface：

（适用于 3.10）python_embeded\python.exe -m pip install insightface-0.7.3-cp310-cp310-win_amd64.whl
（适用于 3.11）python_embeded\python.exe -m pip install insightface-0.7.3-cp311-cp311-win_amd64.whl
（适用于 3.12）python_embeded\python.exe -m pip install insightface-0.7.3-cp312-cp312-win_amd64.whl
（适用于 3.13）python_embeded\python.exe -m pip install insightface-0.7.3-cp313-cp313-win_amd64.whl 5. 大功告成！

II. “AttributeError: 'NoneType' 对象没有属性 'get'”

此错误可能发生在模型文件 inswapper_128.onnx 出现问题时。

请尝试从 这里 手动下载该文件，并将其放置在 ComfyUI\models\insightface 目录中，替换现有的文件。

III. “reactor.execute() 获取了意外的关键字参数 'reference_image'”

这表明输入点已在最新更新中发生变化。
请从您的工作流中移除当前的 ReActor 节点，然后重新添加。

IV. 使用 ReActor 节点时 ControlNet Aux 节点导入失败错误

1. 如果 ComfyUI 正在运行，请先关闭它。
2. 进入 ComfyUI 根目录，在 CMD 中运行：
   • python_embeded\python.exe -m pip uninstall -y opencv-python opencv-contrib-python opencv-python-headless
   • python_embeded\python.exe -m pip install opencv-python==4.7.0.72
3. 完成！

V. 在安装 future-0.18.3 时出现 “ModuleNotFoundError: 没有名为 'basicsr' 的模块” 或 “subprocess-exited-with-error” 错误

• 下载 https://github.com/Gourieff/Assets/raw/main/comfyui-reactor-node/future-0.18.3-py3-none-any.whl
  

• 将其放入 ComfyUI 根目录并运行：

  python_embeded\python.exe -m pip install future-0.18.3-py3-none-any.whl
  

• 然后：

  python_embeded\python.exe -m pip install basicsr
  

VI. “fatal: fetch-pack: invalid index-pack output” 当您尝试 git clone 仓库时

请尝试使用 --depth=1（仅克隆最近一次提交）进行克隆：

 git clone --depth=1 https://github.com/Gourieff/ComfyUI-ReActor

如果需要获取其余内容，可以运行：

 git fetch --unshallow

更新

只需将此 Repo 中的 .bat 或 .sh 脚本放入 ComfyUI\custom_nodes 目录，并在需要检查更新时运行即可。

免责声明

本软件旨在为快速发展的AI生成媒体行业做出积极贡献。它将帮助艺术家完成诸如为自定义角色制作动画，或将该角色用作服装模特等任务。

本软件的开发者深知其可能存在的不道德用途，并致力于采取预防措施加以防范。我们将继续秉持合法合规与伦理道德的原则，推动该项目向积极方向发展。

使用本软件的用户应遵守当地法律法规，负责任地使用本软件。若使用真实人物的面部信息，建议事先征得当事人同意，并在在线发布内容时明确标注为深度伪造内容。本软件的开发者及贡献者对最终用户的任何行为不承担任何责任。

通过使用本扩展程序，您承诺不会创建任何以下内容：

• 违反任何法律的内容；
• 对个人或多人造成伤害的内容；
• 传播（散布）任何可能用于伤害他人的信息（无论是公开的还是私人的）或图像（无论是公开的还是私人的）；
• 散布虚假信息；
• 针对弱势群体的内容。

本软件使用了由InsightFace提供的预训练模型buffalo_l和inswapper_128.onnx。这些模型的使用受以下条件约束：

摘自InsightFace许可协议：InsightFace的预训练模型仅可用于非商业性的研究目的。这包括自动下载的模型以及手动下载的模型。

使用本软件的用户必须严格遵守上述使用条件。本软件的开发者和维护者对InsightFace预训练模型的任何滥用行为不承担任何责任。

请注意，如果您打算将本软件用于任何商业目的，您需要自行训练模型，或寻找可用于商业用途的模型。

模型哈希值

可安全使用的模型具有以下哈希值：

inswapper_128.onnx

MD5:a3a155b90354160350efd66fed6b3d80
SHA256:e4a3f08c753cb72d04e10aa0f7dbe3deebbf39567d4ead6dce08e98aa49e16af

1k3d68.onnx

MD5:6fb94fcdb0055e3638bf9158e6a108f4
SHA256:df5c06b8a0c12e422b2ed8947b8869faa4105387f199c477af038aa01f9a45cc

2d106det.onnx

MD5:a3613ef9eb3662b4ef88eb90db1fcf26
SHA256:f001b856447c413801ef5c42091ed0cd516fcd21f2d6b79635b1e733a7109dbf

det_10g.onnx

MD5:4c10eef5c9e168357a16fdd580fa8371
SHA256:5838f7fe053675b1c7a08b633df49e7af5495cee0493c7dcf6697200b85b5b91

genderage.onnx

MD5:81c77ba87ab38163b0dec6b26f8e2af2
SHA256:4fde69b1c810857b88c64a335084f1c3fe8f01246c9a191b48c7bb756d6652fb

w600k_r50.onnx

MD5:80248d427976241cbd1343889ed132b3
SHA256:4c06341c33c2ca1f86781dab0e829f88ad5b64be9fba56e56bc9ebdefc619e43

请务必检查从未经验证（或不可信）来源下载的这些模型的哈希值是否匹配。

点击展开

文件	来源	许可证
buffalo_l.zip	DeepInsight
codeformer-v0.1.0.pth	sczhou
GFPGANv1.3.pth	TencentARC
GFPGANv1.4.pth	TencentARC
inswapper_128.onnx	DeepInsight
inswapper_128_fp16.onnx	Hillobar

BasicSR - @XPixelGroup
facexlib - @xinntao

@s0md3v, @henryruhs - 原始Roop应用
@ssitu - ComfyUI_roop扩展的第一个版本

ComfyUI-ReActor 快速上手指南

cd ComfyUI/custom_nodes
git clone https://github.com/Gourieff/ComfyUI-ReActor.git

cd ComfyUI-ReActor
pip install -r requirements.txt

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

1. 换脸模型 (可选，支持 Inswapper, ReSwapper, HyperSwap):

   • 下载地址: HuggingFace - Gourieff/ReActor 或 FaceFusion Models
   • 放置目录:
     • Inswapper/ReSwapper: ComfyUI/models/inswapper 或 ComfyUI/models/reswapper
     • HyperSwap: ComfyUI/models/hyperswap (需下载 hyperswap_1a_256.onnx 等)

2. 检测与修复模型 (可选，用于高级功能):

   • face_yolov8m.pt: 放入 ComfyUI/models/ultralytics/bbox
   • sam_vit_b_01ec64.pth: 放入 ComfyUI/models/sams
   • 面部修复模型 (GPEN 等): 放入 ComfyUI/models/facerestore_models

基本使用

1. 最简单的工作流

创建一个基础的换脸工作流，只需三个核心节点：

1. 加载源图像 (Load Image): 上传包含目标人脸的图片（Source）。
2. 加载目标图像 (Load Image): 上传需要被换脸的图片（Target）。
3. ReActor Face Swap 节点:
   • 将源图像连接到 source_image 输入。
   • 将目标图像连接到 target_image 输入。
   • Source Face Index: 设置源图中使用哪张脸（0 代表第一张检测到的脸）。
   • Target Face Index: 设置目标图中替换哪张脸（留空或设为 0 替换所有检测到的脸，或用逗号分隔如 0,1 指定特定脸部）。
   • 点击 "Queue Prompt" 生成结果。

2. 进阶功能示例

调整换脸强度

使用 ReActorSetWeight 节点控制换脸融合度（0% - 100%）：

• 将 ReActor Face Swap 的输出连接到 ReActorSetWeight 的输入。
• 调整 weight 参数（步长 12.5%），数值越低保留原图特征越多。

面部修复与增强

若换脸后画质模糊，可启用修复功能：

• 在 ReActor Face Swap 节点中勾选 Face Restoration。
• 选择修复模型（如 CodeFormer 或 GPEN）。
• 或使用新版节点 Restore Face Advanced 对特定区域进行精细化修复。

混合人脸模型 (Blended Face Model)

为了提高相似度，可将同一个人的多张照片混合成一个模型：

1. 使用 Make Image Batch 节点加载多张同一人的照片。
2. 连接到 ReActorBuildFaceModel 节点。
3. 将生成的 face_model 输出连接到主换脸节点的 face_model 输入（替代直接使用 source_image）。

注意事项

• 合规性: 本插件内置 NSFW 检测器，若检测到违规内容将拒绝处理，请确保使用合法合规的素材。
• 显存管理: 处理复杂工作流或视频时，若显存不足，可使用 Unload ReActor Models 节点释放资源。
• 顺序控制: 默认按人脸大小排序，可在 ReActorOptions 节点中自定义源图和目标图的人脸索引顺序。