mistgate Документация
RU
316

В админке: Ноды

Установка ноды по 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: см. Релизы и подпись. Его состояние показывает строка Пакет релиза на странице «Обновления».

Четыре шага#

  1. Сервер. Введите Адрес SSH-сервера и Порт SSH (обычно 22) и нажмите Проверить сервер. Панель читает SSH host key сервера со своего сервера. Логин и пароль пока не отправляются.
  2. Вход. В блоке «Подтверди ключ сервера» сверьте отпечаток SHA-256 и тип ключа с надёжной копией: той, что показывает консоль хостера, или выводом ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub, выполненным на сервере через эту консоль. Не подтверждайте ключ, который не можете проверить. Поставьте галочку подтверждения и заполните данные ноды: Имя, Адрес (публичный домен или IP для клиентов), Страна, Регион или город и Провайдер. В поле Способ входа выберите Ключ панели или Пароль и введите SSH-логин (по умолчанию root), а для пароля ещё и Пароль SSH. Ключ панели выбран заранее, как только ключ панели вошёл хотя бы на одну ноду. Продолжить может попросить ещё раз подтвердить вход (см. «Повторное подтверждение входа» в Безопасности), затем входит, принимая строго подтверждённый host key, и запускает проверку. Свой ключ, последний вариант, берёт ваш собственный закрытый ключ только для этой установки: см. «Вход со своим ключом» ниже. С паролем отметка Заодно добавить на сервер ключ панели стоит, пока вы её не снимете.
  3. Проверка. Посмотрите Система, Архитектура, Ядро, Процессоры, Память, Свободно на диске, systemd, nftables и Связь с панелью. У сервера без команды nft (в облачных образах Debian 13 её нет) в строке nftables будет «Нет, установка поставит». Если входите с паролем, введите его ещё раз; с ключом панели вводить нечего. Отметьте «Установить агент Mistgate и создать ноду» и нажмите Запустить установку. До этого момента сервер не меняется.
  4. Установка. Задание идёт в панели по этапам: подключение по SSH, проверка сервера, установка nftables (только если на сервере нет команды nft), настройка firewall сервера, передача агента, регистрация ноды, запуск агента, ожидание подключения ноды. Закрыть, оставить установку в фоне закрывает окно, задание продолжается. Когда агент подключится, окно напишет «Нода установлена и подключена» и предложит Открыть ноду. Если задание не удалось, окно назовёт причину и предложит Повторить установку (снова с паролем или с ключом панели как есть) или Открыть менеджер установки. Со своим ключом или с паролем и отметкой задание сначала добавляет ключ панели и только потом меняет остальное; для повтора со своим ключом его нужно дать ещё раз.
Вы даёте адрес сервера и подтверждаете его ключ хоста; панель входит только с этим ключом, проверяет сервер, открывает порты, передаёт подписанный агент, подключает его одноразовым токеном, ставит службу и ждёт, пока агент подключится. адрес сервера прочитать SSH-ключ хоста отпечаток для сверки подтверждение, данные ноды, вход вход только с этим ключом, проверки система, память, связь с панелью Запустить установку открыть порты во включённом файрволе передать подписанный агент подключить одноразовым токеном поставить службу systemd агент подключается (взаимный TLS) Нода установлена и подключена Вы Панель Сервер de1

Профиля на новой ноде пока нет: дальше — Первые пользователи.

Вход с ключом панели#

У панели есть одна своя пара SSH-ключей, она создаётся при первой необходимости. Закрытая половина хранится зашифрованной мастер-ключом и никогда не покидает панель, даже для вас; открытая половина одна для всех нод. Имея её на сервере, панель входит без пароля, в том числе на сервер, который принимает только ключи. Ключ панели в поле Способ входа показывает ключ с кнопкой Скопировать ключ и его отпечаток и раскрывает блок Как добавить его у хостера.

Проще всего один раз добавить ключ в аккаунт хостера:

  1. В панели управления хостера откройте SSH-ключи и выберите «Добавить SSH-ключ».
  2. Назовите его, например, mistgate, вставьте ключ и оставьте включённым «Сохранить ключ в аккаунте», чтобы его получал каждый новый сервер.
  3. Создайте сервер с этим ключом или переустановите существующий с ним.
  4. Вернувшись в мастер, продолжайте с Ключ панели: пароль не нужен.

Уже работающий сервер принимает ключ одной командой, выполненной от имени SSH-логина (Скопировать команду под подсказкой выдаёт её с подставленным ключом):

Shell
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.

  1. Проверка. Панель читает ОС, архитектуру, ядро, процессоры, память, свободное место в /root и наличие systemd, проверяет, нет ли на сервере уже данных ноды Mistgate, и может ли сервер открыть TCP-соединение с адресом панели для агентов (тест на 5 секунд).
  2. nftables. Если на сервере нет команды nft, панель ставит пакет nftables через apt-get отдельным шагом, который мастер называет: ждёт до 5 минут, пока освободится другой менеджер пакетов (cloud-init и unattended-upgrades работают в первые минуты свежего образа), при первой неудаче обновляет списки пакетов и больше ничего не ставит. Если пакет поставить не удалось, задание останавливается здесь, со своим сообщением, ещё до передачи агента. Сервера, где nft есть, этот шаг не касается.
  3. Firewall сервера. Меняется только уже активный firewall; неактивный остаётся выключенным. В UFW добавляется SSH-порт, затем 80/tcp, 443/tcp и 443/udp с комментарием mistgate-node-provision-v1 — кроме портов, для которых у вас уже есть такое же правило. В firewalld SSH-порт, 80/tcp, 443/tcp и 443/udp добавляются во все активные зоны сразу и постоянно, без перезагрузки правил, которая сбросила бы временные правила.
  4. Агент. Панель передаёт агента под архитектуру сервера из доверенного пакета в /root/mistgate-node, сверяет размер и SHA-256 и делает файл исполняемым.
  5. Регистрация. Панель запускает mistgate-node enroll с одноразовым токеном, который действует час. Токен передаётся через стандартный ввод (--token-stdin) и никогда не попадает в командную строку. --resume-key сохраняет ожидающий ключ на диске, чтобы прерванную регистрацию можно было повторить с тем же ключом.
  6. Служба. Панель запускает mistgate-node install: он пишет защищённый юнит systemd и запускает агента — так же, как при ручной установке (см. «Что происходит на сервере» в Добавлении ноды).
  7. Подключение. Панель до 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 Посмотрите журнал сервера, затем повторите.
Установка остановилась. Открой менеджер установки для подробностей Причина, для которой у мастера нет слов; менеджер покажет точный код задания.

Править страницу на GitHub