Elasticsearch · 分布式搜索与分析引擎｜部署与使用全指南
项目仓库： https://github.com/elastic/elasticsearch
开源协议：Elastic License v2 / SSPL（双许可） · 语言：Java · 默认端口：9200（HTTP）/ 9300（transport） · 官方文档：elastic.co/guide · 仓库当前 README：docs 编写指南
说明：仓库当前根目录 README 位于
docs/README.md，内容是 Elasticsearch 文档的编写/构建指南（9.0 起从 AsciiDoc 迁移到 Markdown），不含安装命令。本文基于官方仓库与官方文档站整理。
1 项目简介
Elasticsearch 是分布式搜索与分析引擎，提供近实时的数据检索、结构化搜索、全文搜索与分析能力，常作为 Elastic Stack（ELK：Elasticsearch、Logstash、Kibana）的核心存储与检索引擎，用于日志、可观测性、企业搜索等场景。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Elasticsearch |
| 仓库地址 | github.com/elastic/elasticsearch |
| 项目定位 | 分布式搜索与分析引擎 |
| 开源协议 | Elastic License v2 / SSPL |
| 语言 | Java（运行需 JVM） |
| 默认 HTTP 端口 | 9200 |
| transport 端口 | 9300 |
| 官方文档 | elastic.co/guide |
1.2 适用场景
- 全文检索与企业搜索。
- 日志、指标、APM 可观测性数据存储与查询。
- 与 Logstash、Kibana、Beats 组成 ELK Stack。
1.3 能力边界（官方口径）
- 9.0 起文档迁移到 Markdown（Elastic docs V3）；8.x 仍用 AsciiDoc 系统。
- 仓库 README 是文档贡献指南，不直接给安装步骤。
2 功能特性
- 分布式架构：自动分片与副本，水平扩展。
- 近实时搜索：倒排索引，全文/结构化/地理空间检索。
- REST API：通过 HTTP JSON 操作索引与文档。
- Elastic Stack 集成：Logstash、Kibana、Beats、Fleet。
3 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/elastic/elasticsearch | 源码 |
| 官方文档 | Elasticsearch Guide | 安装/API |
| 文档贡献 | docs/README | 写文档 |
| Docker 镜像 | docker.elastic.co/elasticsearch/elasticsearch |
官方镜像 |
4 部署方式（按官方文档）
4.1 Docker
# 创建网络
docker network create elastic
# 启动单节点（按官方文档选择版本标签）
docker run --name es01 --net elastic -p 9200:9200 \
docker.elastic.co/elasticsearch/elasticsearch:latest启动后访问 http://127.0.0.1:9200 验证。
4.2 其他方式
- 官方发行版（tar.gz/zip/deb/rpm）。
- Kubernetes 用 Elastic Helm Chart / ECK。
- 完整安装步骤以官方安装指南为准。
5 前置要求
- JVM：Elasticsearch 为 Java 应用，随发行版自带 JDK。
- 端口 9200（HTTP）、9300（节点间通信）。
- 生产建议调整虚拟内存、文件描述符等内核参数。
6 常见操作
# 验证集群状态
curl http://127.0.0.1:9200/
# 查看健康
curl http://127.0.0.1:9200/_cluster/health?pretty7 常见问题
- 启动失败：检查 JVM 堆内存、内核参数（vm.max_map_count）。
- 端口冲突：确认 9200/9300 未被占用。
- 版本选择：生产用 GA 版本，按官方兼容矩阵选。
8 风险与说明
- 许可证：Elastic License v2 / SSPL，商用需阅读条款。
- 数据安全：生产务必开启安全（TLS、认证）与备份。
- 非官方声明：本文基于官方仓库 README 与文档站整理，具体安装命令以最新官方指南为准。