---
title: "查询主节点"
date: 2026-03-16
lastmod: 2026-03-16
description: "介绍如何使用 Cat API 查询 Easysearch 集群的主节点信息。"
tags: ["Cat API", "集群管理", "节点"]
summary: "此 API 用于返回 Easysearch 集群主节点（Master Node）的详细信息。
API #  GET /_cat/master API 的作用 #  显示当前集群中主节点的详细信息，包括：
 节点 ID：主节点的唯一标识符 主机名：主节点所在的主机名 IP 地址：主节点的 IP 地址 节点名称：主节点的名称  主节点负责管理集群范围的操作，如创建索引、分配分片、维护集群状态等。当没有主节点时（如主节点故障），所有字段会显示 “-"。
API 的参数 #  此 API 没有路由参数。
查询字符串参数 #     参数 类型 是否必需 默认值 描述     format string 可选 text 响应格式
可选值：json, yaml, text   h string 可选 所有列 指定显示的列，逗号分隔
例如：id,host,ip,node   help boolean 可选 false 显示帮助信息，包括列的描述   local boolean 可选 false 是否从本地节点获取信息   master_timeout time 可选 30s 等待主节点响应的超时时间   s string 可选 - 排序列"
---


此 API 用于返回 Easysearch 集群主节点（Master Node）的详细信息。

## API

```
GET /_cat/master
```

## API 的作用

显示当前集群中主节点的详细信息，包括：

- **节点 ID**：主节点的唯一标识符
- **主机名**：主节点所在的主机名
- **IP 地址**：主节点的 IP 地址
- **节点名称**：主节点的名称

主节点负责管理集群范围的操作，如创建索引、分配分片、维护集群状态等。当没有主节点时（如主节点故障），所有字段会显示 "-"。

## API 的参数

此 API **没有**路由参数。

### 查询字符串参数

| 参数 | 类型 | 是否必需 | 默认值 | 描述 |
|------|------|----------|--------|------|
| `format` | string | 可选 | text | 响应格式<br>可选值：`json`, `yaml`, `text` |
| `h` | string | 可选 | 所有列 | 指定显示的列，逗号分隔<br>例如：`id,host,ip,node` |
| `help` | boolean | 可选 | false | 显示帮助信息，包括列的描述 |
| `local` | boolean | 可选 | false | 是否从本地节点获取信息 |
| `master_timeout` | time | 可选 | 30s | 等待主节点响应的超时时间 |
| `s` | string | 可选 | - | 排序列<br>例如：`host` |
| `v` | boolean | 可选 | false | 详细模式，显示列头 |

## 返回的字段信息

| 列名 | 别名 | 描述 |
|------|------|------|
| `id` | - | 节点 ID |
| `host` | `h` | 主机名 |
| `ip` | - | IP 地址 |
| `node` | `n` | 节点名称 |

## 请求示例

```bash
# 查询主节点信息
GET /_cat/master

# 显示列头
GET /_cat/master?v

# 使用 JSON 格式
GET /_cat/master?format=json

# 只显示特定列
GET /_cat/master?h=id,ip,node

# 显示帮助信息
GET /_cat/master?help
```

## 响应示例

### 文本格式（默认）

```
id                                   host      ip           node
uYWZ7pSNRS-O4oLMP8N_mw                 node1     10.0.1.10    master-node
```

### 文本格式（带列头）

```
id                                   host      ip           node
uYWZ7pSNRS-O4oLMP8N_mw                 node1     10.0.1.10    master-node
```

### JSON 格式

```json
[
  {
    "id": "uYWZ7pSNRS-O4oLMP8N_mw",
    "host": "node1",
    "ip": "10.0.1.10",
    "node": "master-node"
  }
]
```

### 无主节点时的响应

当集群没有主节点时（如集群初始化中或主节点故障）：

```
id   host   ip   node
-    -      -    -
```

### 帮助信息

```
id    |      | node id
host  | h    | host name
ip    |      | ip address
node  | n    | node name
```

## 使用场景

1. **集群管理**：确认当前主节点的身份
2. **故障排查**：检查主节点是否正常
3. **运维操作**：在进行集群级操作前确认主节点
4. **高可用验证**：验证主节点切换是否正常

## 主节点相关概念

### 主节点职责

- 管理集群状态
- 创建/删除索引
- 分配分片到节点
- 处理节点加入/离开

### 主节点选举

- 集群中的 master-eligible 节点可以参与主节点选举
- 当主节点故障时，会自动选举新的主节点
- 通过 `discovery.zen.minimum_master_nodes` 配置防止脑裂

### 专用主节点

在大规模集群中，建议配置专用主节点（master-only nodes）：
- 只负责集群管理，不存储数据
- 减轻主节点负担，提高集群稳定性

## 注意事项

1. 此 API 只支持 GET 方法
2. 当没有主节点时，所有字段显示 "-"
3. `local=true` 时可能返回过时信息，但响应更快
4. 主节点信息可能会在节点故障时自动切换

## 相关文档

- [查询节点](./get-node.md)
- [查询集群健康](./get-cluster-health-cat-format.md)
- [获取集群状态](./get-cluster-state.md)
- [获取节点信息](./get-node-info.md)