> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключение и парк нод

> Добавление Linux-серверов по одному и пачкой, проверка SSH-ключей, импорт, поиск и изменение адреса.

**Парк нод** объединяет самостоятельно подключённые серверы и ноды из Axottle. Здесь ищут машины, смотрят готовность SSH и агента, открывают рабочую страницу, терминал и файлы. Telepúrte подключает существующие серверы; покупка облачной машины выполняется отдельно, например через [провайдеров Axottle](https://docs.axottle.com/ru/providers/provisioning.md).

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

| Сценарий | Что выбрать | Что подготовить |
| - | - | - |
| Один сервер | Добавление Linux-ноды по SSH | Адрес, порт, административный вход |
| Несколько серверов | Пакетное добавление | Карточки адресов, общий SSH-пользователь и реквизиты |
| Серверы в Axottle | Импорт Axottle | Связь панелей, актуальные ноды и агенты в Axottle |

Для изменения каталога нужны права управления нодами. Возможность просматривать парк не выдаёт доступ к терминалу.

## Добавление по SSH

1. Откройте **Парк нод → Добавить ноды** и выберите существующий Linux-сервер.
2. Укажите имя, адрес и SSH-порт. Для пакетного добавления заполните отдельную карточку каждой машины.
3. Проверьте адреса: при первом подключении мастер автоматически закрепляет SSH-ключ ноды. Отдельного поля для ручного ввода host key в текущем мастере нет. Для независимой проверки сверяйте ключ с доверенным каналом, например консолью провайдера.
4. Выберите пароль или приватный ключ для разового подключения. Пользователь должен быть `root` либо иметь подходящий sudo без пароля. На сервере нужны OpenSSH и systemd.
5. Проверьте сводку и запустите подготовку. Реквизиты начального входа используются для этой операции и не становятся постоянным паролем операторов.
6. Дождитесь итогового состояния и откройте карточку ноды.

Подготовка настраивает доверие SSH к Telepúrte, проверяет конфигурацию sshd перед применением и проверяет повторное подключение. При последующих подключениях смена закреплённого ключа блокирует доступ. Если ошибка произошла позже, запись ноды может остаться неподготовленной — это нужно исправить, а не считать успешным подключением.

> [!WARNING]
>
> Не подтверждайте новый host key только потому, что прежний не подходит. Смена ключа может означать переустановку сервера, ошибочный адрес или другую машину. Сначала установите причину через независимый канал.

## Пакетное добавление

Машины обрабатываются последовательно, результаты показываются отдельно. Успех на первых серверах не означает успех всей пачки. Исправляйте конкретные неудачные записи и сверяйте частичный результат перед повтором.

При добавлении в группу по меткам Telepúrte применяет условия группы к выбранным нодам. Конфликтующая существующая метка не должна незаметно заменяться: разберите конфликт перед повторной попыткой. Несвязанные метки сохраняются.

## Что означают состояния

| Состояние | Практический смысл |
| - | - |
| Нода в каталоге | Telepúrte знает о машине; подключение ещё может быть не готово |
| SSH проверен | Подтверждена личность сервера и подготовлен доступ |
| Агент online | Недавно получено сообщение агента; действия зависят от версии и политики |
| Источник отсутствует | Импортированная нода исчезла из актуального инвентаря; история сохраняется |
| Нет доступа пользователя | Нужны роль или грант и допустимый системный логин |

Для Web SSH одновременно нужны проверенная нода, действующий доступ пользователя и готовый бастион. Для плейбука — подходящий агент и права на каждое действие.

## Поиск и организация

Ищите по имени, IP, домену, проекту, локации и меткам. Используйте фильтры источника, проекта, готовности SSH и состояния агента. Для повторяющегося выбора серверов заведите [метки и группы](https://docs.axottle.com/ru/telepurte/groups.md), для площадок — локации.

Название ноды открывает [рабочую страницу](https://docs.axottle.com/ru/telepurte/node-workspace.md): параметры подключения, метрики, процессы, сервисы, доступ, ограничения и история.

## Изменение адреса и отключение

Переименование и описательные поля не меняют SSH-идентичность. Смена IP сбрасывает прежнюю проверку и связанные разрешения, действующие подключения закрываются. Заново проверьте host key и выдайте необходимые разрешения; старые гранты автоматически не оживают.

Отключение ноды прекращает её использование в новых операциях, сохраняя историю. Оно не выключает Linux-сервер у провайдера и не удаляет размещённые приложения.

## Проверка

Проверьте карточку, host key, SSH-готовность и агента, откройте терминал и выполните `hostname` и `whoami`. После пакетного подключения сравните успешные и неудачные результаты с исходным списком.

## Откат

Отзовите тестовые разрешения или отключите ошибочно подключённую ноду. Если подготовка частично изменила SSH на сервере, проверьте его конфигурацию через независимый вход; удаление строки из панели не восстанавливает файлы sshd.

Доступность функций зависит от версии панели, бастионов и агентов; старые сборки могут не содержать описанных возможностей.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.