FFT NPainting LAMA快速部署教程,本地WebUI三步搞定
你是不是也遇到过这样的问题:一张精心拍摄的照片,却被路人、电线杆、水印或杂物破坏了整体美感?想用专业工具修复,却发现Photoshop操作复杂、AI工具又需要注册账号、上传云端,隐私和效率都成问题?今天这篇教程,就带你用FFT NPainting LAMA镜像,在自己电脑上三步完成本地化图像修复——不联网、不上传、不依赖GPU显卡(CPU也能跑),真正把“移除物体”“擦除水印”“修复瑕疵”变成一件开箱即用的事。
这不是一个需要编译源码、配置环境变量、调试CUDA版本的硬核工程;而是一套由开发者“科哥”二次封装优化的轻量级WebUI方案。它基于LAMA(LaMa: Resolution-robust Large Mask Inpainting)模型,融合FFT频域增强策略,在保持边缘自然、纹理连贯、色彩一致方面表现稳定。更重要的是,整个流程对新手友好:不需要懂Python,不用装Conda,甚至不需要知道什么是“inpainting”。
下面我们就从零开始,用最直白的方式,带你把这套图像修复系统跑起来。
1. 环境准备与一键启动
1.1 前置要求确认
这套方案已在主流Linux发行版(Ubuntu 20.04/22.04、CentOS 7/8)实测通过,对硬件要求极低:
- 最低配置:2核CPU + 4GB内存 + 10GB可用磁盘空间
- 推荐配置:4核CPU + 8GB内存(处理1500px以上图像更流畅)
- 无需独立显卡:全程使用CPU推理,避免NVIDIA驱动、CUDA版本等兼容性烦恼
- 无需Python基础:所有依赖已预装,你只需要执行一条命令
小贴士:如果你用的是Windows或macOS,可通过WSL2(Windows Subsystem for Linux)或Docker Desktop快速启用Linux环境,本教程后续步骤完全适用。
1.2 启动服务(仅需两行命令)
打开终端(Terminal),依次执行以下命令:
cd /root/cv_fft_inpainting_lama bash start_app.sh看到如下提示,说明服务已成功启动:
===================================== ✓ WebUI已启动 访问地址: http://0.0.0.0:7860 本地访问: http://127.0.0.1:7860 按 Ctrl+C 停止服务 =====================================注意:如果提示bash: start_app.sh: No such file or directory,请先确认镜像是否完整拉取。可运行ls -l /root/cv_fft_inpainting_lama/查看目录结构,正常应包含start_app.sh、app.py、models/等文件。
1.3 访问Web界面
在你的浏览器中输入地址:
http://127.0.0.1:7860(本机访问)
或
http://你的服务器IP:7860(局域网内其他设备访问)
无需账号密码,打开即用。界面清爽简洁,顶部写着“ 图像修复系统”,右下角还标注着“webUI二次开发 by 科哥 | 微信:312088415”——这是开发者留下的温度,也是你遇到问题时最直接的求助入口。
2. 界面操作全流程详解
2.1 主界面布局:左右双区,所见即所得
整个WebUI采用左右分栏设计,逻辑清晰,毫无学习成本:
┌─────────────────────────────────────────────────────┐ │ 图像修复系统 │ │ webUI二次开发 by 科哥 | 微信:312088415 │ ├──────────────────────┬──────────────────────────────┤ │ │ │ │ 图像编辑区 │ 📷 修复结果 │ │ │ │ │ [图像上传/编辑] │ [修复后图像显示] │ │ │ │ │ [ 开始修复] │ │ │ [ 清除] │ 处理状态 │ │ │ [状态信息显示] │ └──────────────────────┴──────────────────────────────┘- 左侧是你的“画布”:上传图片、用画笔圈出要删除的部分,就像在纸上涂改一样直观。
- 右侧是“成果展示墙”:修复过程实时可见,结果自动保存,路径清晰标注。
没有菜单嵌套、没有隐藏设置、没有参数滑块轰炸——所有功能都在明面上。
2.2 第一步:上传图像(三种方式任选其一)
支持以下任意一种上传方式,亲测全部有效:
- 点击上传:点击虚线框区域,弹出系统文件选择器,选中PNG/JPG/JPEG/WEBP格式图片即可;
- 拖拽上传:直接将图片文件从桌面/文件夹拖入虚线框,松手即上传;
- 粘贴上传:截图后按
Ctrl+V,图像瞬间出现在编辑区(Windows/macOS均支持)。
推荐优先使用PNG格式:无损压缩,保留Alpha通道,修复后细节更锐利、边缘更干净。
❌ 避免使用高分辨率原图(如手机直出的4000×3000像素):虽然能处理,但CPU耗时显著增加。建议提前用系统自带画图工具缩放到2000px宽以内,修复体验更顺滑。
2.3 第二步:标注要修复的区域(核心技巧在这里)
这一步决定了最终效果的好坏。别担心画不准——系统设计了容错机制,我们只需掌握两个关键动作:
2.3.1 用画笔“圈出目标”
- 默认已激活画笔工具(图标为一支笔),无需切换;
- 拖动下方“画笔大小”滑块,根据目标调整粗细:
- 小目标(如水印文字、小污点)→ 调至5–15px,精准描边;
- 大目标(如整根电线杆、背景路人)→ 调至30–80px,快速覆盖;
- 在目标区域涂抹白色遮罩(mask),白色越饱满,系统越明确“这里要重画”;
- 小技巧:宁可多涂一点,不要漏涂。比如去除LOGO,把周围1–2像素也轻轻带过,系统会自动羽化过渡,比紧贴边缘更自然。
2.3.2 用橡皮擦“微调边界”
- 点击工具栏橡皮擦图标(或按键盘
E键); - 擦除误涂区域,或收缩标注范围;
- 特别适合处理毛发、树叶、铁丝网等复杂边缘——先大范围涂,再用小橡皮精修。
实测经验:对于半透明水印或玻璃反光,建议先用中号画笔整体覆盖,再用小号画笔沿边缘补涂一次,修复后几乎看不出处理痕迹。
2.4 第三步:点击“ 开始修复”,静待结果
- 点击蓝色按钮“ 开始修复”,界面右下角状态栏立即变为:
初始化... → 执行推理... → 完成!已保存至: /root/cv_fft_inpainting_lama/outputs/outputs_20260105142318.png - 典型耗时参考:
- 手机截图(720×1280):约6秒
- 电商主图(1200×1200):约12秒
- 高清风景(1800×1200):约25秒
- 修复完成后,右侧实时显示结果图,同时底部明确告知保存路径和文件名(含时间戳,避免覆盖)。
此时你可以:
- 直接右键图片 → “另存为”下载到本地;
- 或通过FTP/SFTP进入
/root/cv_fft_inpainting_lama/outputs/目录批量获取; - 或继续点击“ 清除”,上传新图开启下一轮。
3. 四类高频场景实战演示
光说不练假把式。下面用真实案例,展示这套工具如何解决你日常最头疼的四类问题。
3.1 场景一:彻底清除照片水印(非半透明)
原始图:一张旅游照左下角有“Photo by XXX”文字水印。
操作:
- 上传图片;
- 用15px画笔沿文字外缘涂抹一圈(覆盖文字+1像素背景);
- 点击修复。
效果:文字区域被无缝填充为天空云层纹理,边缘过渡自然,无色差、无模糊。放大查看像素级细节,纹理方向与周围完全一致。
关键点:水印若为深色,系统会优先参考上方/侧方相似区域;若为浅色(如白字),则倾向采样下方/邻近区域。因此涂抹时稍作延展,给算法更多上下文。
3.2 场景二:移除干扰人物或物体(复杂背景)
原始图:咖啡馆合影中,后方闯入一位模糊路人。
操作:
- 上传图片;
- 用30px画笔快速勾勒路人全身轮廓(无需精确到手指,覆盖主体即可);
- 若肩部与背景融合难分,可额外用10px画笔补涂交界处;
- 点击修复。
效果:路人消失,背景桌椅、绿植、灯光自然延续,无“贴图感”。尤其惊喜的是,地面反光和杯壁高光也被智能重建,符合物理逻辑。
进阶技巧:若首次修复后局部仍有痕迹,不要重传原图,而是下载修复图,再次上传,对残留区域做二次精细标注——分层修复,效果更可控。
3.3 场景三:修复老照片划痕与折痕
原始图:泛黄的老照片扫描件,中央有一道明显竖向划痕。
操作:
- 上传图片;
- 用5px画笔沿划痕轨迹细细涂抹(宽度略大于划痕本身);
- 点击修复。
效果:划痕消失,纸张纹理、颗粒感、泛黄基调完整保留。对比PS内容识别填充,本方案在保留胶片质感方面优势明显——因为LAMA模型在训练时大量学习了真实影像退化模式。
3.4 场景四:去除商品图中的参考线/标尺
原始图:产品白底图中残留拍摄用的灰色标尺。
操作:
- 上传图片;
- 用20px画笔沿标尺全长涂抹;
- 点击修复。
效果:标尺消失,纯白背景无缝还原,无灰边、无阴影残留。特别适合电商运营人员批量处理新品图。
注意:若标尺颜色接近背景(如白底上浅灰线),建议先用“裁剪”工具切掉无关区域,再修复,可提升精度。
4. 避坑指南:那些你可能踩的“小陷阱”
再好的工具,用错方法也会事倍功半。以下是实测总结的五大易错点,帮你绕过弯路:
4.1 标注不完整 → 修复区域“漏填”
现象:修复后,目标物体部分残留,或只去掉一半。
原因:画笔未完全覆盖目标,尤其边缘有半透明、阴影、反光时容易遗漏。
解法:养成习惯——标注完后,放大200%检查白色遮罩是否100%覆盖目标,宁多勿少。
4.2 图像过大 → 卡死或超时
现象:点击修复后,状态栏长期停留在“初始化...”,无响应。
原因:镜像默认内存限制为6GB,超大图(>2500px)加载模型+加载图像易触发OOM。
解法:
- 用系统画图、Preview(macOS)或在线工具(如squoosh.app)提前压缩至2000px宽;
- 或修改启动脚本:编辑
/root/cv_fft_inpainting_lama/start_app.sh,在python app.py前添加export PYTHONPATH="/root/cv_fft_inpainting_lama",并确保ulimit -v 8388608(8GB虚拟内存)。
4.3 修复后颜色偏灰/发暗
现象:结果图整体变暗,对比度下降。
原因:原始图含EXIF色彩配置(如sRGB/Adobe RGB),而WebUI默认以线性RGB处理。
解法:上传前用Photoshop/IrfanView“转换为sRGB”,或用命令行批量处理:
convert input.jpg -profile /usr/share/color/icc/colord/sRGB.icc output.jpg4.4 无法访问WebUI(显示连接被拒绝)
现象:浏览器打不开http://127.0.0.1:7860。
排查顺序:
- 终端中执行
ps aux | grep app.py,确认进程在运行; - 执行
netstat -tuln | grep :7860,确认端口监听中; - 若用云服务器,检查安全组是否放行7860端口;
- 尝试换浏览器(Chrome/Firefox优先,Safari偶有WebSocket兼容问题)。
4.5 输出文件找不到
现象:状态栏显示“已保存至xxx.png”,但去对应目录查无此文件。
真相:文件名含毫秒级时间戳(如outputs_20260105142318123.png),手动查找困难。
捷径:在终端执行
ls -lt /root/cv_fft_inpainting_lama/outputs/ | head -5即可列出最近生成的5个文件,一眼定位。
5. 进阶玩法:让修复更聪明、更高效
当你熟悉基础操作后,这些技巧能让效率翻倍:
5.1 分区域多次修复(应对超复杂图)
一张图里既有水印、又有路人、还有划痕?别试图一次搞定。
正确姿势:
- 先修复水印 → 下载结果图;
- 重新上传该图 → 标注路人 → 修复;
- 再次上传 → 标注划痕 → 修复。
每轮聚焦一个问题,成功率更高,且便于回溯调整。
5.2 利用“清除”按钮快速试错
标注不满意?不用关页面重来。点击“ 清除”,画布回归初始状态,上传的原图仍在内存中,3秒内可重新标注——比刷新页面快得多。
5.3 键盘快捷键提升手感
Ctrl+V:粘贴剪贴板图片(截图后直接粘贴,省去保存步骤);Ctrl+Z:撤销上一步画笔/橡皮操作(部分浏览器支持,实测Chrome稳定);Space + 鼠标拖拽:平移画布(大图查看细节必备);Ctrl + 鼠标滚轮:缩放画布(精准定位边缘)。
5.4 自定义输出路径(可选)
如需将结果保存到指定目录(如NAS共享文件夹),可修改/root/cv_fft_inpainting_lama/app.py中的OUTPUT_DIR变量,例如:
OUTPUT_DIR = "/mnt/nas/ai_inpainting_outputs"记得提前创建目录并赋予权限:mkdir -p /mnt/nas/ai_inpainting_outputs && chmod 777 /mnt/nas/ai_inpainting_outputs。
6. 总结:为什么这套方案值得你收藏
回顾整个部署与使用过程,你会发现它真正做到了“三步到位”:
- 第一步,启动快:
cd+bash两行命令,30秒内服务就绪; - 第二步,上手易:上传→涂抹→点击,全程图形化,无术语、无配置;
- 第三步,效果稳:基于LAMA+FFT优化的本地模型,在CPU上也能产出媲美云端API的修复质量。
它不追求炫酷的3D渲染或视频生成功能,而是死磕一个垂直场景——静态图像的精准修复。当你要快速清理一张工作图、修复一张纪念照、处理一批商品图时,它就是那个“不用思考、拿来就用”的可靠伙伴。
更重要的是,它开源、可审计、数据不出本地。在这个AI工具越来越“黑盒化”的时代,能亲手掌控整个流程,本身就是一种技术底气。
获取更多AI镜像
想探索更多AI镜像和应用场景?访问 CSDN星图镜像广场,提供丰富的预置镜像,覆盖大模型推理、图像生成、视频生成、模型微调等多个领域,支持一键部署。