GeekIt

GlusterFS命令速查

服务管理、集群 peer、卷创建与启停、参数调优、扩缩容、自愈、客户端挂载、快照、地理复制、配额与报错排查等 138 条命令

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

命令说明复制
systemctl start glusterd启动 Gluster 管理服务,所有节点都要启动
systemctl enable glusterd设置开机自启
systemctl status glusterd查看服务状态与最近日志
systemctl restart glusterd重启管理服务,重启后会自动恢复卷状态
systemctl stop glusterd停止管理服务(会卸载本节点 brick)
gluster --version查看客户端与服务端版本,集群内版本应保持一致
ss -lntp | grep -E "24007|24008|4915"确认 24007 管理、24008 brick 与 49152+ 数据端口
tail -f /var/log/glusterfs/glusterd.log管理服务日志,peer 与卷操作失败先看这里
tail -f /var/log/glusterfs/bricks/*.logbrick 进程日志,读写异常看这里
gluster volume status all启动后确认各卷 brick 进程状态
ps -ef | grep gluster确认 glusterd 与 brick 进程是否存活
防火墙需放通 24007-24008 与 49152-49200端口不通会导致 peer probe 与挂载失败
命令说明复制
gluster peer probe node2把节点加入可信存储池(只需在一个节点执行)
gluster peer status查看节点连接状态与 UUID
gluster pool list列出存储池内所有节点及状态
gluster peer detach node2移除节点(需先迁走该节点的 brick)
gluster peer detach node2 force强制移除失联节点,可能造成数据不完整
ls /var/lib/glusterd/peers/查看本地保存的 peer 信息文件
gluster peer status --all查看包括已断开节点在内的完整状态
cat /var/lib/glusterd/glusterd.info查看本节点 UUID 与版本
节点主机名必须可解析,且各节点时间同步hostname 不一致或时钟偏差会导致 peer 反复断开
gluster pool list扩容后确认新节点已进入存储池
命令说明复制
gluster volume create gv0 replica 3 node1:/data/br1 node2:/data/br1 node3:/data/br1 force创建三副本分布式卷,force 允许非空目录
gluster volume create gv0 replica 2 node1:/data/br1 node2:/data/br1双副本卷,节省空间但容错较低
gluster volume create gv0 replica 3 arbiter 1 node1:/data/br1 node2:/data/br1 node3:/data/br1仲裁卷:第三副本只存元数据,兼顾一致性与成本
gluster volume create gv0 disperse 4 redundancy 1 node1:/data/br1 node2:/data/br1 node3:/data/br1 node4:/data/br1纠删码卷:4 数据块 1 冗余,空间利用率更高
gluster volume create gv0 node1:/data/br1 node2:/data/br2纯分布式卷,无副本,容量大但不保证可靠
gluster volume create gv0 replica 3 transport tcp node1:/data/br1 node2:/data/br1 node3:/data/br1显式指定传输协议
mkdir -p /data/br1 && xfs_info /data创建 brick 目录并确认文件系统支持扩展属性
brick 目录建议独立挂盘并使用 XFSbrick 不要与其他业务共用分区,避免 IO 争抢
gluster volume info gv0创建后确认卷类型、brick 与状态
gluster volume start gv0新卷创建后必须手动启动
命令说明复制
gluster volume list列出所有卷
gluster volume info查看全部卷的定义
gluster volume info gv0查看指定卷的类型、brick 与选项
gluster volume status gv0查看 brick 进程、端口与在线状态
gluster volume status gv0 detailbrick 明细:磁盘使用、inode 与 pid
gluster volume status gv0 clients查看已挂载的客户端列表
gluster volume status all mem查看各 brick 进程内存占用
gluster volume start gv0启动卷
gluster volume stop gv0停止卷(会断开客户端)
gluster volume stop gv0 force有客户端连接时强制停止
gluster volume delete gv0删除卷定义,brick 目录需手动清理
gluster volume get gv0 all导出该卷全部选项当前值
gluster volume statedump gv0生成卷状态转储,用于深度排查
命令说明复制
gluster volume set gv0 performance.cache-size 1GB读缓存大小,热数据场景可加大
gluster volume set gv0 performance.io-thread-count 32IO 线程数,按 CPU 核数调整
gluster volume set gv0 performance.readdir-ahead on目录预读,海量小文件场景可关闭对比
gluster volume set gv0 network.ping-timeout 42客户端心跳超时,网络抖动大时可调大
gluster volume set gv0 nfs.disable on关闭内置 NFS,避免端口冲突与安全问题
gluster volume set gv0 auth.allow 10.0.0.*限制允许挂载的客户端网段
gluster volume set gv0 cluster.quorum-type auto开启 quorum,避免脑裂时继续写入
gluster volume set gv0 cluster.server-quorum-type server服务端 quorum 判定,与服务端节点数配合
gluster volume set gv0 features.shard on大文件分片,减少单文件锁竞争
gluster volume set gv0 storage.owner-uid 1000统一 brick 文件属主,解决权限不一致
gluster volume set gv0 diagnostics.brick-log-level INFO调整 brick 日志级别,排查期临时开启
gluster volume reset gv0恢复该卷全部选项默认值
gluster volume set gv0 network.remote-dio off关闭远程 DIO,部分应用写入异常时尝试
命令说明复制
gluster volume add-brick gv0 replica 4 node4:/data/br1 force扩容副本数并新增节点
gluster volume add-brick gv0 node4:/data/br2分布式卷追加 brick 提升容量
gluster volume rebalance gv0 start扩容后重平衡数据分布
gluster volume rebalance gv0 status查看重平衡进度
gluster volume rebalance gv0 stop停止重平衡
gluster volume remove-brick gv0 replica 2 node4:/data/br1 start开始缩容,数据迁移到剩余节点
gluster volume remove-brick gv0 replica 2 node4:/data/br1 status查看迁移进度
gluster volume remove-brick gv0 replica 2 node4:/data/br1 commit迁移完成后提交,真正移除 brick
gluster volume remove-brick gv0 replica 2 node4:/data/br1 stop中止缩容操作
gluster volume replace-brick gv0 node4:/data/br1 node5:/data/br1 commit force坏盘替换:把 brick 迁到新节点
gluster volume replace-brick gv0 node4:/data/br1 node5:/data/br1 abort中止替换操作
缩容 commit 前务必确认 status 显示完成提前 commit 会丢失尚未迁移的数据
命令说明复制
gluster volume heal gv0 info查看待修复文件清单
gluster volume heal gv0 info summary待修复与已修复数量汇总
gluster volume heal gv0 info healed查看已修复的文件
gluster volume heal gv0 info split-brain列出脑裂文件
gluster volume heal gv0 full触发全量自愈(耗时长,避开高峰期)
gluster volume heal gv0 enable开启自愈
gluster volume heal gv0 disable临时关闭自愈,减少 IO 压力
gluster volume heal gv0 split-brain source-brick node1:/data/br1指定可信副本作为脑裂修复源
gluster volume heal gv0 split-brain delete删除脑裂条目,保留源副本内容
getfattr -d -m . -e hex /data/br1/file查看文件的 glusterfs 扩展属性,判断版本与锁状态
gluster volume status gv0 detail确认 brick 都在线后再触发自愈
自愈期间 IO 会明显升高全量自愈建议在业务低峰执行并监控负载
命令说明复制
mount -t glusterfs node1:/gv0 /mnt/gv0挂载卷到本地目录
mount -t glusterfs node1:/gv0 /mnt/gv0 -o backup-volfile-servers=node2:node3配置备用节点,首节点故障时自动切换
mount -t glusterfs node1:/gv0 /mnt/gv0 -o ro只读挂载
mount -t glusterfs node1:/gv0 /mnt/gv0 -o acl启用 POSIX ACL
node1:/gv0 /mnt/gv0 glusterfs defaults,_netdev,backup-volfile-servers=node2:node3 0 0/etc/fstab 自动挂载写法
umount /mnt/gv0卸载
umount -l /mnt/gv0延迟卸载,进程占用时使用
df -h /mnt/gv0确认容量与挂载状态
gluster volume set gv0 auth.allow 10.0.0.*挂载失败时检查客户端网段是否被允许
tail -f /var/log/glusterfs/mnt-gv0.log客户端挂载日志,排查卡住与断连
客户端需安装 glusterfs-fuse仅装 glusterfs-server 不足以挂载
命令说明复制
gluster snapshot create snap1 gv0为卷创建快照
gluster snapshot create snap1 gv0 no-timestamp不追加时间戳,便于脚本固定命名
gluster snapshot list列出所有快照
gluster snapshot info snap1查看快照详情与创建时间
gluster snapshot activate snap1激活快照(才能挂载读取)
gluster snapshot deactivate snap1停用快照
gluster snapshot restore snap1把卷恢复到快照状态(会回滚数据)
gluster snapshot restore snap1 force强制恢复,需停止卷与客户端访问
gluster snapshot delete snap1删除快照
gluster snapshot config查看快照数量与软硬限制
gluster snapshot config snap-max-hard-limit 5限制每卷最多保留 5 个快照
快照会占用额外空间brick 所在磁盘要为快照预留容量
命令说明复制
gluster volume geo-replication gv0 ssh://node2::gv1 create push-pem force建立主备卷之间的异步复制
gluster volume geo-replication gv0 ssh://node2::gv1 start启动复制
gluster volume geo-replication gv0 ssh://node2::gv1 status查看复制状态与延迟
gluster volume geo-replication gv0 ssh://node2::gv1 stop暂停复制,维护备端时使用
gluster volume geo-replication gv0 ssh://node2::gv1 config查看复制参数
gluster volume geo-replication gv0 ssh://node2::gv1 config checkpoint now设置检查点,确认某时间点数据已同步
gluster volume geo-replication gv0 ssh://node2::gv1 config log-level INFO调整复制日志级别
gluster volume geo-replication gv0 ssh://node2::gv1 delete删除复制关系
地理复制是异步的延迟取决于网络与变更量,不能当作实时双活
备端卷需提前创建且结构匹配备端容量不足会导致复制中断
命令说明复制
gluster volume quota gv0 enable开启卷配额
gluster volume quota gv0 limit-usage /data 10GB限制 /data 目录最多使用 10GB
gluster volume quota gv0 limit-usage /projects/a 5GB按子目录设置不同额度
gluster volume quota gv0 list查看配额使用情况
gluster volume quota gv0 default-soft-limit 80%软限制,超过后开始告警
gluster volume set gv0 features.quota-deem-statfs on让客户端 df 显示配额容量而不是实际容量
gluster volume quota gv0 disable关闭配额
配额与目录服务会带来额外开销海量小文件场景建议按大目录设置,避免过细
df -h 与 quota list 数值不一致时先确认 deem-statfs 与配额是否已生效
命令说明复制
peer probe: failed: node2 is already part of another cluster节点已在别的集群,需在该节点重置 glusterd 状态
volume create: failed: brick is being usedbrick 目录已被其他卷占用,换目录或先清理
Transport endpoint is not connected客户端与服务端断连,检查网络与 brick 状态,必要时重新挂载
volume status 显示 brick 为 N/Abrick 进程未启动,查 glusterd 与 brick 日志
Heal 长期不结束检查是否有 brick 离线、磁盘满或文件被持续写入
split-brain 文件无法读写用 heal info split-brain 定位,选定源副本后修复
No space left on devicebrick 所在分区满,扩容或清理,注意保留快照空间
connection refused(24007)glusterd 未启动或防火墙拦截
Mount failed: Connection refused挂载地址错误、卷未启动或客户端缺 fuse
Stale file handle文件在服务端被移动或删除,客户端缓存失效,重挂解决
write failed: Read-only file system触发 quorum 或卷被只读,检查在线节点数
volume add-brick 报 replica count 错误副本数必须能被 brick 总数整除,调整参数或分批扩容
客户端写入极慢查 brick 磁盘 IO、网络延迟与 performance.io-thread-count
peer 状态反复 disconnecthostname 解析、时钟同步或端口不通,逐项排查

运维常用组合

集群初始化systemctl start glusterd → gluster peer probe node2 → gluster pool list → mkdir brick → volume create → volume start
创建三副本卷volume create gv0 replica 3 node1:/data/br1 node2:/data/br1 node3:/data/br1 force → volume start gv0 → volume info gv0 → 客户端挂载
扩容peer probe node4 → volume add-brick → volume rebalance start → status → 完成后再挂载新节点
故障自愈volume status gv0 detail → volume heal gv0 info summary → volume heal gv0 full → 观察 healed 与 split-brain
客户端接入mount -t glusterfs node1:/gv0 /mnt/gv0 -o backup-volfile-servers=node2:node3 → df -h → 写测试 → 加入 fstab
容量治理quota enable → limit-usage → features.quota-deem-statfs on → quota list 巡检

常见问题排查

1. 副本数要能整除 brick 数

创建与扩容时副本数必须与 brick 数匹配,否则命令直接拒绝

2. brick 要独立磁盘

brick 目录放在独立分区,避免与系统盘或其他业务争抢 IO

3. quorum 必须开

不开 quorum 时网络分区会导致脑裂写入,事后修复代价极高

4. 自愈要定期看

heal info 长期有积压说明有 brick 异常或空间不足,别等业务报错才发现

5. 缩容先等迁移完成

remove-brick 的 status 显示完成后才能 commit,提前提交会丢数据

6. 版本与时间要统一

各节点 glusterfs 版本不一致、时钟偏差大会导致 peer 与自愈异常

共 138 条 GlusterFS 命令 · 示例中的节点名 node1、卷名 gv0 与 brick 路径请替换为实际环境

关于GlusterFS命令速查

在线 GlusterFS 命令速查手册,按服务与进程管理、集群与节点管理、卷创建、卷启停与查询、卷参数调优、扩容与缩容、自愈与一致性、客户端挂载、快照、地理复制、配额与目录限制、常见报错与排查等 12 类场景整理 140+ 条常用命令,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 systemctl 启停 glusterd 与 24007/24008/49152 端口与 glusterd.log 与 bricks 日志、gluster peer probe/status/detach 与 pool list 与 /var/lib/glusterd/peers、volume create 的 replica 2/3 与 arbiter 1 与 disperse 4 redundancy 1 与 force/transport tcp 与 brick 目录规划、volume list/info/status detail/clients/all mem/start/stop/delete/get all/statedump、volume set 的 performance.cache-size/performance.io-thread-count/performance.readdir-ahead/network.ping-timeout/nfs.disable/auth.allow/cluster.quorum-type/cluster.server-quorum-type/features.shard/storage.owner-uid/diagnostics.brick-log-level 与 volume reset、volume add-brick 与 remove-brick start|status|commit|stop 与 replace-brick commit|abort 与 rebalance start|status|stop、volume heal 的 info/info summary/healed/split-brain/full/enable/disable 与 split-brain source-brick|delete 与 getfattr 扩展属性、mount -t glusterfs 与 backup-volfile-servers 与 fstab 写法与 umount 与 mnt-gv0.log、snapshot create|list|info|activate|deactivate|restore|delete|config 与 snap-max-hard-limit、geo-replication create/start/status/stop/config/checkpoint/delete 与 ssh:// 形式、quota enable/limit-usage/list/default-soft-limit 与 features.quota-deem-statfs,以及 peer probe already part of another cluster、brick is being used、Transport endpoint is not connected、brick N/A、split-brain、No space left on device、Connection refused、Stale file handle、Read-only file system 等报错排查。适用于 GlusterFS 分布式存储部署与运维、卷类型选型与副本规划、扩缩容与数据重平衡、自愈与脑裂修复、客户端挂载与高可用接入、快照备份、跨机房地理复制、目录配额治理,以及存储运维与面试复习。

核心能力

  • 涵盖 systemctl 启停 glusterd 与 24007/24008/49152 端口与 glusterd.log 与 bricks 日志、gluster peer probe/status/detach 与 pool list 与 /var/lib/glusterd/peers、volume create 的 replica 2/3 与 arbiter 1 与 disperse 4 redundancy 1 与 force/transport tcp 与 brick 目录规划、volume list/info/status detail/clients/all mem/start/stop/delete/get all/statedump、volume set 的 performance.cache-size/performance.io-thread-count/performance.readdir-ahead/network.ping-timeout/nfs.disable/auth.allow/cluster.quorum-type/cluster.server-quorum-type/features.shard/storage.owner-uid/diagnostics.brick-log-level 与 volume reset、volume add-brick 与 remove-brick start|status|commit|stop 与 replace-brick commit|abort 与 rebalance start|status|stop、volume heal 的 info/info summary/healed/split-brain/full/enable/disable 与 split-brain source-brick|delete 与 getfattr 扩展属性、mount -t glusterfs 与 backup-volfile-servers 与 fstab 写法与 umount 与 mnt-gv0.log、snapshot create|list|info|activate|deactivate|restore|delete|config 与 snap-max-hard-limit、geo-replication create/start/status/stop/config/checkpoint/delete 与 ssh:// 形式、quota enable/limit-usage/list/default-soft-limit 与 features.quota-deem-statfs,以及 peer probe already part of another cluster、brick is being used、Transport endpoint is not connected、brick N/A、split-brain、No space left on device、Connection refused、Stale file handle、Read-only file system 等报错排查

适用场景

适用于 GlusterFS 分布式存储部署与运维、卷类型选型与副本规划、扩缩容与数据重平衡、自愈与脑裂修复、客户端挂载与高可用接入、快照备份、跨机房地理复制、目录配额治理,以及存储运维与面试复习。GlusterFS命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

GlusterFS命令速查是免费的吗?需要注册或安装吗?
GlusterFS命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
GlusterFS命令速查支持哪些功能?
涵盖 systemctl 启停 glusterd 与 24007/24008/49152 端口与 glusterd.log 与 bricks 日志、gluster peer probe/status/detach 与 pool list 与 /var/lib/glusterd/peers、volume create 的 replica 2/3 与 arbiter 1 与 disperse 4 redundancy 1 与 force/transport tcp 与 brick 目录规划、volume list/info/status detail/clients/all mem/start/stop/delete/get all/statedump、volume set 的 performance.cache-size/performance.io-thread-count/performance.readdir-ahead/network.ping-timeout/nfs.disable/auth.allow/cluster.quorum-type/cluster.server-quorum-type/features.shard/storage.owner-uid/diagnostics.brick-log-level 与 volume reset、volume add-brick 与 remove-brick start|status|commit|stop 与 replace-brick commit|abort 与 rebalance start|status|stop、volume heal 的 info/info summary/healed/split-brain/full/enable/disable 与 split-brain source-brick|delete 与 getfattr 扩展属性、mount -t glusterfs 与 backup-volfile-servers 与 fstab 写法与 umount 与 mnt-gv0.log、snapshot create|list|info|activate|deactivate|restore|delete|config 与 snap-max-hard-limit、geo-replication create/start/status/stop/config/checkpoint/delete 与 ssh:// 形式、quota enable/limit-usage/list/default-soft-limit 与 features.quota-deem-statfs,以及 peer probe already part of another cluster、brick is being used、Transport endpoint is not connected、brick N/A、split-brain、No space left on device、Connection refused、Stale file handle、Read-only file system 等报错排查。
GlusterFS命令速查适合哪些场景使用?
适用于 GlusterFS 分布式存储部署与运维、卷类型选型与副本规划、扩缩容与数据重平衡、自愈与脑裂修复、客户端挂载与高可用接入、快照备份、跨机房地理复制、目录配额治理,以及存储运维与面试复习。