配置项作用 #
node.max_local_storage_nodes 配置项限制在同一物理机器或同一 JVM 实例上可以启动的最大存储节点数量。
是否可选 #
是
默认值 #
1 (只允许 1 个存储节点)
配置项类型 #
静态配置 - 需要重启节点才能生效
配置格式 #
# 默认配置（单个存储节点）
node.max_local_storage_nodes: 1
# 允许多个节点
node.max_local_storage_nodes: 3
# 无限制
node.max_local_storage_nodes: -1
使用场景 #
| 场景 | 推荐值 | 说明 |
|---|---|---|
| 生产环境 | 1 | 每台机器一个节点 |
| 开发测试 | -1 或 3+ | 便于本地测试 |
| 容器环境 | 1 | 每个容器一个节点 |
使用示例 #
生产环境：
node.max_local_storage_nodes: 1
开发环境：
# 允许在同一机器上运行多个节点
node.max_local_storage_nodes: 3
无限制：
# 开发测试环境
node.max_local_storage_nodes: -1
配置验证 #
# 查看当前配置
GET /_nodes/settings?filter_path=nodes.*.node.max_local_storage_nodes
# 查看节点数量
GET /_cat/nodes?v
注意事项 #
- 静态配置：修改需要重启节点
- 生产环境：建议保持默认值 1
- 数据安全：多个节点共享同一存储路径可能导致数据损坏
- 开发测试：可以增加限制进行本地测试
- 已弃用：推荐使用不同的数据路径配置多节点
相关配置项 #
| 配置项 | 默认值 | 说明 |
|---|---|---|
path.data | [] | 数据存储路径 |
node.local_storage | true | 是否使用本地存储 |
完整配置示例 #
# easysearch.yml
# 生产环境
path.data:
- /data/easysearch
node.max_local_storage_nodes: 1
# 开发环境（同一机器多节点）
path.data:
- /data/node1
node.max_local_storage_nodes: 3
