---
title: "获取远程集群信息"
date: 2026-02-19
lastmod: 2026-02-19
description: "获取已配置的远程集群的信息，包括连接状态、连接模式等"
tags: ["集群管理", "远程集群", "集群连接"]
summary: "获取已配置的远程集群的信息，包括连接状态、连接模式、代理地址等配置详情。
API #  GET /_cluster/remote/info GET /_remote/info API 的作用 #  该 API 用于获取已配置的远程集群的信息。返回每个已配置远程集群的连接详情，包括：
 连接状态（connected）：是否已连接 连接模式（mode）：proxy（代理模式）或 sniff（嗅探模式） 超时设置：初始连接超时时间 可用性跳过：是否跳过不可用的集群 模式特定信息：根据连接模式返回不同的额外信息  Proxy 模式额外信息 #     字段 描述     proxy_address 代理地址   server_name 服务器名称   max_proxy_socket_connections 最大代理套接字连接数   num_proxy_sockets_connected 已连接的代理套接字数量    Sniff 模式额外信息 #     字段 描述     seeds 种子节点地址列表   max_connections_per_cluster 每个集群的最大连接数   num_nodes_connected 已连接的节点数量    API 的参数 #  该 API 不支持任何路由参数或 Query String 参数。"
---


获取已配置的远程集群的信息，包括连接状态、连接模式、代理地址等配置详情。

## API

```
GET /_cluster/remote/info
GET /_remote/info
```

## API 的作用

该 API 用于获取已配置的远程集群的信息。返回每个已配置远程集群的连接详情，包括：

- **连接状态**（connected）：是否已连接
- **连接模式**（mode）：`proxy`（代理模式）或 `sniff`（嗅探模式）
- **超时设置**：初始连接超时时间
- **可用性跳过**：是否跳过不可用的集群
- **模式特定信息**：根据连接模式返回不同的额外信息

### Proxy 模式额外信息

| 字段 | 描述 |
|------|------|
| `proxy_address` | 代理地址 |
| `server_name` | 服务器名称 |
| `max_proxy_socket_connections` | 最大代理套接字连接数 |
| `num_proxy_sockets_connected` | 已连接的代理套接字数量 |

### Sniff 模式额外信息

| 字段 | 描述 |
|------|------|
| `seeds` | 种子节点地址列表 |
| `max_connections_per_cluster` | 每个集群的最大连接数 |
| `num_nodes_connected` | 已连接的节点数量 |

## API 的参数

该 API **不支持任何路由参数或 Query String 参数**。

## 示例

### 获取所有远程集群信息

```bash
GET /_cluster/remote/info
```

或

```bash
GET /_remote/info
```

**响应示例：**

```json
{
  "cluster_one": {
    "connected": true,
    "mode": "proxy",
    "initial_connect_timeout": "30s",
    "skip_unavailable": false,
    "proxy_address": "192.168.1.100:9400",
    "server_name": "cluster_one",
    "max_proxy_socket_connections": 100,
    "num_proxy_sockets_connected": 50
  },
  "cluster_two": {
    "connected": true,
    "mode": "sniff",
    "initial_connect_timeout": "30s",
    "skip_unavailable": true,
    "seeds": [
      "192.168.1.101:9300",
      "192.168.1.102:9300"
    ],
    "max_connections_per_cluster": 100,
    "num_nodes_connected": 5
  }
}
```

### 连接状态说明

| 状态 | 描述 |
|------|------|
| `true` | 远程集群已成功连接 |
| `false` | 远程集群未连接或连接失败 |

### 连接模式说明

| 模式 | 描述 |
|------|------|
| `proxy` | 代理模式：通过指定的代理地址连接远程集群 |
| `sniff` | 嗅探模式：通过种子节点发现并连接远程集群的所有节点 |

### skip_unavailable 参数说明

| 值 | 描述 |
|----|------|
| `true` | 当远程集群不可用时跳过，不影响本地操作 |
| `false` | 当远程集群不可用时操作会失败 |