ZFile 更新日志
提示
ZFile 统一发布一个版本:未填写授权码时使用免费功能,填写有效授权码后启用捐赠版功能。仅授权后可用的更新条目会标记为 (捐赠版)。
5.0.4(2026-08-01)
新功能
- 管理员页面顶部新增一键系统诊断,可逐项查看检测进度、停止诊断并重试未通过的项目
- 个人设置支持在右键或长按菜单打开时自动隐藏悬浮操作条,默认启用
优化
- ⭐ (捐赠版) 优化下载统计页面的视觉与数值展示
- 优化仪表盘与系统监控页面的视觉一致性
- 优化上传页面、上传任务弹窗、拖拽反馈和切换动画
- 优化用户编辑与存储源权限页面的布局和操作体验
- 避免进入分享页时短暂显示密码输入界面
- 将返回根目录的文案从
/调整为“根目录” - 调整用户顶部菜单的默认顺序,将相关功能相邻排列
BUG 修复
- ⭐ (捐赠版) 修复部分存储源无法正常使用 OnlyOffice 历史版本的问题
- 修复 PDF 在旧版浏览器中无法正常预览的问题
- 修复代理管理新增表单可能覆盖上次编辑结果的问题
- 修复从“我的收藏”返回文件首页时按钮持续加载的问题
- 修复存储源权限页面启停后未及时生效的问题
5.0.3(2026-07-29)
新功能
- 登录日志支持删除
- 增强搜索功能,支持渐进式返回结果和中止搜索
- 代理池管理支持自定义测试地址和超时时间
- 增强面包屑功能:优化自动折叠方案,支持自定义尺寸,以及点击箭头展开父目录的子项
- 画廊模式支持自动裁切超长图,默认开启,可在用户设置中关闭
优化
- 重新设计视频播放器,大幅优化视觉效果和易用性
- 优化音频播放器样式
- 支持混合选中文件和文件夹后进行移动或复制
- 增强 ZFile 内置脚本的兼容性和功能
- 统一管理员 部分页面在移动端的组件尺寸
- 明确 Passkey 的运行环境限制提示
- 复制失败时提供手动复制弹窗
- 避免 Header 中的登录入口被收起到「更多」菜单
BUG 修复
- 修复登录日志启用密码记录时密码显示异常的问题
- 修复因验证码或 2FA 错误导致登录失败时,仍记录登录密码的问题
- 修复分享页面面包屑误加载文件列表的问题
- 修复画廊模式中收藏按钮显示异常的问题
- 修复列表视图下拖拽选中时,部分已选行未高亮的问题
5.0.2(2026-07-20)
新功能
- 后台新增全局功能搜索,可通过
Command / Ctrl + K搜索页面、设置项和 Tab,并保留最近搜索记录 - 首页视图新增「混合模式」:仅有一个可用存储源时自动打开,存在多个可用存储源时展示存储源列表
- 新增 PostgreSQL 数据库支持,新安装可直接使用 PostgreSQL 初始化并运行
- 用户支持绑定或换绑邮箱、使用邮箱登录,以及通过邮箱验证码找回密码;后台可分别配置注册和账号安全邮件模板
- Google Drive 可在根目录显示只读的「与我共享」目录,并支持 Google Workspace 文件导出下载和独立展示文件名
- 支持通过邀请码注册新账号
- ⭐ (捐赠版) 下载统计新增实际文件数、下载场景、分享链接排行、浏览器与设备分布等分析维度
优化
- 后台安全设置按登录认证与访问控制重新分组,旧管理员双因素认证入口统一到用户级双因素认证
- 演示站允许体验文件收藏和用户偏好设置等非破坏性操作
- 完善 Linux Native 管理脚本的状态、版本、启动和停止输出
BUG 修复
- 修复百度网盘、Google Drive、115 等存储源查询参数二次编码导致的特殊字符访问异常
- 修复存储源别名或直链前缀与系统固定根路由冲突,以及首存储源模式下部分页面返回文件首页异常的问题
- 修复后台登录入口显示配置未正确返回、OAuth 授权弹窗内容溢出等问题
5.0.1(2026-07-13)
新功能
- 支持用户自主注册:注册用户自动继承「虚拟新用户」权限,可按需 启用邮箱验证码、邀请码、图片验证码或 Cloudflare Turnstile;后台提供 SMTP、验证码邮件模板及邀请码批次管理
- 后台支持自动检测新版本,在页面内展示更新摘要和完整更新内容,并可忽略指定版本的更新提醒
优化
- 简化 OIDC 单点登录配置:填写 Issuer URL 后自动读取标准发现配置并校验 Issuer,同时优化第三方登录入口的图标展示
- OnlyOffice 配置测试支持分别检测服务连通性、健康状态、JWT 开关及 Secret,并展示 DocumentServer 版本和更明确的诊断结果
安全加固
- 完善演示站只读限制,覆盖收藏、分享 / 短链、SSO 绑定、WebDAV、OnlyOffice 编辑及在线日志等操作
- 加强授权校验异常日志脱敏,避免短授权码或异常信息中的授权码泄漏
BUG 修复
- 修复分享下载、OAuth 授权及多种网盘请求中的特殊字符路径和查询参数编码问题
- 修复文件删除确认框可能被组合键或回车误触确认的问题
5.0.0(2026-07-12)
新功能
- ⭐ (捐赠版) 双因素认证支持按访问 Host 区分发行方
- ⭐ (捐赠版) 审计日志:记录后台与前台关键操作,敏感信息自动脱敏
- ⭐ (捐赠版) 文件上传 / 下载限速
- ⭐ (捐赠版) 规则管理升级:上传规则、文件查看 / 下载规则、目录文档匹配模式、上传忽略文件规则,支持生效时间、规则表达式在线测试、规则复制到多用户
- ⭐ (捐赠版) OnlyOffice 文档历史:支持版本快照、协同修改记录、历史查看 / 恢复及保留策略
- ⭐ (捐赠版) 下载统计增强:按下载类型查看趋势、Top 排行及多维筛选,可从仪表盘下钻查看
- ⭐ (捐赠版) 在线会话管理:查看登录方式、IP、终端和过期时间,并可强制下线
- 新建文件功能,支持 txt / md / json / docx / xlsx / pptx
- 支持上传 0 字节空文件
- 上传同名文件支持覆盖、跳过或自动重命名
- 文件收藏:支持收藏文件、集中搜索 / 筛选 / 排序、跳转定位,管理员可全局开关
- 文件列表支持按时间、大小、类型分组;顶栏、右键菜单和移动端操作栏支持自定义排序、收起及层级
- 用户偏好 / 使用习惯设置持久化
- 目录优先排序开关、预览器优先级配置
- 音视频与预览体验升级:音频歌词与播放列表、移动端视频选集、PDF 文字层与连续滚动、画廊多选及工具栏、Markdown 预览 / 编辑切换
- 短链支持自定义 Key,并支持按用户管理短链
- 分享管理增强:导出分享链接 / 密码、批量删除、一键清空全部分享,新增分享级「忽略文件夹密码」开关
- 分享有效期的可选项与默认值支持后台配置
- 微信内置浏览器访问直链 / 短链时提供下载引导页
- Passkey(WebAuthn)免密登录,支持自动登录
- 双因素认证(2FA)升级为用户级别,所有用户均可启用,支持全局开关
- 接入 Cloudflare Turnstile 人机验证,保护登录
- 全局密码策略:支持最低长度、强度、定期过期和历史密码防重复;密码过期后强制修改
- OAuth2 / OIDC 单点登录支持绑定已有账号、管理外部账号绑定,并以稳定的第三方账号 ID 识别用户
- 登录后跳转地址、登录会话有效期可配置;支持无 Redis 环境下的会话持久化
- 匿名访问(访客)支持作用范围配置,并优化访客首页
- 权限系统重构:支持分组展示与依赖关系,新增文本编辑、OnlyOffice 编辑等细分权限
- 权限模板与权限复制:可从其他用户复制权限,支持按存储源分配权限和复用权限模板
- 存储源密码、目录文档和文件过滤规则支持生效时间段
- tus 协议分片上传,支持大文件断点续传;S3、又拍云支持断点续传
- 上传分片大小可配置(OneDrive / S3 / 又拍云)
- 百度网盘存储源,支持网页 OAuth2 授权、扫码登录、分片上传及下载
- 网络出站代理池:统一管理 HTTP / SOCKS 代理,存储源访问、OAuth 授权及 S3 系请求可按需选用并测试连通性
- 存储源新增 / 编辑改为多步骤向导,支持连接测 试、本地及远程目录浏览选择、OAuth 授权引导
- 自定义 DNS 解析,应对特殊网络环境下的域名解析问题
- 新增 ICP 备案跳转地址
- 支持安装为 PWA 桌面应用
- 在线日志:后台在线查看 / 下载运行日志,支持全局日志级别配置与脱敏
- 全新仪表盘与系统监控:汇总用户、分享、短链等关键指标,支持实时资源趋势、Docker 环境与关键路径挂载检测、DNS 状态、构建和数据库信息,区块可自定义排序
- 提供配置文件下载和
reset-admin本地救援命令,便于迁移与找回管理员账号
优化
- ⭐ (捐赠版) 授权管理改为独立页面,逐个展示多授权码状态;能力按当前访问域名实时生效,无需重启
- 前台设置、上传任务、图片 / 视频 / 音频预览及移动端弹窗交互全面优化
- 存储源列表增强名称、备注、类型及拼音搜索;不支持的文件操作会提前置灰并说明原因
- 存储源停用时不再刷新令牌、启动时不再加载,新增存储源默认排在末尾
- HTTP 客户端全面重构,自研轻量客户端并移除 Hutool / fastjson 等依赖,请求更快、镜像更小、攻击面更低
- OAuth2 回调改为后端模板化页面并支持本地换取令牌,减少对外部回调服务的依赖
- 临时下载地址改为稳定跳转地址
- 验证码改为 SVG,移除 awt 依赖
- 性能优化:修复存储源列表 N+1 查询、新增数据库热表索引、下载日志异步写入、首页 HTML 缓存
- 下载 日志支持分别控制直链、短链和直接下载 / 预览记录,历史记录保留已删除存储源名称
- 系统监控支持自定义时间范围、趋势平滑及图表导出
- 后台设置改为分域读写;后端管理接口统一迁移至
/api/admin/** - 大量服务按「查询 / 命令」职责拆分,提升可维护性
安全加固
- 登录密码请求支持 RSA 加密传输
- SSO 登录使用一次性授权事务并校验 OIDC 签名、发行方、受众与 nonce,账号绑定和解绑要求重新验证身份
- 增强 OAuth2 回调安全,防止敏感信息泄露
- 修复安全配置局部更新导致 2FA 密钥被清空的问题
- 支持自定义客户端真实 IP 请求头,适配 CDN / 反向代理场景
- 修复文件路径穿越(双点段绕过、FTP / SFTP 路径穿越)
- 代理下载强制签名校验,工具类接口补充管理员鉴权
- 日志全面脱敏,移除明文密码输出
BUG 修复
- ⭐ (捐赠版) 修复 WebDAV 中文用户名密码认证、禁止跨存储源移动复制
- 修复文件名含冒号 / 前后空格导致签名校验失败或下载地址异常的问题
- 修复 115 在分享 / 直链 / 短链下路径二次拼接导致 404 的问题
- 修复阿里云、谷歌云文件名含空格时获取下载地址异常的问题
- 修复 FTP 下载流未执行 completePendingCommand 的问题
- 修复 OnlyOffice 回调保存时用户根目录路径重复拼接的问题
- 修复 SQLite 保存存储源时 "database is locked" 的问题
- 修复多项 MySQL 兼容性 / 关键字问题
- 修复非前后端分离部署下管理员页面刷新跳转登录页的问题
4.5.0(2025-11-09)
新功能
- 分享文件/文件夹功能(默认管理员包含此权限,其他用户需手动分配权限)
- 授权码支持多个,用于应对多种访问地址的情况
- 登录安全入口功能,保护登录页面安全
优化
- 打包下载功能优化(支持打包文件夹, 支持打包下载进度显示)
- WebDAV 根目录显示存储源名称
- 增加下载、打包下载、批量下载确认弹窗开关功能(后台-显示设置-下载确认弹窗)
- 二维码支持下载为 png
- 完善上传失败的提示信息
- 搜索支持回车默认搜索全部
- 优化存储源根目录显示 0B 的问题
- 优化页面显示
BUG 修复
- 修复 WebDAV 新建文件夹异常的 bug
- 修复 WebDAV 存储源获取单个文件/文件夹时的 bug
- 修复 open115 启用代理下载 bug
- 修复对服务器地址检测的 bug
- S3 存储改为仅下载使用加速域名,避免某些厂商不支持加速域名上传的 bug
- 修复本地存储/代理下载返回的文件名在 safari 上乱码的 bug
- 修复时间段选择器表单重置未清空的 bug
- 修复从画廊模式回到存储源列表时,未关闭画廊模式的 bug
- 修复点击 OAuth2 登录图标弹窗预览的 bug
- 修复右键菜单打包下载不显示的 bug
4.4.0(2025-08-24)
新功能
- 115 网盘支持
- 存储源目录文档支持
路径模式配置相对路径或绝对路径
BUG 修复
- 修正获取服务实际地址 bug
- 修复下载日志-删除所有页无响应 bug
- 修复 swagger 文档中字段名为中文的 bug,并将 prod 环境的 swagger 默认禁用。
- 修复打包下载权限问题 (捐赠版)
4.3.3(2025-07-29)
新功能
- 打包下载支持文件夹(捐赠版)
- 移动端显示文件大小功能(此版本默认启用,显示设置可以关闭)
- 支持 kkFileView 预览
- 后台
站点设置->首页 Logo 图片地址支持上传图片、Base64 图片
优化
- 优化 WebDAV 访问速度(捐赠版)
- 优化存储源刷新令牌的机制,不再使用定时任务,改为检测到期刷新。
- 优化站点域名检测功能,检测用户配置的反向代理是否正常(不正确会影响直/短链下载)
- 优化存储源连接超时时间,避免添加/启动系统加载存储源等待时间太长的问题。
- 存储源初始化时使用管理员身份,避免匿名用户的用户基路径不存在导致初始化异常
- 缓存用户可用存储源,加快访问速度
BUG 修复
- 修复 WebDAV 若干 BUG。(捐赠版)
- 修复 S3 自定义域名无法下载的 bug(雨云)
- 修复获取 readme.md 文件时对用户基路径处理异常 bug
- 修复某些 存储源对用户基路径处理异常 bug
- 修复 ftp, 又拍云 获取单个文件信息时异常的 bug
- 修复卡片模式右键多次同一个文件的 bug
4.3.2(2025-06-21)
优化
- 大幅优化 Webdav 访问速度。
- 优化网站加载文件、直链的速度。
BUG 修复
- 修复 Webdav 各种情况导致的链接失败,预览失败的 bug。
- 修复 S3 对象存储代理上传时大文件提示超时的 bug。
- 修复阿里云公共空间且指定了加速域名时短链无法正常使用的 bug。
- 修复部分 2fa 软件(enpass)无法正常识别生成的二维码的 bug。
- 升级 commons-fileupload 版本,修复安全漏洞。
- 修复短链过期检查异常 bug。
不兼容升级
- 从 4.3.2 开始,匿名用户访问 WebDAV 需使用 guest 用户名及任意密码,不再支持使用空账号密码访问。
4.3.1(2025-06-10)
新功能
- 增加强制指定后端地址功能(用于内外网同时使用,强制直链/短链/回调等地址使用指定地址)
优化
- 系统设置页面,双因素认证配置优化,页面新增保存按钮,而不是之前的切换保存。
- 清除密码文件夹缓存明确文案和操作完成提示(首页右上角设置按钮最下方)
- 自定义 JS 页面增加提示信息,提示如果有后端防火墙可能会被当成恶意请求无法保存。
- OnlyOffice 配置页增加提示信息,避免用户在环回地址使用导致无法预览。
- 优化用户管理页面关于虚拟新用户和匿名用户的提示信息,避免用户无法区分
虚拟新用户和匿名用户的区别。
BUG 修复
修复自动检测管理员是否配置存储源功能异常(检测成了虚拟新用户。)