# Топологии

NATS масштабируется за счёт объединения серверов. Один и тот же исполняемый файл сервера и те же клиентские API работают во всех вариантах: меняется топология развёртывания, а не приложение. Начните с одного сервера. Добавляйте серверы по мере необходимости. Объединяйте регионы. Подключайте периферийные устройства. Сочетайте эти варианты.

Пошаговое практическое руководство, в котором один сервер превращается в кластер, затем в суперкластер и дополняется периферийными листовыми узлами, см. в разделе [углублённого изучения топологий](/learn/topologies/.md).

## Один сервер

Самое простое развёртывание NATS — один серверный процесс. Все клиенты подключаются к нему напрямую.

**Движение сообщений — singleServer:** Топология с одним сервером: один сервер NATS и два клиента

* Клиент → NATS
* NATS → Клиент

Используйте один сервер для:

* Локальной разработки и демонстраций
* Встраивания в другое приложение
* Небольших сервисов, которым достаточно одного узла
* Быстрых экспериментов и обучения

## Кластер

**Кластер** — группа серверов NATS, соединённых маршрутами в полносвязную сеть. Клиенты подключаются к любому серверу кластера, а сообщения проходят по маршрутам к подписчикам в любой части сети. При отказе сервера клиенты переподключаются к другому и продолжают работать. С помощью [JetStream](/concepts/jetstream.md) [потоки](/reference/jetstream/api/stream/.md) и [потребители](/reference/jetstream/api/consumer/.md) можно реплицировать между узлами для надёжного хранения.

**Движение сообщений — кластер:** Кластерная топология: три сервера NATS в полносвязной сети и два клиента

* NATS → NATS
* NATS → NATS
* NATS → NATS
* Клиент → NATS
* NATS → Клиент

Используйте кластер, когда нужны:

* Высокая доступность — отказ сервера не останавливает всю систему
* Пропускная способность выше возможностей одного сервера
* Промышленная эксплуатация
* Последовательные обновления без простоя
* Репликация [JetStream](/concepts/jetstream.md) для надёжного хранения потоков и состояния потребителей

## Суперкластер

**Суперкластер** соединяет несколько кластеров с помощью **шлюзов (gateways)**. Каждый кластер работает независимо, обычно в своём регионе или облаке. Шлюзы передают только трафик, к которому есть интерес на другой стороне, сводя межрегиональный обмен к минимуму. Группы очередей автоматически предпочитают локальные обработчики (географическая привязка), поэтому большинство сообщений остаётся в своём регионе.

**Движение сообщений — superCluster:** Топология суперкластера: два кластера, соединённые шлюзами

* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* Клиент → NATS
* NATS → Клиент

Суперкластеры подходят, когда нужны:

* Развёртывания в нескольких регионах или облаках
* Глобальные сервисы с локальной обработкой в регионах

## Листовые узлы

**Листовой узел (leaf node)** — сервер NATS, который устанавливает исходящее соединение с удалённой системой NATS (одним сервером, кластером или суперкластером) и передаёт между ними сведения об интересе к темам. Поскольку соединение устанавливается со стороны листового узла, он может работать везде, где разрешены исходящие подключения: в другом дата-центре, на ноутбуке разработчика или небольшом периферийном устройстве. Для подключённых к нему клиентов это обычный сервер NATS. Если нужны локальные копии данных, [потоки](/reference/jetstream/api/stream/.md) [JetStream](/concepts/jetstream.md) можно зеркалировать или наполнять из источников через соединение листового узла.

**Движение сообщений — leafNode:** Топология листовых узлов: листовой сервер соединяется с кластером

* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* Клиент → NATS
* NATS → Клиент

Листовые узлы хорошо подходят для:

* Периферийных развёртываний и IoT
* Связи локальных сервисов с облачным кластером
* Архитектур «центр — лучи»
* Изоляции арендаторов, когда каждый запускает собственный листовой узел

## Крупномасштабные системы

В реальных развёртываниях сочетаются все эти варианты. Несколько кластеров охватывают регионы и соединяются шлюзами. Каждый кластер связан с листовыми узлами на периферийных площадках, заводах или в филиалах. Каждый листовой узел обслуживает локальных клиентов. Клиентский код везде один и тот же.

**Движение сообщений — massiveScale:** Масштабная топология: суперкластер с листовыми узлами

* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* NATS → NATS
* Клиент → NATS
* NATS → Клиент
* Клиент → NATS
* NATS → Клиент

В центре находится кластер серверов NATS. Каждый сервер кластера может обслуживать собственных клиентов. Листовые узлы расширяют сеть: каждый приносит свою группу клиентов, а кластер видит одно соединение листового узла вместо отдельных клиентов, которых узел аутентифицирует самостоятельно. При этом листовой узел передаёт интерес к темам в ту учётную запись центральной системы, к которой привязан, поэтому пространство имён тем остаётся общим, если не привязать каждый листовой узел к отдельной учётной записи. Этот подход можно повторять: добавлять листовые узлы, клиентов, серверы кластера и кластеры, соединённые шлюзами. Приложения взаимодействуют с NATS одинаково независимо от своего расположения.

## Следующие шаги

* [Углублённое изучение топологий](/learn/topologies/.md) — постройте эти конфигурации на практике
* [Кластеризация и репликация](/learn/clustering/.md) — механизмы работы сети
* [Протокол маршрутов](/reference/protocols/route.md) — взаимодействие серверов кластера
* [Протокол шлюзов](/reference/protocols/gateway.md) — взаимодействие кластеров в суперкластере
* [Протокол листовых узлов](/reference/protocols/leafnode.md) — подключение листовых узлов к центральной системе
