使用tusd实现按年月目录存储上传文件的技术方案

在实际文件上传业务场景中，经常需要按照上传时间对文件进行归档存储。本文将详细介绍如何通过tusd的文件上传服务实现按年月目录自动分类存储的技术方案。

核心需求分析

许多业务系统需要将用户上传的文件按照上传时间自动归档到对应的年月目录中。例如：

• 2024年4月上传的文件应存储在/upload-dir/2024/04/目录下
• 2024年5月上传的文件应存储在/upload-dir/2024/05/目录下

这种存储结构有利于后续的文件管理和检索。

技术实现方案

版本要求

该功能需要tusd v2.0.0及以上版本，因为自定义ID功能是在这个版本引入的。

核心机制：Hook系统

tusd提供了强大的Hook系统，允许开发者在文件上传的生命周期中插入自定义逻辑。我们需要使用pre-create这个Hook点，在文件创建前指定存储路径。

具体实现方法

通过编写Hook脚本返回包含年月信息的自定义ID：

from datetime import datetime
import uuid
import json

# 获取当前年月信息
current_year = datetime.now().year
current_month = datetime.now().month

# 生成唯一标识符
file_uuid = uuid.uuid4()

# 构造返回的JSON响应
response = {
    "ChangeFileInfo": {
        "ID": f"{current_year}/{current_month}/{file_uuid}",
    }
}

# 输出JSON格式的响应
print(json.dumps(response))

部署配置

1. 将上述脚本保存为pre-create文件
2. 确保脚本具有可执行权限
3. 启动tusd时指定hooks目录：

tusd -upload-dir /path/to/uploads -hooks-dir /path/to/hooks

技术原理

当tusd接收到文件上传请求时：

1. 首先执行pre-create钩子脚本
2. 脚本返回包含年月目录结构的自定义ID
3. tusd使用这个ID作为文件存储路径
4. 文件最终存储在类似/upload-dir/2024/04/uuid的路径下

注意事项

1. 确保tusd进程对目标目录有写入权限
2. Hook脚本需要有可执行权限
3. 脚本执行时间会影响上传性能，建议保持简单高效
4. 在高并发场景下，需要考虑UUID冲突的可能性

扩展应用

这种方案不仅可以用于按时间归档，还可以扩展用于：

• 按用户ID分类存储
• 按文件类型分类存储
• 实现自定义的存储命名规则

通过灵活运用tusd的Hook系统，开发者可以实现各种复杂的文件存储策略，满足不同业务场景的需求。