glusterfs启动失败、peer探测失败、volume创建失败及客户端挂载失败的四大典型问题，分别由端口占用、网络/防火墙阻断、brick文件系统不兼容和volume未启动或客户端配置错误导致，需按顺序排查网络连通性、端口状态、文件系统支持性及服务运行状态。
GlusterFS 服务端启动失败，glusterd 报 Address already in use
常见于重复启动或残留进程未清理。GlusterFS 的 glusterd 默认监听 24007 端口，若该端口被占用（比如上次异常退出后 glusterd 还在后台运行），就会卡住。
- 先执行
ps aux | grep glusterd查看残留进程，用kill -9 <pid></pid>杀掉 - 再检查端口：
ss -tuln | grep :24007或lsof -i :24007 - 确认无占用后，手动删掉
/var/lib/glusterd/下的glusterd.info（仅测试环境；生产环境慎删，需先备份）可重置节点状态 - 最后用
systemctl start glusterd启动，systemctl status glusterd确认 Active (running)
添加 peer 失败，gluster peer probe 返回 Probe returned with unknown errno 107
这是典型的网络连通性或防火墙问题，不是 GlusterFS 自身配置错误。errno 107 对应 ENOTCONN，本质是 TCP 连接被拒绝或超时。
- 确保所有节点间能双向 ping 通，且
24007端口开放：telnet <peer-ip> 24007</peer-ip>或nc -zv <peer-ip> 24007</peer-ip> - 关闭 firewalld 或放行端口：
firewall-cmd --permanent --add-port=24007/tcp，然后firewall-cmd --reload - 检查 SELinux：临时设为 permissive 模式验证是否干扰：
setenforce 0；若解决，需配置对应策略而非长期禁用 - 注意：
gluster peer probe必须用 IP（非主机名），除非所有节点的/etc/hosts已精确映射且 DNS 解析稳定
创建 volume 时提示 Transport endpoint is not connected
说明 brick 路径不可达或挂载点未就绪。GlusterFS 不校验 brick 目录是否存在，但要求父目录可写、XATTR 支持正常、且底层文件系统兼容（ext4/xfs 推荐，不支持 btrfs 或 overlayfs）。
- 每个 brick 必须是独立挂载点下的子目录，例如
/bricks/brick1，不能是/home/brick1（/home 是根分区子目录） - 执行
getfattr -d /bricks/brick1验证是否支持扩展属性；若报错Operation not supported，说明文件系统不满足要求 - 确保 brick 所在磁盘已挂载且未满：
df -h /bricks，空余空间建议 ≥5% - 创建 volume 命令中路径必须完整且一致，例如：
gluster volume create myvol replica 2 transport tcp server1:/bricks/brick1 server2:/bricks/brick1
客户端 mount 失败，mount -t glusterfs 卡住或报 Connection refused
这不是 mount 命令本身的问题，而是客户端无法连接到 GlusterFS 的管理服务（即 glusterd），或者 volume 未启动。
- 先在服务端确认 volume 状态：
gluster volume list→gluster volume start myvol（如果显示Stopped） - 客户端需安装
glusterfs-client包（CentOS/RHEL 用yum install glusterfs-fuse，Debian/Ubuntu 用apt install glusterfs-client） - mount 命令必须指定一个在线的 peer IP，不能写 localhost：
mount -t glusterfs server1:/myvol /mnt/gluster - 若仍失败，加
-o log-level=DEBUG查日志：mount -t glusterfs -o log-level=DEBUG server1:/myvol /mnt/gluster，日志默认输出到/var/log/glusterfs/
