Elasticsearch服务器部署:从零到一完整启动+配置教程

张开发
2026/5/3 4:09:49 15 分钟阅读
Elasticsearch服务器部署:从零到一完整启动+配置教程
Elasticsearch服务器部署从零到一完整启动配置教程一、前言二、环境准备Elasticsearch 部署前置要求2.1 支持操作系统2.2 必备依赖三、整体流程Elasticsearch 启动配置流程图四、步骤1下载并安装 Elasticsearch4.1 官方下载地址4.2 Linux 安装命令以 7.17.0 为例4.3 Windows 安装五、步骤2Linux 环境必须配置解决启动报错5.1 创建普通用户ES 禁止 root 启动5.2 修改系统配置解决最大文件数/线程数报错5.3 修改内核配置解决虚拟内存报错六、步骤3JVM 内存配置jvm.options6.1 配置文件路径6.2 核心配置关键避免OOM七、步骤4核心配置elasticsearch.yml7.1 配置文件路径7.2 最常用必改配置完整可复制7.3 配置说明八、步骤5启动 Elasticsearch 服务器8.1 Linux 启动命令必须切换普通用户8.2 Windows 启动九、步骤6验证 ES 服务是否启动成功9.1 命令验证9.2 浏览器访问9.3 启动成功返回示例十、步骤7配置开机自启生产环境必备10.1 创建系统服务10.2 写入配置10.3 设置开机自启十一、常见启动报错及解决方案必看十二、总结结尾The Begin点点关注收藏不迷路一、前言Elasticsearch简称ES是一款非常流行的分布式搜索引擎正确启动与基础配置是使用ES的第一步。很多新手在部署时会遇到启动失败、内存溢出、外网无法访问、权限报错、跨域问题等各种坑。本文将以最详细、最规范、可直接落地的方式讲解 Elasticsearch 服务器下载、安装、启动、核心配置、开机自启全流程搭配流程图、命令、配置文件详解让你一次性成功部署ES。二、环境准备Elasticsearch 部署前置要求2.1 支持操作系统LinuxCentOS、Ubuntu 推荐生产环境Windows测试/开发环境macOS本地开发2.2 必备依赖JDK/JVMES 7.x 内置 JDK无需手动安装 Java内存至少 2GB 空闲内存生产推荐 4GB权限不能使用 root 用户直接启动Linux 必须创建普通用户三、整体流程Elasticsearch 启动配置流程图下载对应版本ES解压安装Linux创建普通用户修改系统配置 文件数、线程数修改jvmoptions内存配置修改elasticsearch.yml核心配置启动ES服务验证启动成功配置开机自启生产必备四、步骤1下载并安装 Elasticsearch4.1 官方下载地址https://www.elastic.co/cn/downloads/elasticsearch4.2 Linux 安装命令以 7.17.0 为例# 下载wgethttps://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.0-linux-x86_64.tar.gz# 解压tar-zxvfelasticsearch-7.17.0-linux-x86_64.tar.gz# 移动到安装目录mvelasticsearch-7.17.0 /usr/local/elasticsearch4.3 Windows 安装直接下载 zip 包 → 解压到任意目录不能带中文路径即可。五、步骤2Linux 环境必须配置解决启动报错5.1 创建普通用户ES 禁止 root 启动# 创建用户useraddesuser# 设置密码passwdesuser# 赋予文件夹权限chown-Resuser:esuser /usr/local/elasticsearch5.2 修改系统配置解决最大文件数/线程数报错vi/etc/security/limits.conf添加以下内容esuser soft nofile 65535 esuser hard nofile 65535 esuser soft nproc 4096 esuser hard nproc 40965.3 修改内核配置解决虚拟内存报错vi/etc/sysctl.conf添加vm.max_map_count262144生效配置sysctl-p六、步骤3JVM 内存配置jvm.options6.1 配置文件路径/usr/local/elasticsearch/config/jvm.options6.2 核心配置关键避免OOM# 初始内存 -Xms1g # 最大内存 -Xmx1g✅ 配置规则内存大小不超过物理内存的 50%不超过32GB避免内存浪费测试环境512m/1g生产环境2g/4g/8g七、步骤4核心配置elasticsearch.yml这是 ES最关键的配置文件决定服务能否外网访问、端口、集群名等。7.1 配置文件路径/usr/local/elasticsearch/config/elasticsearch.yml7.2 最常用必改配置完整可复制# 1. 集群名称cluster.name:es-cluster# 2. 节点名称node.name:es-node-1# 3. 数据存储路径path.data:/usr/local/elasticsearch/data# 4. 日志存储路径path.logs:/usr/local/elasticsearch/logs# 5. 绑定网卡0.0.0.0 代表所有IP可访问network.host:0.0.0.0# 6. http访问端口http.port:9200# 7. 集群通信端口transport.tcp.port:9300# 8. 跨域配置前端/Head/Kibana必备http.cors.enabled:truehttp.cors.allow-origin:*# 9. 单节点启动测试环境discovery.type:single-node7.3 配置说明cluster.name集群名称同一集群必须一致node.name节点名称唯一标识network.host: 0.0.0.0必须修改否则外网无法访问http.port: 9200访问端口discovery.type: single-node单节点模式开发测试使用八、步骤5启动 Elasticsearch 服务器8.1 Linux 启动命令必须切换普通用户# 切换用户suesuser# 进入目录cd/usr/local/elasticsearch# 前台启动测试用./bin/elasticsearch# 后台启动生产用./bin/elasticsearch-d8.2 Windows 启动进入 bin 目录 → 双击 elasticsearch.bat九、步骤6验证 ES 服务是否启动成功9.1 命令验证curlhttp://服务器IP:92009.2 浏览器访问http://IP:92009.3 启动成功返回示例{name:es-node-1,cluster_name:es-cluster,cluster_uuid:xxx,version:{number:7.17.0,build_type:tar},tagline:You Know, for Search}看到这段信息说明ES 启动成功十、步骤7配置开机自启生产环境必备10.1 创建系统服务vi/etc/systemd/system/elasticsearch.service10.2 写入配置[Unit] DescriptionElasticsearch Afternetwork.target [Service] Useresuser ExecStart/usr/local/elasticsearch/bin/elasticsearch Restartalways [Install] WantedBymulti-user.target10.3 设置开机自启systemctl daemon-reload systemctlenableelasticsearch systemctl start elasticsearch十一、常见启动报错及解决方案必看can not run elasticsearch as root原因使用 root 用户启动解决创建普通用户启动max virtual memory areas vm.max_map_count [65530] is too low原因系统虚拟内存配置不足解决执行本文 5.3 步骤the default discovery settings are unsuitable for production原因缺少单节点配置解决添加discovery.type: single-node外网无法访问 9200原因network.host 未配置 0.0.0.0 或防火墙未开放端口解决修改配置 防火墙开放 9200 端口十二、总结ES 不能用 root 启动Linux 必须创建普通用户两个核心配置文件jvm.options内存、elasticsearch.yml服务network.host: 0.0.0.0必须配置否则无法外网访问内存配置Xms 和 Xmx 保持一致且不超过物理内存一半单节点测试添加discovery.type: single-node生产环境必须配置开机自启按照本文步骤操作可实现100% 成功启动 Elasticsearch结尾本文是 Elasticsearch 部署最完整、最详细的实战教程适合新手入门、运维部署、开发测试。欢迎点赞、收藏、关注后续持续更新 ES 集群、Kibana、Logstash 等实战教程需要我给你补充Windows 完整部署图文版或者ES 单机多实例集群配置吗The End点点关注收藏不迷路

更多文章