3 分钟跑通 FaceFusion 模型下载离线部署与校验失败修复指南【免费下载链接】facefusionIndustry leading face manipulation platform项目地址: https://gitcode.com/GitHub_Trending/fa/facefusion第一次跑 FaceFusion 这种人脸交换、人脸增强工具你大概率会卡在同一个地方程序要先从 GitHub 或 HuggingFace 拉取几十种 ONNX 推理模型网络一受限进度条停在 0最后报错退出。这篇指南带你把force-download命令、lite / full 两种下载范围、内网离线部署一次讲清楚照着敲就能跑通。快速上手3 条命令完成模型下载前置条件Python 3.10 及以上系统里装好 curl、ffmpeg、ffprobe 三个依赖。git clone https://gitcode.com/GitHub_Trending/fa/facefusion cd facefusion pip install -r requirements.txt然后执行下载python facefusion.py force-download它会扫描所有处理器模块先拉取.hash校验文件再下载对应的 ONNX 模型到.assets/models/目录最后逐个做 SHA256 校验。日志里全部通过后跑python facefusion.py run就能用了。默认下载的是lite范围最小可用模型集。要启用全部功能就指定fullpython facefusion.py force-download --download-scope full访问不了 GitHub 时切换下载源--download-providers默认值是github huggingface程序按顺序挑一个能连通的地址。GitHub 不通的时候直接强制走 HuggingFacepython facefusion.py force-download --download-providers huggingface这里有个省事的设计HuggingFace 源内置了两个候选地址官网和国内镜像 hf-mirror逐个 ping 通一个用哪个逻辑都在 facefusion/download.py 里不用你手动配任何镜像。内网与离线机器部署完全断网的机器没法在线下载思路是联网机上把模型备齐打包搬过去离线机器只做校验。联网机执行python facefusion.py force-download --download-scope full。打包模型目录tar -czf facefusion-assets.tar.gz .assets传到离线机解压到仓库根目录再跑一遍 force-downloadtar -xzf facefusion-assets.tar.gz python facefusion.py force-download此时命令发现文件齐全且哈希匹配只做本地校验不会发起任何下载。校验全过机器就算部署完成了。团队协作一份模型多处复用多人环境不必每台机器单独下模型。把校验通过的.assets/models/目录整体拷到共享盘或内网文件服务器新机器放进相同路径后重跑force-download即可。想抽查某个文件是否完好对比一下 SHA256 就行sha256sum .assets/models/scrfd_2.5g.onnx cat .assets/models/scrfd_2.5g.onnx.hash两个值一致文件就是完整的。避坑与排错现象日志出现 deleting corrupt source下载反复重来。原因上次下载中断留下了不完整的文件。修复程序会自动删除坏文件重新拉取等本轮 force-download 自然跑完即可。现象进度条不动curl 报超时。原因当前网络访问不了已配置的下载源。修复先试--download-providers huggingface自带镜像仍不行再检查系统代理。现象命令直接报版本或依赖缺失错误。原因不满足 Python 3.10或 curl / ffmpeg / ffprobe 缺装。修复换新 Python 重装依赖Linux 上先补齐 ffmpeg 和 ffprobe。进阶固定下载配置与查看模型来源不想每次带参数把配置写进facefusion.ini[download] download_providers github huggingface download_scope full想确认某个模块到底依赖哪些模型看 facefusion/face_detector.py 里的create_static_model_set每个模型的校验文件、存放路径和下载地址都定义在那里。下载入口的完整逻辑在 facefusion/core.py 的force_download函数排障时值得对照着看。模型下载这件事的关键就一条先让 force-download 把文件拿全再用 SHA256 保证它没坏离线环境则直接搬.assets整个目录。从lite范围起步用到新功能再补--download-scope full把常用模型目录放进内网共享盘新机器免重复下载网络问题排查时先换--download-providers huggingface快速确认是不是源的问题【免费下载链接】facefusionIndustry leading face manipulation platform项目地址: https://gitcode.com/GitHub_Trending/fa/facefusion创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考