Добавьте первую ноду

Нода — Linux-хост, который Gateway использует для конкретной роли: публикации приложений, Docker, баз данных, сборок, мониторинга или Relay. После регистрации хост становится доступен для этой роли; существующие рабочие нагрузки на него автоматически не переносятся.

Выберите способ подключения

Ноду можно добавить двумя способами:

• На своём сервере или ВМ: выполните сгенерированную Gateway команду установки по инструкции ниже.
• С созданием ВМ через Gateway: если хотите заказать ВМ прямо из интерфейса, подключите хостинг-провайдера и выберите этот способ в Add Node. Gateway создаст ВМ и установит демон. Дождитесь готовности ноды, а не только включения ВМ.

Результат регистрации — нода в статусе Online с нужной ролью и возможностями.

Выберите роль до регистрации

Роль	Для чего нужна	Что нужно определить заранее
Ingress	Routes, TLS, Pages, журналы nginx и метрики трафика	Какие публичные адреса и порты принадлежат хосту
Docker	Containers, Deployments, Compose Projects, образы, тома и сети	Какие рабочие нагрузки могут делить один Docker-хост
Databases	Управляемые PostgreSQL, Redis и ClickHouse	Хранилище, резервные копии и изоляция данных
Build Worker	Изолированные сборки из Git через BuildKit/containerd	Исходящий доступ и отделение от постоянных учётных данных
Monitoring	Поддерживаемый сбор данных мониторинга	Какие системы разрешено наблюдать этой ноде
Relay	Ёмкость и устойчивость Secure Link	Доступный служебный адрес и физическая зона отказа

Роль должна соответствовать назначению хоста, его сети, хранилищу и владельцу восстановления. Ноды сборки и баз данных обычно стоит размещать на выделенных хостах.

Подготовьте хост

Подготовьте поддерживаемый Linux-хост с root или рабочим sudo, точным системным временем, надёжным DNS и исходящим доступом к публичному gRPC-адресу Gateway на 9443/tcp. Этот адрес обслуживает Relay; он может отличаться от веб-адреса Gateway за прокси.

Дополнительные требования зависят от роли:

• Ingress требует нужных публичных портов и понятной схемы DNS/TLS;
• Docker — поддерживаемого Docker Engine и достаточной ёмкости;
• Databases — постоянного хранилища и необходимых возможностей loop/mount; обычного ограниченного LXC может быть недостаточно;
• Build Worker — выделенного хоста или внешнего непривилегированного контейнера и утверждённых правил исходящего доступа;
• Relay — адреса и порта, доступных участвующим Gateway, Docker, Ingress и Database-хостам.

Gateway не изменяет межсетевой экран хоста и не выполняет обход NAT.

Зарегистрируйте ноду на своём хосте

1. Откройте Nodes и нажмите Add Node.
2. Выберите роль. Для Relay укажите адрес, по которому другие участники смогут связаться с Relay worker.
3. Задайте имя, отражающее постоянное назначение хоста.
4. Создайте ноду и скопируйте команду установки. В ней есть одноразовый токен регистрации и ожидаемый отпечаток сертификата Gateway.
5. Выполните команду на целевом хосте с нужными правами. Не удаляйте отпечаток и не меняйте адрес Gateway, если только настроенный публичный или локальный адрес действительно неверен.
6. Сохраните вывод установки до появления статуса Online.
7. Откройте сведения о ноде и сверьте имя хоста, роль, ОС, версию, адреса и возможности с ожидаемой схемой.

До передачи одноразового токена демон проверяет закреплённый сертификат Gateway. После регистрации постоянное соединение использует взаимный TLS: сертификаты предъявляют обе стороны. Долговечной связью становится зарегистрированная идентичность ноды, а не исходный токен.

Критерии успеха

Регистрация завершена, если:

• нода находится в статусе Online, а не только создана или ожидает подключения;
• тип и имя хоста верны;
• версия совместима с текущим релизом Gateway;
• нужные возможности доступны, а предупреждения о несовместимости версии отсутствуют;
• состояние выбранной роли исправно;
• нода снова подключается после перезапуска службы демона;
• встроенная проверка достигает настроенного канала обновлений;
• оператор может просматривать и обслуживать ноду без широких прав системного администратора.

Для Relay дополнительно проверьте доступность адреса. Новый исправный Relay не переносит существующие соединения автоматически; для намеренного изменения размещения используйте явную операцию перераспределения.

Проверки оператора по ролям

• Ingress: валидация nginx, служебный адрес, порты 80/443 и ограниченный фрагмент журналов nginx.
• Docker: синхронизация инвентаря, состояние среды выполнения, доступ к файловой системе и ожидаемые возможности GPU или Secure Runtime.
• Databases: корень хранилища, контроль ёмкости и завершение предварительной проверки до создания базы.
• Build Worker: состояние BuildKit/containerd, профиль ресурсов, доступность сканера и правила исходящего доступа.
• Relay: состояние supervisor и worker, публикуемый адрес, число активных туннелей и зона отказа.

Сбой и безопасное восстановление

Если регистрация не завершается, не удаляйте ожидающую подключения ноду до сбора данных. Проверьте сгенерированную команду, время, DNS, исходящий 9443/tcp, отпечаток сертификата, журнал установки и журнал службы демона. Веб-адрес за Cloudflare-прокси не обязательно подходит как gRPC-цель.

Не отключайте закрепление сертификата ради успешного соединения: так ошибка конфигурации превращается в риск подмены идентичности. Если адрес gRPC неверен, исправьте Settings > Gateway > General и создайте новую команду.

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

Далее выберите задачу: опубликуйте первый Route, запустите Docker-приложение или создайте базу данных.