IOPaint Lama 模型下载连接被拒绝？Connection Refused 排查与修复完整指南

IOPaint Lama 模型下载连接被拒绝Connection Refused 排查与修复完整指南【免费下载链接】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 启动时终端卡在拉取模型并抛出 Connection Refused这就是 Lama 模型下载连接被拒绝的典型现场默认擦除模型无法从网络获取。下面按三档方案把它修好。场景还原Lama 模型下载在哪些情况下卡住IOPaint 默认使用 lama 作为擦除模型。首次启动、或换成一个未下载的模型时程序会从源码里写死的 GitHub Releases 地址拉取big-lama.pt约 200MB。你会在这三种情况下卡住终端打印Downloading: https://github.com/...后等待数秒报 Connection Refused 或超时防火墙、代理拦截境外下载或大文件传一半中断缓存目录只剩残损文件系统盘空间不足下载进行到一半报 No space left on device模型正常加载后擦除效果类似下图去水印前后对比右侧为 Lama 处理结果背后机制缺模型时 IOPaint 做了什么流程只有三件事先查本地缓存目录有没有big-lama.pt有就直接加载没有就从源码写死的 URL 下载完成后校验 MD5官方值e3aa4aaa15225a33ec84f9f4bc47e500校验通过才算模型可用。所以排查只围绕两件事文件落到磁盘、MD5 对上。默认缓存位置是~/.cache/torch/hub/checkpoints/。分层解决从完全不走网络到改镜像源第一档快速通道手动放置模型文件完全绕开下载适用场景网络完全不通或你手头已有别的渠道拿到的big-lama.pt。做完后能看到启动日志不再出现 Downloading服务直接监听 8080 端口。把文件放进缓存目录mkdir -p ~/.cache/torch/hub/checkpoints # 将 big-lama.pt 复制到该目录校验完整性md5sum ~/.cache/torch/hub/checkpoints/big-lama.pt失败判断依据输出不等于e3aa4aaa15225a33ec84f9f4bc47e500说明文件损坏删掉重新获取一致则直接启动即可。第二档彻底方案环境变量重定向模型下载地址适用场景没法手动拿文件但有可访问的镜像。原理见 源码位置——URL 和 MD5 都从环境变量读取。export LAMA_MODEL_URLhttps://你的镜像域名/big-lama.pt export LAMA_MODEL_MD5e3aa4aaa15225a33ec84f9f4bc47e500Windows 用户在启动脚本 win_start.bat 里用set写同样两行。MD5 必须保持官方值不要跟着镜像改。失败判断依据若日志打印Downloading: https://你的镜像域名/... to ...说明变量已生效、只是地址不通若仍打印 github.com 地址说明变量没被进程读到检查是否在同一个终端里 export、或 bat 里 set 的位置。第三档备选通道CLI 重试下载 缓存目录迁移适用场景前两档都失败或系统盘满了。先单独触发下载把问题和启动流程隔离开python main.py download --model lama若报磁盘不足把缓存根迁到大盘分区见 const.py 中XDG_CACHE_HOME的读取逻辑再执行一次上面命令export XDG_CACHE_HOME/data/disk1/.cache注意迁移后缓存实际落在$XDG_CACHE_HOME/torch/hub/checkpoints/。验证与回滚一条命令确认修复生效python main.py list输出里出现lama即模型就绪。再启动服务python main.py start --model lama --port 8080回滚方法改坏了就还原现场——关掉终端重开环境变量自动失效删掉手动放置的文件若迁移过缓存目录把unset XDG_CACHE_HOME后旧目录里的文件仍在服务照常加载。避坑清单常见错误对照表现象原因处理重启后不再下载但模型加载报错之前中断留下残损文件程序误以为已下载手动删除缓存目录里的big-lama.pt再重试日志提示 wrong model deleted 并退出下载完成但 MD5 校验失败代码已自动删除坏文件重新运行即可Permission denied缓存目录不可写换可写路径设置XDG_CACHE_HOMElist看不到 lama但文件确认存在下载与启动使用了不同的模型目录启动时传--model-dir与文件位置保持一致延伸模型就绪之后还能做什么动漫风格图片可换用 anime-lama 模型改法与上面完全一致另设ANIME_LAMA_MODEL_URL详见 lama 模型源码攒好模型后可以批量处理文件夹命令入口在 cli.pyWebUI 里可叠加 GFPGAN 人脸修复实现在 plugins/gfpgan_plugin.py改镜像源时还遇到其他报错欢迎在讨论区贴出日志我们一起看。【免费下载链接】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），仅供参考