waifu2x · 动漫风格图片 AI 放大与降噪工具 · 本地部署与使用全指南

项目仓库： https://github.com/nihui/waifu2x-ncnn-vulkan（基于 Tencent ncnn 的 Vulkan 移植版）

开源协议：见仓库 LICENSE · 运行形态：单文件可执行（Windows / Linux / macOS） · 推理框架：Tencent ncnn + Vulkan · 模型：内置 cunet / upconv 模型 · 无需 CUDA/Caffe 运行时 · 仓库分支：master

说明：任务清单登记仓库为 nihui/waifu2x，该名字下并无同名仓库；nihui 维护的实际移植版为 nihui/waifu2x-ncnn-vulkan，原始 waifu2x 项目为 nagadomi/waifu2x。本文按官方移植版撰写。

1 项目简介

waifu2x 最初是一个把动漫风格图片进行超分辨率放大与降噪的开源工具（原始项目 nagadomi/waifu2x）。nihui/waifu2x-ncnn-vulkan 是基于腾讯 ncnn 推理框架、通过 Vulkan API 实现的移植版：一个可执行文件即可在 Intel / AMD / NVIDIA / Apple-Silicon 显卡上快速运行，无需安装 CUDA 或 Caffe 运行时，开箱即用。

发布包内置运行所需的全部二进制与模型，绿色便携。

1.1 核心信息一览

1.2 适用场景

• 想把动漫截图、插画、低分辨率图片无损放大并去除 JPEG 噪点。
• 希望不装 CUDA/Caffe、不跑 Python 环境，一条命令批量处理图片目录。
• 需要在 Apple-Silicon、AMD 或 Intel 核显上利用 Vulkan 加速。

1.3 能力边界（官方口径）

• 它是命令行图像处理工具，不是 Web 服务；适合批处理脚本调用。
• 放大倍数与降噪等级由命令行参数控制（见下文）。
• 崩溃或报错时官方建议升级显卡驱动。

2 功能特性

• 便携单文件：内置二进制与模型，无需 CUDA/Caffe 运行时。
• 跨 GPU 后端：Vulkan 统一支持 Intel / AMD / NVIDIA / Apple-Silicon。
• 降噪 + 放大：降噪等级 -1/0/1/2/3，放大倍数 1/2/4/8/16/32。
• 目录批处理：输入输出可直接传目录。
• 多 GPU 与线程调节：-g 指定 GPU，-j load:proc:save 调三阶段线程数。
• TTA 模式：-x 启用测试时增强。

3 官方界面预览

文首即为官方 README 示例：waifu2x-ncnn-vulkan -i origin.jpg -o output.png -n 2 -s 2 的输出效果。

4 官方跳转链接汇总

5 前置要求与服务器配置

5.1 软件前提

• 操作系统：Windows / Linux / macOS。
• 支持 Vulkan 的显卡（或回退 CPU）。
• 无需 Python、CUDA、Caffe。

5.2 硬件建议

6 方式一：下载即用（推荐）

从 Releases 下载对应系统的可执行文件（已含全部二进制与模型）。

# 基本用法：降噪 2 级、放大 2 倍
waifu2x-ncnn-vulkan.exe -i input.jpg -o output.png -n 2 -s 2

Linux 下给执行权限后运行：

chmod +x waifu2x-ncnn-vulkan
./waifu2x-ncnn-vulkan -i input.jpg -o output.png -n 2 -s 2

7 方式二：源码编译

# macOS 先装 Vulkan SDK：https://vulkan.lunarg.com/

# 1. 克隆并拉子模块
git clone https://github.com/nihui/waifu2x-ncnn-vulkan.git
cd waifu2x-ncnn-vulkan
git submodule update --init --recursive

# 2. CMake 构建
mkdir build && cd build
cmake ../src
cmake --build . -j 4

8 配置项说明（完整命令行参数）

Usage: waifu2x-ncnn-vulkan -i infile -o outfile [options]...

  -h                   显示帮助
  -v                   详细输出
  -i input-path        输入图片路径（jpg/png/webp）或目录
  -o output-path       输出图片路径（jpg/png/webp）或目录
  -n noise-level       降噪等级（-1/0/1/2/3，默认 0）
  -s scale             放大倍数（1/2/4/8/16/32，默认 2）
  -t tile-size         tile 大小（>=32，0=自动；多 GPU 可写 0,0,0）
  -m model-path       模型路径（默认=models-cunet）
  -g gpu-id            GPU 编号（-1=cpu，默认 auto；多 GPU 可写 0,1,2）
  -j load:proc:save    三阶段线程数（默认 1:2:2）
  -x                   启用 TTA 模式
  -f format            输出格式（jpg/png/webp，默认按扩展名/png）

• -n：降噪强度，越大越强；-1 表示不降噪。
• -s：放大倍数，1=不放大，2=放大 2 倍。
• -t：显存不足时调小 tile 降低显存占用。
• -j：小图可用 4:4:4，大图用 2:2:2。

9 常用运维命令

# 单张图片
./waifu2x-ncnn-vulkan -i input.jpg -o output.png -n 2 -s 2

# 批量处理目录
./waifu2x-ncnn-vulkan -i ./input_dir -o ./output_dir -n 1 -s 2

# 强制 CPU
./waifu2x-ncnn-vulkan -i in.png -o out.png -g -1

# 查看帮助
./waifu2x-ncnn-vulkan -h

10 常见故障排查

• 崩溃/报错：官方建议升级显卡驱动（Intel/AMD/NVIDIA 官网）。
• 显存不足：用 -t 调小 tile 大小，或一次处理更小的图。
• 输出体积过大：用 -f webp 减小体积（webp 同为无损编码但体积更小）。
• 多 GPU 指定：用 -g 0,1,2 选择显卡。

11 风险与合规说明

• 许可证：以仓库 LICENSE 为准，二次分发前核对。
• 模型与图片版权：处理的图片需自行拥有版权或获授权。
• 非官方声明：本文基于官方仓库 README 整理，参数以 master 分支最新 --help 为准。