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

> 适用场景：

> - Windows + Docker Desktop

> - 单机学习 / 测试 Apache Doris

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

一、背景说明

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

**FE 启动失败，提示 priority_networks 不包含当前 IP**
**简化启动命令后，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 启动失败，大多是参数理解问题，而不是镜像问题。**