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 笔记