Apache Doris 2.1.5 超详细安装部署教程单机伪集群生产可用一、教程说明本教程适配CentOS 7/8、Ubuntu 18.04/20.04主流Linux系统采用单机伪集群部署1FE1BE开发/测试/小型生产环境通用全程无编译、直接使用官方二进制包零基础可一键复刻。本次安装版本Apache Doris 2.1.5LTS稳定版部署架构单节点 FE前端管理节点 单节点 BE后端存储计算节点包含内容环境初始化、依赖安装、参数优化、服务配置、启停服务、集群初始化、连接测试、开机自启、常见报错排查二、前置环境要求必做2.1 基础硬件要求服务器最低2核4G生产建议4核8G及以上磁盘普通机械盘/SSD均可建议单独数据盘避免系统盘占满网络关闭防火墙或开放Doris端口服务器固定内网IP禁止动态IP2.2 软件依赖要求操作系统Linux不支持Windows、Mac生产部署JDK版本OpenJDK 8u300及以上仅支持JDK8不支持JDK11/17系统工具wget、tar、vim、mysql-client必备2.3 系统参数优化生产必配置Doris对文件句柄、内存交换有严格要求需提前修改系统参数否则会启动失败或运行卡顿。1. 关闭Swap分区临时生效重启失效swapoff-a永久生效重启依旧有效sed-is/^\/.*swap/#/g/etc/fstab2. 调高文件句柄数编辑系统限制配置文件vim/etc/security/limits.conf文件末尾添加以下内容* soft nofile655350* hard nofile655350* soft nproc655350* hard nproc655350退出重新登录服务器执行ulimit -n验证返回655350即为成功。3. 修改内核参数编辑内核配置vim/etc/sysctl.conf添加以下参数vm.max_map_count2000000net.ipv4.tcp_tw_reuse1生效配置sysctl-p2.4 关闭防火墙SELinuxCentOS 7/8# 关闭防火墙systemctl stop firewalld systemctl disable firewalld# 关闭SELinuxsetenforce0sed-is/^SELINUXenforcing/SELINUXdisabled/g/etc/selinux/configUbuntuufw stop ufw disable三、安装依赖环境3.1 安装JDK8优先安装OpenJDK8免费无版权问题# CentOSyuminstall-yjava-1.8.0-openjdk-devel# Ubuntuaptupdateaptinstall-yopenjdk-8-jdk验证版本必须为JDK8java-version3.2 安装MySQL客户端Doris通过MySQL协议连接必须安装客户端# CentOSyuminstall-ymysql# Ubuntuaptinstall-ymysql-client3.3 创建专用用户禁止root运行官方禁止root用户启动Doris需新建普通用户# 创建doris用户useradddoris# 设置密码自定义passwddoris# 赋予目录权限chmod-R755/home/doris# 切换doris用户后续所有操作均用该用户su- doris四、下载并解压Doris安装包4.1 下载官方二进制包切换到doris用户根目录下载2.1.5稳定版cd/home/doriswgethttps://archive.apache.org/dist/doris/2.1.5/apache-doris-2.1.5-bin-x86_64.tar.gz4.2 解压文件tar-zxvfapache-doris-2.1.5-bin-x86_64.tar.gz# 重命名简化目录mvapache-doris-2.1.5-bin-x86_64 doris-2.1.54.3 创建数据、元数据、日志目录cd/home/doris/doris-2.1.5# FE元数据目录mkdir-pdoris-meta# BE数据存储目录mkdir-pbe/storage# 统一日志目录mkdir-pfe/log be/log五、FE节点配置与启动5.1 修改FE配置文件配置文件路径/home/doris/doris-2.1.5/fe/conf/fe.confvimfe/conf/fe.conf修改/新增以下核心配置注释原有默认配置粘贴以下内容# 服务器内网IP必须填写本机真实IP禁止127.0.0.1priority_networks你的服务器内网IP/24# FE元数据存储目录meta_dir/home/doris/doris-2.1.5/doris-meta# 最大连接数qe_max_connection1000# JVM内存配置4G服务器设2G8G设4G按需调整JAVA_OPTS-Xms2048m -Xmx2048m -XX:UseG1GC重点说明priority_networks必须配置多网卡服务器可避免IP识别错误是启动成功的关键。5.2 启动FE节点cd/home/doris/doris-2.1.5shfe/bin/start_fe.sh--daemon--daemon代表后台守护进程启动关闭终端不停止服务。5.3 检查FE启动状态# 查看进程jps|grepFE# 查看启动日志报错排查tail-ffe/log/fe.log出现Frontend startup success即为启动成功。六、BE节点配置、启动与集群绑定6.1 修改BE配置文件配置文件路径/home/doris/doris-2.1.5/be/conf/be.confvimbe/conf/be.conf修改核心配置# 本机内网IPpriority_networks你的服务器内网IP/24# BE数据存储目录storage_root_path/home/doris/doris-2.1.5/be/storage# JVM内存配置JAVA_OPTS-Xms2048m -Xmx2048m6.2 启动BE节点cd/home/doris/doris-2.1.5shbe/bin/start_be.sh--daemon6.3 将BE节点加入Doris集群核心步骤BE启动后未加入集群无法使用需通过MySQL客户端绑定。1. 连接Doris FEmysql -h你的服务器内网IP-P9030-uroot默认账号root默认密码无直接回车登录。2. 添加BE节点到集群ALTERSYSTEMADDBACKEND你的服务器内网IP:9050;3. 查看集群状态# 查看BE节点状态showbackends;# 查看FE节点状态showfrontends;状态为Alive: true即为集群部署成功。七、基础初始化配置必做7.1 修改root账号密码默认无密码存在安全风险建议立即修改SETPASSWORDFORroot%PASSWORD(自定义密码);7.2 创建普通用户业务使用CREATEUSERdoris_user%IDENTIFIEDBY自定义密码;# 赋予所有权限GRANTALLPRIVILEGESON*.*TOdoris_user%;FLUSHPRIVILEGES;7.3 测试建库建表验证可用性# 创建测试库CREATEDATABASEtest_db;USEtest_db;# 创建测试表CREATETABLEuser_info(idINT,nameVARCHAR(20),ageINT)DUPLICATEKEY(id)DISTRIBUTEDBYHASH(id)BUCKETS1PROPERTIES(replication_num1);# 插入测试数据INSERTINTOuser_infoVALUES(1,张三,22),(2,李四,25);# 查询数据SELECT*FROMuser_info;正常查询出数据代表Doris完全安装可用。八、服务启停命令8.1 启动服务# 启动FEsh/home/doris/doris-2.1.5/fe/bin/start_fe.sh--daemon# 启动BEsh/home/doris/doris-2.1.5/be/bin/start_be.sh--daemon8.2 停止服务# 停止FEsh/home/doris/doris-2.1.5/fe/bin/stop_fe.sh# 停止BEsh/home/doris/doris-2.1.5/be/bin/stop_be.sh九、设置开机自启生产推荐通过systemd配置开机自启服务器重启自动拉起Doris服务。9.1 FE开机自启vim/etc/systemd/system/doris-fe.service写入以下内容[Unit] DescriptionApache Doris FE Afternetwork.target [Service] Typeforking Userdoris ExecStart/home/doris/doris-2.1.5/fe/bin/start_fe.sh --daemon ExecStop/home/doris/doris-2.1.5/fe/bin/stop_fe.sh Restartalways [Install] WantedBymulti-user.target9.2 BE开机自启vim/etc/systemd/system/doris-be.service写入以下内容[Unit] DescriptionApache Doris BE Afternetwork.target [Service] Typeforking Userdoris ExecStart/home/doris/doris-2.1.5/be/bin/start_be.sh --daemon ExecStop/home/doris/doris-2.1.5/be/bin/stop_be.sh Restartalways [Install] WantedBymulti-user.target9.3 生效自启配置# 刷新配置systemctl daemon-reload# 设置开机自启systemctlenabledoris-fe systemctlenabledoris-be# 启动服务systemctl start doris-fe systemctl start doris-be十、核心端口说明防火墙放行必备端口服务作用9030FEMySQL客户端连接端口核心8040FEWeb管理页面端口9010FE集群内部通信端口9050BE集群内部通信端口8060BEBE监控端口十一、常见报错与排查方案1. FE启动失败日志报IP错误原因priority_networks配置错误使用127.0.0.1或公网IP解决修改为服务器真实内网IP重启FE2. BE状态为Dead原因端口占用、目录权限不足、swap未关闭解决关闭swap、检查doris用户目录权限、重启BE后重新添加节点3. 连接Doris提示拒绝连接原因防火墙未关闭、FE未启动、端口未放行解决关闭防火墙查看FE进程是否存在放行9030端口4. 文件句柄不足报错原因limits.conf未生效解决重新登录服务器执行ulimit -n验证确保数值为655350十二、Web管理页面访问浏览器访问http://服务器IP:8040登录账号root密码为你自定义的密码可可视化查看集群节点、数据库、表、任务状态。注部分内容可能由 AI 生成