代码改变世界
[登录 · 注册]
  • 和付费网盘说再见,自己搭建个人网盘(Java 开源项目)
  • 本文适合有 Java 基础知识的人群,跟着本文可学习和运行 Java 网盘项目。

    本文作者:HelloGitHub-秦人

    HelloGitHub 推出的《讲解开源项目》系列。

    今天给大家带来一款开源 Java 版网盘项目—— kiftd-source,本文将用 3 分钟带大家搭建一个个人网盘,技术便利生活,你值得拥有~

    项目地址:https://github.com/KOHGYLW/kiftd-source

    一、项目介绍

    kiftd 是一款开源、使用简单、功能完整的 Java 网盘/云盘系统。支持在线视频播放、文档在线预览、音乐播放、图片查看等功能的文件云存储平台。

    技术栈

    • JDK 版本:1.8.0_131
    • 项目管理框架:Maven(m2e 1.8.0 for Eclipse)
    • Archetype:mavem-archetype-quickstart 1.1
    • Spring Boot:SpringBoot 基于 Spring 开发,旨在提高微服务的开发效率。
    • MyBatis:一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。
    • H2 DB:一款开源的嵌入式数据库引擎,采用 Java 语言编写,不受平台的限制。

    二、网盘搭建

    2.1 Windows 环境运行

    2.1.1 下载安装包

    直接从官网下载最新的安装包,安装地址:https://kohgylw.gitee.io/

    项目比较温馨,支持三种下载方式:Github、阿里云、Gitee 下载。如下图:

    2.1.2 检查配置

    这里主要检查一下本地 JDK 是否已安装,在命令行窗口执行 java -version 查看 Java 版本。如下所示表示已安装,就可以进行下一步操作。

    java version "1.8.0_181"
    Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
    Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)
    

    2.1.3 运行 jar

    双击 kiftd-1.0.29-RELEASE.jar,或者在命令行执行 java -jar kiftd-1.0.29-RELEASE.jar 命令都运行可以jar 文件,会弹出安装的界面,如下图:

    这个界面的这几个按钮说明一下:

    • 开启(Start):运行网盘服务,初次启动的端口默认是 8080
    • 文件(Files):这个按钮菜单中主要有网盘文件导入,导出,删除,刷新功能。
    • 设置(Setting):设置功能主要可以设置网盘的服务端口,网盘的物理存储路径等信息。
    • 退出(Exit):关闭网盘系统。

    点击 开启(Start) 按钮即可运行网盘,这里我设置的端口是 8090,在浏览器访问: localhost:8090,运行效果如下图:

    项目是运行了,发现一个问题无法上传文件?因为我们忘了登录这个操作。点击系统 登录按钮,填入账号和密码即可登录。那么登录密码在哪里呢?这里我直接告诉大家,用户信息在 conf/account.properties,文件内容如下:

    #<This is the default kiftd account setting file. >
    #Sun May 10 21:56:28 CST 2020
    admin.pwd=000000  #用户名.密码=000000
    authOverall=l
    admin.auth=cudrm
    
    • 用户名:admin
    • 密码:000000

    这样登录之后就可以使用网盘的所有功能了。

    2.2 Linux 环境运行

    2.2.1 安装 Screen 工具

    Screen 工具能够虚拟出一个终端并执行相应的操作。因为本篇所讲的网盘需要一个终端。执行如下命令安装 Screen

    yum install screen
    

    2.2.2 Screen 常用命令

    screen -S myScreen #创建虚拟终端
    java -jar kiftd-1.0.29-RELEASE.jar -console #在虚拟终端中以命令模式启动 kiftd
    screen -r myScreen #返回之前的虚拟终端并继续操作 kiftd。
    

    2.2.3 命令行操作

    Linux 环境上使用 console 模式启动的效果是这样的:

    命令行输入 -start 即可运行项目。例如输入 -files 控制台显示是这样的:

    其实和 Windows 上一样,包括文件导入,导出,删除功能,多了几个命令是查看文件,切换目录等功能。

    三、开发环境运行

    3.1 下载项目

    两种方式下载项目,使用 GitBash 下载项目:

    git clone https://github.com/KOHGYLW/kiftd-source.git
    

    另外一种方式直接下载 zip 压缩包,如下图:

    3.2 运行

    打开 kohgylw.kiftd.mc.MC 类,进行测试运行。注意:本文使用 Eclipse 工具打开。

    3.3 阅读代码

    3.3.1 前台请求

    就以创建目录这个功能为例。我们先看前端功能。点击“操作”->“新建文件夹”,填写文件夹名称,点击保存如下图:

    我们知道前台 新建文件夹 功能调用的后台接口是 newFolder.ajax

    3.3.2 后端接口
    通过前台请求可知调用的后台接口为 homeController/newFolder.ajax。打开代码实现,我们会看到下面这个方法。

    public String newFolder(final HttpServletRequest request) {
    		
            ...
            //参数校验的部分代码已省略
    		Folder f = new Folder();
    		f.setFolderId(UUID.randomUUID().toString());
    		f.setFolderName(folderName);
    		f.setFolderCreationDate(ServerTimeUtil.accurateToDay());
    		if (account != null) {
    			f.setFolderCreator(account);
    		} else {
    			f.setFolderCreator("匿名用户");
    		}
    		f.setFolderParent(parentId);
    		int i = 0;
    		while (true) {
    			try {
                    // 数据库插入新建文件夹的数据
    				final int r = this.fm.insertNewFolder(f);
    				if (r > 0) {
    					if (fu.isValidFolder(f)) {
    						this.lu.writeCreateFolderEvent(request, f);
    						return "createFolderSuccess";
    					} else {
    						return "cannotCreateFolder";
    					}
    				}
    				break;
    			} catch (Exception e) {
    				f.setFolderId(UUID.randomUUID().toString());
    				i++;
    			}
    			if (i >= 10) {
    				break;
    			}
    		}
    		return "cannotCreateFolder";
    	}
    

    四、功能说明

    4.1 上传

    1. 点击 操作,可以上传文件和上传文件夹,如下图:

    2. 将本地需要上传的文件,拖拽网盘页面也可以上传此文件。

    4.2 视频/音频播放

    1. 上传视频到网盘,网盘也支持在线视频播放,效果如下图:

    2. 上传音频,例如我最喜欢 周杰伦 的歌曲,可以在线播放了。

    4.3 快捷键使用

    网盘还对一些常用功能添加了快捷键。功能和快捷键参照如下:

    功能快捷键
    上传文件夹 Shift +U
    上传文件 Shift +F
    新建文件 Shift +N
    复制 Shift +C
    剪切 Shift +X
    删除 Shift +D

    4.4 配置文件修改

    配置文件在项目 conf 目录,包括两个配置文件:

    • account.properties:配置账号信息,权限信息
    • server.properties:服务器的配置文件,可配置服务器端口,缓冲文件大小等

    4.5 在线预览

    网盘支持文档 txtpdfdocxppt 在线预览功能,支持图片的在线预览。图片预览效果如下:

    pdf 文件预览效果如下:

    4.6 分享下载链接

    网盘也考虑文件的分享,它可以生成下载链接,浏览器访问下载链接就可以直接下载文件。选择需要下载的文件,点击 下载 按钮,选择 下载链接+,既可以生成文件下载链接。如下图:

    五、最后

    教程至此已经结束,你自己的网盘跑起来了吗?网盘是不是还不错?而且搭建也特别简单。一些重要的东西就可以存放到自己的网盘啦!说到底,编程语言只是工具,我们只要很好的使用工具,再加上自己天马行空的思想,我想会创造出更多不可思议的项目。

    Java 语言为什么经久不衰,因为它能做的事情太多了,而且生态也特别丰富。如果你也有兴趣那就加入 Javaer 开发者的大家庭吧!开源分享让我们彼此认识,有了开源项目让我们看到编程语言的绚丽多彩。

    教程至此,你应该也能快速运行个人网盘了。编程是不是也特别有意思呢?先下载安装包给自己部署一套网盘系统吧。对源码感兴趣的朋友可以开始学习项目源码了~ 

    出处:https://www.cnblogs.com/xueweihan/p/13033501.html

  • 【推广】 阿里云小站-上云优惠聚集地(新老客户同享)更有每天限时秒杀!
    【推广】 云服务器低至0.95折 1核2G ECS云服务器8.1元/月
    【推广】 阿里云老用户升级四重礼遇享6.5折限时折扣!
  • 原文:https://www.cnblogs.com/mq0036/p/13037385.html
走看看 - 开发者的网上家园