GeekIt

Ceph命令速查

集群健康、MON 与配置、OSD 与 PG、存储池、RBD、CephFS、RGW、CRUSH、认证与性能排障等 182 条命令

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

命令说明复制
ceph -s集群总览:健康状态、OSD 数量、PG 状态、容量与 IO
ceph status同 ceph -s,排障第一句
ceph -w持续观察集群状态变化,执行操作时开着很直观
ceph health只看健康摘要
ceph health detail健康告警明细,每条告警都带处理建议
ceph health mute PG_DEGRADED临时屏蔽已知告警,避免告警风暴(维护窗口用)
ceph health unmute PG_DEGRADED取消屏蔽
ceph df容量使用率:全局与各存储池
ceph df detail容量明细,含可用空间与对象数
ceph versions各组件版本分布,升级前后核对
ceph fsid查看集群 FSID,多集群环境必备
ceph log last 50查看集群最近 50 条事件
ceph orch ps查看各 daemon 运行状态(需启用 orchestrator)
ceph orch device ls查看各节点可用磁盘与使用状态
命令说明复制
ceph mon statMON 集群成员与角色
ceph mon dumpMON 详细配置:quorum、地址与选举策略
ceph quorum_status查看 quorum 成员与 leader
ceph mon_statusMON 内部状态,排查选举问题
ceph tell mon.* injectargs "--debug_mon 1/5"临时调整 MON 调试级别
ceph config dump导出全部生效配置,排查参数是否被覆盖
ceph config get mon查看 MON 组件的配置项
ceph config get osd osd_mclock_profile查看单个配置项当前值
ceph config set global osd_pool_default_size 3修改全局默认副本数
ceph config set osd osd_max_backfills 2限制回填并发,避免影响业务 IO
ceph config show osd.0查看指定 daemon 的完整配置
ceph config assimilate-conf -i /etc/ceph/ceph.conf把 ceph.conf 中的配置导入集群 config 库
ceph mgr module ls查看 mgr 模块启用情况
ceph mgr services查看 mgr 暴露的服务地址(Dashboard、Prometheus)
命令说明复制
ceph osd treeOSD 拓扑:主机、机架、权重与 up/in 状态
ceph osd df tree按拓扑查看各 OSD 容量与使用率
ceph osd statOSD 总数、up/in 数量
ceph osd metadata 0查看 OSD 所在设备、主机与 CRUSH 位置
ceph osd perf各 OSD 的提交与应用延迟,定位慢盘
ceph osd out 0把 OSD 移出数据分布,迁数据前用
ceph osd in 0把 OSD 重新加入数据分布
ceph osd down 0标记 OSD 为 down,模拟故障或维护
ceph osd reweight 0 0.8临时降低 OSD 权重,缓解单盘写满
ceph osd safe-to-destroy osd.0判断该 OSD 是否可安全下线(不会丢数据)
ceph osd ok-to-stop osd.0判断停掉该 OSD 是否会造成 PG 不可用
ceph osd purge 0 --yes-i-really-mean-it彻底移除 OSD 及其 CRUSH 条目与认证
ceph osd lost 0 --yes-i-really-mean-it标记 OSD 永久丢失,触发副本重建
ceph osd crush remove osd.0从 CRUSH map 中移除该 OSD
ceph-volume lvm list查看 ceph-volume 管理的 OSD 与 LV 对应关系
ceph-volume lvm zap /dev/sdb --destroy清空磁盘准备重新部署(危险,确认设备名)
ceph orch apply osd --all-available-devices自动把空闲磁盘部署为 OSD
命令说明复制
ceph pg statPG 状态汇总:active+clean 比例与数量
ceph pg dump导出全部 PG 明细,量大建议配合 grep
ceph pg dump_stuck inactive查找卡住无法处理的 PG
ceph pg dump_stuck unclean查找未达到 clean 的 PG
ceph pg dump_stuck stale查找长时间未上报的 PG(OSD 可能失联)
ceph pg map 1.0查看 PG 的副本分布与 acting/up 集合
ceph pg 1.0 query查看单个 PG 的详细状态与历史
ceph pg scrub 1.0触发轻量一致性校验
ceph pg deep-scrub 1.0深度校验,能发现静默数据损坏
ceph pg repair 1.0尝试修复不一致的 PG
ceph pg ls-by-pool mypool按存储池列出 PG
ceph pg ls-by-osd osd.0按 OSD 列出 PG,下线前评估影响
ceph osd pool set mypool pg_num 128调整 PG 数(只能增加)
ceph osd pool set mypool pgp_num 128PG 数调整后同步 pgp_num 才会真正重分布
ceph osd pool set mypool pg_autoscale_mode on开启 PG 自动伸缩,新集群推荐
ceph osd pool autoscale-status查看各池建议的 PG 数
ceph osd set norebalance暂停数据重平衡,维护期减少 IO 争抢
ceph osd unset norebalance恢复重平衡
命令说明复制
ceph osd pool create mypool 64创建存储池并指定初始 PG 数
ceph osd pool create mypool replicated myrule指定 CRUSH 规则创建副本池
ceph osd pool ls detail查看所有池的副本、PG 与参数
ceph osd pool get mypool size查看副本数
ceph osd pool set mypool size 3设置副本数与全局默认保持一致
ceph osd pool set mypool min_size 2最小可用副本数,低于该值池会拒绝写
ceph osd pool application enable mypool rbd标注池用途(rbd/cephfs/rgws),否则报 POOL_APP_NOT_ENABLED
ceph osd pool stats各池的 IOPS、带宽与恢复速率
ceph osd pool set mypool quota_max_bytes 1099511627776限制池容量上限(1TB)
ceph osd pool set mypool quota_max_objects 1000000限制池对象数量上限
ceph osd pool set mypool target_size_ratio 0.2配合自动伸缩设置容量占比
ceph osd pool rename old new重命名存储池
ceph osd pool delete mypool mypool --yes-i-really-really-mean-it删除池(需先开启 mon_allow_pool_delete)
ceph config set mon mon_allow_pool_delete true允许删除存储池,操作完建议关掉
命令说明复制
rbd create --size 10240 mypool/myimage创建 10GB 块设备镜像
rbd ls mypool列出池内镜像
rbd info mypool/myimage查看大小、特性与对象分布
rbd resize --size 20480 mypool/myimage扩容镜像
rbd resize --size 10240 --allow-shrink mypool/myimage缩容需显式允许,且要确认文件系统支持
rbd feature disable mypool/myimage exclusive-lock关闭特性以兼容老内核客户端
rbd snap create mypool/myimage@snap20261102创建快照
rbd snap ls mypool/myimage查看快照列表
rbd snap rollback mypool/myimage@snap20261102回滚到快照(会覆盖当前数据)
rbd snap purge mypool/myimage删除该镜像全部快照
rbd map mypool/myimage映射为本地块设备
rbd unmap /dev/rbd0解除映射,删除镜像前必须先 unmap
rbd du mypool/myimage查看实际占用(精简置备下小于逻辑大小)
rbd diff mypool/myimage查看对象级差异,用于增量备份
rbd export mypool/myimage /backup/myimage.bin导出镜像为文件
rbd import /backup/myimage.bin mypool/myimage从文件导入镜像
rbd mirror pool enable mypool image开启镜像级跨集群复制
rbd mirror image status mypool/myimage查看复制状态与延迟
rbd trash ls mypool查看回收站镜像
rbd trash restore mypool/<image-id>从回收站恢复镜像
命令说明复制
ceph fs ls列出文件系统
ceph fs status文件系统状态:MDS、数据池与客户端数
ceph fs volume create cephfs一键创建文件系统(需 orchestrator)
ceph fs dump查看文件系统详细配置与 MDS 映射
ceph fs add_data_pool cephfs cephfs_data2新增数据池扩容底层存储
ceph mds stat查看 MDS 角色与状态
ceph fs set cephfs max_mds 2提升 active MDS 数量,提高元数据并发
ceph fs fail cephfs标记文件系统失败(MDS 异常时的应急操作)
ceph fs subvolumegroup create cephfs group1创建子卷组,做多租户隔离
ceph fs subvolume create cephfs vol1 group1 --size 10737418240创建带配额的子卷
ceph fs subvolume ls cephfs列出子卷
ceph auth get-or-create client.cephfs mon 'allow r' mds 'allow rw' osd 'allow rw pool=cephfs_data'创建文件系统客户端认证
mount -t ceph 10.0.0.1:6789:/ /mnt/cephfs -o name=cephfs,secret=<key>内核客户端挂载(需先获取 key)
ceph fs status cephfs --format jsonJSON 输出便于监控采集
命令说明复制
radosgw-admin user list列出对象存储用户
radosgw-admin user create --uid=app --display-name="App"创建 S3 用户并生成 access/secret key
radosgw-admin user info --uid=app查看用户信息与密钥
radosgw-admin key create --uid=app --key-type=s3 --gen-access-key为新用户追加密钥
radosgw-admin bucket list列出全部 bucket
radosgw-admin bucket stats --bucket=bucket1查看桶的对象数、容量与分片
radosgw-admin bucket check --bucket=bucket1校验桶索引与对象一致性
radosgw-admin quota set --quota-scope=user --uid=app --max-size=10G设置用户容量配额
radosgw-admin quota enable --quota-scope=user --uid=app启用配额
radosgw-admin user rm --uid=app删除用户(先清理其 bucket)
radosgw-admin sync status多区域复制状态,延迟大时看这里
radosgw-admin realm list查看 realm
radosgw-admin zonegroup list查看 zonegroup
radosgw-admin zone list查看 zone 与端点
radosgw-admin gc list查看待回收对象,堆积说明 GC 跟不上
radosgw-admin gc process --include-all手动触发 GC
命令说明复制
ceph osd crush dump查看 CRUSH map 结构(JSON)
ceph osd getcrushmap -o /tmp/crush.bin导出 CRUSH map 二进制
crushtool -d /tmp/crush.bin -o /tmp/crush.txt反编译为可编辑文本
crushtool -c /tmp/crush.txt -o /tmp/crush-new.bin编译回二进制
ceph osd setcrushmap -i /tmp/crush-new.bin应用新的 CRUSH map(会触发数据迁移)
ceph osd crush rule list列出所有规则
ceph osd crush rule dump replicated_rule查看规则细节:故障域与设备类
ceph osd crush rule create-replicated ssd_rule default host ssd创建按主机为故障域的 SSD 规则
ceph osd crush class create nvme创建设备类
ceph osd crush set-device-class nvme osd.0把 OSD 划入设备类
ceph osd crush move node2 root=default调整节点在拓扑中的归属
ceph osd crush reweight osd.0 2.0调整 OSD 权重(按容量比例设置)
ceph osd crush weight-set ls查看兼容权重集
修改 CRUSH 前先导出备份错误的故障域配置会导致副本集中在同一台机器
命令说明复制
ceph auth list列出所有认证实体与权限
ceph auth get client.admin查看 admin 的 key 与 caps
ceph auth get-or-create client.rbd mon 'profile rbd' osd 'profile rbd pool=rbd'按最小权限创建 RBD 客户端
ceph auth caps client.rbd mon 'allow r' osd 'allow rw pool=rbd'修改已有实体的权限
ceph auth del client.rbd删除认证实体
ceph auth print-key client.admin打印指定实体的密钥
ceph auth export -o /tmp/keyring.backup导出全部密钥做备份
ceph auth import -i /tmp/keyring.backup从备份导入密钥
ceph auth get-or-create-key client.xxx mon 'allow r'只输出 key,便于脚本注入
权限遵循最小可用原则按 pool 授权,避免 osd allow *
命令说明复制
ceph osd set noout维护期禁止标记 OSD out,避免触发大规模迁移
ceph osd unset noout维护结束恢复
ceph osd set nodown禁止 OSD 被标记 down(谨慎,可能掩盖真实故障)
ceph osd set noscrub && ceph osd set nodeep-scrub暂停校验,减少维护期 IO 压力
ceph osd unset noscrub && ceph osd unset nodeep-scrub恢复校验
ceph orch restart osd重启全部 OSD 服务(orchestrator)
ceph orch redeploy mgr重新部署指定守护进程
ceph crash ls查看守护进程崩溃记录
ceph crash info <crash-id>查看崩溃堆栈
ceph crash archive-all归档崩溃记录,清理告警
ceph daemon osd.0 status查看单个 OSD 运行时状态
ceph daemon osd.0 config show查看 OSD 实际生效配置
ceph daemon osd.0 perf dumpOSD 性能计数器,定位慢请求
ceph tell osd.* injectargs "--debug_osd 1/5"临时开启 OSD 调试日志
ceph osd pool set mypool noscrub 1单池暂停 scrub
systemctl restart ceph-osd@0重启指定 OSD(传统部署方式)
命令说明复制
ceph osd perf各 OSD 延迟排名,先找最慢的盘
ceph osd pool stats池级 IOPS 与带宽,判断压力来源
rados bench -p mypool 60 write --no-cleanup写入压测 60 秒,保留测试数据
rados bench -p mypool 60 seq顺序读压测
rados bench -p mypool 60 rand随机读压测
rados -p mypool cleanup清理压测产生的数据
rbd bench --io-type write --io-size 4096 --io-threads 16 --io-total 1G mypool/myimage块存储随机写压测
rbd bench --io-type read --io-size 4096 --io-threads 16 --io-total 1G mypool/myimage块存储读压测
ceph mgr module enable prometheus开启 Prometheus 模块
ceph mgr services获取 Prometheus 抓取地址(默认 9283)
curl http://mgr:9283/metrics | grep ceph_osd抓取 OSD 相关指标
ceph config set osd osd_mclock_profile high_client_ops调整 IO 调度策略,优先客户端请求
ceph config set osd osd_recovery_max_active 3限制恢复并发,保护业务 IO
ceph config set osd osd_max_backfills 2限制回填并发,缓解恢复期卡顿
ceph -s 关注 apply/commit 延迟延迟持续升高多为磁盘瓶颈或网络抖动

运维常用组合

日常巡检ceph -s → ceph health detail → ceph osd tree → ceph df → ceph osd perf
新建存储池ceph osd pool create mypool 64 → set size/min_size → application enable rbd → pg_autoscale_mode on → ceph df
扩容与下线ceph osd safe-to-destroy → ceph osd out → 等 PG 恢复 clean → ceph osd purge → 移除磁盘
PG 异常处理ceph pg dump_stuck inactive → ceph pg map → ceph pg 1.0 query → ceph pg repair / deep-scrub
RBD 备份恢复rbd snap create → rbd export → rbd import → rbd snap rollback → rbd trash restore
性能排查ceph osd perf → ceph osd pool stats → ceph daemon osd.0 perf dump → rados bench 对比基线

常见问题排查

1. 先看 ceph -s

健康状态、PG 分布、容量与延迟一屏看完,90% 的问题能在这里定位方向

2. PG 数要合理

PG 过少导致分布不均,过多增加恢复与心跳开销;新集群开 pg_autoscale_mode

3. 维护先 noout

重启节点前 set noout,避免 OSD 被判 down 触发大规模数据迁移

4. 副本数与 min_size

size=3 时 min_size 应为 2,否则挂一台机器整个池就拒绝写入

5. 慢盘会拖垮整个池

用 ceph osd perf 找延迟高的 OSD,及时 reweight 或替换

6. 容量红线

使用率超过 85% 要立即扩容,接近 95% 集群会停止写入

共 182 条 Ceph 命令 · 示例中的池名 mypool、OSD 编号与集群地址请替换为实际环境

关于Ceph命令速查

在线 Ceph 命令速查手册,按集群状态与健康、MON 与配置管理、OSD 管理、PG 与数据恢复、存储池管理、RBD 块存储、CephFS 文件存储、RGW 对象存储、CRUSH 与设备类、认证与密钥、运维操作与故障处理、性能压测与监控等 12 类场景整理 170+ 条常用命令,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 ceph -s 与 ceph -w 与 ceph health detail 与 health mute/unmute、ceph df detail 与 versions 与 fsid 与 log last、mon stat/dump/quorum_status/mon_status 与 injectargs、config dump/get/set/show/assimilate-conf、mgr module ls 与 mgr services、osd tree 与 osd df tree 与 osd stat 与 osd metadata 与 osd perf 与 osd out/in/down 与 osd reweight 与 safe-to-destroy 与 ok-to-stop 与 osd purge/lost 与 ceph-volume lvm list/zap、pg stat 与 pg dump 与 dump_stuck inactive/unclean/stale 与 pg map 与 pg query 与 pg scrub/deep-scrub/repair 与 pg ls-by-pool/ls-by-osd 与 pg_num/pgp_num 与 pg_autoscale_mode 与 autoscale-status、osd pool create/ls detail/get/set/application enable/stats/quota_max_bytes/target_size_ratio/rename/delete 与 mon_allow_pool_delete、rbd create/ls/info/resize/feature disable/snap create|ls|rollback|purge/map|unmap/du/diff/export|import/mirror pool enable/mirror image status/trash、ceph fs ls/status/volume create/dump/add_data_pool/set max_mds/fail 与 mds stat 与 subvolume/subvolumegroup 与内核挂载、radosgw-admin user list/create/info/key create/bucket list/stats/check/quota set/enable/sync status/realm/zonegroup/zone/gc list|process、crush dump/getcrushmap/crushtool/setcrushmap/rule list|dump|create-replicated/class create/set-device-class/move/reweight、auth list/get/get-or-create/caps/del/print-key/export/import、noout/nodown/noscrub/nodeep-scrub 与 orch ps/restart/redeploy/apply osd 与 crash ls/info/archive-all 与 daemon perf dump、rados bench write/seq/rand 与 rbd bench 与 mgr prometheus 与 osd_mclock_profile/osd_recovery_max_active。适用于 Ceph 分布式存储日常运维、集群健康巡检与告警处理、OSD 扩容与安全下线、PG 异常与数据恢复、存储池规划与配额、RBD 快照备份与扩容、CephFS 多租户子卷、RGW 用户桶与配额、CRUSH 故障域调整、性能瓶颈定位,以及存储运维与面试复习。

核心能力

  • 涵盖 ceph -s 与 ceph -w 与 ceph health detail 与 health mute/unmute、ceph df detail 与 versions 与 fsid 与 log last、mon stat/dump/quorum_status/mon_status 与 injectargs、config dump/get/set/show/assimilate-conf、mgr module ls 与 mgr services、osd tree 与 osd df tree 与 osd stat 与 osd metadata 与 osd perf 与 osd out/in/down 与 osd reweight 与 safe-to-destroy 与 ok-to-stop 与 osd purge/lost 与 ceph-volume lvm list/zap、pg stat 与 pg dump 与 dump_stuck inactive/unclean/stale 与 pg map 与 pg query 与 pg scrub/deep-scrub/repair 与 pg ls-by-pool/ls-by-osd 与 pg_num/pgp_num 与 pg_autoscale_mode 与 autoscale-status、osd pool create/ls detail/get/set/application enable/stats/quota_max_bytes/target_size_ratio/rename/delete 与 mon_allow_pool_delete、rbd create/ls/info/resize/feature disable/snap create|ls|rollback|purge/map|unmap/du/diff/export|import/mirror pool enable/mirror image status/trash、ceph fs ls/status/volume create/dump/add_data_pool/set max_mds/fail 与 mds stat 与 subvolume/subvolumegroup 与内核挂载、radosgw-admin user list/create/info/key create/bucket list/stats/check/quota set/enable/sync status/realm/zonegroup/zone/gc list|process、crush dump/getcrushmap/crushtool/setcrushmap/rule list|dump|create-replicated/class create/set-device-class/move/reweight、auth list/get/get-or-create/caps/del/print-key/export/import、noout/nodown/noscrub/nodeep-scrub 与 orch ps/restart/redeploy/apply osd 与 crash ls/info/archive-all 与 daemon perf dump、rados bench write/seq/rand 与 rbd bench 与 mgr prometheus 与 osd_mclock_profile/osd_recovery_max_active

适用场景

适用于 Ceph 分布式存储日常运维、集群健康巡检与告警处理、OSD 扩容与安全下线、PG 异常与数据恢复、存储池规划与配额、RBD 快照备份与扩容、CephFS 多租户子卷、RGW 用户桶与配额、CRUSH 故障域调整、性能瓶颈定位,以及存储运维与面试复习。Ceph命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Ceph命令速查是免费的吗?需要注册或安装吗?
Ceph命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Ceph命令速查支持哪些功能?
涵盖 ceph -s 与 ceph -w 与 ceph health detail 与 health mute/unmute、ceph df detail 与 versions 与 fsid 与 log last、mon stat/dump/quorum_status/mon_status 与 injectargs、config dump/get/set/show/assimilate-conf、mgr module ls 与 mgr services、osd tree 与 osd df tree 与 osd stat 与 osd metadata 与 osd perf 与 osd out/in/down 与 osd reweight 与 safe-to-destroy 与 ok-to-stop 与 osd purge/lost 与 ceph-volume lvm list/zap、pg stat 与 pg dump 与 dump_stuck inactive/unclean/stale 与 pg map 与 pg query 与 pg scrub/deep-scrub/repair 与 pg ls-by-pool/ls-by-osd 与 pg_num/pgp_num 与 pg_autoscale_mode 与 autoscale-status、osd pool create/ls detail/get/set/application enable/stats/quota_max_bytes/target_size_ratio/rename/delete 与 mon_allow_pool_delete、rbd create/ls/info/resize/feature disable/snap create|ls|rollback|purge/map|unmap/du/diff/export|import/mirror pool enable/mirror image status/trash、ceph fs ls/status/volume create/dump/add_data_pool/set max_mds/fail 与 mds stat 与 subvolume/subvolumegroup 与内核挂载、radosgw-admin user list/create/info/key create/bucket list/stats/check/quota set/enable/sync status/realm/zonegroup/zone/gc list|process、crush dump/getcrushmap/crushtool/setcrushmap/rule list|dump|create-replicated/class create/set-device-class/move/reweight、auth list/get/get-or-create/caps/del/print-key/export/import、noout/nodown/noscrub/nodeep-scrub 与 orch ps/restart/redeploy/apply osd 与 crash ls/info/archive-all 与 daemon perf dump、rados bench write/seq/rand 与 rbd bench 与 mgr prometheus 与 osd_mclock_profile/osd_recovery_max_active。
Ceph命令速查适合哪些场景使用?
适用于 Ceph 分布式存储日常运维、集群健康巡检与告警处理、OSD 扩容与安全下线、PG 异常与数据恢复、存储池规划与配额、RBD 快照备份与扩容、CephFS 多租户子卷、RGW 用户桶与配额、CRUSH 故障域调整、性能瓶颈定位,以及存储运维与面试复习。