项目介绍
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 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。