图片跨域代理| images.weserv.nl

产品介绍

wsrv.nl 是一种图像缓存和调整大小服务。我们的服务器会调整您的图像大小，将其缓存到全球，然后显示出来。

• 我们支持多种图像格式，包括 JPEG、PNG、BMP、GIF、TIFF、WebP、PDF 和 SVG。甚至还支持动画 WebP 和 GIF 图像。
• 我们支持 IPv6，提供双栈服务，并支持仅限 IPv6 的源主机。
• 对于通过 TLS/SSL 的安全连接，可以使用 https://wsrv.nl/。这对于在 HTTPS 网站上嵌入 HTTP 图像非常有用。可以通过在主机名前面加上 https:// 来使用 HTTPS 源主机。
• CDN 由 Cloudflare 提供。图像被缓存并直接从200+ 全球数据中心。这确保了最快的加载时间和最佳性能。

How it works 运作方式

传递图像 URL 和一组参数。然后，wsrv.nl 将获取图像，调整其大小，缓存并显示它。下次请求到来时，它将提供缓存的版本。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300">

快速参考

Quick reference

Name	GET	Description
Width	w	设置图像的宽度（以像素为单位）	[info][width]
Height	h	设置图像的高度（以像素为单位）	[info][height]
Device pixel ratio	dpr	设置图像的输出密度	[info][dpr]
Fit	fit	设置图像如何拟合其目标尺寸	[info][fit]
Contain background	cbg	设置使用 &fit=contain 时的背景颜色。	[info][contain-bg]
Without enlargement	we	不要放大图像	[info][without-enlargement]
Alignment position	a	设置图像的对齐方式	[info][alignment-position]
Rectangle crop	crop	将图像裁剪为特定尺寸	[info][rectangle-crop]
Pre-resize crop	precrop	调整大小前的作物行为	[info][rectangle-crop]
Trim	trim	修剪所有边缘的“无聊”像素	[info][trim]
Masking	mask	从预定义列表中设置掩码类型	[info][mask]
Mask trim	mtrim	从蒙版中删除剩余的空格	[info][mask-trim]
Mask background	mbg	设置蒙版的背景色	[info][mask-bg]
Flip	flip	围绕垂直 Y 轴翻转图像	[info][flip]
Flop	flop	围绕水平 X 轴翻移图像	[info][flop]
Rotation	ro	旋转图像	[info][rotation]
Rotation background	rbg	设置以任意角度旋转时的背景颜色	[info][rotation-bg]
Background	bg	设置图像的背景色	[info][background]
Blur	blur	为图像添加模糊效果	[info][blur]
Contrast	con	调整图像对比度	[info][contrast]
Filter	filt	对图像应用滤镜效果	[info][filter]
Gamma	gam	调整图像灰度系数	[info][gamma]
Modulate	mod	使用亮度、饱和度和色调旋转来转换图像	[info][modulate]
Saturation	sat	调整图像的饱和度	[info][saturation]
Hue rotation	hue	对图像应用色相旋转	[info][hue-rotation]
Sharpen	sharp	锐化图像	[info][sharpen]
Tint	tint	为图像着色	[info][tint]
Adaptive filter	af	一种可以在压缩之前应用的筛选算法	[info][adaptive-filter]
Base64 (data URL)	encoding	对要直接在 -tag 中使用的 src= 图像进行编码	[info][base64]
Cache-Control	maxage	浏览器应缓存图像多长时间	[info][cache-control]
Compression level	l	zlib 压缩级别	[info][compression-level]
Default image	default	当加载图像时出现问题，重定向到默认图像	[info][default]
Filename	filename	指定文件名	[info][filename]
Interlace / progressive	il	向 GIF 和 PNG 添加隔行扫描。JPEG 变得渐进式	[info][interlace-progressive]
Number of pages	n	选择要呈现的页数	[info][n-pages]
Output	output	将图像编码为特定格式	[info][output]
Page	page	加载给定页面	[info][page]
Quality	q	定义图像的质量	[info][quality]

Size 大小

控制需要调整图像大小的方式。您可以同时使用和 &w= &h= 参数，也可以仅使用其中一个参数：另一个维度会自动更新。

Width &w= 宽度 &w=

设置图像的宽度（以像素为单位）

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300">

Height &h= 高度 &h=

设置图像的高度（以像素为单位）

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&h=300">

设备像素比 &dpr=

设备像素比用于在 CSS 像素和设备像素之间轻松转换。这使得在各种设备上以正确的像素密度显示图像成为可能，例如带有 Retina 显示屏的 Apple 设备和 Android 设备。必须指定宽度和/或高度，此参数才能正常工作。使用介于 和 8 之间的 1 值。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&h=144&dpr=2">

Fit

控制图像如何拟合到其目标尺寸。以下是几个示例。其中一些值基于 object-fit CSS 属性。

Inside &fit=inside 内部 &fit=内部

默认。 保留纵横比，将图像大小调整为尽可能大，同时确保其尺寸小于或等于指定的尺寸。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=inside">

Outside &fit=outside Outside &fit=外部

保留纵横比，将图像大小调整为尽可能小，同时确保其尺寸大于或等于指定的尺寸

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=outside">

Cover &fit=cover Cover &fit=封面

裁剪图像以覆盖两个提供的尺寸。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=cover">

Fill &fit=fill Fill &fit=填充

忽略输入的纵横比，并拉伸到两个提供的尺寸。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=fill">

Contain &fit=contain Contain &fit=包含

嵌入到两个提供的维度中。可以使用 &cbg= 用背景色填充剩余空间。有关支持的颜色格式，请参阅此处。
更多信息： Issue #80 – 需要适合的信箱图像。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=contain&cbg=black">

没有放大 &we

如果宽度或高度已经小于指定的尺寸，请不要放大。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=inside&we">

Crop 作物

控制图像的对齐方式。

对齐位置 &a=

设置 &fit=cover 或 &fit=contain 时应如何对齐图像。还应指定 &w= 和 &h= 参数。

Position-based 基于位置

控制裁剪的起始位置。设置后 &fit=contain ，它决定了图像在其框内的位置。
有效参数：

• center: default
• top
• right
• bottom
• left
• top-left
• bottom-left
• bottom-right
• top-right

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=cover&a=top">

焦点 &a=focal

您可以使用焦点更具体地了解对齐方式。这可以使用水平 （ ） 和垂直 （ ） 偏移十进制值（介于 和 之间（包括 0.0 和 1.0 之间的浮点数 &fpx= &fpy= ）进行设置。默认值为 0.5 ，或图像的中心。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&h=300&fit=cover&a=focal&fpy=0.45">

智能裁剪 &a=[entropy,attention]

一种基于策略的实验性方法，通过删除无聊的部分来裁剪图像。这仅适用于 &fit=cover .
详细信息：问题 #90 – 添加对智能裁剪的支持。

• entropy: 专注于具有最高Shannon熵的区域。
• attention: 专注于具有最高亮度频率、颜色饱和度和皮肤色调存在的区域

<img src="//wsrv.nl/?url=wsrv.nl/puppy.jpg&w=300&h=300&fit=cover&a=attention">

矩形裁剪 &c[x,y,w,h]=

在任何其他调整大小操作后将图像裁剪为特定尺寸。

TIP
You can use &precrop, for a pre-resize crop behaviour. See Issue #176 – Combine cropping with resizing for more information.
您可以使用 &precrop ，来预调整裁剪行为的大小。有关详细信息，请参阅问题 #176 – 将裁剪与调整大小相结合。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&cx=680&cy=500&cw=300&ch=300">

Trim &trim=

从包含与左上角像素相似的值的所有边缘修剪“无聊”像素。在任何调整大小操作之前进行修整。使用 介于 和 254 之间的 1 值来定义容差级别，以修剪掉相似的颜色值。也可以指定 just &trim ，默认为容差级别为 10

<img src="//wsrv.nl/?url=wsrv.nl/transparency_demo.png&w=300&trim=10">

Mask 面具

。。。

Orientation 取向

。。。

Adjustment 调整

Format 格式

控制图像的输出属性。

自适应滤波器 &af

使用自适应行筛选来减小 PNG 文件大小。仅当输出图像为 时， png 这才有效。

Base64（数据 URL）&encoding=base64

对要直接在 -tag 的 src= 中使用的图像进行编码。使用此链接查看输出结果。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&crop=100,100,720,530&encoding=base64">

缓存控制 &maxage=

定义浏览器应缓存图像的时间。这将更改 max-age Cache-Control HTTP 标头。
我们将“远期到期”定义为默认 1 年。可以使用以下后缀以天、周、月和年为单位指定持续时间：

• d: days
• w: weeks, 7 days
• M: months, 30 days
• y: years, 365 days
  持续时间必须在 1d （1 天） 到 1y （1 年） 之间（含）。任何其他值都将被忽略，并回退到默认值 1 年。

<img src="//wsrv.nl?url=wsrv.nl/lichtenstein.jpg&w=100&maxage=31d">

zlib 压缩级别。使用介于 （no Deflate） 和 9 （maximum Deflate） 之间的 0 值。缺省值为 6 。仅当输出图像为 时， png 这才有效。

默认图片 &default=

如果加载图像时出现问题，则会显示错误。但是，可能需要传递默认图像，而不是向用户提供损坏的图像。
详细信息：问题 #37 – 如果找不到图像的 URL，则返回默认图像。
URL 不得包含 default 查询字符串（如果包含，则将忽略）。

<img src="//wsrv.nl/?url=example.org/noimage.jpg&default=ssl:wsrv.nl%2F%3Furl%3Dwsrv.nl/lichtenstein.jpg%26w%3D300">

文件名 &filename=

指定标头中返回的 Content-Disposition 文件名。文件名只能包含字母数字字符。

隔行扫描 / 逐行扫描 &il

将隔行扫描添加到 GIF 和 PNG。JPEG 变得渐进。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&il">

Number of pages &n=

选择要呈现的页数。缺省值为 1 。设置为 -1 表示“直到文档末尾”。

TIP
-1 will be useful if you need to resize an animated WebP or GIF image.
-1 如果您需要调整动画 WebP 或 GIF 图像的大小，将很有用。

<img src="//wsrv.nl/?url=wsrv.nl/banana.webp&h=300&output=gif&n=-1">

输出 &output=

将图像编码为特定格式。接受 jpg 、 、 、 png gif tiff webp 或 json 。如果未给出任何参数，则将遵循原始图像格式。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&output=webp">

Page &page=

加载给定页面（用于 PDF、TIFF 和多尺寸 ICO 文件）。该值从零开始编号。对于多分辨率图像，可用于 -1 获取最大页面和 -2 最小页面。

质量 &q=

定义图像的质量。使用介于 和 100 之间的 1 值。缺省值为 80 .仅当输出图像为 jpg 或 tiff webp 时，这才有效。

<img src="//wsrv.nl/?url=wsrv.nl/lichtenstein.jpg&w=300&q=20">

------本页内容已结束，喜欢请分享------

感谢您的来访，获取更多精彩文章请收藏本站。

------关注微信公众号：胖大海TuT------