版本 更新
本文档记录 JuiceFS 云服务的版本发布历史,如果你想了解 JuiceFS 社区版的版本发布历史请查看 GitHub。
JuiceFS 客户端保持良好的向前、向后兼容性,但对于大版本刚刚发布之时(对于 JuiceFS 而言,5.1 → 5.2 就属于大版本更新),新版可能存在少量兼容性问题。如果需要回滚大版本,请参考 juicefs version
JuiceFS 5.3.2 (2026/2/2)
- 新增
- sync: 支持外部限速
- 改进
- sync: 减少遍历目录时的内存占用
- 提升 RDMA 的兼容性和稳定性
- Bug 修复
- 修复旧版本内核的内存文件系统不支持 directio 导致缓存失效的问题
JuiceFS 5.3.1 (2026/1/14)
- 新增
- mount: 新增
--cache-scan-interval选项来调整缓存盘扫描间隔 - umount: 支持
--update-fstab来删除对应配置 - fsck: 允许检查某个路径的数据完整性
- debug: 支持使用
--pid来指定进程 ID - 支持 ioctl: 设置文件或者目录为只读或者只允许追加写
- 新增
--trace-file来开启并收集 tracing - 允许通过 S3 接口只读访问按需导入的文件系统
- 支持导入 MinIO 的任意桶
- 为从其他桶导入的数据建立缓存
- 支持通过 RDMA 访问缓存数据
- 支持限制访问对象存储的 QPS
- Python SDK: 支持
status、warmup、merge和info命令接口 - Python SDK: 给 clone 接口新增
follow-link参数
- mount: 新增
- 改进
- mount: fstab 默认新增
nofail选项来忽略挂载失败 - status: 默认过滤出工具的会话
- restore: 新增进度条
- warmup: 在使用
--check选项时按优先级统计数据分布 - warmup: 增加
--follow-link选项 - 改进 info 和 warmup 等交互操作的响应时间
- import: 遇到 List 错误时将立即失败
- objbench: 修复不准确的日志
- gateway:在完成分段上传时检验用户提供的 ETag 是否准确
- gateway: 压缩客户端的访问日志
- sync: 允许配置更多客户端参数(比如
--mountpoint) - sync: 改进使用
jfs://协议时创建目录的错误处理 - sync: 提升使用
jfs://协议同步大文件的性能 - 改进元数据缓存的清理速度
- 改进 DirectIO,支持更多类型的读请求
- 碎片合并时自动清理数据缓存
- 使用后台任务限速来限制预热时的带宽
- 默认收集读放大相关指标
- 挂载时验证配置文件中的文件系统名
- 使用配置文件中保存的密码
- 允许通过环境变量
HOSTNAME定制客户端的机器名 - 减少缓存相关的锁竞争
- 支持 CIDR 格式的缓存节点 IP
- 客户端重连次数遵守
--io-retries参数 - 默认启用 FUSE 的
EnableReadDirPlusAuto功能以使能内核优化 - 确保源集群连上后才允许访问可写镜像集群,避免出现错误
- 当镜像不可用时访问源集群以避免不可用
- 使用镜像的文件系统名作为挂载点的名称
- 修复多个文件系统的指标混到一起的问题
- 调整数据复制时的监控,减少预期内的错误请求的噪音
- 当支持 Ceph 的客户端损坏时自动重新下载
- Windows: 默认在关闭文件时持久化数据
- Windows: 改进后台挂载
- Windows: 新增
-–create-perm挂载选项 - Windows: 支持定制文件系统名
- Windows: 将 administrator 用户的 UID 设为 0(与 Linux 的 root 用户一致)
- Windows: 支持 DirectIO
- Windows: 优化挂载速度
- 优化淘汰磁盘缓存时的锁竞争
- 不再重试超时的分布式缓存请求
- mount: fstab 默认新增
- Bug 修复
- 解决 statvfs 在配置了
--block-interrupt时可能卡住的问题 - 修复 fstab 中的挂载选项可能不正确的问题
- 修复集群模式运行 sync 时 umask 不正确的问题
- 修复并发执行 auth 命令时可能失败的问题
- 修复可写镜像的 ping 指标不准确的问题
- 修复标量类型指标的 0 值不上报的问题
- 修复内核缓存导致 append 模式写相互覆盖问题
- 修复镜像的原集群使用不同版本时的兼容性问题
- Windows: 修复 GID 映射问题
- 解决 statvfs 在配置了
JuiceFS 5.2.23 (2026/1/29)
- 改进
- 提升挂载子目录时
statfs的性能和稳定性
- 提升挂载子目录时
- Bug 修复
- 修复启用共享块设备时可能误将预期外的数据上传到对象存储的问题