夜雨聆风
开源|一款企业级文件管理系统,支持分片上传、断点续传、秒传、多云存储
前言
在日常开发和企业办公中，文件管理是一个绕不开的话题。传统的文件存储方式往往存在诸多痛点：大文件上传容易失败、网络不稳定导致传输中断、文件查找困难、存储空间分散难以统一管理。更不用说在团队协作场景下，文件共享和权限控制更是让人头疼。
市面上虽然有不少网-盘产品，但要么功能受限，要么成-本高昂，要么无法满足企业私有化部署的需求。对于开发者来说，自研一套完整的文件管理系统又需要投入大量时间和精力。
那有没有一款软件能够处理这种现状呢？
今天给大家介绍一款开源的企业级文件管理网-盘系统 Free FS。这是一款基于 Spring Boot 3.x 构建的现代化文件存储处理方案，专为处理上述痛点而生。
介绍
Free FS 是一个功能完备的企业级文件管理网-盘系统后端，专注于提供高性能、高可靠的文件存储和管理服务。系统采用前后端分离架构，后端基于 Spring Boot 3.5 + MyBatis Flex + MySQL + Redis 技术栈，前端采用 React 19 + TypeScript + Vite 等现代化技术。
这套系统不仅支持常见的文件上传下载功能，更在大文件处理、多云存储、权限管理等方面有着出色的表现，适用于企业网-盘、文件管理、云存储、资源管理等多种场景。
前端
前端部分采用现代化的技术栈构建，主要包括：
-
• React 19.x 作为 UI 框架，提供流畅的用户交互体验 -
• TypeScript 5.x 确保代码的类型安-全和可维护性 -
• Vite 6.x 作为构建工具，带来极速的开发体验 -
• Zustand 5.x 负责状态管理，简洁高-效 -
• Tailwind CSS 3.x 提供灵活的样式支持 -
• shadcn/ui 作为 UI 组件库，界面美观统一
前端项目结构清晰，按照功能模块划分，包括文件管理、登录注册、系统设置、文件分享、存储管理、传输管理等页面模块，便于二次开发和功能扩展。
后端
后端是整个系统的核心，采用 Spring Boot 3.5 构建，技术选型相当考究：
-
• Spring Boot 3.5 提供快速开发能力 -
• MyBatis Flex 作为 ORM 框架，灵活高-效 -
• Undertow 高性能服务器，低内存占用，高并发处理 -
• Sa-Token 成熟的权限认证体系 -
• Redis 缓存支持，提升系统性能
后端采用模块化架构设计，主要包括 Web 管理模块、框架层和业务模块三大块。框架层包含公共核心、通知、ORM、预览、Redis、安-全认证、API 文档、SSE 支持和存储插件框架等子模块。业务模块则涵盖文件管理、存储平台管理、系统管理、日志和计划任务等功能。
特点
这套系统有几个非常突出的特点：
大文件上传能力。支持分片上传、断点续传和秒传功能，轻松应对 GB 甚至 T-B 级别的大文件。基于 MD5 校验机制，相同文件可以实现秒级完成上传，大大提升效率。
实时上传进度。系统支持实时推送上传进度，精-确到分片级别，让用户清楚了解文件传输状态，避免盲目等待。
插件化存储架构。采用 SPI 机制实现热插拔，原生支持本地存储、MinIO、阿-里云 OSS、七牛云 Kodo 以及 S3 体系等多种存储方式。如果需要接入新的存储平台，大约 5 分钟就能完成。
在线预览功能。系统默认支持多种文件类型的在线预览，包括图片、文档、文本代码、音视频、压缩包等，无需下载即可快速查看文件内容。
安-全可靠的权限体系。集成 Sa-Token 认证，提供完善的权限控制机制，确保数据访问安-全。同时支持文件完整性校验，确保数据不被篡改。
技术架构
Free FS 采用清晰的分层架构设计，整体分为表现层、业务层、数据层和存储层。
表现层负责处理 HTTP 请求和响应，提供 RESTful API 接口。业务层包含文件管理、用户管理、权限控制、分享管理等核心业务逻辑。数据层通过 MyBatis Flex 操作 MySQL 数据库，Redis 作为缓存层提升性能。存储层则通过插件化机制支持多种存储后端。
这种架构设计使得系统易于维护和扩展，各个模块职责清晰，耦合度低。特别是在存储层，通过插件化设计实现了存储方式的灵活切换，满足不同场景下的部署需求。
部署方式
前端部署
前端部署相对简单，需要先安装 Node.js 20.0.0 及以上版本和 pnpm 8.0.0 及以上版本。
首先克隆项目代码：
git clone 项目地址cd free-fs-frontend安装依赖：
pnpm install配置环境变量，复制 .env.example 并创建 .env.development 文件，设置 API 基础路径：
VITE_API_BASE_URL=http://localhost:8080启动开发服务器：
pnpm dev构建生产版本：
pnpm buildpnpm preview后端部署
后端部署需要准备 JDK 17 及以上、Maven 3.8 及以上、MySQL 8.0 或 PostgreSQL 14 及以上，以及 Redis 环境。
克隆项目并编译：
git clone 项目地址cd free-fsmvn clean install -DskipTests初始化数据库，以 MySQL 为例：
mysql -u root -p < _sql/mysql/free-fs.sql修改配置文件 fs-admin/src/main/resources/application-dev.yml，配置数据库和 Redis 连接信息。
启动应用：
cd fs-adminmvn spring-boot:run或者直接在 IDE 中运行 FreeFsApplication。
服务启动后，可以通过 localhost:8080 访问系统，API 文档地址为 localhost:8080/swagger-ui.html。默认账号为 admin/admin。
开源协议
Free FS 采用 Apache License 2.0 协议开源。这是一个非常宽松的开源协议，允许用户自由使用、修改和分发代码，包括商业用途。
使用 Apache License 2.0 协议的项目可以用于商业场景，无需支付授权费用。但需要注意的是，在分发修改后的代码时，需要保留原始的版权声明和许可证文件。如果对代码进行了重大修改，建议在 NOTICE 文件中说明。
对于企业用户来说，这个协议非常友好，可以在不违反开源精神的前提下，将系统应用于商业项目中。
即刻体验一波
系统安装完成后，使用默认账号 admin/admin 登录，即可开始体验。
首页展示的是文件管理界面，左侧是文件夹树形结构，中间是文件列表，右侧是文件详情和操作面板。界面简洁直观，操作流畅。
上传文件时，系统会自动判断文件大小。小文件直接上传，大文件则自动启用分片上传机制。上传过程中可以看到实时进度，如果网络中断，下次可以继续从断点处上传，无需重新开始。
文件分享功能也很实用，可以生成分享链接，设置提取码和有效期，方便与他人共享文件。
存储管理页面可以配置多个存储平台，根据需要灵活切换。系统会自动统计各个存储平台的空间使用情况，方便管理员进行资源规划。
业务场景
这套系统适用于多种业务场景：
企业内部文件管理。公司内部的文档、资料、项目文件等可以通过这套系统进行统一管理，设置不同的权限级别，确保信息安-全。
团队协作平台。项目团队可以使用系统共享设计稿、代码、文档等资源，通过文件夹权限控制，确保每个成员只能访问自己需要的内容。
教育资源管理。学校或培训机构可以用它来管理课件、视频、习题等教学资源，学生通过分享链接即可访问学习资料。
个人云存储。对于个人开发者或小团队，可以搭建私有云盘，存储代码备份、项目资料、个人文档等，完全掌控自己的数据。
多云存储统一管理。如果企业已经在使用多个云存储服务，可以通过这套系统进行统一管理，根据成-本和性能需求灵活分配存储资源。
系统的核心功能包括文件上传下载、文件夹管理、文件搜索、文件收藏、回收站、文件分享、存储管理、传输管理等，基本覆盖了文件管理的各个方面。
在文件预览方面，系统支持图片、PDF、Office 文档、文本代码、音视频等多种格式的在线预览，无需下载即可快速查看文件内容，提升工作效率。
对于大文件传输，系统的分片上传和断点续传功能确保了传输的稳定性和可靠性，即使在网络不稳定的情况下也能顺利完成文件上传。
结语
Free FS 作为一款开源的企业级文件管理网-盘系统，在功能完整性、技术先进性和易用性方面都有着不错的表现。特别是其插件化存储架构和大文件处理能力，使其在同类产品中具有一定的竞争优势。
对于需要搭建私有文件管理系统的团队或个人来说，这套系统提供了一个很好的起点。无论是直接使用，还是基于它进行二次开发，都能节省大量的时间和精力。
私回：free-fs
获取源码，开源项目的价值在于共建共享，如果你对这个项目感兴趣，不妨尝试一下，也欢迎为项目贡献代码或提出建议。
往期项目
开源|一个会自我进化的 AI 助手，支持工具调用、MCP 集成、多平台部署
开源|一款基于 AI 大模型驱动的开源智能售后服务产品，提供 AI 客服、AI 洞察、AI 搜索、AI 运营等能力
开源|一款国产无代码工作流引擎，支持AI智能审批和低代码集成
开源|一款企业级扫码点餐系统，支持外卖自取、多门店管理、桌台协同点餐
开源|一款超高速 DOM 捕获引擎，轻松实现 HTML 转 PDF、SVG、PNG 等多种格式导出
开源|一款专为销售团队打造的CRM客户关系管理系统，支持客户跟进、商机管理、合同回款全流程
开源|一款功能齐全的小区物业管理系统，支持收费报表、报修、门禁道闸等核心功能
了解更多
