Upscayl 批量 AI 放大实战:10 个文件夹一次搞定
【免费下载链接】upscayl🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl
Upscayl 是一款免费开源的 AI 图像放大工具,一次丢进整个文件夹就能批量完成 AI 图像放大。读完这篇,你会从安装到第一次批量出图走完全流程,还能调好 Tile Size、压缩率这几个最常碰的参数。
它是什么 / 适不适合你
Upscayl 是一个桌面应用,底层用 NCNN 跑 AI 模型把低分辨率图片放大并补细节,支持 Windows、macOS 和 Linux。它的批处理模式(源码在 electron/commands/batch-upscayl.ts)会把输入文件夹里的每张图用同一套参数处理完,结果自动存进新文件夹,你不用盯着。
适合你,如果:
- 一次要处理几十张以上图片(产品图、老照片、素材库)
- 有 Vulkan 支持的显卡(独显,或较新的核显)
- 想要所有图片参数完全一致
不适合你,如果:
- 只放大一两张图(单张模式更直接,但批处理同样适用)
- 完全没有独立显卡且核显太老(处理会非常慢)
- 图片本身严重模糊失焦(AI 补不出没拍到的细节)
准备工作与安装
前置条件:
- 显卡:支持 Vulkan(Nvidia / AMD 独显基本都行,很多老核显不行,但试试不亏)
- 系统:Windows 10+、macOS 12+、主流 Linux 发行版
- 存储:预留 2GB 以上空间放安装包和输出图片
安装步骤(以 Linux AppImage 为例,其他系统类似):
- 去项目仓库的 Release 页下载对应系统的安装包 → 在官网或 GitCode 仓库下载
upscayl-x.x.x-linux.AppImage(macOS 用 .dmg / Mac App Store,Windows 用 .exe) - Linux 用户右键 AppImage → Permissions → 勾选允许执行 → 双击运行
- 首次启动 → 在设置页确认能正常打开 → 看到设置面板即可
- 顺手放大一张测试图 → 在侧边栏点单张放大 → 设置页日志区出现 GPU 列表,说明显卡识别成功
- 如果日志里出现多张 GPU → 记下你要用的那张的编号,填进 GPU ID 输入框
核心操作流程
批处理一共就三步:切模式、选文件夹、点放大。下面按实际操作顺序拆给你看。
1. 切换批处理模式并选输入文件夹
在左侧 Upscayl 标签页找到放大模式选项,从"单张"切成"文件夹(Batch)"模式。然后点选择文件夹按钮,选中存放所有待处理图片的目录。看到输入框里出现文件夹路径,就选对了。
文件夹里只放支持格式的图片(PNG、JPG、JPEG、WebP,完整定义在 common/image-formats.ts),无关文件可以不管,但文件名别带特殊字符。
2. 确认输出位置和参数
批处理会自动在你指定的输出目录里新建一个子文件夹,命名规则是upscayl_格式_模型_倍率,比如upscayl_png_upscayl-standard-4x_4x。你不需要手动创建,代码会自动递归建目录(见 electron/commands/batch-upscayl.ts 第 37-44 行)。
参数区确认:模型(默认 upscayl-standard-4x)、倍率(默认 4x)、保存格式(默认 PNG)、压缩率、Tile Size。
3. 启动批处理并观察日志
点右侧的放大按钮(UPSCAYL)开始。进度条会在窗口顶部走动,设置页的 Log Area 会实时滚动每张图的处理日志。全部跑完后:
- 弹出系统通知 "Images upscayled successfully!"
- 打开输出文件夹,看到所有图片按原名存好
- 如果中途有错误,通知会提示 "encountered some errors",日志里带 ❌ 的行就是失败原因
中途想停:点 Stop 按钮即可,当前已完成的文件不受影响。
4. 放大效果确认
放大完可以肉眼比对。下图是 upscayl-standard-4x 模型的官方对比图(500x500 放大到 2000x2000),细节补全效果直观:
关键参数一次讲清
| 参数 | 默认值 | 推荐值 | 改了会怎样 |
|---|---|---|---|
| Scale(倍率) | 4x | 4x | 内置模型原生只支持 4x;选 2x/3x 时程序会先放大再缩回去(Downscayl 模拟),细节略有损失 |
| Tile Size | 空(自动) | 显存 8GB 以下填 400-600 | 数字越大单块处理越多、速度越快,但吃显存;OOM 崩溃就调小 |
| Compression | 0 | PNG 用 0,WebP 用 80-90 | 值越大文件越小、质量越低;PNG 无损时可保持 0 |
| TTA Mode | 关 | 关 | 开启后质量略提升,处理时间约翻倍,批处理大文件夹慎用 |
| GPU ID | 空 | 多显卡时填对应编号 | 指定用哪张 Vulkan GPU;Windows 下可能被系统显示设置覆盖 |
💡 另外两个开关:Copy Metadata 会在完成后把原图元数据复制到输出图;记得输出文件夹的开关会记住上次的保存位置,省得每次重选。
场景化应用
电商产品图批量出图:300 张 500px 商品图想上到详情页,用默认 upscayl-standard-4x + 4x,格式选 WebP、压缩 80,体积可控又清晰。
老照片数字化:扫描的旧照片通常偏小且噪点重,选 upscayl-standard-4x 或 high-fidelity-4x,格式保 PNG(无损),压缩 0,输出前挑一张先试,确认风格可接受再跑整批。
社媒素材统一规格:一堆尺寸不一的图要凑成统一宽度,打开"自定义宽度"开关填目标像素(比如 1920),倍率选项会自动忽略,所有图输出同宽,方便直接上传。
踩坑与解决
现象:跑起来很慢,像只用 CPU → 原因:Vulkan 没启用或被系统拦了 → 解法
- 设置页日志区确认出现 GPU 列表而不是纯 CPU 回退
- Windows 去"显示设置 → 图形设置"把 Upscayl 设为高性能模式
- 多显卡机器手动填 GPU ID
现象:处理大图时程序直接崩溃 → 原因:显存不够,Tile 太大 → 解法
- Tile Size 填 400(甚至 200)
- 分批跑,每次几十张
- 关掉其他吃显存的程序(浏览器开了十几个标签也算)
现象:批处理结束但缺了几张图 → 原因:失败日志被滚动冲掉 → 解法
- 看设置页 Log Area 里带 ❌ / Error 的行
- 检查缺失图片格式是否在 PNG/JPG/JPEG/WebP 之内
- 把问题文件单独拷出来,用单张模式复现,看具体报错
现象:选 2x 或 3x 倍率效果反而更糊 → 原因:内置模型原生只有 4x,其他倍率是缩放模拟 → 解法
- 直接用 4x,需要小尺寸再手动缩小
- 或加载原生 x2/x3 的自定义模型(NCNN 的 .bin + .param 放进自定义模型文件夹,文档见 docs/Guide.md 的 Custom Models 一节)
效率与效果速览
| 指标 | 手动逐张处理 | Upscayl 批处理 |
|---|---|---|
| 30 张图耗时 | 约 1-2 小时(含选图设参) | 一张跑完即全程无人值守 |
| 参数一致性 | 每张手动调,容易漏 | 全批同一配置,零差异 |
| 出错成本 | 重调重跑 | 已完成的文件保留,补跑剩余即可 |
FAQ
Q1:支持哪些图片格式?PNG、JPG、JPEG、WebP 四种,定义在 common/image-formats.ts。其他格式请先转一下。
Q2:批处理中断了,要全部重来吗?不用。点 Stop 只是杀掉子进程,输出文件夹里已完成的图还在。把失败的图重新放进一个新文件夹再跑一遍即可。
Q3:能用自己的 AI 模型吗?可以。v2.5 起支持加载 NCNN 格式自定义模型(.bin + .param 放一个文件夹,在设置页"Add Custom Models"选中它),模型名会自动出现在模型选择里。
Q4:有命令行接口吗?图形界面是主入口。不过桌面版调用的核心引擎本身支持命令行参数(-i 输入、-o 输出、-n 模型名等,见 electron/utils/get-arguments.ts),进阶用户可以基于它做脚本集成。
写在最后
Upscayl 的批处理把"选一次参数、点一次按钮"变成了整批自动化,你只需要挑图、设参、走开。它免费、开源、跨平台,日常批量放大基本够用。
今天就能做的最小行动:新建一个文件夹,丢 5 张图进去,按上面的流程跑一遍默认配置,10 分钟内你就能打开输出文件夹看到 4 倍放大的结果。
【免费下载链接】upscayl🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考