# Отдельный сервер

Любая топология главы состоит из соединённых процессов `nats-server`. Прежде чем их соединять, рассмотрим один строительный блок.

**Сервер** — один процесс `nats-server`. Он принимает соединения, маршрутизирует сообщения и при включённом JetStream хранит их в потоках. На этапе разработки одного процесса достаточно для всей ORDERS.

Здесь мы запустим локальный сервер разработки `n1`, затем рассмотрим, когда его достаточно и какие ограничения заставят Acme добавить другие.

## Простейшее развёртывание

Связей между серверами пока нет: в центре один сервер, к нему напрямую подключены издатель заказов `order-svc` и подписчик `warehouse`.

**Движение сообщений — Топология одного сервера (анимация):** Топология с одним сервером: сервер разработки Acme n1 и клиенты order-svc и warehouse

* order-svc → n1
* n1 → 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`; показатели рассмотрены в [Мониторинге](/learn/monitoring/.md).

[`jetstream`](/reference/config/jetstream/.md) включает 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 и публикует; та же публикация работает с кластером, суперкластером и листовым узлом.

Установление соединения и аутентификация на уровне протокола описаны в [Справочнике → Клиентский протокол](/reference/protocols/client.md). Здесь нужен только URL.

## Когда достаточно одного сервера

Для ряда задач отдельный сервер — правильный выбор.

Прежде всего **разработка** на ноутбуке или в CI: ничего не нужно согласовывать и ждать.

Также NATS может работать **на самом устройстве**. Небольшой самостоятельный процесс подходит автомобилю, станку, кассовому терминалу или встраивается в другое приложение. Устройство получает полноценный локальный NATS. Позже сервер можно подключить к центру как [листовой узел](/learn/topologies/leaf-nodes.md), но сам по себе он остаётся отдельным.

Третий случай — **небольшой сервис в одном экземпляре**, например внутренняя панель или ночное задание. Если сам сервис — самая уязвимая часть функции, кластеризация брокера не повысит доступность функции без второго экземпляра приложения.

В этих случаях один сервер — соразмерная инфраструктура.

## Ограничения одного сервера

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`. Когда нужно больше, переходите к [первому кластеру](/learn/topologies/your-first-cluster.md). Механика R3 описана в [Кластеризации и репликации](/learn/clustering/.md).

## Что уже готово

Текущее развёртывание Acme:

* Один сервер разработки `n1` на `4222`, мониторинг на `8222`.
* `order-svc` публикует `orders.*` напрямую, а включённый JetStream хранит `ORDERS` на `n1`.

## Что дальше

Объединим `n1-east`, `n2-east`, `n3-east`, чтобы при отказе сервера клиент переподключался и продолжал работу: [Ваш первый кластер](/learn/topologies/your-first-cluster.md).

## См. также

* [Основные понятия → Топологии](/concepts/topologies.md) — краткий обзор.
* [Справочник → Клиентский протокол](/reference/protocols/client.md) — подключение, URL и параметры.
