Z-File 是一个在线文件目录的程序, 支持各种对象存储和本地存储, 使用定位是个人放常用工具下载, 或做公共的文件库. 不会向多账户方向开发.

系统特色
- 内存缓存 (免安装)
- 内存数据库 (免安装)
- 个性化配置
- 自定义目录的 header 说明文件
- 自定义 JS, CSS
- 文件夹密码
- 支持在线浏览文本文件, 视频, 图片, 音乐. (支持 FLV 和 HLS)
- 文件/目录二维码
- 缓存动态开启, 缓存自动刷新
- 全局搜索
- 支持 阿里云 OSS, FTP, 华为云 OBS, 本地存储, MINIO, OneDrive 国际/家庭/个人版, OneDrive 世纪互联版, 七牛云 KODO, 腾讯云 COS, 又拍云 USS
运行环境
- JDK:
1.8
- 缓存:
caffeine
- 数据库:
h2/mysql
快速开始
安装依赖环境:
# CentOS系统
yum install -y java-1.8.0-openjdk unzip
# Debian/Ubuntu系统
apt update
apt install -y openjdk-8-jre-headless unzip
如为更新程序, 则请先执行 rm -rf ~/zfile
清理旧程序. 首次安装请忽略此选项.
下载项目:
wget -P ~ https://c.jun6.net/ZFILE/zfile-release.war
cd ~
mkdir zfile && unzip zfile-release.war -d zfile && rm -rf zfile-release.war
chmod +x ~/zfile/bin/*.sh
程序的目录结构为:
├── zfile
├── META-INF
├── WEB-INF
└── bin
├── start.sh # 启动脚本
└── stop.sh # 停止脚本
├── restart.sh # 重启脚本
启动项目:
~/zfile/bin/start.sh
停止项目:
~/zfile/bin/stop.sh
重启项目:
~/zfile/bin/restart.sh
修改配置文件:
vim ~/zfile/WEB-INF/classes/application.yml
默认启动端口为 8080, 如需请配置文件请编辑上述文件, 修改后重启程序生效.
开放端口 (重点)
如部署后无法访问, 请检查防火墙是否开启此端口:
宝塔用户
宝塔用户可以去后台开放端口:

CentOS 7.x
firewall-cmd --zone=public --add-port=8080/tcp --permanent # 开放 8080 端口
firewall-cmd --reload # 重启firewall
Ubuntu 16.x / Debian 9.x
iptables -I INPUT -p tcp --dport 8080 -j ACCEPT
iptables-save
sudo apt-get install iptables-persistent
sudo netfilter-persistent save
sudo netfilter-persistent reload
域名访问
域名访问可直接将域名 A
记录解析到服务器 IP, 即可通过 域名:端口
访问.
如需直接使用域名, 不带端口, 可将程序设置为 80 端口, 或者使用 nginx
或 caddy
等工具进行反向代理.
这里只简单介绍下宝塔如何进行反向代理:
首先点击 网站
-> 新增站点
:

点击反向代理:

设置反向代理:

然后就可以使用域名访问了.
访问地址
用户前台: http://IP:8080/#/main
初始安装: http://IP:8080/#/install
管理后台: http://IP:8080/#/admin
OneDrive 使用教程
访问地址进行授权, 获取 accessToken 和 refreshToken:
国际/家庭/个人/教育版: 传送门
世纪互联版: 传送门

常见问题
数据库
缓存默认支持 h2
和 mysql
, 前者为嵌入式数据库, 无需安装, 但后者相对性能更好.
默认路径
默认 H2 数据库文件地址: ~/.zfile/db/
, ~
表示用户目录, windows 为 C:/Users/用户名/
, linux 为 /home/用户名/
, root 用户为 /root/
文档文件和加密文件
- 目录文档显示文件名为
readme.md
- 目录需要密码访问, 添加文件
password.txt
(无法拦截此文件被下载, 但可以改名文件)
该项目的开发计划
- ✓ API 支持
- ✓ 更方便的部署方式
- ✓ 布局优化 - 自定义操作按钮 (现为右键实现)
- ✓ 后台优化 - 设置按照其功能进行分离
- ✓ 体验优化 - 支持前后端分离部署
- 新功能 - 后台支持上传、编辑、删除等操作
- 新功能 - WebDav 支持
- 新功能 - Docker 支持
- 新功能 - 离线下载 (aria2)
- 体验优化 - 文本预览更换 vscode 同款编辑器 monaco editor
- 体验优化 - 忽略文件列表 (正则表达式)
- 体验优化 - 自定义支持预览的文件后缀 (正则表达式)
- 架构调整 - 支持多存储策略
- 体验优化 - 一键安装脚本