项目源码|ZFile 在线网盘系统|Spring Boot 3 + Vue 3 · 多存储源 · 在线预览 · SQLite 零依赖

项目源码|ZFile 在线网盘系统|Spring Boot 3 + Vue 3 · 多存储源 · 在线预览 · SQLite 零依赖-远影归灯
ZFile 源码包
此内容为付费资源,请付费后查看
80积分
付费资源

想给自己或小团队搭一个网盘,把本机目录统一管起来,还能在线看图、播视频、开 PDF?ZFile 是一套在线网盘程序。本篇用 4.5 开源源码版,在本机从源码构建,单端口跑起来,主线全部实测。默认用 SQLite,不装 MySQL 和 Redis 也能跑。本帖 80 积分,下载区是前后端源码、构建好的前端和中文部署说明。

后端是 MIT 协议,前端在 package.json 里同样声明 MIT。请保留包里的 LICENSE 和许可说明。可以学习和二次开发。

4 步上手

  1. 准备环境:JDK 21 和 Maven。必须是 21,17 编译不过。不需要数据库服务。
  2. 构建后端:在 zfile 目录执行 mvn clean package -Dmaven.test.skip=true,得到 target/zfile-4.5.0.jar。
  3. 放前端并启动:把包里 prebuilt-static/ 的内容拷到「jar 所在目录/static/」,再 java -jar zfile-4.5.0.jar。浏览器打开 http://127.0.0.1:8080/install。
  4. 挂一个目录:设好管理员后进 /admin,添加「本地存储」,填一个测试目录的绝对路径。回到前台就能浏览了。

能做什么

  • 统一挂载:把一个本机目录挂成网盘。本篇只测了本地存储。
  • 浏览和传输:列表视图、画廊视图、上传、下载。都已实测。
  • 在线预览:视频、音频、PDF、代码高亮。都已实测。
  • 直链和短链:短链可以设有效期。没登录的环境也能直接下载。已实测。
  • 多用户:给普通用户只分配某个子目录和几项权限。已实测。
  • Office 预览、3D 预览、OneDrive/S3/FTP 等云存储、单点登录、分享链接:支持但本篇未实测。限速下载和限制文件类型是捐赠版功能,不在这份开源源码里。

存储源:就是「文件真正放在哪」。可以是本机目录,也可以是云存储。ZFile 把它们统一显示成网盘里的一个盘。

直链 / 短链:直链是带完整路径的下载地址;短链是一串短码,点开后跳到同一个文件,还能设过期时间。

技术栈(压缩)

  • 后端:Spring Boot 3.3、Java 21、MyBatis-Plus、SQLite(可切 MySQL)
  • 前端:Vue 3、Vite、TypeScript、Element Plus、Tailwind
  • 部署:单个 jar,前端放在运行目录的 static/,一个端口搞定

本机部署(已跑通)

详细命令见包里的 DEPLOY.txt。下面按使用顺序看截图。截图里的密码和二维码已打码。

安装和挂载

ZFile 系统初始化页面
看这里:第一次打开 /install 是初始化页。只填三项:站点名称、管理员账号、管理员密码。密码框已打码。点「系统初始化」后跳到登录页。
添加本地存储表单
看这里:后台「存储源设置」点加号,存储策略选「本地存储」。别名填 local,前台地址就是 /local。文件路径必须是绝对路径,这里挂的是本机测试目录。
后台存储源列表
看这里:保存后存储源列表多了一张卡片「远影测试盘」,类型是本地存储,状态是启用。

前台浏览、上传和下载

前台列表视图
看这里:前台默认是列表视图。顶部是面包屑和右侧的存储源下拉框。列出文件名、修改时间、大小。测试图片是自己画的渐变图。
画廊视图
看这里:点顶栏的画廊按钮,同一个目录变成大图瀑布流。适合放照片或设计稿的目录。也可以在存储源里设成默认打开画廊。
上传文件弹窗
看这里:顶栏上传按钮里有新建文件夹、上传文件、上传文件夹。拖文件进框就开始传,进度条走满显示「上传成功」。本机核对过,上传后的文件和原文件逐字节一致。下载同样实测过,下载走的是带签名的临时地址。

在线预览

视频在线播放
看这里:视频是用 ffmpeg 生成的 8 秒彩条测试片。右键「预览」弹出播放器,直接在网页里播放。播放器下方原本还有一排「用外部播放器打开」的按钮,截图里已隐去。
音频播放条
看这里:音频不弹窗,在左下角出现一个迷你播放条。图里已经播到 00:05 / 00:10。
PDF 在线预览
看这里:PDF 在弹窗里逐页显示。顶栏有页码和缩放比例。这份 3 页 PDF 是自己生成的。
代码高亮预览
看这里:打开 .java 文件是代码高亮视图,带行号。顶部能切语言、编码和主题。

直链和短链

生成短链选择有效期
看这里:右键文件选「同时获取」,先弹出短链有效期。这里选 1 天,过期后短链失效。
直链和短链结果
看这里:结果框里最后两行就是直链和短链。上面的二维码区域已隐藏。两条链接都用不带登录信息的 curl 测过,下载回来的视频和原文件一致。
直链短链设置
看这里:后台「直/短链设置」里能开下载日志、Referer 防盗链和单 IP 下载频率限制。这些开关能看到,本篇没有逐项测试。

多用户和目录权限

新建普通用户并分配目录
看这里:用户管理点加号新建 student01。存储源授权里打开「允许使用」,授予根目录填 /共享区,权限列表只勾了预览和下载,所以显示「2 个」。密码框已打码。
用户列表
看这里:列表里多了普通用户 student01。template 是新用户模板,guest 是匿名用户,存储源都是 0 个。所以没登录的访客默认看不到任何文件,本机实测会提示未授权。
普通用户只能看到授权目录
看这里:用 student01 登录后,网盘的根就是「共享区」,只看到课程资料。顶栏没有上传按钮,右键只剩预览、下载、刷新。手动请求上一级目录会被后端拒绝,提示路径存在安全隐患。

显示设置和手机端

显示设置
看这里:显示设置管页面布局、单击还是双击打开、默认排序、下载前要不要确认。后面几个标签是 OnlyOffice、kkFileView 预览配置和公告,本篇没配。
手机宽度下的文件列表
看这里:手机宽度下自动收成一列,只留文件名和大小,右上角汉堡菜单收起了工具按钮。

本机踩坑(压缩)

  • JDK 必须 21。
  • 前端 zfile.config.json 的 baseUrl 默认写死 127.0.0.1:8080。单端口部署改成空字符串最省事;换 IP 或域名时一定要改,否则会跨域。包里的 prebuilt-static/ 已经改好。
  • 后端只认运行目录下的 static/。在别的目录执行 java -jar,前台会打不开。
  • 前端用 pnpm 9 构建,换 npm 或 yarn 可能和锁文件对不上。
  • 官方 Docker 镜像和这份源码不是同一个东西。想学代码,就按本篇从源码构建。

上线前务必处理

  • 管理员用强密码,最好再开两步验证。
  • 本地存储只挂专门的数据目录,不要挂系统目录或家目录。
  • 走反向代理时把真实 IP 头传给后端,否则频率限制看到的都是 127.0.0.1。
  • 对外访问请上 HTTPS。

包里是 4.5 开源源码版的后端和前端源码、构建好的前端静态文件、中文 DEPLOY.txt 和许可说明。原 README 里的官方截图、赞助二维码和仓库统计图已去掉,不作为本包内容。

© 版权声明
THE END
喜欢就支持一下吧
点赞9 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容