Docker安装Elastic

封面图 • 2025-11-13 • Docker

在 Docker 中安装 **Elasticsearch**（简称 Elastic）是一个常见的做法，尤其适合开发和测试环境。以下是使用 Docker 安装 Elasticsearch 的步骤。

---

## ✅ 一、安装 Docker 和 Docker Compose

确保你已经安装了 [Docker](https://www.docker.com/) 和 [Docker Compose](https://docs.docker.com/compose/)。

如果没有安装，可以参考以下命令（以 Ubuntu 为例）：

```bash
sudo apt update
sudo apt install docker.io docker-compose -y
```

---

## ✅ 二、创建 `docker-compose.yml` 文件

在你的项目目录中创建一个名为 `docker-compose.yml` 的文件，并添加以下内容：

```yaml
version: '3.8'

services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.10.4
    container_name: elasticsearch
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    ports:
      - "9200:9200"
      - "9300:9300"
    volumes:
      - esdata:/usr/share/elasticsearch/data
    networks:
      - elastic

volumes:
  esdata:

networks:
  elastic:
```

> ⚠️ 注意：
- 如果你是首次运行，建议使用较新的版本，如 `8.10.4`。
- `discovery.type=single-node` 是用于单节点模式的配置。
- 端口说明：
  - `9200`: HTTP API 端口
  - `9300`: Java 客户端通信端口

---

## ✅ 三、启动 Elasticsearch

在 `docker-compose.yml` 所在目录下执行以下命令：

```bash
docker-compose up -d
```

这会后台启动 Elasticsearch 容器。

---

## ✅ 四、验证 Elasticsearch 是否运行成功

访问以下地址查看是否能正常访问：

```
http://localhost:9200
```

你应该会看到类似以下的响应：

```json
{
  "name": "elasticsearch",
  "cluster_name": "docker-cluster",
  "cluster_uuid": "abc123",
  "version": {
    "number": "8.10.4",
    "build_flavor": "oss",
    "build_type": "tar",
    "build_hash": "abcdef...",
    "build_date": "2023-10-06T12:00:00.000Z",
    "build_snapshot": false,
    "lucene_version": "9.7.0",
    "minimum_wire_compatibility_version": "7.17.0",
    "minimum_index_compatibility_version": "7.0.0"
  },
  "tagline": "You Know, for Search"
}
```

---

## ✅ 五、安装 Kibana（可选）

如果你还需要 Kibana 来可视化数据，可以在同一个 `docker-compose.yml` 文件中添加 Kibana 服务：

```yaml
  kibana:
    image: docker.elastic.co/kibana/kibana:8.10.4
    container_name: kibana
    ports:
      - "5601:5601"
    environment:
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
    depends_on:
      - elasticsearch
    networks:
      - elastic
```

然后重启容器：

```bash
docker-compose up -d
```

访问 Kibana：

```
http://localhost:5601
```

---

## ✅ 六、常见问题

### 1. 内存不足？
Elasticsearch 对内存要求较高，如果出现错误，可以增加 JVM 内存：

```yaml
environment:
  - ES_JAVA_OPTS=-Xms1g -Xmx1g
```

### 2. 配置文件修改？

你可以通过挂载本地配置文件来修改 `elasticsearch.yml` 或 `jvm.options`，例如：

```yaml
volumes:
  - ./config/elasticsearch.yml:/etc/elasticsearch/elasticsearch.yml
```

---

## ✅ 总结

| 步骤 | 内容 |
|------|------|
| 安装 Docker & Docker Compose | ✅ |
| 创建 `docker-compose.yml` | ✅ |
| 启动 Elasticsearch | ✅ |
| 访问 `http://localhost:9200` | ✅ |
| 可选：安装 Kibana | ✅ |

---

如果你需要安装的是 **Elastic Stack**（包含 Elasticsearch + Kibana + Logstash + Beats），也可以使用官方提供的 [Elastic Stack Docker images](https://www.elastic.co/guide/en/elastic-stack-get-started/current/get-started-docker.html)。

需要我帮你生成完整的 `docker-compose.yml` 包含所有组件吗？