В админке: Здоровье
Решение проблем
Частые проблемы по симптомам, как каждая из них выглядит в панели и что с ней делать.
На этой странице
- Нода не выходит на связь
- Подключение ноды не проходит
- Установка по SSH не проходит
- Профиль не запускается
- Клиенты подключаются, но трафик не идёт
- Проверки проходят, но приложение одного человека не работает
- Прокси на том же сервере перестаёт работать при включённом VPN
- Хостер режет UDP
- По Wi-Fi работает, по мобильной сети — нет
- Часы уходят
- Нет модуля ядра AmneziaWG
- Обновление ядра падает на сборке модуля AmneziaWG
- WARP не работает
- Обновление откатилось
- Админка недоступна
- Журнал панели, сроки хранения, экспорт и метрики
- Отладочная запись одной ноды
- Нода не вернулась после обновления ОС
- Панель не перезагрузила ноду после установки обновлений
- Multipath TCP и CVE-2026-98432
Найдите симптом, посмотрите, как он выглядит в панели, и выполните шаги. Большинство ответов начинается на странице ноды: её баннер, вкладки Профили, История и Доктор, а также страница «Здоровье».
Команды на ноде выполняются от root. Служба агента — mistgate-node, её лог в журнале:
journalctl -u mistgate-node -n 100 --no-pagerНода не выходит на связь#
Как это выглядит
- Ждёт установки: ноду добавили, но агент ещё ни разу не подключился. Баннер («Ждём агента») пишет, до какого времени действует команда установки, или что она устарела. Для ноды, которую вы ставите по SSH, см. «Установка по SSH не проходит» ниже.
- Хостер моргнул (серый): нет связи меньше 10 минут. Короткие провалы обычно на стороне хостера; алертов пока нет.
- Недоступна: нет связи 10 минут и дольше. Открывается алерт «Нода недоступна», пишется событие «перестала отвечать».
Что делать
-
Откройте панель хостера и проверьте, что сервер запущен.
-
Если запущен, зайдите по SSH и перезапустите агента (баннер даёт эту команду для копирования):
systemctl restart mistgate-node && journalctl -u mistgate-node -n 50 --no-pager -
Проверьте, что нода достаёт до панели: агент всегда подключается сам, по адресу из своей команды установки (
--panel host:port, по умолчанию порт 443). Его может не пускать исходящий файрвол на ноде или входящий на сервере панели. -
На стороне панели точке подключения агентов нужен TLS: публичный адрес должен работать с
--acme-domainили--tls-cert, либо у панели должен быть отдельный--agent-listen. См. «Конфигурацию». -
Если в логе написано, что для агента не выполнен
enrollили нода выведена из флота, агент завершается, и systemd его не перезапускает. Подключите его заново Новой командой установки с вкладки Сервер ноды. Выведенную из флота ноду заново не подключить: добавьте сервер как новую ноду. -
Для далёкой или медленной ноды увеличьте Разрывать связь с агентом после и Таймаут подключения агента на вкладке Сервер ноды.
Ноде, у которой команда установки устарела, нужна Новая команда установки; старая больше не сработает.
Подключение ноды не проходит#
mistgate-node enroll печатает enroll: и причину.
| Сообщение | Причина | Что делать |
|---|---|---|
--panel, --sni, --ca-sha256 and a token source are required |
Команда обрезалась при копировании. | Скопируйте команду целиком ещё раз. |
enrollment token unknown, expired or used |
Команда установки срабатывает один раз и действует час. | Сделайте Новую команду установки на странице ноды. |
the CA returned by the panel does not match --ca-sha256 или no certificate in the chain matches the pinned CA fingerprint |
Агент попал не на эту панель: неверный адрес или прокси, который сам завершает TLS. | Проверьте --panel. Агенту нужен прямой TLS-путь до панели. |
already enrolled; use --force to replace the identity |
В каталоге состояния уже есть удостоверение ноды. | Добавьте --force к свежей команде или сначала уберите старую ноду. |
too many failed attempts, try later |
Слишком много неудачных попыток с этого адреса за последнюю минуту. | Подождите минуту. |
node retired |
Ноду вывели из флота в панели. | Добавьте сервер как новую ноду. |
remote error: tls: handshake failure (или unrecognized name, internal error) |
Сервер по этому адресу не принял имя агента, значит, это не сама панель: TLS там завершает CDN-прокси (проксируемая запись в Cloudflare), обратный прокси или панель управления хостингом, порт занят другим сервисом либо команда от другой панели. Сертификат за именем агента намеренно выпущен собственным CA панели и закреплён через --ca-sha256: менять или настраивать его не нужно. |
Дайте агентам прямой TLS-путь: укажите в --agent-addr собственный IP сервера или имя в режиме DNS-only; за обратным прокси выделите им отдельный порт через --agent-listen (раздел «За обратным прокси» в Установке панели и Можно ли поставить панель за Cloudflare?). Затем сделайте Новую команду установки. |
| Ошибка соединения или таймаут | Панель недоступна по этому адресу и порту. | Проверьте DNS, файрволы и что панель говорит там по TLS (см. выше). |
install нужен root и каталог состояния после enroll: сначала выполните enroll, с тем же --state-dir, если вы его меняли.
Если Получить команду установки в админке отвечает «panel address is not configured», панель не знает адреса, по которому агентам подключаться: выполните setup с --public-url или запустите serve с --agent-addr (см. CLI).
Установка по SSH не проходит#
Ноды → Добавить ноду → Запустить автоустановку по SSH подключается с сервера панели, поэтому SSH-порт ноды должен быть доступен оттуда, а нода должна достучаться обратно до панели. Если задание не удалось, мастер пишет почему и предлагает Повторить установку (снова с паролем SSH; продолжает с того места, где остановилось) и Открыть менеджер установки, где видна точная причина.
Самые частые причины:
- Файрвол или группа безопасности хостера не пускает сервер панели на SSH-порт («Панель не получила ответ от SSH-сервера вовремя»). Правила хостера панель поменять не может.
- Сервер не достаёт до адреса подключения агентов, или у панели нет публичного адреса: в обоих случаях пишется «Не настроен публичный адрес панели, поэтому нода не сможет подключиться обратно». Проверьте
--public-urlили--agent-addrи исходящий TCP с ноды к панели (обычно 443). - У панели ещё нет доверенного пакета для нод («Установка остановилась»): см. строку Пакет релиза на странице «Обновления».
Все сообщения и что с ними делать — в разделе «Если не получилось» на странице Установка ноды по SSH.
Профиль не запускается#
Как это выглядит
- На вкладке Профили ноды у профиля написано Не запустился с причиной, а баннер ноды пишет «„<профиль>“ не запустился».
- Проверка глазами клиента показывает «✕ не запущен»; пишется событие «„<профиль>“ не запустился».
| Причина в админке | Что делать |
|---|---|
| Порт N занят другой программой (…) | Пункт доктора Занятые порты называет процесс. Остановите эту программу или перенесите профиль на свободный порт этой ноды: Сменить порт на вкладке «Профили». Посмотреть самому: ss -lupn 'sport = :443' (UDP) или ss -ltpn 'sport = :443' (TCP). |
| Не удалось получить сертификат: нужен домен с A-записью на IP ноды и открытые порты 80 и 443 | Укажите Домен (SNI), A-запись которого смотрит на ноду, откройте TCP 80 и 443 на ноде или переключите профиль на самоподписанный сертификат. На IP-адрес Let's Encrypt сертификат не выдаёт. |
| Нет рабочего WARP на ноде | См. «WARP не работает» ниже. |
| AmneziaWG не запустился на ноде | См. «Нет модуля ядра AmneziaWG» ниже. |
| Агенту не хватает прав на сервере | Прочитайте исходный текст ошибки под этой строкой и лог ноды. Агент работает в защищённой службе с небольшим набором прав; если вы видите устаревший юнит в разделе «Здоровье» → «Доктор», примените Обновить службу, либо выполните mistgate-node install текущим бинарником, если агент слишком старый для исправления. |
Когда порт освободился, Перезапустите профиль (или примените исправление доктора Перезапустить профиль).
Порт внутри диапазона прыжков другого профиля или занятый Caddy и другим веб-сервером на TCP 443 доктор тоже покажет. Диалог добавления профиля на ноду заранее проверяет порт и сертификат и предлагает свободный порт.
Клиенты подключаются, но трафик не идёт#
Как это выглядит
- Проверки проходят с ошибками (туннель поднимается, одна тестовая страница не открывается) или не проходят с «Туннель работает, а выход ноды в интернет нет» или «Тестовые сайты отвечают ошибкой».
- Алерт объясняет это в причине; люди говорят «подключено, но ничего не открывается».
Что проверить
- Собственный резолвер ноды — пункт доктора Резолвер сервера. Имена для проверки разрешает нода; если они не разрешаются, примените Исправить резолвер.
- DNS-серверы этой ноды на вкладке Выход ноды — резолверы для трафика ваших пользователей. По умолчанию — резолвер самого сервера.
- WARP: если не проходят только профили с выходом через WARP, см. «WARP не работает».
- AmneziaWG: пункт доктора Бэкенд AmneziaWG предупреждает, когда файрвол хоста отбрасывает пересылаемый трафик (часто из-за Docker на том же сервере).
- Пункты доктора Чужие правила файрвола и Следы других VPN: чужое правило nat или перенаправления может съедать трафик.
- Пункт доктора IPv6: адрес IPv6, который не соединяется наружу, заставляет подвисать сайты с IPv6-записями.
Проверки проходят, но приложение одного человека не работает#
Проверки панели подключаются собственным ключом панели, поэтому зелёная проверка ничего не говорит о ключах приложений человека. Каждое приложение, которое забирает подписку с ID устройства, получает свои ключи (см. «Пользователи и группы»); ключи удалённого устройства перестают работать, а приложение сверх лимита устройств получает только запись-заглушку с названием лимита.
- На странице человека посмотрите статус (отключён, срок истёк, квота выбрана) и Устройства: сколько мест занято из лимита и какие приложения по ссылке.
- Строка 24 ч под профилем на вкладке Профили ноды: если неизвестные ключи растут, пока человек пытается подключиться, его приложение приходит с ключом, которого нода не знает, — от удалённого устройства или старой подписки.
- Удалите там старые приложения, затем в приложении удалите подписку, добавьте ссылку заново и обновите. Появится одно новое устройство. Проверьте, что в списке серверов приложения нет записи с названием лимита.
Прокси на том же сервере перестаёт работать при включённом VPN#
Клиент AmneziaWG с полным туннелем может обращаться к панели на TCP 443, если она использует адрес ноды, и к другим включённым входам, включая HTTPS-сайт Hysteria2 на его настроенном порту. UDP-порты самих AWG-туннелей, SSH и порты управления из туннеля закрыты. Для этого нужен агент ноды v0.1.85; у старого агента открыт только TCP 443.
Хостер режет UDP#
Hysteria2 и AmneziaWG работают поверх UDP, а некоторые хостеры режут UDP на части портов или целиком.
Как это выглядит
- Проверка не проходит с «Нет рукопожатия: UDP-трафик, скорее всего, не доходит».
- «„<профиль>“ не отвечает на порту N, а другой профиль этой ноды отвечает: хостер режет UDP-порт N».
- «Жива, но трафик не идёт»: «похоже, хостер режет этот UDP-порт» или, на 443 или нескольких портах, «похоже, хостер режет входящий UDP целиком».
- Для AmneziaWG статус профиля на вкладке Профили ноды различает два случая: «До порта не дошёл ни один пакет: хостер или фаервол режет этот UDP-порт» и «Пакеты приходят, но рукопожатие не завершается: параметры обфускации на ноде и в конфиге различаются».
- В Истории → События ноды есть
host_firewall_sync_failed: собственный файрвол сервера не пропускает UDP-порт профиля.
Что делать
- Проверьте файрвол или группу безопасности в панели хостера: UDP-порты профиля (и его диапазон прыжков) должны быть открыты для входящего трафика.
- Проверьте собственный файрвол сервера. При активном UFW агент сам добавляет разрешающие правила для UDP-портов и диапазонов прыжков серверов ноды, но никогда не меняет правило, которое добавил не он: ваше правило
denyилиrejectдля такого порта остаётся, и событие его называет. firewalld агент не трогает никогда: добавьте эти UDP-порты в его активную зону вручную. - Перенесите профиль на другой порт этой ноды: Сменить порт на вкладке Профили ноды.
- Если закрыты все порты, напишите в поддержку хостера или перенесите ноду.
Проверка использует основной порт профиля, а не диапазон прыжков по портам, поэтому закрытый диапазон прыжков здесь не виден.
По Wi-Fi работает, по мобильной сети — нет#
Как это выглядит
- По Wi-Fi приложение работает, а по мобильной сети подключается и через несколько секунд перестаёт отвечать или не подключается вовсе.
- У AmneziaWG по мобильной сети первое рукопожатие может пройти, а новые рукопожатия приложения до ноды уже не доходят; профиль на UDP 443 может не получить ни одного пакета.
- Проверки панели и проверка портов проходят.
Что это значит
Трафик режет мобильный оператор человека, а не нода и не хостер: UDP до зарубежных адресов, QUIC или любые соединения с зарубежными хостингами после нескольких килобайт. Панель этого не видит: проверка портов шлёт пакеты из дата-центров, а проверки доступности из страны идут по ICMP и TCP, а не по UDP-портам AmneziaWG и Hysteria2.
Что делать
- Дайте человеку для мобильной сети сервер VLESS REALITY по TCP 443: см. VLESS.
- Если соединения с зарубежными хостингами замерзают после нескольких килобайт, добавьте ретрансляцию через ноду-вход в стране человека. Она передаёт VLESS и Hysteria2, AmneziaWG пока нет; при белых списках на мобильной сети она поможет, только если адрес входа сам в списке.
- Иногда помогает другой UDP-порт или другой пресет мимикрии AmneziaWG. Параметры обфускации помогают редко: оператор режет поток, а не сигнатуру.
Часы уходят#
Как это выглядит
- Пункт доктора Часы: «Внимание» при расхождении с часами панели больше 2 секунд или без синхронизации NTP, «Проблема» — больше 30 секунд.
- События ноды: «часы сервера расходятся с панелью на N с», когда расхождение больше 30 секунд.
На неверных часах ломаются сертификаты, коды из приложения-аутентификатора и рукопожатия WireGuard.
Что делать на ноде:
timedatectl set-ntp true
timedatectlЕсли коды для входа в админку не подходят, проверьте часы сервера панели и телефона: код принимается только в пределах одного 30-секундного шага в любую сторону.
Нет модуля ядра AmneziaWG#
Как это выглядит
- У профиля на ноде: «AmneziaWG не запустился на ноде: посмотри „Бэкенд AmneziaWG“ на вкладке „Сервер“».
- Пункт доктора Бэкенд AmneziaWG сообщает, что рабочего бэкенда нет; Заголовки ядра перечисляет, чего не хватает для модуля.
- У свежего агента при настройке Модуль ядра профили продолжают работать: доктор предупреждает «AmneziaWG пока работает в userspace: модуль ядра не загружается на ядре …» (обычно обновление ядра оставило модуль позади). Соберите модуль, как описано ниже, и нажмите в докторе Вернуться на модуль. Сама нода на модуль не вернётся, пока люди подключены.
Что делать
-
Если у агента нет такого перехода, карточка доктора в один клик предлагает Перевести ноду на «авто».
-
Проще всего: переключите Бэкенд AmneziaWG ноды на Авто (модуль ядра, если он уже загружен, иначе userspace) или Userspace. Userspace модуль не нужен, нужен только
/dev/net/tun. -
Чтобы работать на модуле ядра, выберите Модуль ядра. Свежий агент соберёт модуль сам после вашего подтверждения; пока модуль не готов, AmneziaWG работает в userspace. Иначе выполните сборку на ноде сами; без
--yesкоманда только печатает план:mistgate-node awg prepare-kernel mistgate-node awg prepare-kernel --yesПоддерживаются Debian и Ubuntu (apt), не в контейнере, без Secure Boot, с systemd. Сборка, запущенная панелью, пишет лог в журнал unit
mistgate-awg-prepare. -
Если доктор пишет, что служебный файл скрывает
/dev/net/tun(устаревший unit), примените Обновить службу в разделе «Здоровье» → «Доктор». Если агент слишком старый и не предлагает исправление, вы можете один раз выполнитьmistgate-node installтекущим бинарником.
См. AmneziaWG.
Обновление ядра падает на сборке модуля AmneziaWG#
Как это выглядит
- apt или dpkg пишет
Bad return status for module build on kernel: ..., а пакет ядра или заголовков остаётся недонастроенным (dpkg --auditего покажет); apt после этого отказывается ставить что-либо ещё. - Задача обновления ОС заканчивается кодом
awg_module_build_failed.
Почему
Исходники модуля (amneziawg-dkms 1.0.0 из PPA Amnezia; рецепт для Debian собирает тот же файл) вызывают две функции ядра так, как выбирают по номеру версии ядра. В некоторых дистрибутивных ядрах (Ubuntu 7.0.0-38) одно из двух изменений есть под более старым номером, и модуль не собирается.
Что делает Mistgate
Перед сборкой модуля и ещё раз после неудачной сборки задача обновления (и awg prepare-kernel) смотрит на /usr/src/amneziawg-*/compat/compat.h. Если файл в точности один из двух известных плохих (файл из PPA или он же с первой строкой макроса, удалённой вручную), она заменяет эти строки на такие, что смотрят на настоящую сигнатуру функции ядра, проверяет, что получился ровно ожидаемый файл, дозавершает dpkg и повторяет шаг один раз. Любой другой файл остаётся как есть, а в причине сбоя будет the module source is not one Mistgate knows (sha256 ...) и первые 12 символов его хеша.
Что делать
-
Посмотреть, исправить и дать dpkg закончить:
mistgate-node awg fix-source --check mistgate-node awg fix-source dpkg --configure -a -
Неизвестный файл Mistgate не меняет. Обновите
amneziawg-dkms(исправленный пакет заменит файл) или поправьте файл сами и завершитеdpkg --configure -a.
WARP не работает#
Как это выглядит
- Карточка WARP ноды: Не работает, Нет бэкенда или На паузе.
- Пункт доктора Выход через WARP сообщает о проблеме; у профиля написано «Нет рабочего WARP на ноде».
- «Прямой профиль этой ноды работает, а „<профиль>“ нет: мёртв его выход через WARP».
Профили с выходом через WARP при этом закрываются: напрямую в интернет они трафик не выпускают.
Что делать
- В карточке WARP: Перезапустить WARP и посмотреть рукопожатие, проверки и последнюю ошибку. Перечитать у Cloudflare обновляет данные аккаунта.
- На паузе: нажмите Возобновить.
- «WARP не может работать на этом хосте»: таблицу маршрутов, приоритет правила или имя интерфейса WARP занял другой инструмент (например, старая настройка
wg-quick). Уберите его конфигурацию. - Нет бэкенда: на ноде нет ни модуля ядра WireGuard, ни
/dev/net/tun; если проверка юнита доктора устарела, примените Обновить службу в разделе «Здоровье» → «Доктор». Если агент слишком старый для исправления, вы можете выполнитьmistgate-node installтекущим бинарником. - «Профили с выходом через WARP не стартуют: у ноды нет аккаунта WARP»: зарегистрируйте или импортируйте аккаунт на ноде либо переключите эти профили на прямой выход.
Нода без IPv6 для WARP подходит. См. WARP.
Обновление откатилось#
Как это выглядит
- На странице «Обновления» нода в состоянии Откатилась; Последнее обновление объясняет почему.
- Раскатка на паузе, открыт алерт «Обновление ноды остановилось».
- События ноды: «обновление откатилось».
| Причина | Что делать |
|---|---|
| Новая версия не подключилась и не применила настройки за 5 минут | Прочитайте лог ноды за это время; исправьте связь или конфигурацию. |
| Программа — не тот релиз, который описан в манифесте | Пакет подписан для других бинарников. Подпишите его заново командой mistgate release sign из чистой копии того же тега, не переопределяя --built (см. «Релизы»). |
| Новая версия трижды подряд упала | Прочитайте лог ноды. |
| Новая версия не смогла запустить профиль | Прочитайте ошибку профиля и лог ноды. |
| Новая программа не запустилась (она собрана под эту машину?) | Проверьте архитектуру бинарника для этой ноды. |
| Панель вернула прошлую версию: проверка глазами клиента после обновления не прошла | См. «Здоровье» для профиля, который не проходит. |
| Панель вернула прошлую версию: профиль, который работал раньше, после обновления сломался | Прочитайте ошибку профиля на ноде. |
| Панель вернула прошлую версию: после обновления нода не применила настройки | Прочитайте лог ноды за это время. |
| Панель вернула прошлую версию: новая сборка не подтвердила обновление | Новый агент так и не сообщил, что обновление прошло. Прочитайте лог ноды за это время. |
| Панель вернула прошлую версию: после обновления она не смогла прочитать профили ноды | Не удалось чтение из базы самой панели, нода тут ни при чём. Прочитайте лог панели за это время. |
Устранив причину, продолжите или отмените раскатку и обновите ноду новой раскаткой. См. «Обновления».
Админка недоступна#
| Симптом | Что делать |
|---|---|
| По адресу открывается «Coming soon» или 404 | Вы попали на ширму: в адресе админки есть секретная часть. Выполните mistgate setup на сервере панели: команда сохранит настройки и напечатает адрес админки. |
| Админка на отдельном адресе | Она работает по обычному HTTP на адресе, заданном при настройке, обычно на loopback. Откройте SSH-туннель, например ssh -L 8081:127.0.0.1:8081 root@panel.example.com, затем http://localhost:8081/. |
| «Браузер отклонил passkey для этого адреса» | Открывайте админку ровно по тому адресу, который напечатал setup: passkey привязаны к нему. |
| «Слишком много попыток» | Вход по паролю закрыт на 15 минут. Подождите или выполните mistgate auth reset-login <логин> на сервере панели. |
| Потерян телефон или не осталось passkey | mistgate auth reset-login, см. «Безопасность». |
| Проверка Cloudflare не проходит | mistgate auth turnstile off на сервере панели. |
| Страница «Too Many Requests» | Слишком много запросов из вашей сети; подождите время из Retry-After. |
| Ошибка сертификата в браузере | С --acme-domain публичный адрес должен быть доступен на порту 443, а --acme-http (порт 80) отвечает на проверку HTTP-01 и перенаправляет на HTTPS. С --tls-cert панель перечитывает файл, когда он меняется. |
| Ничего не отвечает | Проверьте службу и её лог на сервере панели (systemctl status, journalctl -u <ваш unit>). |
Ошибки запуска mistgate serve и что они значат:
| Сообщение | Что делать |
|---|---|
data dir: … (run `mistgate setup`) |
Каталога данных нет: на новом сервере выполните mistgate setup, иначе укажите существующий каталог в --data-dir. |
master key: … (run `mistgate setup`) |
Нет master.key, и базы ещё нет: выполните mistgate setup. |
master key: … is missing but the database exists: restore master.key from your backup … |
Установка потеряла ключ. Верните master.key из резервной копии. setup здесь откажется: новый ключ не прочтёт хранимые секреты. |
vault: … is accessible to group or others …; run chmod 600 on it |
Выполните chmod 600 для файла ключа. |
--admin-listen conflicts with the stored admin address … |
Установка настроена на секретный хост или префикс; уберите --admin-listen. |
--tls-cert and --tls-key go together |
Укажите оба флага или ни одного. |
Журнал панели, сроки хранения, экспорт и метрики#
На VPS-редакции владелец находит всё это в Настройки → Система; токен профиля admin читает то же через MCP (panel_logs, retention_status, log_level_plan, retention_plan).
-
Ресурсы панели. Настройки → Система → Ресурсы панели показывает, сколько своему серверу стоит сама панель: её процесс (CPU в процентах от всего сервера, память с кучей Go, открытые файлы против лимита, горутины и потоки, сколько она работает), сервер (занятость CPU со steal и ожиданием диска, load, память, своп, диск каталога данных), база (размер вместе с журналом записи и сколько в ней свободных страниц), агенты на связи и последние 5 минут API админки (запросы, ошибки сервера, время ответа по 95-му процентилю). Карточку видит любой админ, а любой токен читает то же через MCP (
panel_resources). Базу замеряют не чаще раза в минуту. -
Уровень журнала.
mistgate serve --log-level debug|info|warn|error(илиMISTGATE_LOG_LEVEL, по умолчаниюinfo) задаёт уровень при запуске, а--log-format json(илиMISTGATE_LOG_FORMAT) пишет журнал в stderr в JSON. Владелец может сменить уровень на ходу; после перезапуска вернётся заданный. -
Журнал панели. Последние 5000 записей текущего уровня хранятся в памяти (при перезапуске пропадают) и показываются с фильтрами по уровню, времени, тексту, части панели, коду ошибки и коду запроса. Из каждой записи убраны адреса, секретные имена панели и значения, похожие на ключи; показываются только разрешённые атрибуты. Каждое предупреждение и ошибка панели несёт короткий
code. -
Код запроса. Если вызов в админке не удался, она показывает «код запроса abc12345». Тот же код лежит в заголовке ответа
X-Request-Id, в записях журнала этого запроса и в строке аудита сделанного им изменения: человек, назвавший код, и оператор, читающий журнал, говорят об одном запросе. Cloudflare-редакция коды запросов не ставит. -
Сроки хранения. Настройки → Система → Хранение задаёт, сколько живут строки в таблицах, которые чистит почасовая уборка: журнал нод (1–7 дней, по умолчанию 7), события info (90) и предупреждения/ошибки (400), аудит (30–1095, по умолчанию 400), закрытые алерты (90), сырые раунды проверок (25–168 часов, по умолчанию 25), суточные итоги проверок (90), почасовая нагрузка ноды (90), почасовой трафик по людям и по нодам (по 400 дней). Более короткий срок удаляет старые строки при ближайшей уборке, насовсем, и просит step-up. Уборка читает значения в любой редакции; менять их можно на VPS-редакции.
-
Экспорт. Настройки → Система → Экспорт скачивает события, аудит, сохранённый журнал нод и собственный журнал панели за окно до 31 дня в виде NDJSON (по объекту на строку, поле
sourceназывает вид). Каждая строка очищается как журнал панели, адреса клиентов в строках аудита убраны. Просит step-up. -
Метрики.
/metricsна адресе админки отдаёт числа по флоту в текстовом формате OpenMetrics: ноды по состоянию, люди онлайн, активные алерты по важности, развёрнутые проверки по последнему результату, скорость загрузки и отдачи и CPU по нодам, ретрансляторы по состоянию, а также резидентная память процесса панели (process_resident_memory_bytes), его горутины (go_goroutines) и размер базы (mistgate_db_bytes). Ни имён людей, ни адресов. Выключено, пока владелец не включит в Настройки → Система; при включении создаётся токен, он показывается один раз и хранится только хешем, сборщик шлёт его какAuthorization: Bearer <токен>. Пока выключено, адрес отвечает как любой неизвестный путь админки.
Отладочная запись одной ноды#
Если нода ведёт себя странно и её предупреждений мало, владелец может попросить её на несколько минут вести подробный журнал. На странице ноды, Сервер → Отладочная запись, выбери источники (агент, hysteria2, vless, xray, awg, update, kernel; если ничего не выбрано, пишется всё), уровень (отладка или сведения) и длительность (1, 5, 10 или 15 минут) и нажми Отладка на N мин. Обратный отсчёт показывает, сколько осталось; Остановить и показать заканчивает запись сразу. Когда время выйдет, нода присылает то, что накопила, и панель показывает записи с фильтрами по уровню, источнику и тексту. Источник kernel читает журнал ядра за 30 минут до начала захвата и во время него; строки пакетного журнала firewall подсчитываются, но не сохраняются. На узлах с ядровым AWG выбор awg включает отладку модуля на время захвата и добавляет сводку с инициированиями, не получившими ответа за 5 секунд.
- Пределы. Одна запись на ноду за раз, не дольше 15 минут, не больше 20000 записей и 4 МиБ (что не поместилось, считается, но не хранится). Когда запись заканчивается, нода возвращает прежний уровень журнала; перезапуск агента тоже заканчивает запись: на диск на ноде ничего не пишется. Панель хранит запись и её строки 24 часа и не больше 5 записей на ноду; остальное удаляет почасовая уборка (только VPS-редакция).
- Что внутри. Каждая строка очищается на ноде (адреса клиентов становятся
<ip>, текст, похожий на ключ, убирается, у строк xray вырезаются имена хостов, остаётся только короткий список атрибутов журнала нод), ещё раз при сохранении в панели и ещё раз при чтении, с удалением секретных имён панели. Отладочные строки выбранных источников попадают только в запись, а не в собственный журнал ноды. - Кто и что записывается. Владелец запускает и останавливает запись в админке. Токен профиля admin запускает её через
node_debug_capture_plan/node_debug_capture_applyи читает черезnode_debug_logs(запись или нода, фильтрыmin_level,source,query,limit,cursor). Каждый запуск попадает в журнал аудита: кто просил, нода, источники и длительность. Слишком старый агент (безdebug/1) и нода не на связи получают отказ, ничего не отправляется. В Cloudflare-редакции этого нет.
Нода не вернулась после обновления ОС#
Как это выглядит
- В строке ноды написано Перезагрузка…, а через 15 минут обновление останавливается с пометкой «не вернулась»; открыт алерт «Обновление ОС ноды остановилось» (Критично) и пришло сообщение в Telegram.
- События ноды:
os_reboot_started, дальше тишина.
Что делать
- Откройте консоль хостера (панель не достаёт до сервера, который не загружается). Если сервер показывает меню загрузки или завис, выберите прежнее ядро в Advanced options меню GRUB: обновление никогда не удаляет старые ядра.
- Когда сервер поднялся, нода вернётся сама и панель подключит её. Посмотрите Последнее обновление и вкладку История ноды: там причина, по которой новое ядро не стартовало.
- Нажмите Закрыть в строке ноды, чтобы снять алерт. Не повторяйте обновление, пока сервер не работает на ядре, выбранном вами сознательно.
Сервер, который загрузился, но на другом ядре, чем установленное, показывает «загрузился на другом ядре» (kernel_not_switched): меню загрузки (GRUB) запускает не новейшее ядро; поставьте GRUB_DEFAULT=0 и выполните update-grub.
Панель не перезагрузила ноду после установки обновлений#
Обновление заканчивается пометкой Перезагрузка не выполнена и одной из фраз таблицы из раздела Обновление системы одного сервера (reboot_held). Обновления установлены. Нода проверяет, безопасна ли перезагрузка, и отказывает, если не уверена: модуль AmneziaWG не собран под новое ядро (awg_module_missing, awg_module_build_failed), меню загрузки настроено на выбранный пункт (boot_default_custom), файлы нового ядра неполные (initramfs_missing), сервер перезагружался несколько минут назад (too_soon) или панель уже перезагружала его в течение часа или трижды за сутки (reboot_limit). Устраните причину, которую называет фраза, или перезагрузите сервер сами из панели хостера; «перезагрузить всё равно» в панели для этого нет.
Multipath TCP и CVE-2026-98432#
CVE-2026-98432 — ошибка в TCP ядра Linux для IPv4 (CVSS 9.8), через которую показан удалённый root на слушающем порту, принимающем Multipath TCP (MPTCP). Go с версии 1.24 по умолчанию открывает каждый слушающий порт с MPTCP, поэтому панель, агент ноды и порты Xray, которые он держит, принимали MPTCP до v0.1.82 включительно. С v0.1.83 они открывают обычный TCP; Mistgate MPTCP не нужен, а клиенты, которые просят MPTCP, переходят на обычный TCP.
Сама ошибка в ядре, поэтому на каждой ноде и на сервере панели ещё:
-
Выключите MPTCP для всех программ на хосте, включая Caddy и другие программы на Go, так, чтобы это пережило перезагрузку:
echo 'net.mptcp.enabled = 0' | sudo tee /etc/sysctl.d/99-no-mptcp.conf && sudo sysctl -w net.mptcp.enabled=0 -
Перезапустите то, что слушает порты (
sudo systemctl restart mistgate-nodeна ноде,mistgateна сервере панели и Caddy, где он есть): порты, открытые до изменения, держат MPTCP до перезапуска.ss -Hl -Mпокажет оставшиеся MPTCP-порты. -
Поставьте исправленное ядро вашего дистрибутива, как только оно выйдет, и перезагрузитесь.