Отдельный сервер
Любая топология главы состоит из соединённых процессов nats-server. Прежде чем их соединять, рассмотрим один строительный блок.
Сервер — один процесс nats-server. Он принимает соединения, маршрутизирует сообщения и при включённом JetStream хранит их в потоках. На этапе разработки одного процесса достаточно для всей ORDERS.
Здесь мы запустим локальный сервер разработки n1, затем рассмотрим, когда его достаточно и какие ограничения заставят Acme добавить другие.
Простейшее развёртывание
Связей между серверами пока нет: в центре один сервер, к нему напрямую подключены издатель заказов order-svc и подписчик warehouse.
Клиенты не знают друг друга, только один адрес. Издатель отправляет orders.created, сервер передаёт сообщение подходящим подписчикам. Это вся топология.
Именно так вы работали в главах JetStream и безопасности. Это полноценный допустимый способ запуска NATS.
Запустите сервер разработки
Создайте конфигурационный файл. Настроек почти не нужно, но несколько полезны с самого начала.
# n1.conf — the development server
server_name: n1
port: 4222
http_port: 8222
jetstream {
store_dir: "./js/n1"
}
server_name — понятное человеку имя. Задайте n1, чтобы узнавать сервер в журналах и мониторинге.
port — клиентский порт. Стандартный 4222 указан явно; адрес клиента — nats://localhost:4222.
http_port включает выключенный по умолчанию мониторинг. Сразу задайте 8222; показатели рассмотрены в Мониторинге.
jetstream включает JetStream и задаёт store_dir. Так n1 сможет хранить ORDERS из предыдущей главы.
Запустите n1 с этой конфигурацией:
nats-server -c n1.conf
В журнале появятся слушатели клиентов 4222 и мониторинга 8222. Один процесс составляет всю систему.
Проверьте доступность:
nats server check connection --server nats://localhost:4222
Исправный сервер отвечает, проверка показывает OK.
Подключитесь и опубликуйте заказ
При работающем n1 подпишитесь на orders.> в одном терминале:
nats sub "orders.>" --server nats://localhost:4222
В другом подключитесь и опубликуйте заказ ORDERS:
nats pub orders.created '{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}' --server nats://localhost:4222
Подписчик выводит заказ:
[#1] Received on "orders.created"
{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}
Здесь нет особого кода топологии. Клиент задаёт URL и публикует; та же публикация работает с кластером, суперкластером и листовым узлом.
Установление соединения и аутентификация на уровне протокола описаны в Справочнике → Клиентский протокол. Здесь нужен только URL.
Когда достаточно одного сервера
Для ряда задач отдельный сервер — правильный выбор.
Прежде всего разработка на ноутбуке или в CI: ничего не нужно согласовывать и ждать.
Также NATS может работать на самом устройстве. Небольшой самостоятельный процесс подходит автомобилю, станку, кассовому терминалу или встраивается в другое приложение. Устройство получает полноценный локальный NATS. Позже сервер можно подключить к центру как листовой узел, но сам по себе он остаётся отдельным.
Третий случай — небольшой сервис в одном экземпляре, например внутренняя панель или ночное задание. Если сам сервис — самая уязвимая часть функции, кластеризация брокера не повысит доступность функции без второго экземпляра приложения.
В этих случаях один сервер — соразмерная инфраструктура.
Ограничения одного сервера
Acme перерастает n1 из-за доступности и вместимости: единственный сервер может отказать и имеет предел ресурсов.
Это единая точка отказа. При завершении процесса или перезапуске машины отключаются все клиенты. Переключаться некуда; маршрутизация ждёт возвращения n1.
Для перечисленных задач это допустимо, но не для системы, где перезапуск при развёртывании не должен прерывать все заказы.
Надёжность хранения — отдельный вопрос. JetStream сохраняет ORDERS на диске и переживает перезапуск процесса, но данные всё ещё на одной машине. Потеря диска означает потерю потока.
Второй предел — ресурсы. Вертикальное масштабирование даёт более мощный CPU, больше RAM и быстрый диск, но предел есть у любой машины. Дальше нужны дополнительные серверы.
Оба ограничения снимает кластер: клиент может перейти на другой сервер, а поток хранит копии на нескольких машинах. Следующая страница создаёт первый кластер Acme east.
Типичные ошибки
Одна ловушка превращает теоретический предел доступности в конкретную ошибку.
Слишком поздно задуматься об избыточности. Репликацию нельзя просто включить на одном сервере. Запрос трёх реплик ORDERS на n1 отклоняется, поскольку им нужны три сервера:
nats stream add ORDERS --subjects 'orders.*' --storage file --replicas 3 --defaults
Ответ — replicas > 1 not supported in non-clustered mode. Это ограничение топологии, не опечатка. На одном сервере задавайте --replicas 1, понимая, что R1 переживает перезапуск процесса, но не потерю n1. Когда нужно больше, переходите к первому кластеру. Механика R3 описана в Кластеризации и репликации.
Что уже готово
Текущее развёртывание Acme:
- Один сервер разработки
n1на4222, мониторинг на8222. order-svcпубликуетorders.*напрямую, а включённый JetStream хранитORDERSнаn1.
Что дальше
Объединим n1-east, n2-east, n3-east, чтобы при отказе сервера клиент переподключался и продолжал работу: Ваш первый кластер.
См. также
- Основные понятия → Топологии — краткий обзор.
- Справочник → Клиентский протокол — подключение, URL и параметры.