Roop作为开源换脸工具，运行前必须加载inswapper_128.onnx这个核心模型。很多用户第一次启动程序时，会发现它自动从远程仓库拉取该文件，速度极慢甚至反复失败，导致根本进不去主界面。这种情况并不是软件坏了，而是默认下载源在国外，国内网络访问受限。
手动下载模型再指定本地路径，是绕过网络瓶颈最直接的办法。我们只需要提前把inswapper_128.onnx文件存到电脑里，然后告诉Roop去哪个文件夹找它，程序就不会再尝试联网获取。下面从下载渠道、存放位置、配置修改三方面详细说明。
一、inswapper_128.onnx手动下载渠道
这个模型文件体积大约在五百多兆，属于中等大小。最稳妥的来源是Hugging Face上的公开模型仓库，搜索inswapper_128.onnx就能看到多个镜像。如果Hugging Face访问不畅，也可以去GitHub上一些Roop衍生项目的release附件里找，不少开发者打包了完整模型供离线使用。
下载时重点核对文件大小，正常应为五百三十兆左右，明显偏小的可能是损坏或没下完。建议用支持断点续传的下载工具，比如迅雷或者浏览器自带下载器，避免中途断开又要重来。拿到文件后先放在桌面或下载目录，方便后续移动。
二、模型文件存放路径规划
Roop在运行时会去固定的模型目录读取文件，不同系统位置不一样。Windows通常解压后在Roop根目录的models文件夹，Linux一般在用户目录下的.roop/models。我们要把inswapper_128.onnx放进对应models目录，不要改文件名，否则程序识别不了。
如果models文件夹不存在，就自己新建一个。有些整合包把模型放在assets或者weights目录，这时要看软件文档说明。放好之后可以打开文件夹确认，文件图标正常、大小正确即可，不需要解压，因为onnx本身就是模型格式。
三、路径配置与启动设置
多数Roop版本支持命令行参数指定模型路径，例如启动时使用 --inswapper_model_path 后面接文件绝对地址。如果不想每次输命令，可以修改配置文件config.ini，找到model_path相关字段填入本地位置。部分图形界面版在设置页有模型路径输入框，直接浏览选中文件就行。
配置完重启程序，日志里若显示loaded inswapper from local则说明成功走本地读取。此时换脸速度只取决于显卡性能，不再受网络影响。下表列出常见系统默认路径方便对照。
| 系统 | 默认模型目录 | 备注 |
|---|---|---|
| Windows | Roop安装目录/models | 便携版直接放解压处 |
| macOS | ~/Library/Application Support/roop/models | 需显示隐藏目录 |
| Linux | ~/.roop/models | 终端用ls -a查看 |
四、常见错误与排查
有人放完文件还是报找不到模型，一般是路径里有中文或空格，程序解析出错。建议模型目录全英文，比如D:/roop/models。还有情况是下载了错误版本，比如fp16和fp32混用，普通Roop用fp32标准版即可。
若启动仍尝试联网，检查是否配置文件没保存，或者命令行参数拼写错误。用任务管理器看网络占用，若本地读取成功基本无下载流量。实在不行删除缓存重新指路径，九成问题都能解决。
五、总结建议
手动下载inswapper_128.onnx并配置本地路径，是处理Roop模型下载慢的最优解。它不依赖特殊网络环境，一次配置长期受益。建议新装环境就先备好模型文件，省去后续等待焦虑。
平时多关注模型更新，但换脸核心模型很少大改，旧文件也能用很久。掌握这套方法，你不仅能搞定Roop，其他类似AI工具遇下载卡顿也可举一反三，直接本地化部署提升效率。
Roop模型下载inswapper_128.onnx手动下载模型路径配置修改时间：2026-08-10 13:03:39