IOPaint 使用指南：如何免费快速修复图片、去除水印和移除物体-平芜编程栈

IOPaint 使用指南：如何免费快速修复图片、去除水印和移除物体

【免费下载链接】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 是一款开源免费的 AI 图像修复工具，核心任务就一件：把照片里的水印、路人、杂物等不想要的东西抹掉，或者用 Stable Diffusion 把被涂掉的区域重新画出来。全程不用任何商业软件，模型启动时自动下载。

最快上手：三条命令跑起来

安装：一行命令装好依赖和命令行工具
```
pip3 install iopaint
```
启动服务：指定 LaMa 模型和 CPU 设备，首次启动会自动下载模型（下载目录可用--model-dir改）
```
iopaint start --model=lama --device=cpu --port=8080
```
验证：浏览器打开 http://localhost:8080 ，能看到上传图片和涂遮罩的界面就成功了。

按场景用：去水印、移除物体、擦文字

去掉素材图水印的最短路径

买来的素材图满屏水印，手动抠图费时还留毛边。操作路径只有一条：启动上面的服务 → 在网页里打开图片，用遮罩笔刷把水印区域涂黑 → 选择模型、点开始 → 下载处理后的图。

移除照片里的多余物体

路人、杂物、设备线挡住主体是常见痛点。涂遮罩的范围决定效果，建议遮罩比目标物体多留一圈边缘，修复会更自然。

擦掉画面上挡路的文字

游戏截图、海报上的大标题常挡住核心画面。LaMa 模型擦这种纯色或简单背景上的文字效果稳定，涂掉文字区域即可。

漫画去对话气泡

漫画扫描图上密集的日文气泡和杂乱线条，用同一套"涂遮罩 + 修复"流程就能处理，处理完线条更干净，适合做二次元素材。

进阶玩法：批量、插件、Docker

批量处理文件夹里的图片

要修几十张图时别一张张点网页，用命令行iopaint run直接跑文件夹：--image放输入图片，--mask放遮罩文件夹，输出到--output。

iopaint run --model=lama --device=cpu \ --image=/path/to/image_folder \ --mask=/path/to/mask_folder \ --output=output_dir

两个实用细节：遮罩文件夹里的文件要和图片同名配对；如果--mask指向单个遮罩文件，则同一张遮罩会应用到文件夹里所有图片。

启动时带上插件

插件用启动参数开启，所有可用的开关用iopaint start --help查看。以交互式分割为例（基于 Segment Anything，点击即可框出对象）：

iopaint start --enable-interactive-seg --interactive-seg-device=cuda

仓库自带的插件一览（源码在 iopaint/plugins/）：

插件	干什么用
GFPGAN	人脸修复、美化
RealESRGAN	图像超分辨率放大
RemoveBG	移除背景、提取前景
AnimeSeg	动漫角色分割
InteractiveSeg	交互式选区，涂不准遮罩时用它辅助

用 Docker 部署

适合固定在服务器上用。仓库的 docker/ 目录里有 GPU 和 CPU 两份 Dockerfile：

docker build -t iopaint -f docker/GPUDockerfile . docker run --gpus all -p 8080:8080 iopaint

CPU 环境把-f换成docker/CPUDockerfile并去掉--gpus all即可。

选模型与避坑

什么场景配什么模型

场景	推荐配置	依据
快速去物体 / 去水印	`--model=lama`	轻量，日常首选，见 README.md
复杂区域、需要细节重绘	Stable Diffusion 系列	修复质量上限更高
漫画 / 绘画类图片	BrushNet 或 PowerPaint	针对绘画场景的修复模型
批量文件	LaMa +`iopaint run`	命令行直出，不用开网页

常见问题与解法

首次启动等很久：不是卡死，模型在自动下载；想换下载目录就加--model-dir。
想用 GPU 加速：先装 CUDA 版 PyTorch（README 里有对应安装命令），再把--device=cpu改成 GPU 设备；AMD 显卡用 ROCm 版，仅支持 Linux。
批量处理对不上文件：遮罩必须和图片同名；要统一用一张遮罩时，把--mask指到那个文件而不是文件夹。
忘了某个插件怎么开：iopaint start --help会列出全部插件开关，不用翻文档。