tus-node-server 官方基于node 实现的tus server 1.0 发布

tus-node-server 是基于typescript 开发的新的nodejs server，通过拆分为独立的包（file，s3，gcs， server ）

包含的特性

• 完全基于typescript 开发
• 拆分为了独立的包
• 提供了新的events 以及hooks
• 升级了依赖包
• 重新设计了存储
• file 存储添加了过去扩展
• 更好的周边集成（express，fastify。。。）

参考使用

• s3

version: '3'
services:
  minio:
    image: minio/minio:RELEASE.2023-09-16T01-01-47Z
    ports:
      - "9000:9000"
      - "19001:19001"
    environment:
      MINIO_ACCESS_KEY: minio
      MINIO_SECRET_KEY: minio123
    command: server --console-address :19001 --quiet /data

services:

• app.js

const port = 1080
const datastore = new S3Store({
  partSize: 8 * 1024 * 1024, // 8MB
  s3ClientConfig: {
    bucket: process.env.AWS_BUCKET,
    region: process.env.AWS_REGION,
    endpoint: process.env.AWS_ENDPOINT,
    tls: process.env.AWS_TLS === 'true',
    credentials: {
        accessKeyId: process.env.AWS_ACCESS_KEY_ID,
        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
    },
    forcePathStyle: true,
  },
})
const server = new Server({
  path: '/files',
  datastore,
})
 
// New events system
server.on(EVENTS.POST_CREATE, (req, res, upload) => {
    console.log('POST_CREATE',upload)
 
})
server.on(EVENTS.POST_RECEIVE, (req, res, upload) => {
    console.log('POST_RECEIVE',upload)
})
server.on(EVENTS.POST_FINISH, (req, res, upload) => {
    console.log('POST_FINISH',upload)
})
server.on(EVENTS.POST_TERMINATE, (req, res, id) => {
    console.log('POST_TERMINATE',id)
})
server.listen({ host, port })
client.js
const { Server, EVENTS } = require('@tus/server')
const { S3Store } = require('@tus/s3-store')
require('dotenv').config()
const host = '0.0.0.0'
const fs = require('fs')
const tus = require('tus-js-client')
 
const path = `${__dirname}/my.mp4`
const file = fs.createReadStream(path)
 
const options = {
  endpoint: 'http://localhost:1080/files/',
  metadata: {
    filename: 'my.mp4',
    filetype: 'video/mp4',
  },
  one rror(error) {
    console.error('An error occurred:')
    console.error(error)
    process.exitCode = 1
  },
  onProgress(bytesUploaded, bytesTotal) {
    const percentage = ((bytesUploaded / bytesTotal) * 100).toFixed(2)
    console.log(bytesUploaded, bytesTotal, `${percentage}%`)
  },
  onSuccess() {
    console.log('Upload finished:', upload.url)
  },
}
 
const upload = new tus.Upload(file, options)
upload.start()

效果

说明

目前来说tus-node-server 做为一个支持断点续传的解决方案还是很不错的，一个参考集成
对于客户端可以使用提供的周边工具，我们可以基于tus 的node server 或者golang 也是可以的，进行自己的定制调整
可以实现大文件的断点续传能力，node server 提供的扩展能力还是很不错的

参考资料

https://github.com/tus/tus-node-server
https://tus.io/blog/2023/09/04/tus-node-server-v100
https://github.com/tus/tus-js-client/blob/main/docs/api.md
https://github.com/tus/tus-node-server/tree/main/packages/server#servergetreq-res
https://github.com/tus/tus-node-server/issues/483