В админке: Ноды
Установка ноды по SSH
Как панель сама ставит агента ноды на новый сервер по SSH своим ключом или паролем, как следить за заданиями установки, отменять и повторять их и как устроен сохранённый SSH-доступ.
На этой странице
При установке по SSH панель сама подключается к новому серверу, проверяет его, ставит агента ноды и ждёт, пока он подключится: ничего не нужно копировать на сервер и вставлять команды. Это работа владельца, она начинается в Ноды → Добавить ноду → Запустить автоустановку по SSH. Ту же установку может запустить AI-агент через MCP, а вы одобряете её в админке: см. инструкцию для AI-агента. Если панель не может подключиться к серверу по SSH, используйте ручную установку.
Что понадобится#
- Сервер с Ubuntu 22.04 или новее либо Debian 12 или новее, amd64 или arm64, с systemd, хотя бы 256 МиБ памяти и местом в
/rootдля агента (его размер плюс 64 МиБ). См. Требования. - Вход по SSH как
rootили как пользователь, которомуsudo -nразрешён без пароля, — с ключом панели на сервере (см. «Вход с ключом панели» ниже) или с паролем. Адрес должен быть публичным: приватные, loopback- и link-local-адреса отклоняются. - SSH, открытый для сервера панели. Если firewall или security group хостера ограничивают SSH, сначала разрешите входящий TCP на SSH-порт с публичного исходящего адреса сервера панели. Панель может менять только firewall на самом сервере и только после SSH-подключения.
- Адрес панели для агентов, доступный с сервера: публичный адрес панели на TCP 443 или адрес из
serve --agent-addr. Проверка тестирует это. - Публичный адрес, известный панели:
setup --public-urlилиserve --agent-addr. Без него мастер пишет «Не настроен публичный адрес панели». - Доверенный пакет агента ноды с неистёкшим сроком в каталоге данных панели. Панель из официального релиза скачивает его из GitHub Releases при запуске и потом каждые 10 минут. Панели, которую вы собрали сами, нужен подписанный вами пакет в
<data-dir>/dist: см. Релизы и подпись. Его состояние показывает строка Пакет релиза на странице «Обновления».
Четыре шага#
- Сервер. Введите Адрес SSH-сервера и Порт SSH (обычно 22) и нажмите Проверить сервер. Панель читает SSH host key сервера со своего сервера. Логин и пароль пока не отправляются.
- Вход. В блоке «Подтверди ключ сервера» сверьте отпечаток SHA-256 и тип ключа с надёжной копией: той, что показывает консоль хостера, или выводом
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub, выполненным на сервере через эту консоль. Не подтверждайте ключ, который не можете проверить. Поставьте галочку подтверждения и заполните данные ноды: Имя, Адрес (публичный домен или IP для клиентов), Страна, Регион или город и Провайдер. В поле Способ входа выберите Ключ панели или Пароль и введите SSH-логин (по умолчаниюroot), а для пароля ещё и Пароль SSH. Ключ панели выбран заранее, как только ключ панели вошёл хотя бы на одну ноду. Продолжить может попросить ещё раз подтвердить вход (см. «Повторное подтверждение входа» в Безопасности), затем входит, принимая строго подтверждённый host key, и запускает проверку. Свой ключ, последний вариант, берёт ваш собственный закрытый ключ только для этой установки: см. «Вход со своим ключом» ниже. С паролем отметка Заодно добавить на сервер ключ панели стоит, пока вы её не снимете. - Проверка. Посмотрите Система, Архитектура, Ядро, Процессоры, Память, Свободно на диске, systemd, nftables и Связь с панелью. У сервера без команды
nft(в облачных образах Debian 13 её нет) в строке nftables будет «Нет, установка поставит». Если входите с паролем, введите его ещё раз; с ключом панели вводить нечего. Отметьте «Установить агент Mistgate и создать ноду» и нажмите Запустить установку. До этого момента сервер не меняется. - Установка. Задание идёт в панели по этапам: подключение по SSH, проверка сервера, установка nftables (только если на сервере нет команды
nft), настройка firewall сервера, передача агента, регистрация ноды, запуск агента, ожидание подключения ноды. Закрыть, оставить установку в фоне закрывает окно, задание продолжается. Когда агент подключится, окно напишет «Нода установлена и подключена» и предложит Открыть ноду. Если задание не удалось, окно назовёт причину и предложит Повторить установку (снова с паролем или с ключом панели как есть) или Открыть менеджер установки. Со своим ключом или с паролем и отметкой задание сначала добавляет ключ панели и только потом меняет остальное; для повтора со своим ключом его нужно дать ещё раз.
Профиля на новой ноде пока нет: дальше — Первые пользователи.
Вход с ключом панели#
У панели есть одна своя пара SSH-ключей, она создаётся при первой необходимости. Закрытая половина хранится зашифрованной мастер-ключом и никогда не покидает панель, даже для вас; открытая половина одна для всех нод. Имея её на сервере, панель входит без пароля, в том числе на сервер, который принимает только ключи. Ключ панели в поле Способ входа показывает ключ с кнопкой Скопировать ключ и его отпечаток и раскрывает блок Как добавить его у хостера.
Проще всего один раз добавить ключ в аккаунт хостера:
- В панели управления хостера откройте SSH-ключи и выберите «Добавить SSH-ключ».
- Назовите его, например,
mistgate, вставьте ключ и оставьте включённым «Сохранить ключ в аккаунте», чтобы его получал каждый новый сервер. - Создайте сервер с этим ключом или переустановите существующий с ним.
- Вернувшись в мастер, продолжайте с Ключ панели: пароль не нужен.
Уже работающий сервер принимает ключ одной командой, выполненной от имени SSH-логина (Скопировать команду под подсказкой выдаёт её с подставленным ключом):
mkdir -p ~/.ssh && chmod 700 ~/.ssh && echo 'ssh-ed25519 AAAA… mistgate-panel' >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keysЕсли сервер не принимает ключ, мастер пишет «Сервер не принял ключ панели» и открывает подсказку: ключ должен быть в ~/.ssh/authorized_keys введённого логина. Нода, установленная по ключу, пароля не хранит; позже его можно задать на её карточке SSH-доступа (см. «Сохранённый SSH-доступ» ниже). Когда установку планирует AI-агент, экран одобрения предлагает тот же выбор: Ключ панели или Пароль.
Установка с паролем тоже кладёт на сервер ключ панели, если не снять отметку Заодно добавить на сервер ключ панели: панель добавляет ключ, входит с ним для проверки и дальше входит по ключу, а пароль остаётся запасным. Если сервер ключ не принимает, установка продолжается с паролем, а менеджер установки пишет почему. Установка с паролем, которую планирует AI-агент, всегда добавляет ключ, и экран одобрения об этом пишет.
Вход со своим ключом#
Свой ключ, последний вариант в поле Способ входа, берёт закрытый ключ, который уже пускает на сервер, например ваш ~/.ssh/id_ed25519: перетащите файл в поле или вставьте ключ. Мастер никогда не показывает ключ обратно, только «Ключ добавлен». Если у ключа есть парольная фраза, мастер спросит её, когда панель прочитает ключ.
Ключ нужен только для этой установки и нигде не сохраняется: задание держит его зашифрованным, пока идёт, и удаляет по окончании. Прежде чем менять на сервере что-то ещё, панель добавляет свой ключ и входит с ним, и дальше сохранённый доступ ноды — ключ панели. Для повтора ключ нужно дать ещё раз.
Надёжнее добавить ключ панели у хостера. Ваш личный ключ часто открывает много серверов, а так он проходит через браузер и панель.
Что панель делает на сервере#
Всё идёт по одному SSH-соединению, которое принимает только подтверждённый host key. Для логина, отличного от root, каждая команда выполняется через sudo -n.
- Проверка. Панель читает ОС, архитектуру, ядро, процессоры, память, свободное место в
/rootи наличие systemd, проверяет, нет ли на сервере уже данных ноды Mistgate, и может ли сервер открыть TCP-соединение с адресом панели для агентов (тест на 5 секунд). - nftables. Если на сервере нет команды
nft, панель ставит пакетnftablesчерезapt-getотдельным шагом, который мастер называет: ждёт до 5 минут, пока освободится другой менеджер пакетов (cloud-init и unattended-upgrades работают в первые минуты свежего образа), при первой неудаче обновляет списки пакетов и больше ничего не ставит. Если пакет поставить не удалось, задание останавливается здесь, со своим сообщением, ещё до передачи агента. Сервера, гдеnftесть, этот шаг не касается. - Firewall сервера. Меняется только уже активный firewall; неактивный остаётся выключенным. В UFW добавляется SSH-порт, затем 80/tcp, 443/tcp и 443/udp с комментарием
mistgate-node-provision-v1— кроме портов, для которых у вас уже есть такое же правило. В firewalld SSH-порт, 80/tcp, 443/tcp и 443/udp добавляются во все активные зоны сразу и постоянно, без перезагрузки правил, которая сбросила бы временные правила. - Агент. Панель передаёт агента под архитектуру сервера из доверенного пакета в
/root/mistgate-node, сверяет размер и SHA-256 и делает файл исполняемым. - Регистрация. Панель запускает
mistgate-node enrollс одноразовым токеном, который действует час. Токен передаётся через стандартный ввод (--token-stdin) и никогда не попадает в командную строку.--resume-keyсохраняет ожидающий ключ на диске, чтобы прерванную регистрацию можно было повторить с тем же ключом. - Служба. Панель запускает
mistgate-node install: он пишет защищённый юнит systemd и запускает агента — так же, как при ручной установке (см. «Что происходит на сервере» в Добавлении ноды). - Подключение. Панель до 2 минут ждёт подключения агента, затем сохраняет SSH-доступ (в зашифрованном виде) и завершает задание.
Дальше агент сам держит UFW в соответствии со своими профилями: применив включённый UDP inbound, он добавляет в активный UFW этот точный порт и принятый диапазон прыжков по портам Hysteria2 — правилами, помеченными как свои. Правило для того же порта, которое добавил не он, агент никогда не меняет и не удаляет. UFW запускается вне песочницы агента, временным юнитом systemd. firewalld только проверяется: агент называет порты, которых нет в зоне по умолчанию, а добавляете их вы. Если firewall сервера не удалось привести в порядок, у ноды появится одно предупреждение host_firewall_sync_failed, а inbound продолжит работать. Вывод ноды из флота удаляет помеченные правила, включая правила 80/443 от установки; правило SSH не удаляется никогда.
Задания установки и менеджер установки#
Каждая установка — это задание, которое панель хранит. Менеджер установки по адресу <адрес админки>nodes/install показывает последние 100 заданий с их состоянием (в очереди, установка, остановка, отменено, нода подключена, ошибка) и сохранённые доступы к серверам. Страница задания показывает его этапы, обновляется каждые 4 секунды и никогда не показывает вывод с сервера. Открыть её может только владелец.
Менеджер установки говорит по-русски, по-английски или по-китайски (упрощённый): на языке админки, если открыт из мастера (он передаёт ?lang=; для админки на персидском или турецком — по-английски), иначе на первом языке браузера, если это китайский или русский, иначе по-английски.
- Отмена. Задание в очереди останавливается сразу, его временные SSH-данные удаляются. Идущее задание получает запрос на остановку; команда, которая уже выполняется на сервере, могла его изменить, поэтому перед повтором проверьте сервер.
- Повтор. Неудачное или отменённое задание можно запустить снова с SSH-логином и паролем либо с ключом панели. Проверка увидит, есть ли на сервере уже данные этой ноды, и задание продолжится с того места; сервер с данными другой ноды отклоняется. Задание ноды, выведенной из флота, повторить нельзя: начните новую установку.
- Имена. Имя ноды занято, пока нода активна или для неё идёт установка. Вывод ноды сохраняет историю и освобождает имя.
- Пароль. Пока задание идёт, SSH-пароль хранится зашифрованным мастер-ключом панели и привязан к этому заданию. Когда задание заканчивается, он удаляется; при успехе он становится сохранённым доступом ноды. Задание с ключом панели не хранит секретов, только логин. Собственный закрытый ключ хранится так же, без парольной фразы, и удаляется по окончании задания.
Сохранённый SSH-доступ#
После успешной установки панель хранит SSH-логин и пароль (у ноды, установленной по ключу, пароля нет), зашифрованные мастер-ключом, вместе с закреплённым host key и отметкой, входит ли ключ панели. Ни запросы API, ни инструменты MCP, ни логи никогда не возвращают пароль. Панель входит сначала с ключом, а с сохранённым паролем — только пока этот пароль последний раз работал по SSH.
- Посмотреть. Карточка Сервер → SSH-доступ на странице ноды показывает SSH-сервер, логин и закреплённый ключ сервера, а в заголовке — как панель попадает на сервер: Ключ панели или Только пароль. Показать пароль просит ещё раз подтвердить вход и записывается в журнал аудита.
- Сменить. На той же карточке Сменить пароль предлагает Сгенерировать (панель придумает пароль из 26 символов) или Ввести свой (не короче 12 символов) и просит ещё раз подтвердить вход. Смена может занять до минуты, карточка показывает, что она идёт; не закрывайте страницу. Потом карточка покажет новый пароль с кнопкой копирования на 60 секунд или пока вы не уйдёте с вкладки: сохраните его сразу. Таблица доступов к серверам в менеджере установки тоже принимает введённый пароль, а через MCP
node_server_password_rotateпоручает панели сгенерировать пароль; агент его не видит. В любом случае панель сначала сохраняет новый пароль как ожидающий, меняет его на сервере черезchpasswd, заново входит с ним и только потом заменяет сохранённый: после этого карточка пишет Проверен. У выведенной ноды кнопки Сменить пароль нет. - Пароль не сохранён. У ноды, установленной по ключу, его нет: блок пароля пишет Не сохранён и предлагает Задать пароль, который работает как смена, через ключ панели. Через ключ смена проходит и на сервере, который отказывает во входе по паролю через SSH; тогда карточка отмечает «Вход по паролю через SSH на сервере закрыт — пароль нужен для консоли хостера и sudo».
- Прерванная смена. Если сервер не подтвердил новый пароль, карточка пишет Смена не подтверждена, а следующий показ или смена сначала пробует оба. Если сервер недоступен и нельзя узнать, какой вход работает, Показать пароль покажет «Текущий пароль (не проверен)» и «Новый пароль из прерванной смены (не проверен)»: сначала пробуйте текущий. Новая смена подождёт, пока сервер не ответит. Если сервер отвергает оба, сбросьте пароль через консоль хостера.
- Пароль, сгенерированный панелью. Его знает только панель, и карточка об этом пишет. Покажите его и сохраните копию, прежде чем выводить ноду.
- Выведенная нода. Её карточка SSH-доступа остаётся: панель больше не меняет этот сервер, но пароль по-прежнему можно показать. Забыть сохранённый доступ — с двойным подтверждением и свежим подтверждением входа — удаляет его насовсем. Забыть можно только доступ выведенной ноды. Ключ панели остаётся в
~/.ssh/authorized_keysна том сервере: удалите его там, если панель больше не должна входить.
SSH-ключи на сервере#
Блок Ключи на карточке SSH-доступа работающей ноды показывает ~/.ssh/authorized_keys SSH-логина; панель читает его по SSH, когда карточка открывается (Перечитать ключи читает ещё раз). У каждого ключа видны тип (ED25519, RSA 3072, ECDSA 256, ED25519-SK), комментарий и отпечаток SHA-256, а также отметки: Ключ панели, С ограничениями (в строке есть опции вроде from= или command=) и сколько строк содержат один и тот же ключ. Комментарии и пустые строки только подсчитываются. Нестандартный AuthorizedKeysFile в sshd_config панель не читает, поэтому там список может быть неполным.
- Привязать ключ принимает одну строку открытого ключа, например содержимое
~/.ssh/id_ed25519.pub; RSA-ключ должен быть не короче 2048 бит. Вставленный туда закрытый ключ отклоняется прямо в браузере и никуда не отправляется. Ключ, который уже есть в файле с опциями, остаётся как есть. - Отвязать сначала переспрашивает. Если это ваш единственный ключ, а вход по паролю на сервере закрыт, попасть туда потом можно будет только через панель или консоль хостера.
- Ключ панели. Если его отвязать, панель будет входить по сохранённому паролю и сначала проверит его; без сохранённого пароля ключ отвязать нельзя. Если ключа нет в файле, блок пишет «Ключа панели нет на сервере» и предлагает Вернуть; если он в файле, но панель входит по паролю, — «Панель им не пользуется» и Использовать.
- Нода только с паролем предлагает Поставить ключ панели под заголовком карточки: панель добавляет свой ключ, входит с ним для проверки, а пароль остаётся запасным.
На странице Ноды владелец видит «N нод входят только по паролю», пока у работающих нод нет ключа панели. Поставить ключ панели там отмечает эти ноды и запускает Ключ панели в строке массовых действий: она просит подтвердить вход, затем по очереди добавляет ключ на ноды и для каждой показывает, поставлен он или почему нет. Это происходит только по вашему нажатию; Скрыть убирает предложение, пока ещё какая-нибудь нода не начнёт входить только по паролю. Та же строка меняет пароль SSH сразу на нескольких нодах (каждая получает свой сгенерированный пароль, показать его можно только в её карточке) и привязывает или отвязывает на них ваш ключ: см. Массовые действия.
Подключить SSH-доступ к ноде, поставленной командой#
У ноды, поставленной ручной командой, нет сохранённого SSH-доступа: её карточка Сервер → SSH-доступ пишет «Панель не хранит SSH-доступ к этому серверу» и предлагает Подключить SSH-доступ. Окно спрашивает SSH-адрес (подставлен адрес ноды) и порт, показывает host key для подтверждения и спрашивает вход так же, как мастер установки: Ключ панели, Пароль с Заодно добавить на сервер ключ панели или Свой ключ. Панель входит один раз, проверяет, что на сервере регистрация именно этой ноды, и сохраняет доступ; сервер другой ноды отклоняется. Если пароль подходит, а ключ панели добавить не удалось, доступ сохраняется с паролем, и карточка пишет почему.
В Cloudflare-версии#
Edge-версия панели (панель на Cloudflare Workers) тоже ставит ноды по SSH. Мастер, шаги, менеджер установки и сохранённый доступ те же; установки выполняются во втором скрипте Worker, mistgate-edge-provision, который mistgate edge deploy разворачивает вместе с панелью (см. Установку Cloudflare-версии). Что отличается:
- Панель подключается из сети Cloudflare, а не с известного вам сервера и не с вашего компьютера. На время установки SSH на новом сервере должен принимать входящий TCP из интернета на своём порту: и в firewall или security group хостера, и в firewall на самом сервере. Правило только для вашего IP или одного фиксированного адреса панели даст таймаут: Cloudflare не публикует адреса, с которых подключается Worker. Менять или показывать сохранённый пароль позже тоже придётся по SSH, поэтому для этого откройте доступ снова.
- Агент берётся из подписанного релиза на GitHub, версия которого совпадает с версией панели, а нода регистрируется по публичному адресу панели. У сборки панели, которая не является релизом, нет доверенного агента, и мастер скажет об этом.
- «Отказ или недоступность» (мастер пишет «Сеть панели отказала в соединении с этим адресом, или сервер из неё недоступен») значит, что сеть Cloudflare не соединила панель с этим адресом. Из Worker отказ платформы и закрытый порт выглядят одинаково, поэтому панель не может сказать, что именно случилось. Проверьте: адрес принадлежит Cloudflare или имя проксируется Cloudflare (оранжевое облако в списке DNS), тогда нужен собственный адрес сервера или имя без прокси; частная сеть или сервер, доступный только через VPN или бастион; неверный порт или нет SSH-службы на нём.
Если панель не может подключиться к серверу так, поставьте ноду командой вручную: рядом с этой ошибкой мастер предлагает Поставить командой вручную, а Добавление ноды её описывает. Установка, которую Cloudflare прервал три раза подряд, останавливается как неудавшаяся: повторите её или используйте команду вручную.
Если не получилось#
| Мастер пишет | Что делать |
|---|---|
| Панель не получила ответ от SSH-сервера вовремя | Проверьте, что SSH работает на этом порту, и разрешите входящий TCP с исходящего адреса сервера панели в firewall хостера. Если SSH закрывает firewall сервера, откройте его через консоль хостера. |
| Сеть панели отказала в соединении с этим адресом, или сервер из неё недоступен | Только edge-версия: см. «В Cloudflare-версии» выше. Укажите собственный публичный адрес сервера или используйте ручную установку. |
| Панель не получила ответ от SSH-сервера вовремя, и в тексте названа сеть Cloudflare | Edge-версия: на время установки разрешите входящий TCP на SSH-порт из интернета, а не только с вашего IP, или используйте ручную установку. |
| Панель не смогла получить SSH-ключ по этому адресу | Проверьте адрес, порт и SSH-службу. |
| Укажи публичный адрес сервера, доступный по SSH | Адрес приватный, loopback, link-local или не резолвится. Укажите публичный адрес сервера. |
| Сервер отклонил SSH-логин или пароль | Проверьте оба. Если сервер принимает только ключи, выберите Ключ панели. |
| Сервер не принял ключ панели | Добавьте ключ в ~/.ssh/authorized_keys SSH-логина (SSH-ключи у хостера или команда в блоке Как добавить его у хостера), затем снова нажмите Продолжить. |
| Сервер не принимает вход по паролю, только по ключу | Выберите Ключ панели и добавьте ключ панели на сервер. |
| После подтверждения SSH-ключ изменился | Сервер теперь показывает другой host key: прежде чем начинать заново, выясните почему. |
| Нужна Ubuntu 22.04 или новее либо Debian 12 или новее / Поддерживаются архитектуры amd64 и arm64 | Сервер не поддерживается; ручную установку пробуйте, только если знаете, что агент там работает. |
| Для SSH-пользователя нужен root-доступ или беззапросный sudo | Войдите как root или разрешите пользователю sudo -n. |
| Не настроен публичный адрес панели, поэтому нода не сможет подключиться обратно | Задайте --public-url или --agent-addr. |
| Сервер не смог открыть TCP-соединение с адресом панели для агентов | Разрешите порт агентов в firewall или security group перед панелью, проверьте DNS адреса для агентов и исходящий TCP с сервера, затем попробуйте снова. |
| На сервере нет systemd | Нужна Ubuntu 22.04+ или Debian 12+ с systemd. |
| У сервера мало памяти или процессора | Агенту нужно не меньше 256 МБ оперативной памяти. |
| На сервере мало свободного места для агента | Нужен размер агента плюс 64 МБ. Освободите место и повторите. |
| На сервере уже есть данные другой или повреждённой ноды Mistgate | Удаляйте /var/lib/mistgate-node на сервере, только если той ноды больше нет, затем повторите. |
| У панели нет проверенного агента для архитектуры этого сервера | Проверьте Пакет релиза на странице «Обновления», затем повторите. |
| Это имя ноды уже занято | Выберите другое имя или сначала выведите старую ноду. |
| На сервере нет команды nft, а панель не смогла поставить пакет nftables | В облачных образах Debian 13 nft нет. Поставьте пакет вручную от root (apt-get install -y nftables), затем нажмите Повторить установку. Без него у агента не работают защита SSH, прыжки по портам и WARP. |
| Панель подключилась, но не смогла настроить активные правила UFW/firewalld | Проверьте root или sudo -n у пользователя и firewall сервера, затем повторите. |
| SSH прервался после изменений на сервере | Часть команд установки могла выполниться. Посмотрите на сервер, затем повторите. |
| Агент установился, но не подключился к панели | На сервере: journalctl -u mistgate-node -n 50 --no-pager. Обычно нода не может достучаться до адреса панели для агентов. |
| Mistgate не смог установить или запустить службу systemd | Посмотрите журнал сервера, затем повторите. |
| Установка остановилась. Открой менеджер установки для подробностей | Причина, для которой у мастера нет слов; менеджер покажет точный код задания. |