Subidas de video reanudables con tus, Node y tus-js-client

Subir archivos grandes a través de internet siempre ha sido un desafío técnico. Las conexiones inestables, los cortes de red y los temporizadores de proxy pueden truncar una transferencia de varios gigabytes en cuestión de segundos, obligando al usuario a reiniciar desde cero. Este problema es especialmente crítico en entornos profesionales donde se manejan videos de alta resolución, copias de seguridad o datasets de machine learning. El protocolo tus (Resumable Upload Protocol) ofrece una solución elegante y estandarizada basada en HTTP que permite reanudar subidas interrumpidas sin perder el progreso ya acumulado.

En este artículo exploraremos en profundidad cómo implementar subidas reanudables de video utilizando Node.js y la librería tus-js-client, analizando tanto la arquitectura del lado del servidor como la integración en el navegador. Además, mostraremos cómo empresas como Q2BSTUDIO aplican estas técnicas en proyectos reales de software a medida para mejorar la experiencia de usuario y la robustez de las plataformas que gestionan contenido multimedia.

El talón de Aquiles de las subidas tradicionalesUna petición POST multipart tradicional envía el archivo completo en una sola conexión. Si el navegador parpadea, el servidor reinicia o el usuario cambia de red, toda la transferencia se pierde. Este modelo no escala para archivos de cientos de megabytes o varios gigabytes, habituales en aplicaciones de vídeo bajo demanda, telemedicina o vigilancia. El protocolo tus resuelve este problema dividiendo el archivo en fragmentos (chunks) que se envían mediante peticiones PATCH independientes, cada una indicando el offset exacto donde debe continuar la escritura. El cliente puede preguntar al servidor mediante una petición HEAD cuántos bytes se han almacenado y reanudar exactamente desde ahí.

Arquitectura del servidor con @tus/serverLa implementación del lado servidor con Node es sorprendentemente ligera. Usando el paquete @tus/server y un almacén de datos como @tus/file-store, podemos montar un endpoint que acepte subidas reanudables en pocas líneas. El servidor escucha en una ruta como /files, valida el tipo de archivo y el tamaño máximo en un hook onUploadCreate, y puede ejecutar acciones posteriores en onUploadFinish. Para producción, el almacenamiento en disco es insuficiente; se recomienda migrar a @tus/s3-store, que utiliza servicios cloud AWS o Azure para garantizar durabilidad y escalabilidad. De hecho, en Q2BSTUDIO integramos servicios cloud AWS y Azure en plataformas que requieren almacenamiento compartido entre múltiples instancias, asegurando que una subida parcial sobreviva a reinicios del servidor.

Cliente en navegador con tus-js-clientDel lado del cliente, la librería tus-js-client simplifica la lógica de reintentos y reanudación. Al seleccionar un archivo, se crea una instancia de Upload configurada con el endpoint, metadatos y una política de reintentos exponenciales (retryDelays). Lo más potente es el método findPreviousUploads, que permite detectar subidas previas del mismo archivo (basado en su huella) y reanudarlas automáticamente, incluso después de recargar la página. La experiencia de usuario final es impecable: si la red falla durante la subida de un video de 4 GB, tras restablecerse la conexión el progreso continúa desde el último offset conocido, sin que el usuario tenga que intervenir.

Verificación del comportamiento reanudablePara demostrar la recuperación, podemos simular un corte de red mientras se sube un archivo grande. En las herramientas de desarrollador del navegador se observa una petición HEAD que devuelve el encabezado Upload-Offset con el número de bytes almacenados, seguida de una petición PATCH que envía solo el fragmento faltante. El progreso no se reinicia; salta directamente al 62,3% (por ejemplo) y continúa. Esta capacidad es crítica en entornos donde la inteligencia artificial necesita procesar grandes volúmenes de datos de video, como en sistemas de análisis de contenido o entrenamiento de modelos de visión por computadora.

Seguridad y limpieza: dos aspectos que no deben descuidarseUn endpoint de subida abierto es una puerta de entrada para ataques de denegación de servicio o relleno de almacenamiento. El hook onUploadCreate es el lugar ideal para validar autenticación mediante tokens JWT o sesiones, rechazando la subida antes de que se almacene un solo byte. Además, el protocolo tus soporta la cabecera Upload-Expires para expirar subidas parciales abandonadas. Llamar periódicamente a cleanUpExpiredUploads evita que los residuos se acumulen. En Q2BSTUDIO, cuando desarrollamos aplicaciones a medida que manejan contenido sensible, aplicamos prácticas de ciberseguridad como validación de tokens, cifrado en tránsito y control de acceso basado en roles, protegiendo tanto los datos del cliente como la infraestructura subyacente.

Más allá del demo: integraciones empresarialesEl protocolo tus no es solo una curiosidad técnica; es la base de servicios de subida en plataformas como Cloudflare Stream, Vimeo o Supabase. Con el mismo código cliente se puede apuntar a cualquiera de estos endpoints, lo que permite migrar entre proveedores sin cambiar la lógica de subida. Para empresas que necesitan servicios de inteligencia de negocio que consuman datos de video o grandes ficheros, integrar tus garantiza que la ingesta sea fiable. Además, la combinación con agentes IA permite automatizar la transcodificación y el análisis en tiempo real apenas se completa la subida, usando el hook onUploadFinish para lanzar pipelines serverless.

Reflexión finalImplementar subidas reanudables con tus es una inversión técnica que se amortiza rápidamente en ahorro de ancho de banda, mejora de la experiencia de usuario y reducción de soporte técnico. No se trata solo de replicar un fragmento de código; implica repensar la arquitectura de transferencia de datos desde cero. En Q2BSTUDIO, como empresa de desarrollo de software y tecnología, aplicamos este tipo de soluciones en proyectos que van desde portales de video corporativo hasta plataformas de telemedicina, combinando IA para empresas, automatización de procesos y servicios cloud para ofrecer sistemas robustos y escalables. Si tu negocio maneja subidas grandes o necesita que los datos lleguen completos sin importar la red, el protocolo tus no es una opción, es la respuesta.