Agent Skills
› fanfan-de/anybox
› netlify-image-cdn
netlify-image-cdn
GitHub指导如何使用 Netlify Image CDN 进行图像优化与转换。涵盖基本用法、查询参数配置、远程图片白名单、URL 重写缓存策略及结合 Functions 和 Blobs 构建用户上传管道，实现高效的图像处理服务。
Trigger Scenarios
需要优化网站图片加载速度
生成响应式图片或缩略图
配置 Netlify 图像转换端点
设置用户上传图片处理流程
Install
npx skills add fanfan-de/anybox --skill netlify-image-cdn -g -y
SKILL.md
Frontmatter
{
"name": "netlify-image-cdn",
"description": "Guide for using Netlify Image CDN for image optimization and transformation. Use when serving optimized images, creating responsive image markup, setting up user-uploaded image pipelines, or configuring image transformations. Covers the \/.netlify\/images endpoint, query parameters, remote image allowlisting, clean URL rewrites, and composing uploads with Functions + Blobs."
}
Netlify Image CDN
Every Netlify site has a built-in /.netlify/images endpoint for on-the-fly image transformation. No configuration required for local images.
Basic Usage
<img src="/.netlify/images?url=/photo.jpg&w=800&h=600&fit=cover&q=80" />
Query Parameters
| Param | Description | Values |
|---|---|---|
url |
Source image path (required) | Relative path or absolute URL |
w |
Width in pixels | Any positive integer |
h |
Height in pixels | Any positive integer |
fit |
Resize behavior | contain (default), cover, fill |
position |
Crop alignment (with cover) |
center (default), top, bottom, left, right |
fm |
Output format | avif, webp, jpg, png, gif, blurhash |
q |
Quality (lossy formats) | 1-100 (default: 75) |
When fm is omitted, Netlify auto-negotiates the best format based on browser support (preferring webp, then avif).
Remote Image Allowlisting
External images must be explicitly allowed in netlify.toml:
[images]
remote_images = ["https://example\\.com/.*", "https://cdn\\.images\\.com/.*"]
Values are regex patterns.
Clean URL Rewrites
Create user-friendly image URLs with redirects:
# Basic optimization
[[redirects]]
from = "/img/*"
to = "/.netlify/images?url=/:splat"
status = 200
# Preset: thumbnail
[[redirects]]
from = "/img/thumb/:key"
to = "/.netlify/images?url=/uploads/:key&w=150&h=150&fit=cover"
status = 200
# Preset: hero
[[redirects]]
from = "/img/hero/:key"
to = "/.netlify/images?url=/uploads/:key&w=1200&h=675&fit=cover"
status = 200
Caching
- Transformed images are cached at the CDN edge automatically
- Cache invalidates on new deploys
- Set cache headers on source images to control caching:
[[headers]]
for = "/uploads/*"
[headers.values]
Cache-Control = "public, max-age=31536000, immutable"
User-Uploaded Images
Combine Netlify Functions (upload handler) + Netlify Blobs (storage) + Image CDN (serving/transforming) to build a complete user-uploaded image pipeline. See references/user-uploads.md for the full pattern.
Bundled References (Load As Needed)
Version History
- 08dc189 Current 2026-07-05 19:03
