UNet人脸融合结果保存在哪？outputs目录说明
你刚完成一次UNet人脸融合，右侧面板上那张高清自然的融合图正静静展示着效果——但当你想把这张图永久保存下来、发给朋友或用于后续工作时，却突然发现：它到底存在服务器哪个角落？
别急，这不是玄学问题，而是每个初次使用unet image Face Fusion人脸融合人脸合成 二次开发构建by科哥镜像的用户都会遇到的真实困惑。本文不讲原理、不堆参数，只用最直白的语言，带你彻底搞清：融合结果究竟生成在哪儿？outputs目录里藏着什么？怎么快速定位、安全备份、批量管理？
我们从WebUI界面的一次点击出发，层层拆解文件路径、命名逻辑和存储机制，让你下次操作完“开始融合”后，3秒内就能在终端里找到那张属于你的成果。
1. 融合结果默认保存位置：/root/outputs/是唯一真相
所有通过Face Fusion WebUI生成的图片，无一例外，全部自动保存在容器内的/root/outputs/目录下。这不是猜测，不是经验，而是镜像启动脚本与WebUI后端代码共同写死的硬编码路径。
关键确认点：
- 镜像文档明确指出：“图片会自动保存到
outputs/目录”；- 启动指令为
/bin/bash /root/run.sh，说明整个应用以/root为工作根目录；- WebUI源码中所有文件写入操作均基于相对路径
outputs/，而当前工作目录即/root。
这意味着：
你不需要手动指定保存路径；
无需配置环境变量或修改配置文件；
每次点击“开始融合”，系统就自动执行save_image(..., path="/root/outputs/xxx.png")。
但请注意：这个/root/outputs/是容器内部路径。如果你在宿主机（比如你的Mac或Windows电脑）上运行Docker，那么这个目录实际映射在宿主机的某个位置——而这个映射关系，正是你能否顺利拿到图片的关键。
2. 容器内外路径映射：看清outputs/真实落点
镜像本身不负责“暴露”目录，它只按规则往/root/outputs/写文件。真正决定你能否在本地看到这些图片的，是Docker运行时的卷（volume）挂载配置。
2.1 默认行为：未显式挂载时，文件仅存于容器内
如果你直接执行类似以下命令启动镜像：
docker run -p 7860:7860 -it unet-face-fusion-image那么/root/outputs/就是一个临时容器层目录。一旦你docker stop并docker rm删除该容器，里面所有融合结果将永久消失，无法恢复。
这是新手最容易踩的坑：兴高采烈做完10张融合图，关掉终端再打开，发现全没了。
2.2 正确做法：必须挂载宿主机目录到/root/outputs
要让融合结果持久化、可访问、可备份，请务必在docker run时添加-v参数，将宿主机的一个真实文件夹映射进去：
# Linux/macOS 示例：将当前目录下的 outputs 文件夹挂载进去 docker run -p 7860:7860 -v $(pwd)/outputs:/root/outputs -it unet-face-fusion-image # Windows PowerShell 示例： docker run -p 7860:7860 -v ${PWD}\outputs:/root/outputs -it unet-face-fusion-image执行后，效果是这样的：
| 容器内路径 | 宿主机对应路径 | 说明 |
|---|---|---|
/root/outputs/ | 你指定的宿主机路径 | 所有融合图实时双向同步 |
/root/outputs/2024-06-05/ | outputs/2024-06-05/ | 按日期自动创建的子目录 |
/root/outputs/2024-06-05/face_fusion_001.png | outputs/2024-06-05/face_fusion_001.png | 实际生成的图片文件 |
此时你在WebUI点10次“开始融合”，宿主机的outputs/文件夹里就会立刻出现10张图；
关闭容器、重启镜像、甚至重装系统，只要宿主机文件夹还在，图片就永远安全；
你可以用任何看图软件、批量重命名工具、云盘同步服务直接操作这些文件。
3. outputs目录结构解析：日期子目录 + 自动编号命名
进入/root/outputs/（或你挂载的宿主机对应文件夹），你会看到一个清晰、有序、完全自动化管理的结构：
outputs/ ├── 2024-06-05/ │ ├── face_fusion_001.png │ ├── face_fusion_002.png │ └── face_fusion_003.png ├── 2024-06-06/ │ ├── face_fusion_001.png │ └── face_fusion_002.png └── 2024-06-07/ └── face_fusion_001.png3.1 一级目录：按年-月-日自动创建
- 每天首次生成融合图时，系统自动创建形如
YYYY-MM-DD的子目录； - 同一天的所有结果都归入该目录，避免文件混杂；
- 目录名不含空格、特殊字符，兼容所有操作系统和云服务。
3.2 文件命名：face_fusion_XXX.png格式
- 前缀固定为
face_fusion_，一眼识别用途； - 后缀为三位数字编号（
001,002, ...），按生成时间顺序递增； - 扩展名统一为
.png，保证无损质量与透明通道支持； - 不包含时间戳、哈希值或随机字符串——简洁、可读、易排序。
优势：用文件管理器按名称排序，就是按生成时间排序；
❌ 注意：编号每天重置，2024-06-05/face_fusion_001.png和2024-06-06/face_fusion_001.png是两张完全不同的图。
4. 如何快速定位最新融合图？三种高效方法
不用翻文件夹、不用记路径，三招直达最新成果：
4.1 方法一：终端命令（Linux/macOS）
在宿主机挂载目录中执行（假设挂载到~/my-fusion-outputs）：
# 进入输出目录 cd ~/my-fusion-outputs # 查看最新生成的5个文件（按修改时间倒序） ls -lt */face_fusion_*.png | head -n 5 # 或直接打开最新一张（macOS） open "$(find . -name 'face_fusion_*.png' -type f | sort -r | head -n1)" # 或直接打开最新一张（Linux，需安装 xdg-utils） xdg-open "$(find . -name 'face_fusion_*.png' -type f | sort -r | head -n1)"4.2 方法二：WebUI界面右键下载（最简单）
- 融合成功后，右侧结果区会显示图片；
- 鼠标右键点击该图片 → “图片另存为...”；
- 浏览器会弹出标准保存对话框，你可以选择任意本地路径保存；
- 适合单张快速导出，无需接触终端；
- 注意：此方式保存的是浏览器缓存副本，非原始文件，但画质完全一致。
4.3 方法三：进入容器内部查看（进阶调试）
当你需要确认容器内状态，或挂载失效时排查问题：
# 查看正在运行的容器ID docker ps # 进入容器（替换 <container_id> 为实际ID） docker exec -it <container_id> /bin/bash # 在容器内直接列出最新文件 ls -lt /root/outputs/*/face_fusion_*.png | head -n 3此时你看到的路径就是绝对真实的/root/outputs/...，可直接cat日志、stat文件属性，精准定位问题。
5. 高级技巧：自定义保存路径与批量管理
虽然默认路径足够好用，但某些场景下你可能需要更灵活的控制。
5.1 修改保存根目录（需重建镜像）
/root/outputs/是硬编码路径，无法通过WebUI设置更改。但如果你有二次开发需求，可修改源码中的保存逻辑：
# 原始代码（伪代码） output_dir = os.path.join("/root", "outputs", today_str) os.makedirs(output_dir, exist_ok=True) cv2.imwrite(os.path.join(output_dir, f"face_fusion_{idx:03d}.png"), result_img)→ 改为读取环境变量：
output_root = os.environ.get("FACE_FUSION_OUTPUT_ROOT", "/root/outputs") output_dir = os.path.join(output_root, today_str)然后启动时传入：
docker run -e FACE_FUSION_OUTPUT_ROOT="/data/fusion-results" -v /path/on/host:/data/fusion-results ...此操作需重新构建镜像，仅推荐开发者或长期部署用户使用。
5.2 批量重命名与分类（推荐脚本）
为方便归档，可用以下Python脚本，按融合比例、源图名等信息重命名：
#!/usr/bin/env python3 import os import glob from datetime import datetime # 遍历所有 outputs/ 下的 png 文件 for img_path in glob.glob("outputs/**/face_fusion_*.png", recursive=True): # 提取日期和序号 parts = img_path.split("/") date_part = parts[-2] # 如 "2024-06-05" base_name = os.path.basename(img_path) # 如 "face_fusion_001.png" # 构造新名：日期_序号_融合比例.png（示例） new_name = f"{date_part}_{base_name.replace('face_fusion_', '')}" # 重命名（谨慎！建议先测试） new_path = os.path.join(os.path.dirname(img_path), new_name) os.rename(img_path, new_path) print(f"Renamed: {img_path} → {new_path}")运行前请务必备份原目录。此类脚本可集成进CI/CD流程，实现全自动归档。
6. 常见问题速查：为什么找不到图？怎么解决？
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| WebUI显示“融合成功！”，但 outputs 文件夹为空 | 宿主机未挂载 volume，或挂载路径错误 | 检查docker run命令是否含-v；确认挂载路径拼写正确；用docker exec进容器验证/root/outputs/是否真有文件 |
| outputs 文件夹里有文件，但全是黑图或损坏图 | 显存不足导致图像写入失败；或PNG编码库异常 | 升级NVIDIA驱动；降低输入图分辨率；检查nvidia-smi确认GPU内存充足 |
| 同一天生成多张图，但编号跳变（如 001→003） | 中间某次融合因超时/报错中断，编号仍递增 | 属正常行为，编号只增不减；检查日志确认是否报错；忽略跳号，以文件修改时间为准 |
| 想删除某天的所有图，但担心误删其他数据 | outputs 是独立目录，与其他功能隔离 | 安全删除：rm -rf outputs/2024-06-05/；不会影响模型、配置或WebUI运行 |
7. 最佳实践总结：三步养成好习惯
别再让成果“消失”在容器里。只需坚持这三步，从此融合结果尽在掌控：
- 启动必挂载：每次
docker run都加上-v /your/local/path:/root/outputs； - 命名即归档：利用
outputs/YYYY-MM-DD/天然按日期分组，每周压缩一次当周文件夹； - 右键即备份：对重要结果，右键“图片另存为”到桌面或云盘，双重保险。
记住：技术工具的价值，不在于它多强大，而在于你能否稳定、可靠、零门槛地拿到结果。/root/outputs/就是那个沉默却忠实的保管员——你只需给它一条通往现实世界的路，它就把每一份创意，稳稳交到你手上。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
