Skip to main content
Axottle Doctor помогает проверить сервер, на котором работает панель. Запускайте его, если панель не открывается, база данных недоступна, появились ошибки TLS или перед обращением в поддержку.
Для запуска нужен доступ к консоли сервера панели. Для восстановления служб используйте sudo axottle.

​
Запуск Doctor

Откройте интерактивное меню:
Выберите Doctor. Проверка начнётся автоматически и может занять некоторое время: Doctor последовательно проверяет панель, базу данных, системные службы, свободное место, сеть, DNS, сертификаты и подключённые компоненты. Краткая сводка остаётся в верхней части экрана. Подробные результаты можно прокручивать:
  • ↑ и ↓ или колесо мыши — прокрутка списка;
  • Page Up и Page Down — переход на страницу;
  • Home и End — начало и конец результатов;
  • Esc — возврат к меню Doctor.
В результатах используются пять состояний: Найдите проблемную проверку и прочитайте строки Found, Why и Next: там указано, что обнаружено, почему это важно и что можно сделать.
Если нужен только текстовый результат без интерактивного меню, выполните axottle doctor. Даже при найденных проблемах Doctor завершит саму диагностику и покажет все доступные результаты.

​
Безопасное восстановление

Пункт Attempt safe recovery подходит для типовых сбоев, когда остановилась база данных, панель, фоновые службы или веб-сервер. Doctor попробует запустить или перезапустить нужную службу, при необходимости обновить уже настроенный сертификат, а затем повторит все проверки. Перед запуском учитывайте следующее:
  • активные соединения с перезапускаемой службой могут кратковременно прерваться;
  • Doctor не меняет пароли базы данных и не редактирует DNS-записи;
  • если действие выполнить не удалось, оно останется в списке с пометкой failed и пояснением;
  • после восстановления на экране показываются выполненные действия и результаты повторной проверки.
Если вы не хотите, чтобы Doctor перезапускал службы, используйте только Run diagnostics.

​
Место на диске

Полный диск — это не «медленно», а остановка: PostgreSQL не может записать checkpoint, ловит панику и уходит в цикл перезапусков, который пишет в журнал ещё больше. К этому моменту API уже недоступен, поэтому разбираться приходится локально. Экран Место на диске в меню sudo axottle раскладывает занятое место по категориям и делит их на две группы: что можно очистить и что защищено. Тома базы данных не трогаются никогда. Действия по Enter: очистить всё, очистить то, что старше 7 дней, старше 30 дней, или показать, где это лежит (каталоги и самые большие файлы). Перед удалением показывается, сколько освободится и сколько файлов затронуто, а само удаление требует явного y. После очистки диск пересчитывается. Логи работающих контейнеров обнуляются на месте, а не удаляются: Docker держит их открытыми, и удаление файла не вернуло бы место до перезапуска контейнера.
Установщик и обновление проверяют свободное место до начала работы. Для обновления это критично: оно снимает дамп базы, а дамп, которому не хватило места, — это обрезанный дамп, из которого потом «откатятся». Локальный бэкап по той же причине не стартует без запаса: нужен максимум из 1 ГиБ и двойного размера прошлого архива.
За тем же следит фоновая проба здоровья: инцидент заводится при остатке меньше 10% и меньше 5%, пороги общие с Doctor. Ограничения на размер журналов теперь стоят в каждом сервисе compose-файла, в /etc/docker/daemon.json и у journald, поэтому логи Remnawave и прокси больше не съедают диск за неделю.

​
Support bundle

Support bundle — это архив с результатами проверки и журналами, который можно приложить к обращению в поддержку.

​
Выберите период

В строке Log period нажимайте Enter, пока не появится подходящий период:
  • 1 час;
  • 6 часов;
  • 24 часа;
  • 7 дней;
  • 30 дней;
  • вся доступная история.
Обычно достаточно периода, который начинается немного раньше первых признаков проблемы. Например, если сбой произошёл два часа назад, выберите 6 часов. Чем больше период, тем дольше собирается архив и тем больше будет файл.

​
Соберите и проверьте архив

  1. Выберите Collect support bundle.
  2. Дождитесь окончания сбора. Не закрывайте терминал во время создания архива.
  3. Выберите Send bundle to support.
  4. Перед отправкой выберите Show archive contents, чтобы увидеть краткие сведения об архиве.
  5. Для полной проверки выберите Save locally, откройте сохранённый архив и просмотрите manifest.json.
  6. Вернитесь в Send bundle to support и выберите Send to support.
В архив могут войти журналы панели, базы данных, веб-сервера, фоновых служб, агента, Remnawave, Docker, установщика, обновления и удаления, а также сведения о состоянии сервера. Если какого-то источника на сервере нет или он недоступен, это будет отмечено в манифесте архива. Пароли, ключи, токены и другие распространённые секреты маскируются перед сохранением. Идентификаторы, используемые для сопоставления обращения, сохраняются в обезличенном виде.
Перед передачей архива за пределы организации всё равно просмотрите его состав. В нестандартных журналах могут встречаться данные, характерные только для вашей инфраструктуры.
Если отправить архив не получилось, Doctor сохранит его на сервере и покажет путь к файлу. Этот файл можно приложить к обращению вручную.

​
Как выбрать действие

​
Рекомендуемый регламент

Резервные копии обслуживаются отдельно — см. Резервные копии панели. Порядок обновления описан на странице Обновление панели.

​
Проверка

После диагностики убедитесь, что:
  • в сводке нет необъяснённых Failed;
  • у каждого Warning есть понятное следующее действие;
  • после безопасного восстановления проблемные службы прошли повторную проверку;
  • созданный support bundle открывается, а его манифест соответствует выбранному периоду и ожидаемым источникам.

​
Откат

Обычная диагностика ничего не меняет. Локально сохранённый support bundle можно удалить как обычный файл. Безопасное восстановление может перезапустить службы или обновить существующий сертификат. Если после него ситуация ухудшилась, не повторяйте действие вслепую: сохраните bundle, проверьте журнал выполненных действий и восстановите нужную службу по её штатной инструкции. Для аварийного порядка действий используйте страницу Реагирование на инциденты.
Убедитесь, что команда запущена на сервере панели. Выберите Attempt safe recovery. Если база не поднялась, проверьте состояние контейнера PostgreSQL или службы postgresql, затем соберите bundle — в него попадут доступные журналы базы и установщика.
Выберите Save bundle locally и приложите сохранённый файл к обращению вручную. Проверьте также DNS, исходящее соединение и адрес сервера поддержки.
Skipped обычно означает, что компонент не используется в этой установке. Unknown означает, что Doctor не смог получить данные — часто из-за недостаточных прав или недоступной службы. Запустите sudo axottle и повторите проверку.
Связанные страницы: Реагирование на инциденты, Эскалация, CLI axottle.
Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-12.