URL 即配置的 Node.js 图片处理库

imgx,把图片处理写进 URL

缩放、裁剪、加水印、转格式 —— 全部用一段可读的 URL 表达,底层由 sharp 驱动,可直接接入任意 Node.js 项目。

npm install @imgx-kit/core

开始使用 · 支持 Node.js 18+,ESM 与 CJS 双产物

核心特性

  • URL 参数驱动 — 兼容阿里云 OSS x-oss-process,URL 即配置
  • 链式 Builder API — TypeScript 友好,IDE 智能提示
  • 12+ 内置操作 — 缩放、裁剪、旋转、水印、格式转换、质量调节等
  • 基于 sharp — 成熟的 libvips 后端,稳定可靠

用法示例

同一套引擎,两种调用方式 —— 选你代码里更顺手的那一种。

URL 风格

import { processImage } from '@imgx-kit/core';

const buf = await processImage(
  './photo.jpg',
  'image/resize,w_300/format,webp',
);

Builder 风格

import { imgx } from '@imgx-kit/core';

const buf = await imgx('./photo.jpg')
  .resize({ w: 300 })
  .format({ type: 'webp' })
  .toBuffer();

效果对比

同一张原图,三组参数:

等比缩放至宽 300

等比缩放至宽 300

image/resize,w_300
圆形头像

圆形头像

image/resize,w_200,h_200,m_fill/circle,r_100
添加文字水印

添加文字水印

image/resize,w_400/watermark,text_SGVsbG8sd_t_50,g_se

imgx 底层使用 sharp 与 libvips。