NAS 与运维

Free-Fs:文件管理与分享系统

  • 0 次阅读
  • 0 条评论
文章摘要

Free-Fs 是面向个人和小团队的文件管理系统,原资料介绍了上传、预览、分享、权限和存储配额。适用前提是选择可追溯的发行版本,并核对数据库、对象存储与前端依赖。 文件实体与元数据由不同组件保存,上传、预览和分享依赖整套服务。用户配额和回收站影响日常使用与恢复。 适合个人和小团队文件管理。先用独立存储验证权限,再连接正式资料。

项目介绍

Free-Fs 是面向个人和小团队的文件管理系统,原资料介绍了上传、预览、分享、权限和存储配额。适用前提是选择可追溯的发行版本,并核对数据库、对象存储与前端依赖。

文件实体与元数据由不同组件保存,上传、预览和分享依赖整套服务。用户配额和回收站影响日常使用与恢复。

适合个人和小团队文件管理。先用独立存储验证权限,再连接正式资料。

核心功能

功能 作用与使用方式
文件管理 上传移动和下载
分片续传 测试中断后的行为
在线预览 检查常用格式
分享控制 测试密码有效期和撤销
配额权限 限制不同用户空间

功能示意

Free-Fs 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 配置指南
分类 NAS 与运维
整理日期 2026-11-14

安装与运行

在 Linux/WSL 开发环境准备项目要求的 Java、Maven,以及独立的 MySQL 和 Redis。先以开发方式验证;以下命令不是一个没有数据库就能直接启动的单服务配置。

1. 安装和初始化

git clone https://gitee.com/dromara/free-fs.git
cd free-fs
mvn clean install -DskipTests

2. 第一次使用

先建立专用数据库和账号,按仓库 _sql/free-fs.sql 导入表结构;编辑 fs-admin/src/main/resources/application-dev.yml,把 MySQL、Redis 和存储配置改为自己的连接。然后启动:

cd fs-admin
mvn spring-boot:run

按启动日志显示的端口访问,先测试登录、上传小文件、预览和删除。前端是独立 Vue 工程,按对应目录 README 安装构建;后端接口启动不等于前端已经部署。

数据库导入命令使用 mysql -u 自己的数据库用户 -p 自己建立的数据库 < _sql/free-fs.sql,密码在交互提示中输入。首次安装确认 SQL 是否包含建库语句,再选择数据库;不要向已有业务库导入测试表。

常见问题

  • 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
  • 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
  • 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。

更新与备份

更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。

官方资料