如何使用Docker容器部署ApacheDoris并实现分布式查询-Docker-PHP中文网

用 Docker 部署 Apache Doris 实现分布式查询，核心是启动 1 个 FE 和 2 个 BE 容器，共用 bridge 网络并正确配置 FE_SERVERS 与 BE_ADDR；宿主机必须提前设置 vm.max_map_count=2000000，BE 才能注册成功并支持分布式查询。

如何使用docker容器部署apachedoris并实现分布式查询

用 Docker 部署 Apache Doris 并实现分布式查询，核心在于正确启动 FE（Frontend）和 BE（Backend）两个角色，并确保它们能互相发现、注册成功。单机上通过容器编排模拟分布式行为是完全可行的，不需要多台物理机。

必须提前配置的系统参数

Doris 的 BE 进程对 Linux 内存映射区域数量敏感，宿主机必须调高 vm.max_map_count，否则 BE 启动失败或状态异常：

执行命令临时生效：sudo sysctl -w vm.max_map_count=2000000
写入配置永久生效：echo "vm.max_map_count=2000000" | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
验证是否生效：sysctl vm.max_map_count，输出应为 2000000

使用 docker-compose 部署最小分布式集群

推荐采用 1 个 FE + 2 个 BE 的结构——这是功能完整、资源可控、又能体现“分布式查询”特性的最小组合。所有服务在同一台机器运行，但彼此独立，BE 会自动向 FE 注册并参与数据存储与计算分发。

创建 docker-compose.yml，内容如下：

version: '3.8'
services:
  doris-fe:
    image: apache/doris:2.0.0-fe-x86_64
    container_name: doris-fe
    environment:
      - FE_SERVERS=fe1:127.0.0.1:9010
      - FE_ID=1
    ports:
      - "8030:8030"  # Web UI
      - "9020:9020"  # RPC
      - "9030:9030"  # MySQL protocol
      - "9010:9010"  # Edit log
    volumes:
      - ./fe/conf:/opt/doris-fe/conf
      - ./fe/log:/opt/doris-fe/log
      - ./fe/data:/opt/doris-fe/doris-meta
    networks:
      - doris-net
<p>doris-be1:
image: apache/doris:2.0.0-be-x86_64
container_name: doris-be1
environment:</p>

FE_SERVERS=fe1:127.0.0.1:9010
BE_ADDR=127.0.0.1:9050 ports:
"8040:8040"
"9050:9050"
"9060:9060" volumes:
./be1/conf:/opt/doris-be/conf
./be1/log:/opt/doris-be/log
./be1/data:/opt/doris-be/storage depends_on:
doris-fe networks:
doris-net

doris-be2: image: apache/doris:2.0.0-be-x86_64 container_name: doris-be2 environment:

FE_SERVERS=fe1:127.0.0.1:9010
BE_ADDR=127.0.0.1:9051 ports:
"8041:8040"
"9051:9050"
"9061:9060" volumes:
./be2/conf:/opt/doris-be/conf
./be2/log:/opt/doris-be/log
./be2/data:/opt/doris-be/storage depends_on:
doris-fe networks:
doris-net

networks: doris-net: driver: bridge

关键点说明：

Docker Compose Optimizer

优化 Docker Compose 配置，适用于开发和生产环境——审计服务、网络、卷、健康检查和资源管理。

下载

两个 BE 使用不同端口映射（如 9050/9051），避免宿主机端口冲突
BE_ADDR 必须设为容器内可解析的地址（127.0.0.1 在容器内即本机），且与 FE 的 FE_SERVERS 中 IP 和端口一致
所有容器共用 doris-net 网络，保障内部通信；FE 和 BE 之间不依赖宿主机 localhost，而是走 Docker 内网

验证分布式查询能力

集群启动后，需确认 BE 已成功加入并能协同处理查询：

启动命令：docker-compose up -d，等待约 2–3 分钟
检查状态：docker-compose ps，所有服务应显示 Up
连接 MySQL 客户端：mysql -h 127.0.0.1 -P 9030 -u root
执行诊断 SQL：

-- 查看前端节点（应有 1 行，Join 和 Alive 均为 true）
SELECT host, join, alive FROM frontends();
<p>-- 查看后端节点（应有 2 行，Alive 均为 true）
SELECT host, port, alive FROM backends();</p><p>-- 创建测试表（Doris 自动按 BE 数量分片）
CREATE TABLE test_dist (
id BIGINT,
name STRING,
dt DATE
) DISTRIBUTED BY HASH(id) BUCKETS 10;</p><p>-- 插入少量数据
INSERT INTO test_dist VALUES (1, 'Alice', '2026-05-07'), (2, 'Bob', '2026-05-07');</p><p>-- 执行查询（FE 会将任务拆解，调度到多个 BE 并行执行）
SELECT COUNT(*) FROM test_dist;
</p>

若 backends() 返回两行且 alive=true，且 COUNT(*) 查询能秒级返回结果，即表明分布式查询链路已通。