Upscayl：跨平台AI图片放大桌面应用部署指南

官方信息

项目背景

很多人听说过 Real-ESRGAN 的强大效果，但一看到要装 Python、配 PyTorch、敲命令行就劝退了。有没有一个像普通软件一样，下载安装包、双击打开、拖入图片、点按钮就能放大的工具？Upscayl 就是为这个需求而生的。

它把 Real-ESRGAN 的 ncnn 推理引擎包装成了一个精美的 Electron 桌面应用，界面像现代商业软件一样简洁：左边选图片、中间选模型和放大倍数、右边点 Upscayl 按钮就开始处理。所有计算都在本地完成，图片不上传任何服务器，隐私安全。

Upscayl 在 GitHub 上收获超过 30K Star，是全球最受欢迎的开源 AI 图片放大工具之一，被 The Verge、TechCrunch 等媒体报道。除了桌面版，还推出了云端版 Upscayl Cloud，方便没有显卡的用户使用。

核心特性

• 真正跨平台：Windows、macOS（含 Apple Silicon）、Linux 全支持
• 图形化界面：拖放操作，无需命令行，小白也能用
• 多模型选择：内置通用图、动漫图、数字艺术、低光照等多种 AI 模型
• 自定义模型：支持导入自己训练的 .param/.bin 模型文件
• 批量处理：一次拖入整个文件夹，批量放大
• 本地运行：基于 ncnn，CPU/GPU 都能跑，图片不出本机
• 放大倍数可调：2x/3x/4x 自由选择
• 免费开源：GPL-3.0 协议，完全免费无广告
• 高级选项：自定义输出格式（PNG/JPG/WebP）、压缩质量、覆盖文件

环境要求

• Windows：Windows 10 1809+（64位），4GB 内存，兼容 GPU 推荐
• macOS：macOS 12+，Intel 或 Apple Silicon 芯片
• Linux：Ubuntu 20.04+/Fedora 36+，glibc 2.31+
• 显卡：非必需，但有 NVIDIA/AMD/Apple Silicon GPU 会快 5~10 倍
• 磁盘空间：约 500MB 安装包 + 模型文件
• 无需安装 Python、无需配置 CUDA，开箱即用

详细部署步骤

方式一：Windows 安装

1. 访问 官方下载页，点击 Windows 图标下载 .exe 安装包
2. 或直接从 GitHub Releases 下载：
   • Upscayl-Setup-x.xx.x.exe（标准安装版）
   • Upscayl-x.xx.x-portable.exe（绿色便携版，放 U 盘即用）
3. 双击 .exe 文件，按向导下一步完成安装
4. 首次启动会提示选择模型存放目录，建议默认即可
5. Windows SmartScreen 可能提示"未知发布者"，点击"仍要运行"即可

方式二：macOS 安装

1. 下载对应芯片版本：
   • Apple Silicon（M1/M2/M3/M4）：Upscayl-x.xx.x-mac-arm64.dmg
   • Intel Mac：Upscayl-x.xx.x-mac.dmg
2. 打开 .dmq 文件，把 Upscayl 拖入 Applications 文件夹
3. 首次打开若提示"无法验证开发者"，前往 系统设置 → 隐私与安全性 → 点击"仍要打开"

方式三：Linux 安装

# Ubuntu/Debian - AppImage 方式（最简单）
# 1. 下载 .AppImage 文件
chmod +x Upscayl-*-linux.AppImage
./Upscayl-*-linux.AppImage

# 或者通过 deb 包安装
sudo dpkg -i Upscayl-*-linux.deb

# Fedora/RHEL
sudo rpm -i Upscayl-*-linux.rpm

# 通过 Flatpak 安装（推荐）
flatpak install flathub org.upscayl.Upscayl
flatpak run org.upscayl.Upscayl

方式四：从源码构建（开发者）

# 克隆仓库
git clone https://github.com/upscayl/upscayl.git
cd upscayl

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 打包当前平台安装包
npm run make

# 打包所有平台（需要对应平台环境）
npm run package

使用方法

基本操作流程

1. 打开 Upscayl 应用
2. 第一步：选择图片 - 点击"Select Image"按钮或直接拖入图片到窗口
3. 第二步：选择模型 - 在下拉菜单中选择 AI 模型：
   • RealESRGAN x4plus：通用照片/图片默认模型
   • Remacri：数字艺术/插画增强
   • Digital Art：动漫/二次元专用
   • Ultramix Balanced：平衡速度与质量
   • Low Light：暗光照片增强
4. 第三步：设置放大倍数 - 拖动滑块选择 2x/3x/4x
5. 第四步：选择输出目录 - 默认在原图同目录生成 upscayled 子文件夹
6. 第五步：点击"Upscayl" 按钮开始处理
7. 等待进度条完成，结果自动保存在输出目录

高级功能

• 批量处理：切换到"Batch"标签页，选择整个文件夹批量放大
• 自定义模型：切换到"Custom Model"标签，导入自己的 .param + .bin 模型文件
• 覆盖输出：在 Settings 中勾选"Overwrite"，直接替换原文件
• 输出格式：Settings 中可选择 PNG（无损）/JPG（体积小）/WebP

常见问题 FAQ

Q1：处理速度很慢怎么办？
A：Upscayl 默认使用 CPU 推理。有独立显卡的用户可以在 Settings → Accelerator 中选择 GPU（NVIDIA Vulkan / Apple Metal），速度可提升 5~10 倍。没有 GPU 只能耐心等待，或改用 2x 放大。

Q2：macOS 打开提示"应用已损坏"？
A：这是因为应用未经过苹果签名。打开终端执行：xattr -cr /Applications/Upscayl.app，然后重新打开即可。

Q3：放大后图片出现伪影/涂抹感？
A：不同模型适合不同场景。照片用 RealESRGAN x4plus，动漫用 Digital Art，插画用 Remacri。切换模型对比效果，选最适合的。

Q4：支持 PNG 透明背景吗？
A：支持。RealESRGAN 系列模型可以保留透明通道，输出 PNG 格式即可。

Q5：Upscayl Cloud 是什么？收费吗？
A：Upscayl Cloud 是官方提供的在线版，无需本地显卡，在浏览器中即可使用。免费额度有限，高级功能需要订阅。桌面版完全免费。

跳转链接

• GitHub 仓库：https://github.com/upscayl/upscayl
• 官方网站：https://upscayl.org
• Releases 下载：https://github.com/upscayl/upscayl/releases
• Flatpak 安装：https://flathub.org/apps/org.upscayl.Upscayl