> 适用场景：

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