企业官网建设流程全解析

IOPaint 图像修复模型下载被拒？3 步快速修复 Lama-Cleaner 环境

【免费下载链接】IOPaintImage inpainting tool powered by SOTA AI Model. Remove any unwanted object, defect, people from your pictures or erase and replace(powered by stable diffusion) any thing on your pictures.项目地址: https://gitcode.com/GitHub_Trending/io/IOPaint

IOPaint 是一款基于 SOTA AI 模型的开源图像修复工具，能从照片里擦除不需要的物体、人物与文字。启动时如果 Lama 模型反复因网络问题下载失败，按本文 3 步操作，10 分钟内即可恢复去除功能。

🔍 症状自查

启动 IOPaint 并准备使用默认的 lama 模型时，如果看到下面任意一种表现，就是模型下载环节出了问题：

• 日志打印Connection refused或超时后进程直接退出，WebUI 打不开
• 日志卡在Downloading "https://.../big-lama.pt"，2.3GB 的文件传到一半就断开
• 每次重启都提示重新下载，始终装不上，模型列表里看不到 lama

下载动作集中在 Lama 模型定义 中，地址和 MD5 都有默认值，所以只需解决"把文件拿进来"这一件事。

🛠️ 分步修复路径：环境变量与手动放置模型

第 1 步：用环境变量切换模型下载源

程序启动时会先读两个环境变量，读不到才用默认地址。先设置它们再启动：

export LAMA_MODEL_URL="你的镜像源地址/big-lama.pt" export LAMA_MODEL_MD5="e3aa4aaa15225a33ec84f9f4bc47e500"

这样做的意义：下载源换成你本地能连通的地址，而 MD5 保持官方值不变，程序才能校验文件没传坏。Windows 用户把同样的语句写进 启动脚本 即可。设置后重启 IOPaint，日志会显示它正从新地址拉取。

第 2 步：手动放置模型文件到缓存目录

镜像源也不稳时，自己把big-lama.pt下载好放进默认缓存位置（路径规则见 模型下载与校验逻辑）：

• Linux/Mac：~/.cache/torch/hub/checkpoints/big-lama.pt
• Windows：%USERPROFILE%\.cache\torch\hub\checkpoints\big-lama.pt

程序每次启动都会检查这个位置，文件在就直接跳过下载。放好后做一次完整性确认：

md5sum ~/.cache/torch/hub/checkpoints/big-lama.pt # 期望输出 e3aa4aaa15225a33ec84f9f4bc47e500

值一致就说明模型可用；不一致就重新下载，不用排查其他环节。

第 3 步：CLI 下载命令触发拉取

不想等 WebUI 自动下载，可以主动用命令行完成下载与校验：python -m iopaint.cli download --model lama。该命令由 CLI 下载入口 提供，成功后打印Done.；若再次报网络错误，回到第 1 或第 2 步处理。

图 1：水印被干净去除，背景填充无痕迹

✅ 验证是否生效

用一条最轻量的命令确认模型已就位：

python -m iopaint.cli list

输出中出现lama即准备完成。接着执行python main.py start --model lama打开 WebUI，刷上蒙版点击生成，背景应被自然补全，不再出现白块或残留。

图 2：涂抹蒙版后，画面中不需要的物体被平滑移除

⚠️ 常见坑与备选方案

📌 总结

整套方案的核心就一条：让big-lama.pt进入缓存目录并通过 MD5 校验——环境变量换源或手动放置，任选其一即可。环境跑通后，还可以继续体验 GFPGAN 人脸修复插件 与 power_paint 的 AI 绘画增强，也欢迎把你的可用镜像源分享到项目讨论区。

【免费下载链接】IOPaintImage inpainting tool powered by SOTA AI Model. Remove any unwanted object, defect, people from your pictures or erase and replace(powered by stable diffusion) any thing on your pictures.项目地址: https://gitcode.com/GitHub_Trending/io/IOPaint