如何保存修复结果？科哥镜像输出路径详解
1. 为什么你总找不到修复后的图片？
你是不是也遇到过这种情况：点击“ 开始修复”后，右下角状态栏明明显示“完成！已保存至: /root/cv_fft_inpainting_lama/outputs/outputs_20260105142318.png”，可一打开文件管理器，却怎么也找不到那个带时间戳的PNG文件？或者用FTP连上去翻遍整个目录，只看到空荡荡的outputs/文件夹？
这不是你的错。这是很多第一次使用科哥二次开发的FFT NPainting Lama图像修复镜像的用户共同踩过的坑——不是没保存，而是你没找对地方，也没用对方法。
这篇文章不讲原理、不堆参数，就专注解决一个最实际的问题：如何稳定、可靠、可复现地拿到你辛苦标注并修复好的那张图。我会带你从WebUI界面提示、系统真实路径、权限配置、下载方式到自动化脚本，一层层拆解，确保你看完就能立刻找到、下载、甚至批量管理所有修复结果。
2. WebUI界面上的“保存路径”到底指什么？
2.1 界面显示 ≠ 文件已就绪
先明确一个关键事实：WebUI右下角显示的“已保存至: xxx.png”，仅代表后端Python服务已调用cv2.imwrite()或PIL.Image.save()将图像写入磁盘。它不保证：
- 文件已完全刷入硬盘（尤其在低配服务器上存在缓存延迟）
- 你当前登录的用户有权限读取该路径
- 路径中的父目录（如
outputs/）已存在且可写
所以，当你看到那行绿色提示时，请先别急着去下载，按以下三步确认：
- 刷新页面：点击浏览器刷新按钮，确认状态未变回“执行推理…”
- 检查路径真实性：打开终端，执行
ls -l /root/cv_fft_inpainting_lama/outputs/ - 验证文件完整性：执行
file /root/cv_fft_inpainting_lama/outputs/outputs_*.png，确认输出含PNG image data
重要提醒：该镜像默认以
root用户运行，所有输出文件属主为root。如果你用普通用户（如ubuntu）通过SFTP连接，默认无法访问/root/下的任何文件。这是90%“找不到文件”问题的根源。
2.2 真实输出路径结构解析
根据镜像文档和源码逻辑，完整路径由三部分构成：
| 组成部分 | 示例值 | 说明 |
|---|---|---|
| 根目录 | /root/cv_fft_inpainting_lama/ | 镜像预置的工作目录，不可更改 |
| 子目录 | outputs/ | 固定名称，由Flask后端硬编码指定，存放所有修复结果 |
| 文件名 | outputs_20260105142318.png | 格式为outputs_YYYYMMDDHHMMSS.png，精确到秒，无重复 |
你可以用以下命令一次性列出所有已生成的修复图：
ls -t /root/cv_fft_inpainting_lama/outputs/outputs_*.png | head -n 5-t参数按修改时间倒序排列，head -n 5只显示最近5张，避免列表过长。
3. 三种可靠获取修复结果的方法（按推荐顺序）
3.1 方法一：通过WebUI内置下载按钮（最简单，但需前置配置）
镜像WebUI其实自带下载功能，但默认被隐藏——因为需要你先启用Nginx反向代理并配置静态文件服务。如果你的服务器已部署Nginx，只需两步激活：
步骤1：创建软链接，暴露outputs目录
cd /root/cv_fft_inpainting_lama ln -sf /root/cv_fft_inpainting_lama/outputs /var/www/html/inpainting_outputs步骤2：在Nginx配置中添加静态路由
编辑/etc/nginx/sites-available/default，在server块内加入：
location /inpainting_outputs/ { alias /var/www/html/inpainting_outputs/; autoindex on; autoindex_exact_size off; autoindex_format html; }然后重启Nginx：
sudo systemctl restart nginx配置完成后，你就能在浏览器直接访问：http://你的服务器IP/inpainting_outputs/
点击任意outputs_*.png即可下载。此方法支持断点续传，适合大图传输。
3.2 方法二：使用SCP命令行下载（最通用，无需额外服务）
这是跨平台、零依赖的方案，Windows用户可用WinSCP，Mac/Linux用户直接终端执行：
# 下载最新一张修复图（自动匹配时间戳最大的文件） scp root@你的服务器IP:/root/cv_fft_inpainting_lama/outputs/outputs_*.png ./repaired_image.png # 或者下载全部（注意：会覆盖同名文件） scp root@你的服务器IP:/root/cv_fft_inpainting_lama/outputs/outputs_*.png ./downloads/权限提示：如果提示
Permission denied (publickey)，说明你未配置SSH密钥。此时改用密码登录：scp -o PubkeyAuthentication=no root@你的服务器IP:/root/cv_fft_inpainting_lama/outputs/outputs_*.png .
3.3 方法三：挂载outputs/目录到宿主机（适合长期高频使用）
如果你在Docker中运行该镜像（绝大多数CSDN星图用户如此），最佳实践是启动时就将outputs/目录映射到宿主机。这样修复结果天然落盘，无需任何后续操作。
假设你宿主机的/data/inpainting_outputs是你想存放图片的目录，启动命令应为：
docker run -d \ --name inpainting-lama \ -p 7860:7860 \ -v /data/inpainting_outputs:/root/cv_fft_inpainting_lama/outputs \ -v /data/inpainting_models:/root/cv_fft_inpainting_lama/models \ your-image-name启动后，所有修复图将实时同步到宿主机的/data/inpainting_outputs/，你可用任何文件管理器直接访问，完全规避权限和路径问题。
4. 常见失败场景与精准解决方案
4.1 场景：ls能看到文件，但SCP下载后打不开（损坏）
现象：终端执行ls -lh outputs_*.png显示文件大小正常（如1.2M），但下载到本地用看图软件打开报错“文件已损坏”。
根本原因：镜像使用的Lama模型在推理时若显存不足，会静默截断图像写入，导致PNG文件头完整但数据区不全。
验证命令：
# 检查PNG文件头是否合法 head -c 8 /root/cv_fft_inpainting_lama/outputs/outputs_*.png | xxd # 正常输出应为：00000000: 8950 4e47 0d0a 1a0a .PNG....解决方案：
- 降低输入图像分辨率（严格控制在1280x1280以内）
- 在
start_app.sh中增加显存限制（适用于NVIDIA GPU）：export CUDA_VISIBLE_DEVICES=0 export PYTORCH_CUDA_ALLOC_CONF=max_split_size_mb:128
4.2 场景：outputs/目录为空，但WebUI显示“已保存”
现象：ls /root/cv_fft_inpainting_lama/outputs/返回空，但界面提示保存成功。
排查链路：
- 检查磁盘空间：
df -h /root—— 若Use%达100%，清理/root/.cache/torch/hub/ - 检查目录权限：
ls -ld /root/cv_fft_inpainting_lama/outputs/—— 应为drwxr-xr-x - 检查Python错误日志：
tail -20 /root/cv_fft_inpainting_lama/app.log
一键修复命令（执行后重启服务）：
mkdir -p /root/cv_fft_inpainting_lama/outputs chmod 755 /root/cv_fft_inpainting_lama/outputs chown root:root /root/cv_fft_inpainting_lama/outputs4.3 场景：文件名带中文或特殊字符，下载后乱码
现象：上传含中文名的原图（如产品截图-2026.jpg），修复后文件名变成outputs_20260105142318.png，但有时会意外出现outputs_20260105142318_产品截图.png，导致Linux系统无法识别。
原因：前端JavaScript未对原始文件名做URL编码，后端Python处理时发生编码异常。
永久解决：修改app.py中保存逻辑（约第187行），将：
filename = f"outputs_{datetime.now().strftime('%Y%m%d%H%M%S')}.png"替换为：
import re safe_name = re.sub(r'[^\w\s-]', '', original_filename.split('.')[0]) safe_name = re.sub(r'[-\s]+', '-', safe_name).strip('-') filename = f"outputs_{datetime.now().strftime('%Y%m%d%H%M%S')}_{safe_name}.png"5. 进阶技巧：自动化归档与批量处理
5.1 每次修复后自动压缩并邮件发送
将以下脚本保存为/root/cv_fft_inpainting_lama/auto_send.sh：
#!/bin/bash # 监控outputs目录，新文件生成后自动压缩并邮件发送 IN_DIR="/root/cv_fft_inpainting_lama/outputs" OUT_ZIP="/tmp/latest_repair.zip" inotifywait -m -e create --format '%w%f' "$IN_DIR" | while read file; do if [[ "$file" == *.png ]]; then zip -j "$OUT_ZIP" "$file" echo "新修复图已生成：$(basename "$file")" | mutt -s "【图像修复通知】" -a "$OUT_ZIP" -- your@email.com rm "$OUT_ZIP" fi done赋予执行权限并后台运行：
chmod +x /root/cv_fft_inpainting_lama/auto_send.sh nohup /root/cv_fft_inpainting_lama/auto_send.sh > /dev/null 2>&1 &5.2 用Python脚本批量重命名，按日期分类
创建/root/cv_fft_inpainting_lama/batch_rename.py：
import os import glob from datetime import datetime output_dir = "/root/cv_fft_inpainting_lama/outputs" for png_file in glob.glob(os.path.join(output_dir, "outputs_*.png")): # 提取时间戳：outputs_20260105142318.png → 20260105 date_part = os.path.basename(png_file)[8:16] date_obj = datetime.strptime(date_part, "%Y%m%d") month_dir = os.path.join(output_dir, date_obj.strftime("%Y年%m月")) os.makedirs(month_dir, exist_ok=True) new_path = os.path.join(month_dir, os.path.basename(png_file)) os.rename(png_file, new_path) print(f"已移动：{os.path.basename(png_file)} → {os.path.relpath(new_path, output_dir)}") print("批量归档完成！")执行一次即可按月份自动整理：
cd /root/cv_fft_inpainting_lama && python3 batch_rename.py6. 总结：掌握这四点，再不丢图
1. 路径认知要准确
/root/cv_fft_inpainting_lama/outputs/是唯一有效路径，别在/home/或/var/里瞎找。
2. 权限问题要前置解决
用root用户操作，或提前配置SFTP用户对/root/的读取权限，别等出问题再折腾。
3. 下载方式要选对场景
- 临时用：
scp命令最快 - 长期用：Docker
-v挂载最稳 - 团队用：Nginx静态服务最方便
4. 异常要有快速诊断法
记牢三个命令：ls -l outputs/看文件、file *.png验格式、tail -20 app.log查错误。
现在，打开你的终端，执行第一条ls命令，亲眼确认那张属于你的修复图正安静躺在outputs/目录里——这才是技术落地最踏实的瞬间。
--- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
