Alojamiento eficiente de imágenes: CDN y procesamiento
La entrega estática y la transformación de imágenes resuelven problemas distintos. Una CDN estática
almacena en caché archivos que ya existen; no redimensiona un JPEG simplemente porque añadas
?width=800. Aquí generarás archivos versionados a partir de una fotografía local
de confianza y abrirás una vista previa adaptable con una imagen de sustitución de un solo intento.
Después podrás publicar esos mismos archivos en tu CDN de alojamiento de imágenes.
Elige archivos estáticos o transformaciones dinámicas
La generación previa evita el trabajo de decodificación cuando se solicita una nueva URL de imagen. Almacenas y publicas un conjunto conocido de archivos, incluidas variantes que quizá nunca se soliciten. Una URL versionada identifica un archivo con dimensiones y formato fijos, lo que facilita distinguir los fallos de generación de los fallos de entrega.
Elige deliberadamente entre variantes generadas previamente y un servicio de transformación. Si necesitas redimensionamiento arbitrario, usa un servidor de origen de procesamiento o un servicio como Smart CDN de Transloadit. Verifica las condiciones de los parámetros y de la firma de ese servicio; los objetos estáticos de S3/CloudFront no interpretan parámetros de consulta de transformación.
Cloudinary
Los servicios de transformación alojados definen su propia sintaxis de URL y las ubicaciones de origen permitidas. Sigue la referencia de transformaciones de Cloudinary o la documentación equivalente de tu proveedor. Una URL de un proveedor no puede usarse como contrato genérico de redimensionamiento en otra CDN.
Herramientas y bibliotecas para el procesamiento de imágenes
Sharp (Node.js)
Usa una versión de Node.js 26 con mantenimiento y Corepack instalado por separado. Este ejemplo se probó con Node.js 26.12.1 y 26.13.0, además de Yarn 4.12.0. Aquí se fija Sharp 0.35.4 para garantizar la reproducibilidad, sin afirmar que sea el parche más reciente. Consulta los requisitos de instalación de Sharp para conocer las plataformas compatibles y los paquetes nativos opcionales.
Ejecuta este bloque de Bash desde un directorio con permisos de escritura. El bloque crea un proyecto Yarn independiente y deja tu shell en su directorio original. El archivo de bloqueo vacío establece los límites del proyecto incluso dentro de un espacio de trabajo existente; Yarn sigue leyendo la configuración aplicable de los directorios superiores.
(
command -v node >/dev/null &&
command -v corepack >/dev/null &&
mkdir image-publish &&
cd image-publish &&
printf '%s\n' '{"private":true,"packageManager":"yarn@4.12.0"}' > package.json &&
touch yarn.lock &&
corepack yarn add --exact sharp@0.35.4
)
Si image-publish ya existe, elige otro nombre de directorio nuevo en lugar de eliminar
su contenido. Si la instalación falla después de crearlo, inspecciona ese directorio y elige un nombre
nuevo para el siguiente intento de configuración. Después de una instalación correcta, abre una
terminal en image-publish. Usa corepack yarn node para el script, de modo
que funcione tanto con la instalación Plug’n’Play predeterminada de Yarn como con su enlazador
node-modules.
Proporciona photo.jpg: su contenido puede ser JPEG o PNG, independientemente de
este nombre de archivo fijo. Usa una imagen sRGB de confianza de 8 bits sin canal alfa. La entrada
no debe estar vacía ni superar los 8 MiB, con un máximo de 12.000.000 píxeles y al menos 1280 píxeles
de ancho después de aplicar la orientación EXIF. El programa rechaza otros formatos decodificados,
espacios de color y profundidades de muestra. Se trata de una tarea de publicación secuencial, no de
un endpoint de subida ni de un validador general para archivos maliciosos. Los contenedores JPEG y
PNG se leen como una imagen fija principal; esto no demuestra que se haya procesado una imagen
complementaria MPO, una animación APNG o un mapa de ganancia HDR.
Guarda lo siguiente como build-images.mts:
import { mkdir, open, writeFile } from 'node:fs/promises'
import sharp, { type SharpOptions } from 'sharp'
async function main() {
const file = await open('photo.jpg', 'r')
let source
try {
const stat = await file.stat()
if (!stat.isFile() || stat.size < 1 || stat.size > 8 * 1024 * 1024) {
throw new Error('Use a regular source image no larger than 8 MiB.')
}
source = Buffer.alloc(stat.size)
let offset = 0
while (offset < source.length) {
const { bytesRead } = await file.read(source, offset, source.length - offset, null)
if (bytesRead === 0) throw new Error('Source changed during publishing.')
offset += bytesRead
}
} finally {
await file.close()
}
const options: SharpOptions = { limitInputPixels: 12_000_000, failOn: 'warning' }
const metadata = await sharp(source, options).metadata()
if (!['jpeg', 'png'].includes(metadata.format) || (metadata.pages ?? 1) !== 1) {
throw new Error('Use a JPEG or PNG primary image.')
}
if (metadata.space !== 'srgb' || metadata.depth !== 'uchar' || metadata.hasAlpha) {
throw new Error('Use an 8-bit sRGB image without an alpha channel.')
}
const orientedWidth = metadata.autoOrient?.width ?? metadata.width
if (!orientedWidth || orientedWidth < 1280) throw new Error('Source must be at least 1280px wide.')
await mkdir('images', { recursive: true })
for (const width of [320, 640, 1280]) {
const result = await sharp(source, options).rotate().resize({ width }).webp({ quality: 80 })
.toBuffer({ resolveWithObject: true })
await writeFile('images/photo-' + width + '-v1.webp', result.data, { flag: 'wx' })
}
const fallback = await sharp(source, options).rotate().resize({ width: 640 })
.jpeg({ quality: 80 }).toBuffer({ resolveWithObject: true })
await writeFile('images/photo-640-v1.jpg', fallback.data, { flag: 'wx' })
console.log(JSON.stringify({ width: fallback.info.width, height: fallback.info.height }))
}
main().catch((error: unknown) => {
console.error(error instanceof Error ? error.message : 'Image publishing failed.')
process.exitCode = 1
})
Ejecuta el programa guardado desde ese directorio:
corepack yarn node build-images.mts
El programa escribe tres variantes WebP basadas solo en el ancho, de 320, 640 y 1280 píxeles, además de un JPEG de respaldo de 640 píxeles de ancho. Todas conservan la relación de aspecto de la imagen orientada. La última línea JSON indica el ancho y el alto reales del JPEG. Abre la vista previa local e inspecciona la imagen antes de subir cualquier archivo; la calidad 80 es un ajuste del codificador, no una promesa de un tamaño de archivo o una calidad perceptual determinados.
No modifiques la entrada durante una ejecución. Las escrituras exclusivas rechazan los nombres de
archivo de salida existentes, incluido el JPEG de respaldo. Un fallo puede dejar resultados parciales;
inspecciónalos y usa una versión nueva para reintentar. Cambia v1 en todos
los nombres de salida y las referencias HTML a la vez cuando publiques una versión nueva. La tarea
no revierte los archivos que ya ha escrito.
La orientación automática de Sharp aplica la orientación EXIF antes de redimensionar. Su comportamiento de salida predeterminado elimina los metadatos de origen. Inspecciona por tu cuenta los colores y la orientación de la imagen mostrada; estos límites no demuestran que un original dañado esté intacto.
ImageMagick
Si ya tienes ImageMagick 7 con soporte para JPEG y WebP, este comando de Bash crea un WebP pequeño a partir de la misma imagen de origen aprobada. Se probó con ImageMagick 7.1.2-32; obtén actualizaciones con mantenimiento desde las descargas de ImageMagick.
(
set -o noclobber
magick photo.jpg -auto-orient -resize '640x640>' -strip -quality 80 webp:- > photo-small.webp
)
La geometría de redimensionamiento entre comillas ajusta la imagen a
un área de 640 × 640 sin ampliarla. Una imagen de 1280 × 720 pasa a 640 × 360; una de 320 × 180
conserva ese tamaño. Esto difiere de las variantes basadas solo en el ancho del script de Sharp y
no crea el conjunto completo de la vista previa. La shell rechaza un
photo-small.webp existente antes de iniciar la conversión. Una conversión fallida puede
dejar un archivo nuevo vacío o parcial; inspecciónalo antes de reintentar con un nombre nuevo.
El comando no incluye ninguna de las protecciones de entrada del script de Sharp. Usa aquí solo
la imagen de origen sRGB de 8 bits ya aprobada; los archivos que no sean de confianza necesitan
aislamiento de procesos y políticas para los decodificadores y los recursos.
Previsualiza imágenes adaptables generadas previamente
Guarda esta página completa como index.html junto al directorio generado
images/. Guarda el bloque de gestión de errores que aparece inmediatamente
debajo como fallback.js y abre index.html en tu navegador.
Sus rutas relativas funcionan directamente desde el directorio local.
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Responsive image preview</title>
<body style="margin: 0">
<picture>
<source
type="image/webp"
data-srcset="images/photo-320-v1.webp 320w, images/photo-640-v1.webp 640w, images/photo-1280-v1.webp 1280w"
sizes="(max-width: 640px) 100vw, 640px"
>
<img
id="hero"
data-src="images/photo-640-v1.jpg"
data-fallback="images/placeholder.png"
alt="A description of your photograph"
width="640"
height="360"
style="display: block; width: 100%; max-width: 640px; height: auto"
>
</picture>
<script src="fallback.js"></script>
</body>
</html>
Establece width y height con las dimensiones reales
del JPEG de respaldo que imprime el script. Los valores 640 × 360 corresponden a una imagen de origen
16:9; otras relaciones de aspecto necesitan alturas diferentes. Sustituye el texto alternativo por
una descripción de tu imagen. El valor de sizes coincide con el diseño de
esta página, que deja de crecer al alcanzar un ancho de 640 medido en píxeles CSS. Un navegador puede
elegir entre las opciones WebP según su área de visualización y densidad de píxeles; el JPEG es la opción
predeterminada cuando no se selecciona WebP.
Los atributos data-src y data-srcset retrasan las solicitudes
hasta que el script fallback.js instala su controlador. Esta vista previa necesita
JavaScript. Proporciona tu propio PNG real como images/placeholder.png, o usa una copia de
un PNG aprobado. Para probar la recuperación, cambia temporalmente el nombre del archivo WebP
seleccionado y vuelve a cargar la página. Restáuralo después. Si falta la imagen de sustitución,
debería quedar el texto alternativo de la imagen sin reintentos repetidos.
Gestión de errores de carga de imágenes
Guarda lo siguiente como fallback.js junto a index.html.
El script registra el controlador antes de activar las URL de la vista previa. Al eliminar las
opciones adaptables, la imagen de sustitución puede convertirse en la imagen seleccionada:
function installImageFallback(image, fallbackUrl) {
image.addEventListener('error', () => {
for (const source of image.closest('picture')?.querySelectorAll('source') ?? []) {
source.remove()
}
image.removeAttribute('srcset')
image.removeAttribute('sizes')
image.src = fallbackUrl
}, { once: true })
}
const hero = document.getElementById('hero')
if (hero instanceof HTMLImageElement) {
installImageFallback(hero, hero.dataset.fallback ?? '/images/placeholder.png')
for (const source of hero.closest('picture')?.querySelectorAll('source') ?? []) {
if (source.dataset.srcset) source.srcset = source.dataset.srcset
}
if (hero.dataset.src) hero.src = hero.dataset.src
}
El controlador se ejecuta una vez por elemento de imagen. Si la imagen de sustitución también falla, el navegador conserva el texto alternativo accesible y no se vuelve a asignar otra imagen de sustitución. En una aplicación existente, conecta el controlador antes de establecer las URL de las imágenes para que un fallo inmediato no pueda ocurrir antes del registro.
Publica archivos versionados en tu CDN
Sube los archivos WebP generados y el JPEG de respaldo de images/, junto con
tu imagen de sustitución, a un prefijo aprobado para contenido público. Conserva las rutas
relativas o sustituye cada URL de imagen de la vista previa por su URL de CDN. Establece los tipos
de contenido image/webp, image/jpeg y
image/png para sus respectivos archivos. No subas originales privados a ese
prefijo.
Usa tiempos de permanencia en caché largos para objetos inmutables y versionados. Establece de forma deliberada los metadatos de control de caché y después inspecciona las cabeceras de respuesta de la CDN; cambiar los metadatos del origen no sustituye al instante las respuestas almacenadas en caché.
No necesitas una cuenta en la nube para este ejemplo local. Para aprovisionar la infraestructura, consulta la guía de configuración de S3 y CloudFront independiente. Es una lectura complementaria, no un requisito previo para la vista previa.
Para ese despliegue, consulta los requisitos actuales de AWS para orígenes privados. OAC usa un origen de bucket S3 normal, no un endpoint de sitio web. Con la propiedad de todos los objetos establecida obligatoriamente a nombre del propietario del bucket, solicitudes OAC siempre firmadas y una política de bucket limitada a la distribución, CloudFront puede leer un origen privado. Los objetos cifrados con SSE-KMS también necesitan la política adecuada para la clave KMS. El HTTPS para visitantes y la autorización de visitantes son ajustes independientes; OAC no autentica a los visitantes de una URL de CDN pública.
Consideraciones de seguridad al usar CDN
Los orígenes privados y la entrega privada son controles independientes. Para el acceso privado de los visitantes, configura las URL firmadas de CloudFront y el grupo de claves de confianza asociado. Una URL prefirmada de S3 no firma automáticamente las solicitudes a CloudFront.
Mantén las claves de firma del lado del servidor, autoriza el objeto solicitado antes de conceder acceso y evita registrar cadenas de consulta firmadas. No publiques respuestas privadas con una política de caché pública compartida.
Resuelve problemas comunes del alojamiento de imágenes en CDN
Invalidación de caché
Prefiere un nombre de archivo inmutable nuevo para una imagen nueva. Cuando sea necesario invalidar la caché, limita la operación a la distribución y las rutas previstas. Una invalidación es una operación real en la cuenta y puede tener un costo; no la ejecutes como un comando genérico de depuración en producción.
Monitoreo del rendimiento
Usa el panel de red del navegador para inspeccionar la solicitud de la imagen seleccionada, el tamaño de la respuesta y las cabeceras de caché. Prueba dispositivos representativos y cachés tanto vacías como con contenido almacenado. La vista previa local verifica la selección de archivos y la recuperación; no mide la latencia de una CDN desplegada ni demuestra ahorros de ancho de banda.
¿Prefieres no ejecutarlo por tu cuenta?
Smart CDN de Transloadit transforma y entrega archivos sobre la marcha.
