# Elasticsearch 9.3.1 本机安装记录

按 [ES_9](./ES_9) 文档在本机完成安装，数据与日志安装在 **/data** 目录下。

## 安装概要

| 项目 | 说明 |
|------|------|
| 版本 | Elasticsearch 9.3.1（APT 9.x 源） |
| 安装方式 | 官方 APT 源，二进制在 `/usr/share/elasticsearch` |
| 数据目录 | `/data/elasticsearch/data` |
| 日志目录 | `/data/elasticsearch/logs` |
| 配置 | `/etc/elasticsearch/elasticsearch.yml` |
| 模式 | 单机单节点 `discovery.type: single-node` |
| 安全 | `xpack.security.enabled: false`（开发环境） |
| HTTP | `http://0.0.0.0:9200` |
| Kibana | 9.3.1，`http://0.0.0.0:5601`，已安装并启用 |

## 已执行步骤

1. 添加 ES 9.x APT 源与 GPG，`apt-get install elasticsearch`
2. 创建 `/data/elasticsearch/{data,logs}` 并 `chown elasticsearch:elasticsearch`
3. 配置 `elasticsearch.yml`：cluster、node、path.data/logs、network、discovery、security
4. JVM 堆：`/etc/elasticsearch/jvm.options.d/heap.options` 中 `-Xms4g -Xmx4g`（本机约 15GB 内存）
5. sysctl 与 limits 已按文档追加（vm.max_map_count、nofile、nproc、memlock 等）
6. `systemctl enable elasticsearch` 且 `systemctl start elasticsearch`
7. Kibana：`apt-get install kibana`，配置 `/etc/kibana/kibana.yml`（server.host: 0.0.0.0, elasticsearch.hosts: http://127.0.0.1:9200），`systemctl enable kibana` 且 `systemctl start kibana`

## 验证

```bash
curl http://127.0.0.1:9200
# 返回 cluster_name: searchengine-cluster, version.number: 9.3.1
```

## 常用命令

```bash
# Elasticsearch
sudo systemctl status elasticsearch   # 状态
sudo systemctl start elasticsearch    # 启动
sudo systemctl stop elasticsearch      # 停止

# Kibana
sudo systemctl status kibana
sudo systemctl start kibana
sudo systemctl stop kibana
```

## Kibana

- **版本**：9.3.1（与 ES 同源）
- **配置**：`/etc/kibana/kibana.yml`（server.host: 0.0.0.0, server.port: 5601, elasticsearch.hosts: http://127.0.0.1:9200）
- **访问**：浏览器打开 `http://<本机IP>:5601`（ES 未开安全时可直接进入首页）

## 与 SearchEngine 项目集成

- 环境变量或配置中 ES 地址：`ES_HOST=http://127.0.0.1:9200`
- 索引与导入：使用项目内 `mappings/search_products.json`（9.3 建议 bfloat16）及 `./scripts/ingest.sh` 等脚本。