.jpg)
Pujar fitxers grans a través d’internet sempre ha estat un desafiament tècnic. Les connexions inestables, els talls de xarxa i els temporitzadors de proxy poden truncar una transferència de diversos gigabytes en qüestió de segons, obligant l’usuari a reiniciar des de zero. Aquest problema és especialment crític en entorns professionals on es gestionen vídeos d’alta resolució, còpies de seguretat o datasets de machine learning. El protocol tus (Resumable Upload Protocol) ofereix una solució elegant i estandarditzada basada en HTTP que permet reprendre pujades interrompudes sense perdre el progrés ja acumulat.
En aquest article explorarem en profunditat com implementar pujades reprenibles de vídeo utilitzant Node.js i la llibreria tus-js-client, analitzant tant l’arquitectura del costat del servidor com la integració al navegador. A més, mostrarem com empreses com Q2BSTUDIO apliquen aquestes tècniques en projectes reals de programari a mida per millorar l’experiència d’usuari i la robustesa de les plataformes que gestionen contingut multimèdia.
El taló d’Aquil·les de les pujades tradicionalsUna petició POST multipart tradicional envia el fitxer complet en una sola connexió. Si el navegador parpelleja, el servidor reinicia o l’usuari canvia de xarxa, tota la transferència es perd. Aquest model no escala per a fitxers de centenars de megabytes o diversos gigabytes, habituals en aplicacions de vídeo sota demanda, telemedicina o vigilància. El protocol tus resol aquest problema dividint el fitxer en fragments (chunks) que s’envien mitjançant peticions PATCH independents, cadascuna indicant l’offset exacte on ha de continuar l’escriptura. El client pot preguntar al servidor mitjançant una petició HEAD quants bytes s’han emmagatzemat i reprendre exactament des d’allà.
Arquitectura del servidor amb @tus/serverLa implementació del costat servidor amb Node és sorprenentment lleugera. Utilitzant el paquet @tus/server i un emmagatzematge de dades com @tus/file-store, podem muntar un endpoint que accepti pujades reprenibles en poques línies. El servidor escolta en una ruta com /files, valida el tipus de fitxer i la mida màxima en un hook onUploadCreate, i pot executar accions posteriors en onUploadFinish. Per a producció, l’emmagatzematge en disc és insuficient; es recomana migrar a @tus/s3-store, que utilitza serveis cloud AWS o Azure per garantir durabilitat i escalabilitat. De fet, a Q2BSTUDIO integrem serveis cloud AWS i Azure en plataformes que requereixen emmagatzematge compartit entre múltiples instàncies, assegurant que una pujada parcial sobrevisqui a reinicis del servidor.
Client al navegador amb tus-js-clientDel costat del client, la llibreria tus-js-client simplifica la lògica de reintents i reprensió. En seleccionar un fitxer, es crea una instància d’Upload configurada amb l’endpoint, metadades i una política de reintents exponencials (retryDelays). El més potent és el mètode findPreviousUploads, que permet detectar pujades prèvies del mateix fitxer (basat en la seva empremta) i reprendre-les automàticament, fins i tot després de recarregar la pàgina. L’experiència d’usuari final és impecable: si la xarxa falla durant la pujada d’un vídeo de 4 GB, un cop restablerta la connexió el progrés continua des de l’últim offset conegut, sense que l’usuari hagi d’intervenir.
Verificació del comportament repreniblePer demostrar la recuperació, podem simular un tall de xarxa mentre es puja un fitxer gran. A les eines de desenvolupador del navegador s’observa una petició HEAD que retorna la capçalera Upload-Offset amb el nombre de bytes emmagatzemats, seguida d’una petició PATCH que envia només el fragment que falta. El progrés no es reinicia; salta directament al 62,3% (per exemple) i continua. Aquesta capacitat és crítica en entorns on la intel·ligència artificial necessita processar grans volums de dades de vídeo, com en sistemes d’anàlisi de contingut o entrenament de models de visió per ordinador.
Seguretat i neteja: dos aspectes que no s’han de descuidarUn endpoint de pujada obert és una porta d’entrada per a atacs de denegació de servei o ompliment d’emmagatzematge. El hook onUploadCreate és el lloc ideal per validar autenticació mitjançant tokens JWT o sessions, rebutjant la pujada abans que s’emmagatzemi un sol byte. A més, el protocol tus suporta la capçalera Upload-Expires per fer expirar pujades parcials abandonades. Cridar periòdicament a cleanUpExpiredUploads evita que els residus s’acumulin. A Q2BSTUDIO, quan desenvolupem aplicacions a mida que gestionen contingut sensible, apliquem pràctiques de ciberseguretat com validació de tokens, xifrat en trànsit i control d’accés basat en rols, protegint tant les dades del client com la infraestructura subjacent.
Més enllà del demo: integracions empresarialsEl protocol tus no és només una curiositat tècnica; és la base de serveis de pujada en plataformes com Cloudflare Stream, Vimeo o Supabase. Amb el mateix codi client es pot apuntar a qualsevol d’aquests endpoints, cosa que permet migrar entre proveïdors sense canviar la lògica de pujada. Per a empreses que necessiten serveis d’intel·ligència de negoci que consumeixin dades de vídeo o fitxers grans, integrar tus garanteix que la ingesta sigui fiable. A més, la combinació amb agents IA permet automatitzar la transcodificació i l’anàlisi en temps real un cop completada la pujada, utilitzant el hook onUploadFinish per llançar pipelines serverless.
Reflexió finalImplementar pujades reprenibles amb tus és una inversió tècnica que s’amortitza ràpidament en estalvi d’ample de banda, millora de l’experiència d’usuari i reducció de suport tècnic. No es tracta només de replicar un fragment de codi; implica repensar l’arquitectura de transferència de dades des de zero. A Q2BSTUDIO, com a empresa de desenvolupament de programari i tecnologia, apliquem aquest tipus de solucions en projectes que van des de portals de vídeo corporatiu fins a plataformes de telemedicina, combinant IA per a empreses, automatització de processos i serveis cloud per oferir sistemes robustos i escalables. Si el teu negoci gestiona pujades grans o necessita que les dades arribin completes sense importar la xarxa, el protocol tus no és una opció, és la resposta.
