IOPaint 完整指南：免费开源的 AI 图像修复工具，三步擦除照片里的任何物体
项目地址: https://gitcode.com/GitHub_Trending/io/IOPaint IOPaint 是一款免费开源的 AI 图像修复工具，能把照片里你不想要的物体、水印、路人一键擦除，还能用 Stable Diffusion 把擦掉的区域重新画上你想画的东西。它完全在本地运行，照片不会上传到任何服务器。下面这篇指南带你从零快速上手，从最基础的去水印到进阶的批量修复都能搞定。
🎯 什么时候你会需要它
大多数人的需求其实就三件事，IOPaint 都覆盖：
去掉照片上的水印
图库图、演示图上常见的斜排水印，用 IOPaint 的默认模型 LaMa（一款专门做图像补全的修复模型）就能抹平，背景纹理会自然衔接。
处理完成后，水印消失，画面细节保留完整：
擦除画面中不想要的物体
多出来的气球、路过的行人、杂物，都可以框选后交给 AI 补全。下面这张照片左上角多出的白色气球被擦除后，屋顶木架结构依然完整：
修复老旧照片
磨损、划痕、褪色严重的老照片，也可以用同样思路处理，让画面更清爽：
🚀 从安装到出图只需三步
IOPaint 支持 CPU、GPU 和 Apple Silicon，不需要专门配环境。整个过程就三步。
第一步，安装。在终端里执行 pip3 install iopaint，装好就完成依赖配置。
第二步，启动服务。执行下面这条命令，模型会在启动时自动下载，不用你手动找文件：
iopaint start --model=lama --device=cpu --port=8080
第三步，打开浏览器访问 http://localhost:8080，就能看到操作界面。选图、用画笔圈住要处理的区域、点运行，等几秒钟就能出图。
如果你只想要最简单的体验，Windows 用户也可以直接看 一键安装包脚本。想换成 GPU 加速，把命令里的 --device=cpu 改成 --device=cuda 即可。
✏️ 标记区域的最佳画法
IOPaint 靠"标记"来判断要处理哪里，标记的质量直接决定效果：
- 用适中大小的画笔把目标区域盖满，边缘略往外圈一圈更稳。
- 复杂物体可以分几次小块标记，别一次糊一大片。
- 只想去水印这类细线条时，顺着线条描边即可，不必涂满整块。
界面里支持预览，标记完可以先看一眼遮罩范围再运行，避免擦过头。
🔁 进阶玩法：换模型做"重绘"而不是"擦除"
默认的擦除模型负责"抹掉"，但如果你想让抹掉的地方长出新东西，可以切到扩散模型。IOPaint 内置了 Stable Diffusion、SDXL 等模型，支持"按提示词重绘"和"向外扩展画面"（outpainting）。
几个常用方向：
- PowerPaint：边涂边生成新内容，适合替换物体。
- AnyText：专门用来在图里生成文字，做海报、贴图很顺手。
- Stable Diffusion / SDXL 系列：通用重绘，支持接各种社区模型。
启动时加 --model 指定模型名就能切换，可选模型清单见 模型目录。模型文件首次会自动下载，也可以用 --model-dir 改存放位置。
📦 批量处理与实用插件
如果你有一堆图要处理，不用一张张点。命令行里用 run 子命令就能批量跑，把原图和遮罩分别指向对应文件夹：
iopaint run --model=lama --device=cpu \
--image=/path/to/images \
--mask=/path/to/masks \
--output=output_dir
当 --mask 指向单个文件时，所有图都会用同一个遮罩，很适合做统一的水印清理。
除了核心模型，IOPaint 还带了一组可选插件，启动时加对应开关就能用，源码在 插件目录：
- Segment Anything（交互式分割）：点一下就能精准选中物体，比手绘画笔更快。
- GFPGAN / RestoreFormer：人脸修复，适合老照片里的脸部。
- RealESRGAN：超分辨率放大，把低清图变清晰。
- RemoveBG / Anime Seg：抠背景，分别为通用图和二次元图训练。
🔒 照片为什么不会上传云端
这一点是很多人最关心的。IOPaint 是"自托管"的工具，也就是服务跑在你自己的机器上：界面、模型、图片处理全都在本地完成，不会把照片传到第三方服务器。对隐私敏感的场景——比如处理证件照、客户素材——这一点对比那些要上传的在线工具更放心。模型文件首次下载后也会缓存在本地，之后离线也能用。
常见问题
- 显存不够怎么办？ 启动时加
--low-mem或--cpu-offload，把部分权重放到内存里，能明显降低显存占用。 - 想要 Apple Silicon 加速？ 大多数模型会自动用上 MPS（苹果芯片的加速方式），个别擦除模型会自动回退到 CPU，不影响使用。
- 换电脑怎么办？ 用
--model-dir指定模型目录，把缓存目录拷过去就行，不用重新下载。
去体验一下
IOPaint 完全免费开源，没有内购也没有订阅。你可以先在本地跑起来试去水印，再慢慢玩扩散模型和插件，按自己的节奏来。打开终端装一下、启动服务，几分钟就能看到自己的第一张修复图。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
