文件与存储管理
文件与存储管理模块提供统一的文件上传与存储能力，支持本地存储、阿里云 OSS 和 RustFS 三种后端，可在运行期间灵活切换。
功能入口
登录管理后台后，点击左侧菜单 系统管理 > 文件管理，进入文件列表页面。页面以表格形式展示所有已上传的文件，包含文件名、大小、存储方式、上传时间等字段。
三种存储方式
Forge Admin 通过 forge-starter-file 模块封装了三种存储后端：
| 存储方式 | 说明 | 适用场景 |
|---|---|---|
| 本地存储 | 文件保存在服务器本地磁盘 | 开发测试、单机部署 |
| OSS | 阿里云对象存储 | 生产环境、分布式部署 |
| RustFS | 高性能分布式文件存储 | 大文件、高并发场景 |
配置切换
存储方式通过系统参数配置管理，管理员可在 系统管理 > 参数配置 中修改：
- 找到参数键名为
sys.file.storageType的配置项 - 修改参数值为
local、oss或rustfs - 保存后立即生效，后续上传的文件将使用新存储方式
切换存储方式不会影响已上传文件的访问，旧文件仍通过原存储路径访问。
文件列表管理
文件管理页面提供以下功能：
- 查看文件列表：展示所有已上传文件，支持按文件名和存储方式筛选
- 预览文件：点击文件名可在线预览图片和文档
- 复制链接：点击复制按钮获取文件访问 URL
- 下载文件：点击下载按钮将文件保存到本地
- 删除文件：点击删除按钮移除文件，同时清理存储端文件
文件渲染
在前端页面中展示文件时，请使用系统提供的标准方法：
- 图片文件：使用
AuthImage组件渲染，自动携带认证 Token - 文件下载：使用
getFileUrl(fileId)工具函数获取下载链接 - 图片上传组件：存储的是
fileId，不是 URL，禁止直接用NAvatar的src属性
vue
<!-- 正确方式：使用 AuthImage 组件 -->
<AuthImage :file-id="row.avatar" />注意事项
imageUpload组件存储的是文件 ID（fileId），不是 URL- 获取文件下载链接使用
getFileUrl(fileId)from@/utils/file - 删除文件操作不可逆，请确认文件不再使用后再执行删除
相关文档
- 动态配置管理 — 如何修改文件存储配置