文件管理

文件管理模块提供文件的上传、存储、预览和访问控制能力，支持多种存储方式，满足不同场景的文件管理需求。

功能总览

功能点	说明
文件上传	支持单文件和多文件上传
文件存储	本地存储与云存储支持
文件预览	图片、文档等文件的在线预览
文件下载	文件下载和访问控制
存储配置	多存储源的配置管理

文件上传

文件上传支持灵活的配置和多种上传方式：

• 单文件上传：单个文件的选择和上传
• 批量上传：同时选择多个文件批量上传
• 拖拽上传：支持将文件拖拽到上传区域
• 分片上传：大文件自动分片上传，支持断点续传
• 上传限制：可配置允许的文件类型、最大文件大小

上传配置

配置项	说明
允许类型	允许上传的文件扩展名列表
最大大小	单个文件的最大大小限制
存储路径	文件在存储系统中的存放路径规则
自动命名	上传时是否自动生成文件名防重名

文件存储

系统支持多种存储方式，可根据部署环境灵活配置：

存储方式	说明	适用场景
本地存储	文件存储在应用服务器本地磁盘	开发测试环境
云存储 OSS	对接阿里云 OSS 对象存储	生产环境
云存储 COS	对接腾讯云 COS 对象存储	生产环境
MinIO	对接 MinIO 自建对象存储	私有化部署

存储策略

• 存储隔离：不同业务模块的文件存储在不同目录
• 自动归档：过期文件自动迁移至冷存储归档
• 备份策略：重要文件的定期备份和异地容灾

文件预览

文件预览功能支持多种格式文件的在线查看：

• 图片预览：支持 JPG、PNG、GIF、WebP 等常见图片格式
• 文档预览：支持 PDF、Word、Excel 等文档在线预览
• 视频预览：支持 MP4 等常见视频格式的在线播放
• 缩略图：图片文件自动生成缩略图

访问控制

文件访问具有完善的权限控制机制：

• 身份验证：文件访问需携带有效的用户凭证
• 权限校验：校验用户对文件的访问权限
• 临时链接：生成带过期时间的临时访问链接
• 防盗链：配置 Referer 白名单防止文件被盗用