---
title: "节点数据角色配置"
date: 2026-03-21
lastmod: 2026-03-21
description: "控制节点是否持有数据的配置说明"
tags: ["节点", "角色配置", "数据节点"]
summary: "配置项作用 #  node.data 配置项控制节点是否可以作为数据节点，即是否可以持有索引数据。
是否可选 #  是
默认值 #  true (可作为数据节点) 配置项类型 #  静态配置 - 需要重启节点才能生效
配置格式 #  # 默认配置（数据节点） node.data: true # 禁用数据角色 node.data: false 节点类型说明 #     node.data node.master 节点类型 说明     true true 主数据节点 既持有数据又可当选 master   true false 数据节点 只持有数据   false true 专用主节点 只处理集群管理   false false 协调节点 只处理路由和搜索    推荐设置 #     环境 node."
---


## 配置项作用

`node.data` 配置项控制节点是否可以作为数据节点，即是否可以持有索引数据。

## 是否可选

是

## 默认值

```
true (可作为数据节点)
```

## 配置项类型

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

## 配置格式

```yaml
# 默认配置（数据节点）
node.data: true

# 禁用数据角色
node.data: false
```

## 节点类型说明

| node.data | node.master | 节点类型 | 说明 |
|-----------|------------|----------|------|
| true | true | 主数据节点 | 既持有数据又可当选 master |
| true | false | 数据节点 | 只持有数据 |
| false | true | 专用主节点 | 只处理集群管理 |
| false | false | 协调节点 | 只处理路由和搜索 |

## 推荐设置

| 环境 | node.data | 说明 |
|------|-----------|------|
| 小型集群 | true | 所有节点都存储数据 |
| 大型集群 | 混合 | 分离数据和主节点角色 |
| 协调节点 | false | 只处理请求路由 |
| 专用主节点 | false | 只管理集群状态 |

## 使用示例

**数据节点：**

```yaml
node.name: data-node-1
node.data: true
node.master: false
node.ingest: false
```

**协调节点：**

```yaml
node.name: coordinating-node-1
node.data: false
node.master: false
node.ingest: false
```

**专用主节点：**

```yaml
node.name: master-node-1
node.data: false
node.master: true
node.ingest: false
```

## 配置验证

```bash
# 查看节点角色
GET /_cat/nodeattrs?v&h=name,node.roles,data,master

# 查看节点信息
GET /_nodes
```

## 注意事项

1. **静态配置**：修改需要重启节点
2. **集群规划**：应与 node.roles 配合使用
3. **数据分布**：数据节点负责存储和检索数据
4. **资源考虑**：数据节点需要更多存储和内存
5. **已弃用**：推荐使用 node.roles 配置

## 相关配置项

| 配置项 | 默认值 | 说明 |
|-------|-------|------|
| `node.roles` | [master, data, ingest] | 节点角色列表 |
| `node.master` | true | 是否为 master 节点 |
| `node.ingest` | true | 是否为摄取节点 |

## 完整配置示例

```yaml
# easysearch.yml

# 数据节点配置
node.name: data-node-1
node.roles: [data]
node.data: true
```