> 适用场景：
> - 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 启动失败，大多是参数理解问题，而不是镜像问题。\*\*