Vercel Blob - Next.js - subidas - tutorial - seguridad
6 min lectura

Cómo subir archivos grandes directo a Vercel Blob con autorización

Guía Next.js: autoriza en servidor y sube archivos grandes del navegador a Vercel Blob. Incluye código, prueba en Preview, costos y límites.

Cómo subir archivos grandes directo a Vercel Blob con autorización

Una fundadora recibe fotos de producto de 30 MiB desde un formulario. Si manda el archivo al servidor de Next.js, la petición puede chocar con el límite de la Function, incluso tras la nueva beta de 20 MiB. Para este caso, la subida directa a Vercel Blob cambia el recorrido: el servidor comprueba al usuario y entrega un token temporal; el navegador envía los bytes al almacenamiento. Es una guía de implementación sobre una función disponible, no un anuncio nuevo.

Cuándo elegirla

Este patrón sirve para imágenes, archivos de clientes o exportaciones que no necesitan atravesar tu Function. La beta de cuerpos de 20 MiB puede simplificar una carga pequeña que sí debas procesar en el servidor; para 30 MiB y más, la ruta directa evita poner el archivo en esa petición. Vercel documenta Blob en todos los planes y un límite máximo de 5 TB por archivo; recomienda subida multipart para archivos mayores de 100 MB. Esos límites no son una promesa de que cualquier navegador, conexión o cuenta complete una carga enorme: mide tus casos reales.

Prepara el proyecto

  1. Crea una tienda Blob en Storage y conéctala al proyecto. Para el ejemplo de fotos públicas, elige acceso público solo si de verdad quieres URL accesible para cualquiera que la conozca. Para documentos privados, usa una tienda privada y adapta la lectura.
  2. Activa la variable de lectura y escritura de la conexión para el servidor. Vercel la usa para emitir tokens de cliente; nunca la envíes al navegador. Conecta también el entorno Preview y, si desarrollas localmente, Development.
  3. Instala el SDK con npm i @vercel/blob. El ejemplo siguiente supone un proyecto Next.js App Router con autenticación Auth.js ya configurada en @/auth.

Ruta que autoriza, sin recibir el archivo

En app/api/product-photos/upload/route.ts, handleUpload recibe la petición de token y la notificación de carga terminada. La comprobación de sesión debe ejecutarse antes de emitir el token. Cambia el import de auth por el proveedor real de tu app y comprueba también que el usuario pueda subir archivos para ese producto.

import { handleUpload, type HandleUploadBody } from '@vercel/blob/client';
import { auth } from '@/auth';

export async function POST(request: Request) {
  const body = (await request.json()) as HandleUploadBody;
  try {
    const result = await handleUpload({
      body,
      request,
      onBeforeGenerateToken: async (pathname) => {
        const session = await auth();
        if (!session?.user?.email) throw new Error('No autorizado');
        if (!pathname.startsWith('product-photos/')) {
          throw new Error('Ruta no permitida');
        }
        return {
          allowedContentTypes: ['image/jpeg', 'image/png', 'image/webp'],
          addRandomSuffix: true,
          tokenPayload: JSON.stringify({ userEmail: session.user.email }),
        };
      },
      onUploadCompleted: async ({ blob, tokenPayload }) => {
        // Valida tokenPayload y asocia blob.url al producto en tu base de datos.
        // No aceptes un productId enviado por el cliente sin autorización.
        console.log('Carga terminada', blob.url, tokenPayload);
      },
    });
    return Response.json(result);
  } catch (error) {
    return Response.json({ error: (error as Error).message }, { status: 400 });
  }
}

El console.log es un punto de integración, no persistencia. Antes de producción, verifica propiedad del producto, valida el tipo real del archivo después de subirlo, guarda la URL en una transacción y decide qué hacer con objetos huérfanos. Si necesitas control estricto de tamaño, fija un límite en tu flujo y confirma en el SDK y la tienda cuál se aplica realmente; un atributo de formulario no basta como política de seguridad.

Formulario del navegador

En un componente cliente, importa upload. La URL de la ruta de token coincide con la que acabas de crear. El archivo viaja del navegador a Blob; tu Function participa en autorización y callback.

'use client';
import { upload } from '@vercel/blob/client';
import { useState } from 'react';

export default function ProductPhotoUpload() {
  const [status, setStatus] = useState('');
  return <form onSubmit={async (event) => {
    event.preventDefault();
    const input = event.currentTarget.elements.namedItem('photo') as HTMLInputElement;
    const file = input.files?.[0];
    if (!file) return;
    setStatus('Subiendo…');
    try {
      const blob = await upload(`product-photos/${file.name}`, file, {
        access: 'public',
        handleUploadUrl: '/api/product-photos/upload',
      });
      setStatus(`Listo: ${blob.url}`);
    } catch (error) { setStatus(`Error: ${(error as Error).message}`); }
  }}>
    <input name="photo" type="file" accept="image/jpeg,image/png,image/webp" required />
    <button type="submit">Subir foto</button>
    <p role="status">{status}</p>
  </form>;
}

Prueba y límites

Despliega primero a Preview. Prueba una imagen pequeña y una de 30 MiB, revisa en Network que el cuerpo grande vaya a Blob y que tu API solo intercambie el token. Repite sin sesión: no debe emitir token. Prueba extensión y tipo no admitidos y verifica que el callback registre la URL una sola vez. Vercel explica que onUploadCompleted no puede llamar a localhost; usa Preview o un túnel y VERCEL_BLOB_CALLBACK_URL si necesitas ese callback local.

Consulta precio y límites actuales antes de mover tráfico: aunque la subida directa evita pasar bytes por la Function, Blob cobra almacenamiento, operaciones y transferencia de salida según plan. No hemos desplegado este ejemplo en una cuenta propia ni medido coste o velocidad. La decisión práctica es clara: si tu archivo excede el tamaño cómodo de una Function y no requiere procesamiento inmediato allí, prueba la ruta directa en Preview con autenticación y una muestra real.

Recibe lo nuevo en tu correo

Workshops gratis, herramientas y novedades de IA aplicadas a negocio, sin humo.

🎓 Workshops en vivo🛠️ Herramientas nuevas⚡ Novedades de IA

Sin spam. Te das de baja cuando quieras.

Comentarios

Aún no hay comentarios. Sé el primero.

Deja un comentario