Ubuntu 22 集群部署 Apache Doris 3.0.3 笔记
Ubuntu 22 集群部署 Apache Doris 3.0.3 笔记
1. 集群部署架构概览
本文介绍如何在多台 Ubuntu 22.04 服务器上部署 Apache Doris 集群。典型部署结构如下：
- 1~3 台 FE（Frontend）节点（建议奇数台，以实现高可用）
- 多台 BE（Backend）节点（建议至少 2 台以上）
- 所有节点需安装相同版本的 Doris，并保证时间同步、网络互通。
示例架构如下：
| 节点角色 | 主机名 | 内网 IP |
|---|---|---|
| FE 主节点 | doris-fe-1 | 192.168.1.101 |
| FE 副节点 | doris-fe-2 | 192.168.1.102 |
| FE 副节点 | doris-fe-3 | 192.168.1.103 |
| BE 节点1 | doris-be-1 | 192.168.1.201 |
| BE 节点2 | doris-be-2 | 192.168.1.202 |
| BE 节点3 | doris-be-3 | 192.168.1.203 |
2. 基础准备工作
关于 Doris 的下载、解压、目录命名、JAVA_HOME 设置、ulimit 设置等内容，本文不再赘述，详见上一篇Ubuntu 22 安装 Apache Doris 3.0.3 笔记
请确保每台节点的 Doris 安装目录结构一致，例如都解压到
/opt/doris/apache-doris。
3. 配置并启动 FE 主节点
在 FE 主节点（192.168.1.101） 上进行以下配置：
3.1 修改 fe/conf/fe.conf
如有需要，可调整内存：
JAVA_OPTS_FOR_JDK_17="-Xmx2G -Xms1G ..."
3.2 启动 FE 主节点
cd /opt/doris/apache-doris/fe/bin
./start_fe.sh --daemon
确认日志输出无异常：
tail -f ../log/fe.log
4. 添加 FE 副节点（从节点）
在 FE 副节点（192.168.1.102 和 192.168.1.103） 上：
不要手动启动副 FE 节点！
❗FE 副节点 不能直接启动，而是通过
--helper参数由主节点引导启动，否则会造成元数据冲突或启动失败。
4.1 启动副 FE 节点（使用 --helper）
在副节点上执行：
cd /opt/doris/apache-doris/fe/bin
./start_fe.sh --helper 192.168.1.101:9010 --daemon
其中 9010 是 FE 的默认 RPC 通信端口。
4.2 登录 FE 主节点，添加 FOLLOWER
mysql -h 192.168.1.101 -P 9030 -u root
执行：
ALTER SYSTEM ADD FOLLOWER "192.168.1.102:9010";
ALTER SYSTEM ADD FOLLOWER "192.168.1.103:9010";
SHOW FRONTENDS;
确保副节点状态为 FOLLOWER，Alive 为 true。
5. 配置并添加 BE 节点
在每台 BE 节点（192.168.1.201~203）上进行如下配置：
5.1 修改 be/conf/be.conf
可选内存配置：
JAVA_OPTS="-Xmx2G -Xms1G"
5.2 启动 BE
cd /opt/doris/apache-doris/be/bin
./start_be.sh --daemon
5.3 登录 FE 主节点，添加 BE
ALTER SYSTEM ADD BACKEND "192.168.1.201:9050";
ALTER SYSTEM ADD BACKEND "192.168.1.202:9050";
ALTER SYSTEM ADD BACKEND "192.168.1.203:9050";SHOW BACKENDS;
确认所有 BE 状态为 Alive，LastHeartbeat 正常。
6. 常见问题与建议
❗FE 从节点启动顺序错误
不要直接运行 start_fe.sh 启动副本节点，一定使用：
./start_fe.sh --helper <主FE IP>:9010
否则会启动失败或无法加入集群。
如果没有用–helper参数启动fe导致无法加入集群
若错误使用了 --daemon 启动 FE 导致无法加入集群，请执行以下步骤清理：
cd /opt/doris/apache-doris/fe
rm -rf doris-meta/*
rm -rf log/*
然后使用正确命令重新启动：
./bin/start_fe.sh --helper 192.168.1.101:9010 --daemon
参考资料
- Apache Doris 官方文档
- Ubuntu 22 安装 Apache Doris 3.0.3 笔记
