# Apache Doris FE Docker 启动问题排错与解决总结

> 适用场景：

> - Windows + Docker Desktop

> - 单机学习 / 测试 Apache Doris

> - 使用官方镜像 `apache/doris:fe-2.1.10`

---

一、背景说明

在使用 Docker 启动 Apache Doris FE（Frontend）过程中，先后遇到了以下两个问题：

1. **FE 启动失败，提示 priority_networks 不包含当前 IP**

2. **简化启动命令后，FE 又提示缺少必要参数**

本文记录完整的 **问题现象 → 原因分析 → 正确做法**，帮助后续快速避坑。

---

二、问题一：priority_networks 配置导致 FE 启动失败

1️⃣ 现象

FE 启动日志中出现错误：

```text

ERROR FrontendOptions.initAddrUseIp()

ip address range configured for priority_networks does not include the current IP address

```

---

2️⃣ 原因分析

• Doris FE 对 `priority_networks` 有严格校验

• Docker 容器 IP 与宿主机 IP 网段不一致

• `0.0.0.0/0` 不会被 Doris 识别为合法兜底网段

---

3️⃣ 结论

> ❗ 单机 Docker / 学习环境

> **不要手动配置 `priority_networks`**

---

三、问题二：Missing required parameters

1️⃣ 现象

```text

ERROR Entrypoint: Missing required parameters. Please check documentation.

```

---

2️⃣ 原因分析

FE 镜像不是开箱即用，必须提供：

• `FE_SERVERS`

• `FE_ID`

---

四、正确的单机 FE 启动方式（推荐）

```powershell

docker run -d --name doris-fe `

-p 8030:8030 `

-p 9010:9010 `

-e FE_SERVERS=fe1:127.0.0.1:9010 `

-e FE_ID=1 `

-v doris-fe-meta:/opt/apache-doris/fe/doris-meta `

-v doris-fe-log:/opt/apache-doris/fe/log `

apache/doris:fe-2.1.10

```

---

五、启动验证

```powershell

docker logs -f doris-fe

```

Web UI：

```

http://localhost:8030

```

账号：root

密码：空

---

六、经验总结

• 单机 Docker 不配置 priority_networks

• FE 必须指定 FE_ID / FE_SERVERS

• 使用 127.0.0.1 更稳妥

---

七、后续建议

• 部署 BE

• Docker Compose

• Doris 架构理解

---

> 总结：

> **Doris 启动失败，大多是参数理解问题，而不是镜像问题。**