🚀 版本更新记录

最新版本

🎯 1.4.0 (2026-03-14)

✨ 新特性

• 下载接口支持分片下载

  • 新增分片下载信息接口 (/download/chunk/info)，获取文件大小、分片大小、总分片数等信息
  • 新增分片下载接口 (/download/chunk)，支持通过 start 和 end 参数指定下载范围
  • 支持大文件分片下载，提升下载性能和用户体验
  • 支持所有存储类型（OSS、COS、OBS、S3、本地存储、HTTP转发）
  • 提供完整的分片下载测试工具

• HTTP Range请求支持（断点续传）

  • 标准下载接口支持 HTTP Range 请求头（Range: bytes=start-end）
  • 支持断点续传功能，提升大文件下载体验
  • 返回 206 Partial Content 状态码
  • 支持所有存储类型（OSS、COS、OBS、S3、本地存储、HTTP转发）
  • 支持 HEAD 请求，仅获取文件元数据（大小、类型等）

• 批量删除接口

  • 新增批量删除接口 (/delete/batch 和 /delete/batch/{业务类型})
  • 支持一次请求删除多个文件（最多100个）
  • 内置并发控制（默认并发数5），提升删除效率
  • 返回每个文件的详细删除结果（成功/失败及错误信息）
  • 单个文件失败不影响其他文件删除
  • 自动进行路径安全验证和清理

• 分片上传清理任务

  • 新增定时清理任务，自动清理过期的分片上传数据
  • 使用 Cron 定时器，每天凌晨1点自动执行
  • 支持清理本地临时分片文件和对象存储的未完成分片上传
  • 使用 Redis Hash 存储对象存储的分片上传元数据，便于扫描和清理
  • 自动取消对象存储的未完成分片上传，避免资源浪费

🔨 功能优化

• 路径处理优化

  • 自动清理路径中多余的斜杠（开头、中间、末尾）
  • 支持 /path/to/file 和 path/to/file 两种格式
  • 自动将反斜杠 \ 替换为正斜杠 /
  • 提升路径兼容性和安全性，防止路径遍历攻击
  • 应用于所有下载和删除接口

• 参数验证优化

  • 移除 Gin 的 binding 验证标签，改为手动验证
  • 提供更详细、更友好的错误提示信息
  • 明确指出具体参数和问题，便于快速定位和修复
  • 统一错误提示格式，提升开发体验

• 错误处理增强

  • 优化所有接口的错误提示信息
  • 区分不同类型的错误（参数错误、权限错误、文件不存在等）
  • 提供具体的错误原因和修复建议
  • 完善异常捕获和日志记录

• 文档完善

  • 完善下载API文档，添加分片下载和Range请求详细说明
  • 完善删除API文档，添加批量删除接口详细说明
  • 添加完整的使用示例和最佳实践（JavaScript、Axios、Go、React、Vue）
  • 优化首页内容，突出新功能特性
  • 更新版本更新记录，详细记录所有新功能和优化

历史版本

🎯 1.3.0 (2026-01-18)

✨ 新特性

• 上传接口支持分片上传

🔨 功能优化

• 配置文件读取优化
  • 支持从 config/ 子目录读取配置文件
  • 优先级：config/config.yaml > config.yaml
  • 启动时输出配置根目录路径，便于确认配置位置
  • 保持向后兼容，仍支持根目录配置文件

🎯 1.2.0 (2025-07-27)

✨ 新特性

• 上传接口增加文件大小、后缀参数输出
• 上传接口增加无后缀名文件支持
• 上传配置增加业务文件夹，用于区分不同的子目录
• 增加http转发模式，自动把请求转发给其他的服务器（支持服务发现）

🔨 功能优化

• 优化nacos注册本机ip获取
• 优化上传文件最大大小单位
• 文件后缀名增加复合.gz、.bz2、.xz支持

🌟 1.1.0 (2025-05-31)

✨ 新特性

• 增加本地授权中心支持
• 增加删除文件接口
• 文件上传接口增加原始路径参数
• 配置增加是否运行删除
• 优雅关闭服务

🔨 功能优化

• 优化下载文件异常
• 优化请求参数日志
• 优化nacos配置信息（区分注册中心和配置中心）
• 优化日志格式（输出格式、nacos日志合并）

🌟 1.0.0 (2025-04-12)

✨ 新特性

• 增加mac系统支持
• 下载文件增加通过路径下载

🔨 功能优化

• 优化授权

🌟 0.2.0 (2024-09-21)

✨ 新特性

• 支持文件在线预览功能
• 文件名称参数支持自定义

🔨 功能优化

• 增强下载安全验证机制
• 优化文件业务类型,采用 URI 方式处理不同业务类型的权限隔离

🌟 0.1.0 (2024-08-31)

🏗️ 框架升级

• 支持 Nacos 注册中心接入

✨ 核心特性

• 文件上传能力

  • 支持文件大小限制配置
  • 支持文件后缀名白名单
  • 支持配置多个上传类型

• 多存储方案支持

  • 服务器本地目录存储
  • 阿里云对象存储(OSS)
  • 腾讯云对象存储(COS)
  • 华为云对象存储(OBS)
  • S3 协议对象存储