IOPaint 模型下载卡 Connection Refused：Lama-Cleaner 换源与手动落盘两条路径的完整修复

IOPaint 模型下载卡 Connection RefusedLama-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/IOPaintIOPaint 的 Lama-Cleaner 模型默认从境外源拉取big-lama.pt 体积约 2.3GB国内网络下常报 Connection Refused把首次部署卡死在模型下载这一步。读完后可以换内网镜像或手动落盘让 IOPaint 用 lama 模型跑通图片去文字、去水印。先确认是不是同一个坑对号入座三条中占一条再往下走日志里出现Connection Refused或Connection reset by peer且卡在下 big-lama.pt 的阶段下载速度掉到 0长时间不动最终超时退出文件下了一半被删日志提示 MD5 不符校验逻辑在 iopaint/helper.py下载逻辑在 iopaint/model/lama.py。根因基本就三种GitHub 源访问不稳、单位/校园网防火墙拦境外资源、2.3GB 大文件传输中断。不用深入原理先修。两条修复路径挑一条走默认推荐路径A改动最小拿不到稳定镜像时走路径B。路径A环境变量换源默认推荐直接把下载源指到内网或可达镜像。默认源与 MD5 的读取位置在 iopaint/model/lama.py 的LAMA_MODEL_URL与LAMA_MODEL_MD5两个环境变量MD5 固定为e3aa4aaa15225a33ec84f9f4bc47e500换源时不能改。export LAMA_MODEL_URLhttps://your-mirror.example.com/models/big-lama.pt export LAMA_MODEL_MD5e3aa4aaa15225a33ec84f9f4bc47e500Windows 用set代替export或直接加到 scripts/user_scripts/win_start.bat 的启动命令之前。改完重启 IOPaint拉取即走新源。路径B手动把 big-lama.pt 放进缓存目录先取文件、放对目录、验 MD5三件事一次做完。校验值对上加载阶段就不再联网。cp /path/to/big-lama.pt ~/.cache/iopaint/models/ md5sum ~/.cache/iopaint/models/big-lama.pt # 期望输出 e3aa4aaa15225a33ec84f9f4bc47e500Windows 的目录换成%LOCALAPPDATA%\iopaint\models\用certutil -hashfile big-lama.pt MD5校验。注意模型目录根由XDG_CACHE_HOME决定iopaint/const.py 中DEFAULT_MODEL_DIR动过该变量的机器目录可能不在默认位置。一条命令验证跑下面两条第一条确认模型在不在第二条起 WebUI模型已就位时启动不再触发下载localhost:8080即可进编辑器试去文字、去水印。python -m iopaint.cli download --model lama python main.py --model lama卡住时的速查表先按表对症状多数是这四类现象可能原因处理MD5 不匹配传输中断或源文件本身损坏重新取文件再跑一次md5sum校验缓存目录 Permission denied目录属主或权限不对修复权限如chmod -R 755 ~/.cache模型加载失败torch 相关报错依赖版本不匹配按 requirements.txt 重装依赖下载反复中断、空间告警缓存所在磁盘满了export XDG_CACHE_HOME/large_disk/.cache指到空间充足的分区修通之后顺手试试人脸模糊的老照片可开 GFPGAN 插件做修复实现在 iopaint/plugins/gfpgan_plugin.py。要擦除后重绘文字或物件切到 Power Paint代码在 iopaint/model/power_paint/。还有别的卡点直接提 issue 到项目仓库或来社区贴日志。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考