共计 2071 个字符，预计需要花费 6 分钟才能阅读完成。
提醒：本文最后更新于 2022-04-13 20:56，文中所关联的信息可能已发生改变，请知悉！
前言
此项目是一个在线文件目录的程序, 支持各种对象存储和本地存储, 使用定位是个人放常用工具下载, 或做公共的文件库. 不会向多账户方向开发。
前端基于 h5ai 的原有功能使用 Vue 重新开发了一遍。
后端采用 SpringBoot, 数据库采用内嵌数据库。
预览地址: https://zfile.jun6.net
项目地址: https://github.com/zhaojun1998/zfile
系统特色
- 内存缓存 (免安装)
- 内存数据库 (免安装)
- 个性化配置
- 自定义目录的 header 说明文件
- 自定义 JS, CSS
- 文件夹密码
- 支持在线浏览文本文件, 视频, 图片, 音乐. (支持 FLV 和 HLS)
- 文件 / 目录二维码
- 缓存动态开启, 缓存自动刷新
- 全局搜索
- 支持 阿里云 OSS, FTP, 华为云 OBS, 本地存储, MINIO, OneDrive 国际 / 家庭 / 个人版, OneDrive 世纪互联版, 七牛云 KODO, 腾讯云 COS, 又拍云 USS.
快速开始
安装依赖环境:
# CentOS 系统
yum install -y java-1.8.0-openjdk unzip
# Debian/Ubuntu 系统
apt update
apt install -y openjdk-8-jre-headless unzip如为更新程序, 则请先执行 ~/zfile/bin/stop.sh && rm -rf ~/zfile 清理旧程序. 首次安装请忽略此选项.
下载项目:
export ZFILE_INSTALL_PATH=~/zfile
mkdir -p $ZFILE_INSTALL_PATH && cd $ZFILE_INSTALL_PATH
wget https://c.jun6.net/ZFILE/zfile-release.war
unzip zfile-release.war && rm -rf zfile-release.war
chmod +x $ZFILE_INSTALL_PATH/bin/*.sh程序的目录结构为:
├── zfile
├── META-INF
├── WEB-INF
└── bin
├── start.sh # 启动脚本
└── stop.sh # 停止脚本
├── restart.sh # 重启脚本
启动项目:
~/zfile/bin/start.sh常用命令
~/zfile/bin/start.sh # 启动项目
~/zfile/bin/stop.sh # 停止项目
~/zfile/bin/restart.sh # 重启项目 访问地址:
用户前台: http://127.0.0.1:8080/#/main
初始安装: http://127.0.0.1:8080/#/install
管理后台: http://127.0.0.1:8080/#/admin
OneDrive 使用教程.
访问地址进行授权, 获取 accessToken 和 refreshToken:
国际 / 家庭 / 个人版:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=09939809-c617-43c8-a220-a93c1513c5d4&response_type=code&redirect_uri=https://zfile.jun6.net/onedirve/callback&scope=offline_access%20User.Read%20Files.ReadWrite.All
世纪互联版:
https://login.chinacloudapi.cn/common/oauth2/v2.0/authorize?client_id=4a72d927-1907-488d-9eb2-1b465c53c1c5&response_type=code&redirect_uri=https://zfile.jun6.net/onedirve/china-callback&scope=offline_access%20User.Read%20Files.ReadWrite.All
然后分别填写至访问令牌和刷新令牌即可:
运行环境
- JDK: 1.8
- 缓存: caffeine
- 数据库: h2/mysql
预览
常见问题
数据库
缓存默认支持 h2 和 mysql, 前者为嵌入式数据库, 无需安装, 但后者相对性能更好.
默认路径
默认 H2 数据库文件地址: ~/.zfile/db/, ~ 表示用户目录, windows 为 C:/Users/ 用户名 /, linux 为 /home/ 用户名 /, root 用户为 /root/
头尾文件和加密文件
- 目录头部显示文件名为
header.md - 目录需要密码访问, 添加文件
password.txt(无法拦截此文件被下载, 但可以改名文件)
TODO
- API 支持 点击查看文档
- 更方便的部署方式
- 文本预览更换更好用的编辑器
- 后台支持上传、编辑、删除等操作
- WebDav 支持
- Docker 支持
转载至：http://www.zhaojun.im/zfile-readme/
