★ FEATURED ARTICLE 5 分钟搞定 FaceFusion 模型下载从断网续传到内网部署【免费下载链接】facefusionIndustry leading face manipulation platform项目地址: https://gitcode.com/GitHub_Trending/fa/facefusionFaceFusion 首次运行前要先拉一批模型文件小的 2.5MB大的约 340MB加起来要留 2GB 左右的空间。FaceFusion 模型下载出故障基本就卡在三个地方下载中断、校验失败、内网拉不到文件。这篇文章按你的网络状况分三条路线每一步只给一条能直接跑的命令。下载前4 项自查动手前花一分钟确认环境能省掉后面 90% 的重跑。检查项怎么看不达标怎么办磁盘空间df -h .当前盘至少留 2GB不足先清理网络ping -c 3 github.com超时或丢包严重换时段或走代理依赖确认 Python 3.10以及curl、ffmpeg、ffprobe可用缺哪个装哪个模型目录项目根目录是否已有.facefusion/已有就跳过下载直接进验证环节先跑这一条把空间、网络、依赖一次确认完df -h . ping -c 3 github.com which python curl ffmpeg ffprobe看到 0% 丢包、四个路径都打印出来就具备开工条件了。对号入座你的网络属于哪种网络状况推荐路线能稳定访问下载源直接run交给首次运行的自动下载下载源时通时断force-download强制下载中断后重跑即可续传完全离线内网联网机上预下载打包搬运.facefusion/动手三种场景各走各的路外网顺畅交给自动下载网络没毛病就不用折腾直接启动python facefusion.py run首次运行会自动拉取所需模型。下载器内置了 5 次重试偶发的网络抖动一般不用管跑完看到界面正常打开就说明模型就位。网络飘忽强制下载一步到位信号时好时坏时改用force-download一次性拉齐文件。范围用--download-scope控制lite只下必需文件full拉全量下载源用--download-providers切支持github和huggingfacepython facefusion.py force-download --download-scope full进度条会显示已下字节数和当前提供商。中途断了就重跑同一条命令已有的文件会接着下不用从头来。全部拉完、没有报错信息就可以进验证环节。彻底没网手动搬运内网机器本身拉不到文件思路就是一条在联网机上把模型备齐再整体搬过去。python facefusion.py force-download --download-scope full联网机上跑完后.facefusion/目录里就是完整的模型家底face/下是inswapper_128.onnx约 95MB这类交换模型face_enhancer/下是gfpgan_1.4.onnx约 340MBface_detector/下是yoloface_1n.onnx约 6.5MB、scrfd_2.5g.onnx约 2.5MBframe_enhancer/下是real_esrgan_x4.onnx约 67MB。搬运步骤见下文。下完别急着跑验证与收尾⚠️ 模型下载失败最常见的根因是文件不完整下到一半断掉文件在、内容是坏的。FaceFusion 给每个模型都配了一个.hash文件存 CRC32 摘要所以先对整个目录做一遍哈希校验python -c from facefusion.filesystem import resolve_file_paths from facefusion.download import validate_source_paths valid, invalid validate_source_paths(resolve_file_paths(.facefusion)) print(invalid:, len(invalid) or ALL OK)看到invalid: ALL OK说明所有文件都能对上哈希。如果列出了具体文件那就是它们坏了回到强制下载把对应文件重拉一遍再校一次。确认无误后顺手清掉残留的临时文件find .facefusion -name *.tmp -delete find .facefusion -name *.part -delete这条命令只删半截文件正常模型不会被动到。离线环境部署把模型搬进内网机器 .facefusion/目录和代码是分开的部署到离线机器只需要搬这个目录。打包、传输、恢复三步tar -czf facefusion-models.tar.gz .facefusion/ scp facefusion-models.tar.gz user内网机器:~/目标机上执行解压再做一次哈希校验通过后就能正常run了tar -xzf facefusion-models.tar.gz -C 项目根目录/ find .facefusion -name *.tmp -delete find .facefusion -name *.part -delete如果目标机上的.facefusion/里混着旧版本文件用哈希校验的结果定位坏文件逐个重拉即可不用整个目录推倒重来。快问快答Q模型下载失败、一直卡在同一进度怎么排查先用ping -c 3 github.com判断是源不通还是中途断流。源不通就换时段、走代理或改用--download-providers huggingface换源中途断流就重跑force-download断点续传会接上。Q强制下载中断了必须从头再来吗不用。重跑同一条命令即可下载模块 会先对比本地文件大小已有的部分直接从断点继续。Q--download-scope到底选 lite 还是 fulllite只拉必需文件适合先验证环境full拉齐所有功能文件正式使用建议直接上full一次到位。Q完全离线的内网环境模型该放哪项目根目录的.facefusion/子目录按功能分好face/、face_enhancer/、face_detector/等每个文件旁边都有同名.hash文件目录结构照抄联网机即可。三条路线记住一句话能直连就交给自动下载网络飘忽就上force-download加断点续传彻底没网就在联网机预下载再打包搬运最后都用哈希校验验收。现在就跑一遍上面那条自查命令把磁盘、网络、依赖一次确认完。【免费下载链接】facefusionIndustry leading face manipulation platform项目地址: https://gitcode.com/GitHub_Trending/fa/facefusion创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
