# Углублённый курс Core NATS

Core NATS — основа всех остальных возможностей. Это система публикации и подписки: издатель публикует сообщение в тему, а каждый заинтересованный подписчик получает копию. Здесь нет очереди брокера, хранения и подтверждений. Сообщение получают только те, кто слушает прямо сейчас, и никто другой.

Этой единственной идеи — темы и интереса к ним — достаточно для четырёх шаблонов взаимодействия и общей системы адресации. Глава знакомит с ними так, как вы осваивали бы их при написании кода: сначала один издатель и один подписчик, затем адресация, ответы, балансировка нагрузки и сбор ответов, по одной странице за раз. Начинается глава ещё на шаг раньше — с соединения, которое первым делом открывает каждый клиент. После шаблонов разбираются заголовки сообщений, серверное преобразование тем, жизненный цикл соединения и отладка доставки.

**Движение сообщений — Публикация / Подписка (анимация):** Анимация публикации и подписки: издатель отправляет сообщения, а NATS доставляет копию каждому подходящему подписчику.

* Издатель → NATS (тема: обновления)
* NATS → Подписчик 1 (тема: обновления)
* NATS → Подписчик 2 (тема: обновления)

## Core NATS не хранит сообщения

Ключевое свойство, о котором нужно помнить на протяжении всей главы: **Core NATS обеспечивает доставку не более одного раза**. Сообщение доходит до каждого заинтересованного подписчика, подключённого в момент публикации, не более одного раза. Если подписчик не в сети, перезапускается или ещё не подписался, он никогда не увидит это сообщение. Сервер не сохраняет его для последующей доставки.

Это намеренное поведение. Оно делает Core NATS компактным и быстрым и хорошо подходит, когда каждое сообщение заменяется следующим: текущая цена, температура или уведомление об устаревании кеша.

Если сообщения должны дожидаться подписчика, переживать перезапуск или воспроизводиться позже, добавьте поток. Это [JetStream](/learn/jetstream/.md) — слой долговременного хранения поверх Core NATS. В этой главе рассматривается всё, что происходит *до* обращения к нему.

## Сквозной сценарий

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

С заказом происходят три события: создание, отправка и отмена. Каждое представлено сообщением в своей теме:

```
orders.created

orders.shipped

orders.canceled
```

Полезная нагрузка — небольшой JSON-объект одинаковой структуры во всех примерах главы:

```
{

  "order_id": "ord_8w2k",

  "customer": "acme-co",

  "total_cents": 4200,

  "ts": "2026-05-22T10:14:22Z"

}
```

Этими сообщениями интересуются несколько сервисов. Процесс `warehouse` упаковывает заказ по событию `orders.created`. Сервис `notifications` отправляет письмо покупателю при отгрузке. Конвейер `analytics` подсчитывает все события. Далее появятся региональная аналитика и аудит через шаблоны тем, сервис `inventory`, отвечающий на запросы, пул `packers`, распределяющий нагрузку, и три поставщика тарифов доставки, отвечающие на один вопрос.

На протяжении главы используется один локальный `nats-server` (на двух последующих страницах он перезапускается с флагом или конфигурационным файлом), а подписчики и сервисы добавляются по мере изучения.

## Для кого эта глава

Вы прочитали введение [Основные понятия → Публикация и подписка](/concepts/pub-sub-basics.md) или уже знакомы с темами и подписчиками. Вместо повторения *что это такое* глава показывает, *как это работает*: протокольный механизм, компромиссы каждого шаблона и практический сеанс, выстраиваемый команда за командой. Каждая страница вводит одну-две новые идеи и опирается на предыдущую.

## План главы

| Страница                                                                    | Что вы узнаете                                                                                                                    |
| --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| [Подключение](/learn/core-nats/connecting.md)                               | Одно долгоживущее соединение на клиента, URL и установление соединения, имена соединений и heartbeat PING/PONG                    |
| [Публикация и подписка](/learn/core-nats/publish-subscribe.md)              | Публикация без ожидания, подписка и отписка, граф интереса, доставка не более одного раза и лимит полезной нагрузки 1 МБ          |
| [Темы и подстановочные символы](/learn/core-nats/subjects-and-wildcards.md) | Иерархии тем с точками-разделителями и символы `*` и `>` в подписках                                                              |
| [Запрос-ответ](/learn/core-nats/request-reply.md)                           | Тема ответа `_INBOX`, тайм-ауты и сигнал отсутствия отвечающих сервисов                                                           |
| [Группы очередей](/learn/core-nats/queue-groups.md)                         | Балансировка нагрузки с доставкой каждого сообщения ровно одному участнику группы                                                 |
| [Scatter-gather](/learn/core-nats/scatter-gather.md)                        | Рассылка одного запроса нескольким сервисам и сбор ответов                                                                        |
| [Заголовки сообщений](/learn/core-nats/headers.md)                          | Метаданные «ключ — значение» в формате `NATS/1.0`, их запись и чтение, коды состояния, передаваемые сервером в том же канале      |
| [Преобразование тем](/learn/core-nats/subject-mapping.md)                   | Перезапись темы на сервере до маршрутизации: переименование, взвешенное разделение трафика и секционирование по хешу сегмента     |
| [Жизненный цикл соединения](/learn/core-nats/connection-lifecycle.md)       | Влияние разрыва на клиента и сообщения в пути, переподключение силами клиента и обратные вызовы для отслеживания жизненного цикла |
| [Отладка доставки](/learn/core-nats/debugging-delivery.md)                  | Поиск причин отсутствия сообщения с помощью перехвата трафика, списка подписок сервера и трассировки                              |
| [Куда двигаться дальше](/learn/core-nats/where-next.md)                     | Повторение четырёх основных идей и дальнейшие возможности                                                                         |

## Предварительные требования

Вам понадобятся:

* Один локальный `nats-server`. Достаточно стандартной сборки: Core NATS не требует флагов. Запустите его командой `nats-server`.
* CLI `nats`, установленный и настроенный на ваш сервер. Каждый пример начинается с CLI; большинство страниц также показывает операции на JavaScript, Go, Python, Java, Rust и C#. Две страницы о серверных возможностях (преобразование тем и отладка доставки) используют только CLI.
* На странице [Преобразование тем](/learn/core-nats/subject-mapping.md) сервер запускается с конфигурационным файлом командой `nats-server -c server.conf`; содержимое файла приведено на странице.
* Для [Отладки доставки](/learn/core-nats/debugging-delivery.md) нужен порт мониторинга сервера, включаемый командой `nats-server -m 8222`.

Откройте терминал, выполните `nats-server` и переходите к следующей странице.

## Что дальше

Начните с [Подключения](/learn/core-nats/connecting.md): одно долгоживущее соединение, которое клиент открывает перед публикацией или подпиской, обмен сообщениями при его установлении и heartbeat для проверки доступности.

## См. также

* [Основные понятия → Публикация и подписка](/concepts/pub-sub-basics.md) — пятиминутный обзор той же темы.
* [Углублённый курс JetStream](/learn/jetstream/.md) — слой долговременного хранения, который не рассматривается в этой главе.
