GeekIt

JuiceFS命令速查

格式化挂载、元数据引擎、对象存储、缓存参数、客户端诊断、配额回收、sync 同步、备份迁移、网关与排障等 142 条命令

共 142 条命令 · 12 类场景 · 点击右侧图标可复制

命令 / 参数说明复制
juicefs version查看客户端版本,跨版本挂载同一卷要保证兼容
juicefs format --storage s3 --bucket https://bucket.s3.amazonaws.com redis://127.0.0.1:6379/1 myjfs初始化文件系统:指定对象存储与元数据引擎
juicefs format --storage minio --bucket http://10.0.0.11:9000/data --access-key AK --secret-key SK redis://127.0.0.1:6379/1 myjfs对接 MinIO 等 S3 兼容存储
juicefs format --block-size 4096 --compress zstd --trash-days 1 redis://127.0.0.1:6379/1 myjfs初始化参数:块大小、压缩算法与回收站保留天数
juicefs mount -d redis://127.0.0.1:6379/1 /mnt/jfs后台挂载到本地目录
juicefs mount redis://127.0.0.1:6379/1 /mnt/jfs前台挂载,便于观察日志
juicefs mount --cache-dir /data/cache --cache-size 102400 --free-space-ratio 0.05 redis://127.0.0.1:6379/1 /mnt/jfs指定缓存目录、缓存容量(MiB)与磁盘最小剩余比例
juicefs mount --writeback redis://127.0.0.1:6379/1 /mnt/jfs开启回写模式:先写本地缓存再异步上传,适合小文件
juicefs mount --read-only redis://127.0.0.1:6379/1 /mnt/jfs只读挂载,做数据校验或灾备读取
redis://127.0.0.1:6379/1 /mnt/jfs juicefs _netdev,defaults 0 0写入 /etc/fstab 实现开机自动挂载
juicefs umount /mnt/jfs卸载文件系统
juicefs umount -f /mnt/jfs强制卸载,进程占用时使用
juicefs status redis://127.0.0.1:6379/1查看卷名、UUID、块大小与已用空间
juicefs status /mnt/jfs通过挂载点查看客户端与卷状态
命令 / 参数说明复制
redis://[:password@]127.0.0.1:6379/1Redis 元数据地址,生产建议哨兵或集群
redis://:pass@redis-master:6379/1带密码的 Redis 地址写法
mysql://user:pass@(10.0.0.21:3306)/juicefsMySQL 元数据地址
postgres://user:pass@10.0.0.21:5432/juicefs?sslmode=disablePostgreSQL 元数据地址
tikv://10.0.0.31:2379,10.0.0.32:2379/juicefsTiKV 元数据地址,超大规模场景
badger:///var/lib/juicefs/meta单机 Badger 元数据,本地测试常用
sqlite3:///var/lib/juicefs/meta.dbSQLite 元数据,仅适合单机验证
juicefs status mysql://user:pass@(10.0.0.21:3306)/juicefs查看元数据引擎中的卷信息
juicefs config redis://127.0.0.1:6379/1查看卷级配置:回收站天数、是否只读等
juicefs config redis://127.0.0.1:6379/1 --trash-days 7修改回收站保留天数
juicefs config redis://127.0.0.1:6379/1 --capacity 10995116277760设置卷容量上限,用于配额保护
元数据引擎是单点,务必做高可用Redis 建议主从+哨兵,MySQL 建议主从,否则元数据故障会导致全部挂载不可用
命令 / 参数说明复制
--storage s3 --bucket https://bucket.s3.ap-east-1.amazonaws.comAWS S3 配置写法
--storage minio --bucket http://10.0.0.11:9000/jfsMinIO 配置写法,需带桶名
--storage oss --bucket https://jfs.oss-cn-hangzhou.aliyuncs.com阿里云 OSS 配置写法
--storage ceph --bucket http://10.0.0.12:8080/jfsCeph RGW 配置写法
export ACCESS_KEY=AK && export SECRET_KEY=SK用环境变量传凭据,避免写入命令历史
juicefs objbench --storage s3 --bucket https://bucket --access-key AK --secret-key SK对象存储基准测试,评估上传下载能力
juicefs config redis://127.0.0.1:6379/1 --storage查看当前卷使用的存储类型
对象存储桶不建议开启版本控制版本控制会与 JuiceFS 的块回收逻辑冲突,导致空间无法释放
对象存储与元数据要同区域跨区域访问会显著增加延迟并产生流量费用
凭据建议用 IAM 角色或密钥管理服务避免长期 AK/SK 硬编码在脚本里
命令 / 参数说明复制
--cache-dir /data/cache缓存目录,生产建议独立 SSD
--cache-size 102400缓存上限(MiB),按本地磁盘容量设置
--free-space-ratio 0.05缓存盘保留的最小剩余比例
--cache-partial-only只缓存小文件与随机读,顺序读不占缓存
--writeback回写模式,写入先落本地再异步上传
--readahead 300预读大小(MiB),大文件顺序读可适当调大
--max-readahead 6144预读上限,避免占用过多内存
--attr-cache 1 --entry-cache 1 --dir-entry-cache 1元数据缓存时长(秒),高频 stat 场景可调大
--open-cache 0文件句柄缓存,0 表示关闭,减少元数据压力
--buffer-size 300读写缓冲区大小(MiB)
--max-uploads 20并发上传数,受对象存储限流约束
--heartbeat 12心跳间隔(秒),影响故障发现速度
--backup-meta 3600元数据自动备份间隔(秒),0 表示关闭
--no-bgjob关闭后台清理任务,客户端只做读写
--umask 022 --uid 1000 --gid 1000统一挂载后的文件权限与属主
命令 / 参数说明复制
juicefs status /mnt/jfs查看客户端会话、版本与缓存使用
juicefs stats /mnt/jfs实时指标:ops、带宽、缓存命中与对象存储请求
juicefs stats /mnt/jfs --interval 5每 5 秒刷新一次指标
juicefs profile /mnt/jfs开启性能剖析,观察慢请求分布
juicefs config /mnt/jfs --json以 JSON 输出当前客户端配置
juicefs info /mnt/jfs/path/file查看文件的 inode、块与对象映射
juicefs rmr /mnt/jfs/dir快速递归删除超大目录,比 rm -rf 更快
juicefs warmup /mnt/jfs/dataset --threads 16预热缓存,把数据提前拉取到本地
juicefs fsck redis://127.0.0.1:6379/1一致性检查:统计损坏或缺失的对象
juicefs gc redis://127.0.0.1:6379/1清理对象存储中的孤立块(默认只扫描)
juicefs gc redis://127.0.0.1:6379/1 --delete实际删除无引用的对象,释放空间
juicefs gc --compact压缩元数据引擎中的键,减小体积
tail -f /var/log/juicefs.log后台挂载日志位置(--log 可自定义)
命令 / 参数说明复制
juicefs status redis://127.0.0.1:6379/1查看卷的已用空间与文件数
juicefs df /mnt/jfs查看挂载点容量与使用率
juicefs quota set /mnt/jfs/team-a --capacity 10737418240为目录设置容量配额
juicefs quota set /mnt/jfs/team-a --inodes 1000000限制目录内文件数量
juicefs quota get /mnt/jfs/team-a查看目录配额使用情况
juicefs quota ls /mnt/jfs列出全部配额
juicefs quota check /mnt/jfs校验配额数据一致性(维护时执行)
juicefs config redis://127.0.0.1:6379/1 --trash-days 7设置回收站保留天数,0 表示立即删除
ls -la /mnt/jfs/.trash回收站目录,误删文件可在此恢复
juicefs status /mnt/jfs --jsonJSON 输出用于监控采集
删除大目录后空间未释放检查回收站与 gc 是否执行,对象回收有延迟
命令 / 参数说明复制
juicefs sync ./local /mnt/jfs/data本地目录同步到 JuiceFS
juicefs sync /mnt/jfs/data /backup/data从 JuiceFS 同步到本地
juicefs sync s3://bucket/prefix /mnt/jfs/data --threads 32对象存储直接同步进 JuiceFS
juicefs sync /mnt/jfs/data s3://bucket/prefixJuiceFS 数据导出到对象存储
juicefs sync src dst --delete-dst目标端多余文件一并删除(严格一致)
juicefs sync src dst --exclude "*.tmp" --exclude ".git/*"排除不需要同步的文件
juicefs sync src dst --start 2026-11-01 --end 2026-11-02按时间范围同步增量数据
juicefs sync src dst --limit 100000限制单个目录的文件数,控制单次任务规模
juicefs sync src dst --list-threads 8 --list-retry 3调整列举并发与重试次数
juicefs sync src dst --manager-addr 10.0.0.11:9001分布式同步:多客户端协同,需指定 manager
同步前先小批量试跑确认路径、权限与排除规则,避免误删
命令 / 参数说明复制
juicefs dump redis://127.0.0.1:6379/1 /backup/meta.json导出元数据快照(不含数据)
juicefs dump redis://127.0.0.1:6379/1 /backup/meta.json --subdir /team-a只导出指定子目录的元数据
juicefs load redis://127.0.0.1:6379/2 /backup/meta.json把元数据导入另一个卷
juicefs dump 与对象数据要配套备份只备份元数据无法恢复文件内容
juicefs sync /mnt/jfs/ /mnt/newjfs/ --threads 32跨卷迁移数据
先 format 新卷 → load 元数据 → sync 数据标准迁移顺序,顺序错误会导致元数据与数据不匹配
juicefs fsck redis://127.0.0.1:6379/1迁移后做一致性校验
juicefs config redis://127.0.0.1:6379/1 --backup-meta 3600开启元数据自动备份
备份策略:元数据每日 dump + 对象存储跨区域复制两层保护,兼顾 RPO 与成本
juicefs status 校验恢复后的卷信息确认卷名、UUID 与容量正确
命令 / 参数说明复制
juicefs gateway redis://127.0.0.1:6379/1 0.0.0.0:9000启动 S3 网关,让业务用 S3 协议访问
juicefs gateway --access-key AK --secret-key SK redis://127.0.0.1:6379/1 0.0.0.0:9000网关启用固定凭据
juicefs gateway --multi-buckets redis://127.0.0.1:6379/1 0.0.0.0:9000顶层目录映射为多个 bucket
juicefs webdav redis://127.0.0.1:6379/1 0.0.0.0:9009启动 WebDAV 服务,方便办公场景直接挂载
curl http://127.0.0.1:9000/minio/health/live网关健康检查
mc alias set jfs http://127.0.0.1:9000 AK SK用 mc 验证网关可用性
mc ls jfs/通过 S3 协议列出目录
网关适合只支持 S3 的应用性能与 POSIX 语义不如原生挂载,按场景选择
WebDAV 适合低并发文档场景大文件与高并发仍建议原生 FUSE 挂载
命令 / 参数说明复制
juicefs bench /mnt/jfs --block-size 1MiB --file-size 1GiB --threads 4综合基准测试:大文件与元数据操作
juicefs bench /mnt/jfs --bigfile-only只测大文件吞吐
juicefs bench /mnt/jfs --smallfile-only只测小文件与元数据性能
juicefs mdtest /mnt/jfs --threads 8元数据压力测试,评估创建/删除能力
juicefs objbench --storage s3 --bucket https://bucket对象存储基准,先确认底层带宽
juicefs stats /mnt/jfs观察缓存命中率与对象存储请求数
juicefs profile /mnt/jfs --interval 1定位慢请求时间分布
--max-uploads 50 --buffer-size 600提高上传并发与缓冲区,适合大文件顺序写
--upload-limit 200 --download-limit 200限制带宽(Mbps),避免占满专线
缓存命中率低时先扩缓存命中率长期低于 80% 说明缓存容量或策略不合适
小文件多要开 writeback并适当增大 --attr-cache 与 --entry-cache
juicefs profile 采集完记得关闭长期开启会产生额外开销
命令 / 参数说明复制
juicefs mount --read-only redis://127.0.0.1:6379/1 /mnt/jfs-ro只读挂载,供分析或备份读取
juicefs config redis://127.0.0.1:6379/1 --read-only直接把卷设为只读,所有客户端生效
--umask 027 --uid 1000 --gid 1000控制挂载后的文件权限,避免越权访问
redis://:password@host:6379/1元数据连接必须带密码,禁止无认证暴露
redis 配置 requirepass 与 bind 内网地址Redis 元数据泄露等于全量数据泄露
对象存储使用最小权限的子账号只授权指定桶的读写,不要给全账号权限
juicefs config redis://127.0.0.1:6379/1 --trash-days 0关闭回收站,删除即释放(谨慎)
juicefs dump 文件含目录结构元数据备份文件要按敏感数据管理
挂载点权限结合系统 ACL 使用多租户共享挂载时用目录权限隔离
命令 / 参数说明复制
database is not formatted元数据地址上没有卷,先执行 juicefs format
connection refused(redis/mysql)元数据引擎未启动、地址错误或网络不通
NOAUTH Authentication requiredRedis 需要密码,地址中补 :password@
fusermount: executable file not found缺少 fuse3 工具,安装 fuse3 并确认在 PATH
permission denied(挂载时)需要 root 或 fuse 权限,检查 /dev/fuse 与用户组
I/O error(读写时)多为对象存储不可用或凭据失效,看 juicefs.log
SignatureDoesNotMatch / AccessDeniedAK/SK 错误或桶权限不足
NoCredentialProviders未提供对象存储凭据,检查环境变量与参数
read-only file system卷被设为只读或元数据引擎异常,检查 juicefs config
cache dir is not writable缓存目录权限或磁盘满,检查 df 与属主
cannot allocate memory内存不足,下调 --buffer-size 与并发数
slow requests 持续出现用 juicefs profile 与 stats 对比是元数据慢还是对象存储慢
容量显示不释放删除进入回收站、gc 未运行或对象存储开启版本控制
mount 后卡住无响应元数据不可达时会长时间重试,先验证元数据连通性
juicefs fsck 报对象缺失从备份恢复对应文件,勿直接 gc --delete
多客户端看到的数据不一致检查元数据缓存参数与客户端时间同步

运维常用组合

初始化上线juicefs format --storage s3 --bucket ... redis://... myjfs → juicefs mount -d → df -h → juicefs status
迁移到新卷juicefs format 新卷 → juicefs load 元数据 → juicefs sync 数据 → juicefs fsck → 切换挂载
性能排查juicefs stats 看缓存命中 → juicefs profile 看慢请求 → juicefs objbench 测底层 → 调整 cache 与并发
空间回收检查 .trash → juicefs config --trash-days → juicefs gc --delete → df -h 复核
协议接入juicefs gateway redis://... 0.0.0.0:9000 → mc alias set → mc ls 验证 → 业务切 S3 接口
日常巡检juicefs status → juicefs df → juicefs quota ls → juicefs fsck

常见问题排查

1. 元数据引擎是核心

Redis/MySQL 一旦不可用,所有挂载点都会卡住,生产必须做主从或哨兵

2. 缓存盘要独立

缓存目录与业务盘分开,并设置 --free-space-ratio 防止写满系统盘

3. 写模式按场景选

大文件顺序写用默认模式,小文件多再考虑 --writeback

4. 回收站与 gc 配合

删除先进 .trash,过期后由 gc 清理对象,空间不是立即释放

5. dump 只备元数据

恢复必须元数据与对象存储数据配套,缺一不可

6. 先 objbench 再定架构

底层对象存储的延迟与带宽决定 JuiceFS 的上限,上线前先压测

共 142 条 JuiceFS 命令 · 示例中的元数据地址、桶名与挂载点请替换为实际环境

关于JuiceFS命令速查

在线 JuiceFS 命令速查手册,按格式化与挂载、元数据引擎、对象存储与凭据、缓存与挂载参数、客户端运维与诊断、容量配额与回收站、数据同步 sync、备份恢复与迁移、网关与协议访问、性能测试与调优、安全与权限、常见报错与排查等 12 类场景整理 140+ 条常用命令与参数,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 juicefs version/format 的 --storage s3|minio|oss|ceph 与 --bucket/--access-key/--secret-key/--block-size/--compress/--trash-days、juicefs mount -d 与 --cache-dir/--cache-size/--free-space-ratio/--writeback/--read-only/--readahead/--max-readahead/--attr-cache/--entry-cache/--dir-entry-cache/--open-cache/--buffer-size/--max-uploads/--heartbeat/--backup-meta/--no-bgjob/--umask/--uid/--gid 与 /etc/fstab 写法与 umount -f、元数据地址 redis:// 与 mysql:// 与 postgres:// 与 tikv:// 与 badger:// 与 sqlite3://、juicefs status/config 的 --trash-days/--capacity/--read-only、对象存储凭据环境变量与 objbench、juicefs stats/profile/info/rmr/warmup/fsck/gc --delete --compact、juicefs df 与 quota set/get/ls/check 的 capacity 与 inodes、.trash 回收站、juicefs sync 的 --threads/--delete-dst/--exclude/--start/--end/--limit/--list-threads/--list-retry/--manager-addr 与 s3:// 互同步、juicefs dump 的 --subdir 与 load 与迁移顺序、juicefs gateway 的 --access-key/--secret-key/--multi-buckets 与 juicefs webdav、juicefs bench 的 --bigfile-only/--smallfile-only 与 mdtest 与 profile、upload-limit/download-limit、挂载安全与 Redis 认证,以及 database is not formatted、connection refused、NOAUTH、fusermount not found、permission denied、I/O error、SignatureDoesNotMatch、NoCredentialProviders、read-only file system、cache dir is not writable、cannot allocate memory、容量不释放等报错排查。适用于 JuiceFS 云原生文件系统部署、POSIX 共享存储接入、元数据引擎选型与高可用、对象存储对接与凭据管理、缓存与写模式调优、数据迁移与元数据备份恢复、S3/WebDAV 协议访问、配额与回收站治理,以及存储运维与面试复习。

核心能力

  • 涵盖 juicefs version/format 的 --storage s3|minio|oss|ceph 与 --bucket/--access-key/--secret-key/--block-size/--compress/--trash-days、juicefs mount -d 与 --cache-dir/--cache-size/--free-space-ratio/--writeback/--read-only/--readahead/--max-readahead/--attr-cache/--entry-cache/--dir-entry-cache/--open-cache/--buffer-size/--max-uploads/--heartbeat/--backup-meta/--no-bgjob/--umask/--uid/--gid 与 /etc/fstab 写法与 umount -f、元数据地址 redis:// 与 mysql:// 与 postgres:// 与 tikv:// 与 badger:// 与 sqlite3://、juicefs status/config 的 --trash-days/--capacity/--read-only、对象存储凭据环境变量与 objbench、juicefs stats/profile/info/rmr/warmup/fsck/gc --delete --compact、juicefs df 与 quota set/get/ls/check 的 capacity 与 inodes、.trash 回收站、juicefs sync 的 --threads/--delete-dst/--exclude/--start/--end/--limit/--list-threads/--list-retry/--manager-addr 与 s3:// 互同步、juicefs dump 的 --subdir 与 load 与迁移顺序、juicefs gateway 的 --access-key/--secret-key/--multi-buckets 与 juicefs webdav、juicefs bench 的 --bigfile-only/--smallfile-only 与 mdtest 与 profile、upload-limit/download-limit、挂载安全与 Redis 认证,以及 database is not formatted、connection refused、NOAUTH、fusermount not found、permission denied、I/O error、SignatureDoesNotMatch、NoCredentialProviders、read-only file system、cache dir is not writable、cannot allocate memory、容量不释放等报错排查

适用场景

适用于 JuiceFS 云原生文件系统部署、POSIX 共享存储接入、元数据引擎选型与高可用、对象存储对接与凭据管理、缓存与写模式调优、数据迁移与元数据备份恢复、S3/WebDAV 协议访问、配额与回收站治理,以及存储运维与面试复习。JuiceFS命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

JuiceFS命令速查是免费的吗?需要注册或安装吗?
JuiceFS命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
JuiceFS命令速查支持哪些功能?
涵盖 juicefs version/format 的 --storage s3|minio|oss|ceph 与 --bucket/--access-key/--secret-key/--block-size/--compress/--trash-days、juicefs mount -d 与 --cache-dir/--cache-size/--free-space-ratio/--writeback/--read-only/--readahead/--max-readahead/--attr-cache/--entry-cache/--dir-entry-cache/--open-cache/--buffer-size/--max-uploads/--heartbeat/--backup-meta/--no-bgjob/--umask/--uid/--gid 与 /etc/fstab 写法与 umount -f、元数据地址 redis:// 与 mysql:// 与 postgres:// 与 tikv:// 与 badger:// 与 sqlite3://、juicefs status/config 的 --trash-days/--capacity/--read-only、对象存储凭据环境变量与 objbench、juicefs stats/profile/info/rmr/warmup/fsck/gc --delete --compact、juicefs df 与 quota set/get/ls/check 的 capacity 与 inodes、.trash 回收站、juicefs sync 的 --threads/--delete-dst/--exclude/--start/--end/--limit/--list-threads/--list-retry/--manager-addr 与 s3:// 互同步、juicefs dump 的 --subdir 与 load 与迁移顺序、juicefs gateway 的 --access-key/--secret-key/--multi-buckets 与 juicefs webdav、juicefs bench 的 --bigfile-only/--smallfile-only 与 mdtest 与 profile、upload-limit/download-limit、挂载安全与 Redis 认证,以及 database is not formatted、connection refused、NOAUTH、fusermount not found、permission denied、I/O error、SignatureDoesNotMatch、NoCredentialProviders、read-only file system、cache dir is not writable、cannot allocate memory、容量不释放等报错排查。
JuiceFS命令速查适合哪些场景使用?
适用于 JuiceFS 云原生文件系统部署、POSIX 共享存储接入、元数据引擎选型与高可用、对象存储对接与凭据管理、缓存与写模式调优、数据迁移与元数据备份恢复、S3/WebDAV 协议访问、配额与回收站治理,以及存储运维与面试复习。