> 适用场景：
> - 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：
```
```
账号：root
密码：空
六、经验总结
-
单机 Docker 不配置 priority_networks
-
FE 必须指定 FE_ID / FE_SERVERS
-
使用 127.0.0.1 更稳妥
七、后续建议
-
部署 BE
-
Docker Compose
-
Doris 架构理解
> 总结：
> **Doris 启动失败，大多是参数理解问题，而不是镜像问题。**