ZFile 更新日志

提示

ZFile 统一发布一个版本：未填写授权码时使用免费功能，填写有效授权码后启用捐赠版功能。仅授权后可用的更新条目会标记为 （捐赠版）。

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 预览支持双指捏合缩放与拖动平移

优化

• ⭐ （捐赠版） 重做授权管理页，支持多授权码管理与状态展示
• 管理后台仪表盘改版为数据看板设计，支持区块拖拽排序与首屏骨架屏
• 后台设置页统一为卡片布局，增加未保存更改提醒，表格首屏统一骨架屏
• 文件列表直接返回收藏状态，收藏操作响应更快
• 优化静态资源缓存策略，版本升级后刷新页面即可生效
• 权限不足时上传与文本编辑会明确提示缺少的具体权限

安全加固

• SSO 自动建号时外部邮箱不再直接视为已验证，需验证码确认后生效，邮箱已被占用时引导绑定已有账号
• 启用或更换注册 Turnstile 配置时，保存前必须完成一次真实人机验证，避免错误配置导致注册不可用
• 分享文件的下载地址不再携带明文密码，改用 30 分钟限时签名令牌

BUG 修复

• 修复向 OneDrive、又拍云上传含子目录的文件夹时失败或被误跳过的问题
• 修复部分 S3 兼容存储因 Content-Type 签名不一致导致上传被拒绝的问题
• 修复 Safari 浏览器视频无法播放的问题
• 修复分享密码超过 8 位时保存失败的问题
• 修复复制用户时新用户携带源用户邮箱导致冲突的问题
• 修复删除用户时关联数据清理失败可能留下残留数据的问题
• 修复 PostgreSQL 下部分含保留字字段的查询报错的问题
• 修复未启用 Redis 时后台在线会话列表加载失败的问题
• 修复仪表盘用户统计计入匿名与内置模板账号导致数字虚高的问题
• 修复 Native 版本 Redis 缓存读写与登录会话恢复报错、部分接口返回异常的问题
• 修复访问控制可能因过期 IP 检测结果误判、或误将自身 IP 加入黑名单导致无法进入后台的问题
• 修复事务回滚后审计日志仍记录操作成功的问题
• ⭐ （捐赠版） 修复大小写不敏感的数据库排序规则下 LDAP 用户可能重复建档或绑定丢失的问题
• ⭐ （捐赠版） 修复仅有一个授权码时授权管理页无法继续添加授权码的问题

5.0.6(2026-08-17)

新功能

• ⭐ （捐赠版） 新增 LDAP 登录功能。

优化

• 统一后台列表、设置、仪表盘、日志等页面的页头、布局、搜索、保存和业务弹窗交互
• 优化 PDF 预览标题与工具栏，长文档改为按可视区域渲染并释放远离页面，降低内存占用
• 优化 Office 预览加载骨架和错误状态，支持重试，管理员可直接前往 OnlyOffice 设置排查
• 支持复制文件和文件夹复制到当前目录，可选择自动重命名保留副本或跳过
• 新增可信代理 IP / CIDR 配置和客户端 IP 实时识别检测

安全加固

• 修改或启用登录 Turnstile 配置时，保存前必须使用待保存的 Site Key 与 Secret Key 完成人机验证，避免错误配置导致登录不可用

BUG 修复

• 修复 FTP 上传被服务端拒绝时仍可能按成功处理的问题
• 修复多标签页同时保存用户偏好时可能触发 SQLite 锁冲突的问题
• 修复在输入框、文本域或富文本编辑区粘贴内容时可能误触文件上传的问题
• 修复存储源 OAuth 授权弹窗继承外层表单错误状态的问题

5.0.5(2026-08-09)

新功能

• 管理员可在文件前台直接跳转编辑当前目录对应的目录文档
• 画廊模式支持根据当前目录图片占比自动切换，可配置图片占比阈值和最少图片数
• 管理员可从创建分享和生成短链弹窗直接管理有效期快捷选项

优化

• 增强 WebDAV 文件复制兼容性，支持探测服务端复制能力并按配置使用 COPY+MOVE 或流式回退
• 统一优化直链、短链和创建分享等新式弹窗的布局与响应式尺寸

BUG 修复

• 修复 115 非秒传场景普通上传失败的问题
• 修复 MySQL 默认使用 MyISAM 时 Flyway 迁移表引擎不兼容的问题
• 修复存储源连接测试错误叠加管理员用户基路径的问题
• 修复搜索场景下面包屑状态栏未动态显示的问题

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 修复

修复自动检测管理员是否配置存储源功能异常（检测成了虚拟新用户。）

4.3.0(2025-05-25)

新功能

• 支持 OAuth2 单点登录 PR-741
• SFTP 支持密钥模式登录 PR-738
• 增加清理密码文件夹缓存功能（首页右上角 - 设置按钮 - 最后）

优化

• 限制 webdav 存储源链接时间为 10 秒, 避免因网络问题一直卡住等待
• 如果用户未启用，首页不再返回存储源列表

BUG 修复

• 修复为用户设置基路径后，密码文件夹异常的 bug(影响保存密码，预览，移动复制等操作)
• 修复本地存储不支持 range 的bug
• 修复某些 webdav 服务器上传文件时文件大小必传导致上传失败的 bug
• 修复卡片模式下打开画廊模式时显示异常的 bug
• 修复从存储源根目录回到存储源列表时上传按钮仍然占位的 bug
• 修复修改密码弹窗移动端宽度显示不全的 bug

4.2.3

优化

1. 优化存储源必填提示文字为中文.
2. 完善规则管理页面的提示信息

BUG 修复

1. 修复移动端首页设置按钮不显示的 bug
2. 修复用户密码无法修改的 bug
3. 修复 Google Drive 某些情况下返回刷新令牌为空的 bug
4. 修复 S3 存储类型新建文件夹或上传文件夹失败的bug
5. 修复升级到 4.2.2 版本后 Webdav 无法使用的 bug
6. 修复 minio 使用域名时，默认为域名风格地址导致无法下载的 bug
7. 修复用 OnlyOffice 预览过某个文件后，删除或重新上传本地修改过的文件时，仍然看到旧版本的 bug
8. 修复保存的用户规则重启后失效的 bug
9. 完善 "上传规则应用至重命名" 功能的说明和功能
10. 修复未保存的规则进行测试时始终提示不匹配的 bug

4.2.2

新功能

• 增加移动端布局指定。
• 新增记住密码功能。
• 支持自定义 office 预览的文件后缀。
• 支持强制设置匿名用户显示内容。

BUG 修复

• 修复错误使用代理下载限速作为代理下载过期时间的 bug。
• 修复 2fa 页面首次打开自动保存 bug
• 修复从 "内容变更前隐藏弹窗公告" 的存储源切换其他存储源时，闪一下的 bug。
• 修复移动端面包屑某些情况下不刷新的 bug。

优化

• 优化密码文件夹匹配性能

4.2.1

新功能

1. 增加规则管理功能：可限制不同用户上传/显示文件的功能。（捐赠版专属）
2. 大幅优化移动端体验。（后台管理）
3. 新的图标模式视图（前台顶部栏点击设置按钮切换）

BUG 修复

1. 修复苹果手机 qq 和微信浏览器长按不弹出菜单的 bug
2. 修复 cors 跨域配置异常的bug
3. 修复密码文件夹规则包含通配符时，无法保存的 bug
4. 修复 od 个人版移动、复制文件失败的 bug（api 不同，个人版必须要传递目标文件夹 id）

优化

1. 优化右键菜单显示效果
2. 增强存储源配置校验

4.2.0

注意，此版本为一次大版本更新，虽然已经测试过很多轮，但仍然可能存在未知问题，追求稳定可以先观望下或等下个版本相对稳定后再升级。

• 如果要升级，请先备份好数据！
• 如果要升级，请先备份好数据！
• 如果要升级，请先备份好数据！

更新方式已经兼容为和以前一样，具体可参见文档左侧安装向导

新功能

• 多用户功能
• 登录日志功能
• 访问控制功能
• 存储源均支持服务器中转下载、限速
• Webdav 支持上传、删除、重命名等功能（beta）
• 支持移动、复制文件、文件夹功能
• OnlyOffice 支持在线编辑，协同编辑，支持 JWT Token 验证

优化

• 大幅优化服务启动性能(5 倍以上，不含存储源本身初始化时间)
• 管理员模块页面优化，功能分组设计，方便管理
• 直链、短链页面上分开获取，避免之前的歧义
• 视频、PDF、Office、3D、纯文本文件预览支持全屏显示
• 更换纯文本预览组件，提高页面加载速度
• 纯文本预览支持自动识别文件编码

BUG

• 修复修改直链别名后需重启服务才生效的 bug
• 修复苹果设备 safari 上长按无法弹出右键菜单的问题 (然后删除了悬浮菜单功能)

暂时只想到这些更新点，但实际上还有很多优化和 bug 修复，之后会慢慢补充到文档。

4.1.6

新功能

• zfile 捐赠版未填写或授权错误提示信息优化 (捐赠版)
• referer 防火墙表达式在线测试功能
• 复制存储源功能
• 短链增加有效期功能 (可在 "直/短链设置" 中修改短链有效期)
• 支持自定义 title 和 favicon 功能，返回的 html 是已经修改过的，不是等待页面加载完再修改。
• 密码文件夹支持选择是否记住密码(默认不记住密码,可在后台 "显示设置" 中修改)

优化

• 优化打包下载因配置不当导致无法下载的提示（捐赠版）
• 优化 referer 黑白名单校验表达式提示信息
• 优化路径直链功能，不再使用全局过滤器实现，而是使用动态 Controller 实现
• 修正下载日志中时间描述歧义
• 自定义 confirm 和 prompt 组件
• 完善本地存储路径校验功能，提示必须输入绝对路径
• 修改 "是否允许使用直链" 功能描述

BUG

• 修复 webdav 管理页面错误弹窗的 bug (捐赠版)
• 修复直短链下载响应头问题，导致安卓手机下载 apk 时自动变 zip 的问题
• 修复多吉云令牌无法自动刷新的 bug
• 升级依赖版本，修复安全漏洞
• 修复从存储源根目录回退到存储源列表时，首页仍然显示了底部文档的 bug。
• 修复从后台点击 logo 回到前台时，面包屑可能异常的 bug
• 修复视频播放器某些情况无法识别字幕的 bug
• 修复苹果系设备上移动端后台菜单错误的 bug
• 修复某些情况下无限重定向的 bug
• 修复本地存储某些情况下安全性 bug

4.1.5

新功能

• 支持区分预览和下载的权限 （捐赠版）
• 新增存储源多吉云支持
• 新增卡片布局模式
• 增加加载更多功能，优化大文件夹加载速度，支持设置每页初始最多显示文件数及每次加载更多文件数 #468
• 增加首页 logo 显示功能
• 增加设置默认排序字段和排序方向的功能
• 视频播放器开启 airplay 功能（如果设备支持）
• 新增批量按条件删除直链下载日志功能
• 增加直链单位时间内单 IP 最大下载次数限制功能

优化

• 优化后端自动校验域名是否设置正确的功能，不使用强弹窗提示，而是在后台设置页面显示提示信息。
• 优化面包屑功能，支持根据页面宽度自动折叠部分面包屑
• hls 视频播放不再依赖直链，而是使用自定义解析器获取文件实际直链，解决了部分视频无法播放的问题
• 修改 referrer 策略，修改为同源的才发送 referrer，其他的不发送。
• 优化直链 Referer 黑/白名单域名输入框提示信息，提示需要输入协议头
• 为了安全性，去除从服务器加载文本文件的功能。
• 移动端视频播放非全屏状态下，隐藏网页全屏按钮，避免工具类宽度不足问题
• 更换 flv.js 为 mpegts.js 播放器，提高性能
• 增强自定义 js 功能，支持更多场景
• 更显眼的提示 Google Drive 需要自建 API 应用才能使用
• 更显眼的提示用户腾讯云使用 CDN 回源鉴权后需要关闭 ZFile 中私有空间开关。

BUG

• 修复搜索文件后，点击面包屑无法返回的 bug （捐赠版）
• 修复存储源别名修改后再修改回去提示占用的 BUG
• 修复本地存储上传文件后，未解除文件占用的 BUG
• 修复上传文件夹时，实际上传后的文件路径错乱的 BUG #485
• 修复文件夹上传时，当文件进入队列后，切换到其他目录，队列中的文件上传目录会变化的 BUG.
• 修复某些分辨率下，文件前的图标被遮挡的 bug
• 修复右键菜单在存储源为空时无效的 bug
• 修复存储源为空时文件区域高度异常问题
• 修复调用 potplayer 播放视频时文件名中包含中文报错的 bug
• 修复短链对应的存储源关闭后，存储源仍然可以访问的 bug
• 修复自动设置 CORS 时，某些 S3 兼容性不同导致的 BUG（BackBlaze 不支持 * 和实际域名写到一起，不支持空值）
• 修复 Google Drive 中的快捷方式文件夹无法正常显示的 bug
• 修复未控制并发为同一文件生成了多条短链的 bug
• 修复七牛对私有空间使用自定义域名后无法正常下载的 bug

4.1.4

优化

• 优化存储源列表在移动端容易误触拖动的问题，在移动端增加长按 300 耗秒延迟，使得可以长按拖动。
• OneDrive、SharePoint 上传大小为 0 的文件时，直接提示失败，不支持上传空文件。
• 去除初始化页面和后台站点设置页面对于站点域名字段的校验，允许用户输入任意值（为了支持 IPV6 地址）。
• 密码、过滤、目录文档中的规则表达式自动 trim 前后空格，防止勿输入空格导致不可用。
• 增强 SharePoint 存储源的提示，提示网站隐私设置需为 "公用-组织中的任何人都可访问此站点" 时才能正常使用。
• 优化代码，提供系统稳定性。

BUG

• 修复本地存储上传、删除等文件操作，可能存在越权获取到上级目录的 bug.
• 修复后台设置直链 Referer 防盗链不生效的 bug.
• 修复加密文件夹在未输入密码时，显示了目录文档的 bug
• 修复上传时，排队中的任务因目录切换导致恢复排队后上传到当前所在目录的 bug
• 修复本地存储文件夹大小显示错误的 bug
• 修复 404，403，401 页面显示异常的 bug
• 修复自定义 js 功能，面对多个 script 标签无法正常加载的 bug
• 修复对单个文件生成直链时，导致列表上文件大小显示异常的 bug
• 修复本地存储无法上传大小为 0 的 bug

4.1.3

BUG

• 修复加了密码的文件夹无法正常删除、重命名等操作的 BUG （4.1.2 Pro 版本引起，建议升级到 4.1.3 Pro）
• 修复部分存储源根目录无法文件操作的 BUG**（4.1.2 Pro 版本引起，建议升级到 4.1.3 Pro）**
• 修复更新存储源设置第二次保存才会生效的 BUG （4.1.2 Pro 版本引起，建议升级到 4.1.3 Pro）
• 修复支持显示文件夹大小的存储类型未显示的 BUG
• 修复在 Linux 下开启后台登录图片验证码时，出现异常提示的 BUG

4.1.2

新功能

• 服务器中转下载的直链支持手动添加 type=preview 来改变直链的默认下载行为。如直链是图片，访问 http://127.0.0.1:8080/directlink/image.png 默认为下载，访问 http://127.0.0.1:8080/directlink/local/image.png?type=preview 则为预览（浏览器支持的话）
• 新增功能，可控制未生成的路径直链是否允许访问，如直链为：http://127.0.0.1:8080/directlink/local/image.png ，该文件未生成直链，是否允许直链访问，设置位置在后台： 直链管理 -> 直链设置 -> 是否允许路径直链可直接访问。
• 弹窗模式目录文档增加选项，支持控制是否不再显示（仅对确认的目录生效，且这个目录公告变更后会再次提示）
• 视频在线预览下方工具类支持隐藏

优化

• 📱浏览器兼容性增强，经测试最低支持到 谷歌 49+、Firefox 51+、Android 7.0+ ，不支持 IE 任何版本。
• 👨‍💻 优化代码结构，更加规范
• 🗒 优化日志输出，便于出现问题时快速定位
• ⚡️ 优化缓存功能，避免频繁查询数据库，提高查询效率
• 🔐 安全性提升，所有文件操作，都校验文件夹密码。

BUG

• 修复新增存储源失败后，再次新增其他类型的存储源类型失败的 BUG
• 修复某些情况下会显示 [SQLITE_BUSY] The database file is locked (database is locked) 的 BUG。
• 修复删除存储源后，没有同步删除其他相关资源的 BUG（如直链、下载日志、过滤规则、密码规则等）
• 修复目录密码、目录文档规则表达式某些情况未生效的 BUG。
• 修复目录密码某些情况下前端未自动缓存导致一直提示手动输入的 BUG。
• 修复 S3 协议存储源只能展示同目录下前 1000 个文件的 BUG
• 修复新增加的存储源顺序不在最前面的 BUG
• 修复捐赠版 linux 启动脚本某些情况未成功加载项目目录下配置文件的 BUG
• 修复直链页面显示大小异常的 BUG
• 修复弹窗模式的 readme 文档内容较多时不显示滚动条的 BUG
• 修复未添加任何存储源时，debug 模式也无法重置密码的 BUG
• 修复存储源删除后，直链页面无法打开的 BUG
• 修复没有传递 origin 时，无法正常跨域的 bug
• 修复 Cloudflare R2 和 Oracle R2 无法正常添加问题
• 修复 S3 存储类型域名风格无法选择问题。
• 修复部分情况下文件夹大小未显示的 bug

4.1.1

新功能

• 3d 文件使用直链加载，且支持背景颜色选择器。

优化

• 自定义 js 修改为页面加载完才执行，防止获取不到元素的情况。
• 上传弹窗下也支持 ctrl + v 粘贴上传
• 修改系统设置 value 值字段类型为 text, 防止自定义 js css 过长无法保存

BUG

• 修复某些情况拖拽无效的 bug

• 修复直接截图到剪贴板的图片无法直接粘贴上传的 bug

• 修复 3d 某些情况无法正常加载的问题。

• 修复首次安装 zfile 时没有自动创建数据库目录的 bug

捐赠版

• 直链排行日志 - 文件，支持显示存储源 key 和文件路径

4.1.0

新功能

• Google Drive 支持
• 支持 Office 预览功能，如 excel，ppt，word 使用 OnlyOffice 实现，支持自建服务。
• 支持 3D 文件预览，如 'dae', 'fbx', 'gltf', 'glb', 'obj', 'ply', 'stl' 格式，obj 格式的还会自动检测同目录同名的 mtl 纹理文件。
• 支持 WebDAV 功能（捐赠版），目前仅支持只读操作，后续会支持上传，删除等功能。

优化

• 后台直链列表和统计页面支持复制直链和打开直链功能
• 增加校验，直链前缀不可为空
• OneDrive/SharePoint/Google Drive 动态提示自定义 api 时需要填写的回调地址，且支持复制。
• OneDrive/SharePoint/Google Drive 获取令牌链接支持复制
• 上传页面增加 已上传大小/总大小 显示
• 优化批量生成直链功能，保证生成顺序，且只需要调用一次后台，避免批量生成直链时触发 cc
• 优化批量删除功能，且只需要调用一次后台，避免批量删除时触发 cc
• 批量生成直链后，支持批量复制名称功能

BUG

• 修复批量生成直链顺序混乱的 BUG

• 修复某些 4.0.8 及以前的版本使用 zfile 默认 api 获取访问令牌时可能会报错的 bug

4.0.10

新功能

批量下载和打包下载授权功能，授予管理员/匿名用户是否可用

优化

• 未填写备案信息时, footer 不显示.
• 优化 OneDrive/SharePoint 获取 token 体验，增加信息显示，并优化页面效果。
• 打包下载增加 loading
• 打包下载时，其中一个文件错误，则取消打包并提示错误文件.

BUG

• 修复 SharePoint 世纪互联自定义 api 失败的 bug
• 修复 OneDrive/SharePoint 自定义 api 时 clientSecret 包含特殊字符时异常的 bug
• 修复兼容读取 readme.md 模式仅启动后首次设置有效的 bug

4.0.9

新功能

• ✨ 增加目录文档兼容模式，如启用该功能，则忽略规则模式，而是读取目录下 readme.md 文件，并显示在文件列表下方显示
• ✨ 增加最大同时上传数限制
• ✨ ZFile Pro 特有功能 增加打包下载功能（仅兼容谷歌浏览器）
• ✨ 新增同时上传文件数量限制, 新增上传失败重试功能，新增删除等待中和已完成任务功能

优化

• ✨完善 OneDrive SharePoint 自定义 clientId 、clientSecret、redirectUri 功能体验.
• ✨ 优化后台存储源列表页面, 更易于操作
• ✨ 优化上传页面样式，更加美观.
• 因浏览器特性兼容性，批量下载或打包下载时判断当前浏览器，提示推荐使用谷歌浏览器。
• 优化自定义 js 功能，支持写 <script></script> 标签也可不写，解析时会自动兼容.
• 优化代码，修改配置信息默认值，并使 zfile.config.json 可配置前台设置默认值，如移动端默认画廊列数、画廊列间距、行间距等功能
• 优化画廊模式列间距功能, 避免大于 1 列且设置了列间距的情况下, 最后一列的右侧也会显示空白间距.
• 当未上传完成时，增加 badge 显示未上传完成数量.
• 上传需要服务器中转的文件时，如 ftp、sftp、webdav 时提示服务器中转中.
• 浏览器控制台增加浏览器信息输出, 便于问题发现和排查
• 增加文件页文字宽度和粗度, 易于浏览
• 完善存储源别名填写时对系统默认关键字的检测, 如为系统关键词, 则不允许设置为存储源别名
• 优化后台日志下载功能，增加 loading, 防止日志文件过大时导致看起来没反应的问题。

BUG

• 修复批量删除直链或直链下载日志数量过多时, 无法正常删除的问题。

• 修复右键菜单点击空白处失败的 bug

• 修复默认打开画廊模式失败的 BUG.

• 修复右键菜单在错误的地方（如 dialog）显示的 bug

4.0.8

新功能

• 支持右键文件区空白处（非 header 和 footer 部分）新建文件夹、上传文件、上传文件夹
• 右键菜单支持刷新按钮
• PDF 预览功能，支持按 + - 放大缩小，支持按 ← → 切换页码（非显示全部页码状态下）

优化

• 完善 OneDrive SharePoint 反代域名参数的描述信息
• 统一本地存储、sftp、ftp、webdav 下载文件 contentType 为 application/octet-stream, 避免浏览器自动进行默认预览动作
• 完善删除文件、文件夹操作体验，区分删除的是一个还是多个。区分当前存储源是否支持删除非空文件夹
• 完善存储源添加时校验，如果 zfile 站点是 https 的，则提示不允许添加 http 协议的加速域名.
• 重构部分代码, 优化组件间的引用关系
• 修复拖拽上传和粘贴上传失效的 bug
• 优化移动端视频弹窗、文本弹窗、图片预览的兼容性问题
• 优化移动端视频播放器切换上一个下一个逻辑
• 优化 minio 提示信息

BUG

• 修复 IOS 浏览器下画廊模式无法点击预览的 BUG
• 修复 Safari 浏览器某些文件类型无法正常下载的 BUG
• 修复 m3u8 无法正常播放的 BUG
• 修复兼容 h5ai_dplayer 时，如果切片目录隐藏，导致无法正常加载的 BUG
• 修复获取 m3u8 直链后系统报错的 bug.
• 修复默认打开画廊模式失败的 BUG.

4.0.7

新功能

• 兼容 h5ai_dplayer https://github.com/Pearlulu/h5ai_dplayer：如同目录下有 __{video_name}__ 则取 __{video_name}__/video.m3u8

优化

• 优化 S3 协议自动配置跨域逻辑，改为不覆盖原有配置。且增加 GET 跨域，对于在线预览文本、视频场景提供跨域支持.
• 优化图片预览使用体验，默认预览图片支持左右切换
• 画廊模式重新支持懒加载
• 移动端适配：优化文件页移动端布局，改为右上角点击显示所有功能
• 移动端适配：优化登录和初始化页面移动端体验.
• 移动端适配：优化移动端消息提示和弹窗确认/弹窗输入框体验
• 移动端适配：优化移动端布局，管理后台表单元素支持换行.
• 移动端适配：优化移动端布局，移动端所有 dialog 弹窗宽度设置为 90%
• 移动端适配：优化后台管理移动端布局，下级后弹出所有功能菜单
• 移动端适配：优化管理后台 header 部分布局, 兼容移动端
• 代码优化，解除未来 jdk 版本对过期内容的引用

BUG

• 修复画廊模式下点击无法预览的 BUG
• 修复文件列表某些情况最后一个文件会被挡住的 bug, 且会有两个滚动条，影响使用体验 #390 #393
• 修复 minio 设置跨域上传报错的 bug

4.0.6

新功能

• 独立直链和短链功能，短链不再依赖直链，可单独启用
• 支持权限设置： 是否可用、忽略密码、忽略隐藏

优化

• 修复本地存储文件路径描述，对于 docker 环境更容易理解。
• 优化使用体验，移动端画廊模式默认为 1 列
• 优化视频、文本、文档等异步组件首次加载卡顿问题, 增加骨架屏.
• 优化移动端视频弹窗宽度
• 修复搜索框无法粘贴问题

BUG

• 修复腾讯云 cos 对象存储，无法自动加载账号下的所有存储器列表的 bug
• 修复长图片被拉伸的 bug
• 修复调用播放器 potplayer 时，链接中包含中文导致无法播放的 bug.
• 修复部分情况 ctrl + v 控制台报错的 bug
• 暂时关闭图片懒加载, 待完美解决后再次开放.

4.0.5

这是第一个捐赠版版本，在开源社区版基础上支持文件搜索、下载限制、权限控制、统计分析功能