Linux下GlusterFS搭建教程详解

本文系统梳理了在Linux环境下搭建GlusterFS分布式文件系统时最常遭遇的四大“拦路虎”——服务端启动失败、peer探测异常、volume创建报错及客户端挂载卡死，并直击根源：看似是配置问题，实则多由端口冲突、网络/防火墙阻断、brick所在文件系统不兼容（如btrfs或overlayfs）或服务状态未就绪等底层环境不一致所致；通过清晰的排查路径——从进程与端口清理、跨节点连通性验证、扩展属性与挂载点规范检查，到volume启停与客户端依赖配置——帮助运维人员快速定位真因，避免在错误方向上耗费大量时间，尤其强调多节点部署中文件系统类型、挂载方式和网络策略必须严格统一，否则可能引发静默故障，防不胜防。

GlusterFS 服务端启动失败，glusterd 报 Address already in use

常见于重复启动或残留进程未清理。GlusterFS 的 glusterd 默认监听 24007 端口，若该端口被占用（比如上次异常退出后 glusterd 还在后台运行），就会卡住。

• 先执行 ps aux | grep glusterd 查看残留进程，用 kill -9 杀掉
• 再检查端口： 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 24007 或 nc -zv 24007
• 关闭 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/

GlusterFS 的坑大多藏在“看似配置对了，其实网络、权限、文件系统三者之一没对齐”——尤其是多节点部署时，每个 brick 的文件系统类型和挂载方式必须完全一致，否则上线后某天突然只读或静默丢数据，排查起来比重搭还费时间。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~