ZFile 更新日志
提示
ZFile 统一发布一个版本:未填写授权码时使用免费功能,填写有效授权码后启用捐赠版功能。仅授权后可用的更新条目会标记为 (捐赠版)。
5.1.1(2026-11-12)
新功能
- ⭐ (捐赠版) 新增缩略图功能,支持常见图片,视频与 PDF 缩略图
- ⭐ (捐赠版) 访问规则支持设置生效时间,预览时可模拟指定时间点的规则效果
- 分享支持设置访问权限(预览、下载、批量下载、打包下载),默认沿用创建者的权限,管理员可在后台分享管理中单个或批量修改
- 后台可关闭分享匿名访问,未登录访客需先登录,登录后自动回到原分享页
- FTP 存储源支持显式和隐式 FTPS
- 支持 SMB 存储源
- S3 存储源的地域改为选填,留空时自动推导
优化
- 本地存储下载速度提升,大量下载同时进行时页面不再卡顿;多人同时上传、下载时页面响应更及时
- 优化文件过滤、密码文件夹、目录文档配置页面,支持先预览效果
- 优化前台后台各个页面设计,统一风格和视觉交互逻辑
- OneDrive、SharePoint、Google Drive、百度网盘等存储源授权改为分步引导,回调页面无法访问时可复制回调地址粘贴回 ZFile 完成授权,也可直接填写已有令牌
- 只分享一个文件夹时,分享直接以该文件夹为根目录打开
- 分享页支持列表、网格和画廊视图,并显示文件数量
- 画廊与图片预览按可视区域加载图片,新增「同时加载数量」设置
- 站点公告改为信息条,关闭后可在顶栏再次打开,内容更新后重新显示;较长的顶部目录文档默认折叠
- PDF 预览支持「连续 / 单页」切换,单页模式两侧提供翻页按钮,快捷键改为速查浮层
- 主题、文件分组、二维码样式等更多个人偏好随账号同步,偏好设置改为标签页布局
- Markdown 预览所需的代码高亮、公式、流程图等组件改为本地加载,内网环境也能正常显示;页面资源按需加载,打开更快
- Docker 部署时,本地存储源路径下方显示对应的宿主机目录;仪表盘容器信息按不可用原因给出对应提示
- 仪表盘实时监控改为服务器推送,连接失败时自动改为定时刷新
- 上传设置页显示上传缓存目录是否可用,系统诊断新增上传缓存目录检查
- OnlyOffice 连接测试失败时给出对应的修复建议
- SQLite 数据库的 WAL 日志文件在写入高峰后自动收缩,不再长期占用磁盘空间
安全加固
- 用户密码改用 PBKDF2 加盐哈希存储,已有账号在下次登录(包括 WebDAV 登录)后自动升级
- 新安装的站点默认只信任本机与内网代理转发的客户端 IP;客户端 IP 识别设置提供推荐配置与 Cloudflare 回源网段预设,信任所有来源时提示 IP 可能被伪造
- 文件过滤中设为「禁止访问」的文件,同时禁止通过下载链接和直链下载
- 密码文件夹与文件过滤规则在保存时校验表达式,规则匹配出错时不再放行访问
- 加强系统安全性,修复多项潜在安全漏洞
BUG 修复
- 修复文件或文件夹名包含 #、?、%、+ 等特殊字符时,目录跳转、路径直链、下载或 WebDAV 访问异常的问题
- 修复网络中断后续传或取消上传时上传被锁定的问题;大文件上传完成后写入存储源时,不再因反向代理超时而失败
- 修复以其他系统账户运行(如 Windows 服务)时,上传因缓存目录无权限而失败的问题
- 修复由服务器中转的文件点击下载时在新标签页打开、没有直接保存的问题
- 修复 SQLite 数据库在下载记录、搜索索引等频繁写入时,保存设置偶尔提示「数据库繁忙」的问题
- 修复程序刚启动时并发访问存储源偶尔报错的问题
- 修复启用 Redis 时,修改后的数据可能仍读取到旧缓存的问题
- 修复 Google Drive 上传失败、移动时未同时重命名、共享云端硬盘无法写入以及列表不完整的问题
- 修复 OneDrive / SharePoint 列表翻页异常, 以及 SharePoint 存储源未使用所选文档库的问题
- 修复 115 网盘重命名后操作异常、目录列表漏项,以及服务端读取文件失败的问题
- 修复阿里云 OSS、腾讯云 COS 等存储上传或新建文件夹时提示不支持 aws-chunked 编码的问题,S3 类存储源新增分块编码开关
- 修复又拍云直链签名有效期按分钟计算,导致链接有效期远超设置值的问题
- 修复 SFTP 获取文件夹信息不正确的问题
- 修复 OnlyOffice 文档保存期间再次打开,或只读用户打开同一文件后,编辑内容保存失败的问题
- 修复实时日志持续读取时丢失日志行的问题
- 修复系统监控组件不可用时程序无法启动,以及 Docker 无响应时仪表盘加载卡住的问题
- 修复注册验证码时长超出范围时注册设置页无法打开的问题
- 修复开启双因素认证后,未填写验证码登录时提示系统错误的问题
- 修复移动端侧滑返回可能导致页面刷新或退出站点、多级菜单无法逐级返回,以及文件操作条重复显示入口的问题
- 修复视频网页全屏时透出页面背景的问题
不兼容升级
- 已有分享会按升级时创建者在该存储源的预览、下载权限设置分享权限;创建者已删除或没有对应权限的分享,升级后将无法预览或下载,如有需要请在后台分享管理中调整
- 如果自定义的
application.properties(包括 NAS 套件的配置文件)中有server.tomcat.threads.max=10,请删除这一行,否则多人同时上传、下载时页面可能卡顿 - 升级后登录过的账号会改用新的密码存储格式,如需回退到旧版本,这些账号需要重新设置密码
5.1.0(2026-10-12)
新功能
- 前台页头支持「双层导航」与「单行导航」,管理员可按站点需要切换布局,
- kkFileView 支持包含站点名、用户名和预览时间的动态水印、手动刷新预览缓存及实例访问密钥
- kkFileView 可配置预览弹窗中的新标签页入口是否显示
- 访问规则支持仅排除指定用户
优化
- 音频播放器重新设计,优化 UI 效果
- 画廊模式风格优化,优化 UI 效果,支持更多设置
- 优化页头操作栏、右键菜单与批量操作栏的自定义设置,支持拖拽排序、分区管理和实时预览,改善小屏下的菜单展开与操作收起
- 优化文件列表布局、视图切换与文件类型图标,已选统计分别显示文件和文件夹数量,快捷键说明按使用场景分类
- 优化图片预览工具条与缩略图操作,支持双击切换缩放,改善手机端显示与键盘操作
- 重新设计收藏页,按存储源展示收藏数量,优化来源筛选、失效收藏提示与手机端布局
- kkFileView 如未配置地址,前台右键菜单、悬浮菜单不显示入口。
安全加固
- 加强系统安全性,修复多项潜在安全漏洞
BUG 修复
- 修复切换存储源或目录时,上一个目录的 README 弹窗短暂闪现的问题
- ⭐ (捐赠版) 修复上传访问规则的通配匹配范围不正确,以及文件或目录名含花括号时匹配异常的问题
5.0.9(2026-10-02)
新功能
- ⭐ (捐赠版) 访问规则功能完全重新设计,支持在线预览规则。
- 新用户目录模板支持用户及日期变量,创建用户时生成并固定实际目录
优化
- 优化路径选择器、输入弹窗,操作提示等 UI 设计
- 更新 ZFile Logo 字标与站点图标,统一各页面品牌展示
- 新用户目录变量通过 模板配置弹窗统一设置,支持用户 ID、用户名和年月日变量;创建用户时生成实际目录并保存固定路径
- HTML 和 Markdown 预览记忆用户的预览偏好
- 弹窗、抽屉统一 ESC 与手机返回交互,编辑草稿关闭时提示未保存的更改
- 文件选择操作条适配短列表与不同屏幕尺寸
安全加固
- 管理员救援密码重置先校验系统已初始化,避免修改未安装环境
- 加强 FTP 及直链、短链下载的路径越界校验,历史链接也执行路径安全检查
- 新增「允许上传可执行内容」独立权限,对 HTML、XHTML、SVG 文件的上传及相关文件操作进行权限校验;管理员可配置主动内容预览并确认执行脚本的风险
- README、公告与 Markdown 预览的渲染结果统一进行 HTML 安全过滤,降低脚本注入风险
BUG 修复
- 修复 OneDrive 文件操作的 JSON 请求头不正确导致请求失败的问题,保留服务端错误信息便于定位
- 修复文件夹移动时对自身子目录的判断不准确,导致合法移动被拒绝的问题
- 修复注册页未应用登录页配置的自定义 JS/CSS 的问题
- 修复 WebDAV getcontentlength 属性响应异常问题
- 修复 OnlyOffice 历史快照读取异常的问题
5.0.8(2026-09-17)
优化
- ⭐ (捐赠版) 优化移动端文件搜索按钮与弹窗布局,搜索范围选项支持自动换行
- ⭐ (捐赠版) 注册页同步展示登录页配置的自定义版权信息
- 视频播放器按视频格式和弹幕需求加载组件,减少首次打开时的等待
- 优化仪表盘移动端监控图表操作区与日期选择布局,修复横向溢出和操作区遮挡图表的问题
- 仪表盘区分数据库与配置、日志目录的挂载风险,提供可复制的 Docker Run 与 Compose 挂载配置示例
- 优化面包屑折叠,长路径不再挤压右侧功能按钮
BUG 修复
- 修复分享页下载、复制下载链接仍使用旧地址的问题,统一使用限时签名链接,避免在下载地址中携带分享密码
- 修复分享访问页未显示站点与当前目录标题的问题
- 修复注册页未展示备案信息的问题,统一登录页、注册页与首页备案链接展示
5.0.7(2026-09-15)
新功能
- ⭐ (捐赠版) 支持分别自定义登录页与首页版权信息
- 单点登录新增企业微信(自建应用)协议
- SSO 服务商支持保存前发起测试登录核对身份字段
- 新增雨云对象存储类型
- 上传设置新增单文件最大上传大小配置(默认 10GB),超限上传会提示具体上限
- 新增「允许覆盖上传」独立权限,可按用户和存储源单独控制覆盖已有文件
- 支持为登录页和管理后台配置自定义 JS/CSS
- 音频播放器支持逐字歌词,兼容同名 .lrc 文件与内嵌歌词标签
- HTML 文件支持沙箱渲染预览,Markdown/HTML 编辑器支持编辑与预览分栏和代码块自动换行
- 邀请码支持批次管理,可撤销、导出 CSV 并查看使用记录
- 移动端 PDF 预览支持双指捏合缩放与拖动平移
优化
- ⭐ (捐赠版) 重做授权管理页,支持多授权码管理与状态展示
- 管理后台仪表盘改版为数据看板设计,支持区块拖拽排序与首屏骨架屏
- 后台设置页统一为卡片布局,增加未保存更改提醒,表格首屏统一骨架屏
- 文件列表直接返回收藏状态,收藏操作响应更快
- 优化静态资源缓存策略,版本升级后刷新页面即可生效
- 权限不足时上传与文本编辑会明确提示缺少的具体权限