From fcc3bdc70d818c60942a5988772c087b6dcda02c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=9D=92=E9=98=B3=E9=BE=99=E9=87=8E?= 本应用是一款快捷的网络文件分享工具——您可以把它看成是一款简化的“网盘”,它可以运行在普通的家用PC上,而且即使是没有什么经验的用户也能成功安装并使用它。它具备很多高级功能,例如视频的在线播放,而且还在不断地添加新功能。 本应用的作者相信,不仅仅是他本人,还有很多人需要在局域网内搭建起一个简便的网盘系统以便让所有在同一局域网内的同事或同学都能够使用随处可见的浏览器去访问、上传或下载若干文件——无论是不足1MB的文本,还是超过4GB的1080p视频,而且它最好安装简单,界面便捷,还要有必备的管理功能。实际上,kiftd的设计初衷正是为了满足这一需求。作者最初编写它的目的是能够在办公室和教室内将自己的资料快速分发给学生或其他老师,在作者成功弄丢了几次U盘之后,便萌生了设计这样一款应用的想法。 本应用使用java开发,因此可以部署在windows/Linux/Unix(包括Mac os X)之中的任意系统上,只要安装java 8及以上环境。 如果您无法访问互联网,也可以阅读下面的现在开始使用!一章。
- 如果需要查看各项设置的设置方式,请参阅基本设置一章。
- 如果您使用本应用,即视为同意下列条款:
- KIFT——快捷、强大、小巧的开源网盘系统
-
-【青阳网络文件系统自述文档】
-
-
-
-简介
-kift有哪些亮点?
-
-
-
-资源导航
-立即搭建一个网盘:您可以阅读github上的快速开始:https://github.com/KOHGYLW/kiftd/wiki。
-
-
-现在开始使用!
-
-
-
第一步:首先,您需要在您的计算机上安装java 8或以上版本的java环境,这是本应用运行的先决条件。java的安装并不麻烦,您可以很快完成它。
- -第二步:按照下列操作启动您的服务器: -
$ sudo ./startup.sh
(适用于Linux、Unix、Mac OS X用户)。这一步会启动服务器。如果您访问成功,会看到如下效果:
-现在,您已经可以让他人访问您的网盘了。就是这么简单。
-*如何让他人访问:如果您需要他人访问您的网盘,请在局域网内其他主机上,使用浏览器访问您本机IP地址,即可进入本系统。 例如 http://192.168.1.2/ 其中IP地址部分需根据您的计算机IP地址进行替换。
-*如何使用上传、修改等功能:您可以先使用内置用户(admin,000000)进行登录并进行全部权限的操作。至于如何修改用户密码或添加更多的用户,请阅读后面的 - 《用户授权》部分。
-如果您需要关闭本应用,请bin目录,运行shutdown.bat文件(适用于windows用户)/在终端执行命令:$ ./shutdown.sh
(适用于Linux、Unix、Mac OS X用户)。这一步会关闭服务器。
本应用记录的日志文件存放在“~/文档/KohgylwIFT/log”路径下。日志文件的标题为日志产生的日期,以“klog”作为后缀。日志文件的内容以纯文本格式进行记录,您可以使用文本编辑器(例如“记事本”)打开它们并查看其内容。
-这些都是一个网盘最基本的功能, 本系统尽可能的将它们做的简单易用,让您在使用部署时几乎没有学习成本。 界面简单高效也是本系统的特色之一:本人相信对于大多数喜欢体验开源技术的用户而言,一个高速、流畅、干净又足够硬派的系统远比一个界面华丽却相应缓慢的系统更具有吸引力。如下图,这是文件列表的基本效果,其中可以点击的是文件夹,不可点击的为文件。 -
-上传至本系统的全部mp4资源和webm资源均可使用在线播放功能(用户需具备[下载]权限才可播放视频),不限大小和长度。操作方式为:点击文件后方操作栏中的“播放”按钮,会自动打开播放页面并在线播放。点击页面右上方“关闭”按钮停止播放并关闭播放页面。效果如下:
-您可以直接查看PDF文档的内容而无需下载它。在线查看提供了页数跳转、旋转、搜索等功能。这个功能是为了方便办公环境下更好的区分不同版本的PDF文档,有些文档可能看上去很像但是内容有细微差别,例如不同日期的工作报表。这种情况下,使用在线预览功能会方便许多。效果如下:
-本应用也支持bmp、jpg、jpeg、png、gif五种常见图片格式的在线查看。您可以通过它快速查找全部文件列表中您所中意的那张图片。效果如下:
-为了方便个人操作,本应用的全部设置都基于文件配置。您可能对这种配置方式不太熟悉甚至觉得它很高深,不过不用担心,请跟着下面的说明大胆尝试一下,之后,您可能会喜欢上这种配置方式并体会到它的优点。
-- ... - #[Set the account(who can login) list] - #Example: - #account.list = user1,user2,user3... - accounts.list = admin - ... --
- ... - accounts.list = admin,test - ... -- 注意:分割两个用户名的逗号必须是英文逗号 -
至此,一个名为test的用户已经创建完毕。
-- ... - #[Set the password for every account] - #Example: - #pwd.user1 = 123456 - #pwd.user2 = abcdef - #... - pwd.admin = 000000 - ... --
- ... - pwd.test = 123456 - ... --
现在,用户test可以使用密码123456进行登陆了。
-- #[Set the permission for accounts] - #c = Create the new folder - #u = Upload files - #d = Delete files or folders - #r = Rename files or folders - #l = downLoad files - #Defult setting:l - #Example: - #auth.admin = cudr - #auth.user1 = u - #... - auth.admin = cudr - #overall -- this value set the permission for all user (include visitor who not login) - #Example: - #authOverall = none - authOverall = l --
- ... - auth.admin = cudr - auth.test = u (增加这一行) - ... --
最终,我们新创建的用户test就可以在登陆后进行上传操作了(authOverall一项设置的是匿名用户和全部用户共有的基本权限,例如默认设置为l的意思是所有用户和匿名用户均可执行下载操作)。
-注:各个字母代表的权限如下:
-所谓下载缓冲区:它的设置决定了服务器为每位执行下载的用户开辟多大的内存作为其下载数据的缓冲区。默认情况下您无需修改这个值,除非您的内存过小或者您需要同时服务规模庞大的用户。
-- ... - #[Set the size of the buffer memory for file download by byte] - #This value depending on your network speed and your memory size - #Example: - #buff.size=1048576 - #Default value:1048576 - #Bigger buffer size will use bigger memory and provide users faster download speed(No faster than network speed) - buff.size=1048576 - ... --
- ... - buff.size = 524288 - ... --
该值越大,对内存的需求量就越高,同时硬盘的读取次数就越低,您应该根据您的硬盘性能、内存大小和网络速度三者进行综合考虑,并设置该值。如果您对此不了解,请勿修改默认值。
-本日志分为两种类型,分别为“异常”和“事件”。其中,“异常”记录的是服务器运行中产生的意外错误,“事件”记录的是用户的操作历史。
-- ... - #[Set the logging level] - #This setting determines what info need to log. - #R = Runtime exception only. - #E = important Events include runtime exception,operation of delete download rename and upload(create). - #N = No activity will be logged. - #default setting(if program not found this setting):R. - #Example: - #log=E - log=E - ... --
- ... - log=N - ... --
我们推荐使用默认的日志记录方式,它会记录所有异常信息和用户的操作过程,您可以通过这些记录更好地进行管理。
-