这次我们来看一个在 Docker 环境下部署 Apache Doris 的实战项目。Doris 是一个高性能、实时的分析型数据库，但在 Docker 中部署时，FE（Frontend）和 BE（Backend）节点的配置与注册是新手最容易踩坑的地方。这篇文章不讲 Doris 有多好，直接告诉你如何用 Docker 把它跑起来，并解决节点注册失败、服务无法启动等常见问题。如果你正在搭建实时数仓、做数据分析，或者想快速体验 Doris 的功能，这篇文章会帮你避开部署路上的那些“坑”。我们将从 Docker 环境准备开始，一步步完成 FE 和 BE 节点的配置、启动、注册和验证，并给出详细的排查清单。整个过程不依赖复杂的 K8s 编排，单机 Docker 就能完成。1. 核心能力速览在动手之前，我们先快速了解在 Docker 中部署 Doris 的核心要点和门槛。能力项说明项目类型分析型数据库 (OLAP)开源团队Apache 软件基金会 (Apache Doris)部署方式Docker 容器化部署核心组件FE (Frontend) 节点、BE (Backend) 节点硬件门槛内存建议 4GB 以上，磁盘空间 10GB 以上。FE 对内存敏感，BE 对 I/O 和 CPU 敏感。网络要求FE 和 BE 容器间需要网络互通，通常使用 Docker 自定义网络。启动方式通过docker run命令或 Docker Compose 启动。配置重点FE 的元数据持久化、BE 的存储路径映射、节点 IP 地址的正确配置。是否支持 API是，通过 MySQL 协议 (端口 9030) 和 HTTP 协议 (端口 8030) 提供服务。适合场景本地开发测试、快速原型验证、学习 Doris 架构与功能。关键提醒：Docker 部署 Doris 主要用于测试和学习。生产环境部署涉及高可用、多副本、资源隔离等更复杂的配置，通常建议使用物理机或虚拟机。2. 适用场景与使用边界在 Docker 里跑 Doris，到底适合谁？能解决什么问题？又有哪些限制？这是部署前必须想清楚的。适合谁用？数据分析初学者：想快速了解 Doris 的基本操作和 SQL 语法，不想折腾复杂的本地编译或集群搭建。开发与测试人员：需要为应用程序提供一个本地的、隔离的 Doris 测试环境，验证数据导入、查询逻辑。架构师或运维：评估 Doris 的性能和特性，为生产环境选型做技术验证。能解决什么问题？环境快速就绪：几分钟内获得一个可运行的 Doris 实例，无需处理操作系统依赖、编译等问题。环境隔离与清理：测试完成后，直接删除容器和镜像即可，不影响宿主机环境。简化配置管理：通过 Docker 的卷（Volume）和网络（Network）管理数据持久化和组件通信。不适合什么场景？生产环境：Docker 部署通常无法满足生产环境对性能、高可用性、持久化存储和监控的高要求。大规模性能测试：Docker 的虚拟化开销、共享宿主资源等因素会影响性能测试结果的准确性。需要深度定制：如果需要修改 Doris 源码或使用特定版本的依赖库，Docker 镜像可能无法满足。使用边界与注意事项数据持久化：务必使用 Docker 卷或绑定挂载将 FE 的元数据目录和 BE 的存储目录持久化到宿主机，否则容器重启数据即丢失。资源限制：为容器设置合理的内存和 CPU 限制，避免单个容器占用过多资源影响宿主机。网络配置：确保 FE 和 BE 容器使用固定的主机名或 IP（通过自定义网络），这是节点成功注册的关键。3. 环境准备与前置条件开始部署前，请确保你的环境满足以下要求。我们将以 Linux（Ubuntu/CentOS）和 macOS 为例，Windows 用户建议使用 WSL2。1. 操作系统与 Docker操作系统：Linux (内核 3.10+)， macOS， 或 Windows 10/11 with WSL2。Docker Engine：版本 20.10.0 或更高。确保 Docker 服务已启动。Docker Compose：版本 v2 或更高（如果使用 Compose 部署）。这是可选但推荐的工具。检查命令：# 检查 Docker 版本 docker --version # 检查 Docker Compose 版本 docker compose version2. 系统资源内存：建议为 Docker 分配至少 4GB 内存。运行一个 FE 和一个 BE，容器内存分配建议各 2GB。磁盘空间：至少预留 10GB 可用空间，用于存放镜像、容器层和持久化数据。CPU：现代双核处理器即可。3. 网络与端口Doris 默认使用以下端口，请确保它们在宿主机上未被占用：FE:8030: HTTP 端口，用于 Web 前端和 REST API。9020: FE 内部 RPC 端口。9030: MySQL 协议端口，用于客户端连接（如 MySQL 客户端、JDBC）。