---
title: "节点本地存储节点数限制配置"
date: 2026-01-22
lastmod: 2026-01-22
description: "控制同一机器上允许的最大存储节点数配置说明"
tags: ["节点", "存储配置", "开发环境"]
summary: "配置项作用 #  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` 配置项限制在同一物理机器或同一 JVM 实例上可以启动的最大存储节点数量。

## 是否可选

是

## 默认值

```
1 (只允许 1 个存储节点)
```

## 配置项类型

**静态配置** - 需要重启节点才能生效

## 配置格式

```yaml
# 默认配置（单个存储节点）
node.max_local_storage_nodes: 1

# 允许多个节点
node.max_local_storage_nodes: 3

# 无限制
node.max_local_storage_nodes: -1
```

## 使用场景

| 场景 | 推荐值 | 说明 |
|------|--------|------|
| 生产环境 | 1 | 每台机器一个节点 |
| 开发测试 | -1 或 3+ | 便于本地测试 |
| 容器环境 | 1 | 每个容器一个节点 |

## 使用示例

**生产环境：**

```yaml
node.max_local_storage_nodes: 1
```

**开发环境：**

```yaml
# 允许在同一机器上运行多个节点
node.max_local_storage_nodes: 3
```

**无限制：**

```yaml
# 开发测试环境
node.max_local_storage_nodes: -1
```

## 配置验证

```bash
# 查看当前配置
GET /_nodes/settings?filter_path=nodes.*.node.max_local_storage_nodes

# 查看节点数量
GET /_cat/nodes?v
```

## 注意事项

1. **静态配置**：修改需要重启节点
2. **生产环境**：建议保持默认值 1
3. **数据安全**：多个节点共享同一存储路径可能导致数据损坏
4. **开发测试**：可以增加限制进行本地测试
5. **已弃用**：推荐使用不同的数据路径配置多节点

## 相关配置项

| 配置项 | 默认值 | 说明 |
|-------|-------|------|
| `path.data` | [] | 数据存储路径 |
| `node.local_storage` | true | 是否使用本地存储 |

## 完整配置示例

```yaml
# easysearch.yml

# 生产环境
path.data:
  - /data/easysearch
node.max_local_storage_nodes: 1

# 开发环境（同一机器多节点）
path.data:
  - /data/node1
node.max_local_storage_nodes: 3
```