> ## 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.
# Обслуживание и Axottle Doctor
> Как проверить сервер панели, устранить типовые сбои и подготовить диагностический архив для поддержки.
Axottle Doctor помогает проверить сервер, на котором работает панель. Запускайте его, если панель не открывается, база данных недоступна, появились ошибки TLS или перед обращением в поддержку.
Для запуска нужен доступ к консоли сервера панели. Для восстановления служб используйте `sudo axottle`.
## Запуск Doctor
Откройте интерактивное меню:
```bash theme={null}
sudo axottle
```
Выберите **Doctor**. Проверка начнётся автоматически и может занять некоторое время: Doctor последовательно проверяет панель, базу данных, системные службы, свободное место, сеть, DNS, сертификаты и подключённые компоненты.
Краткая сводка остаётся в верхней части экрана. Подробные результаты можно прокручивать:
* `↑` и `↓` или колесо мыши — прокрутка списка;
* `Page Up` и `Page Down` — переход на страницу;
* `Home` и `End` — начало и конец результатов;
* `Esc` — возврат к меню Doctor.
В результатах используются пять состояний:
| Состояние | Что означает |
| --------- | ---------------------------------------------------- |
| `OK` | Проверка пройдена |
| `Warning` | Сервис работает, но требует внимания |
| `Failed` | Найдена проблема, которая может мешать работе панели |
| `Skipped` | Проверка не относится к этой установке |
| `Unknown` | Для проверки не хватило доступа или данных |
Найдите проблемную проверку и прочитайте строки **Found**, **Why** и **Next**: там указано, что обнаружено, почему это важно и что можно сделать.
Если нужен только текстовый результат без интерактивного меню, выполните `axottle doctor`. Даже при найденных проблемах Doctor завершит саму диагностику и покажет все доступные результаты.
## Безопасное восстановление
Пункт **Attempt safe recovery** подходит для типовых сбоев, когда остановилась база данных, панель, фоновые службы или веб-сервер. Doctor попробует запустить или перезапустить нужную службу, при необходимости обновить уже настроенный сертификат, а затем повторит все проверки.
Перед запуском учитывайте следующее:
* активные соединения с перезапускаемой службой могут кратковременно прерваться;
* Doctor не меняет пароли базы данных и не редактирует DNS-записи;
* если действие выполнить не удалось, оно останется в списке с пометкой `failed` и пояснением;
* после восстановления на экране показываются выполненные действия и результаты повторной проверки.
Если вы не хотите, чтобы Doctor перезапускал службы, используйте только **Run diagnostics**.
## 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 сохранит его на сервере и покажет путь к файлу. Этот файл можно приложить к обращению вручную.
## Как выбрать действие
| Ситуация | Что выбрать |
| ------------------------------------------------ | ---------------------------------------------------------------------------- |
| Панель работает, нужна профилактическая проверка | **Run diagnostics** |
| Панель или база данных остановилась | **Run diagnostics**, затем **Attempt safe recovery** |
| Нужно обратиться в поддержку | Выберите период → **Collect support bundle** → просмотрите и отправьте архив |
| Нужно вернуться к предыдущей проверке | **View last diagnosis** |
| Отправка в поддержку недоступна | **Save bundle locally** |
## Рекомендуемый регламент
| Периодичность | Действие |
| ---------------------------- | ---------------------------------------------------- |
| Еженедельно | Запустить Doctor и разобрать `Warning` и `Failed` |
| После обновления | Проверить панель, базу данных, порты и TLS |
| Перед обращением в поддержку | Собрать bundle за период инцидента |
| Ежемесячно | Проверить свободное место и старые локальные bundles |
Резервные копии обслуживаются отдельно — см. [Резервные копии панели](/ru/operations/backups). Порядок обновления описан на странице [Обновление панели](/ru/operations/updates).
## Проверка
После диагностики убедитесь, что:
* в сводке нет необъяснённых `Failed`;
* у каждого `Warning` есть понятное следующее действие;
* после безопасного восстановления проблемные службы прошли повторную проверку;
* созданный support bundle открывается, а его манифест соответствует выбранному периоду и ожидаемым источникам.
## Откат
Обычная диагностика ничего не меняет. Локально сохранённый support bundle можно удалить как обычный файл.
Безопасное восстановление может перезапустить службы или обновить существующий сертификат. Если после него ситуация ухудшилась, не повторяйте действие вслепую: сохраните bundle, проверьте журнал выполненных действий и восстановите нужную службу по её штатной инструкции. Для аварийного порядка действий используйте страницу [Реагирование на инциденты](/ru/operations/incident-response).
Убедитесь, что команда запущена на сервере панели. Выберите **Attempt safe recovery**. Если база не поднялась, проверьте состояние контейнера PostgreSQL или службы `postgresql`, затем соберите bundle — в него попадут доступные журналы базы и установщика.
Выберите **Save bundle locally** и приложите сохранённый файл к обращению вручную. Проверьте также DNS, исходящее соединение и адрес сервера поддержки.
`Skipped` обычно означает, что компонент не используется в этой установке. `Unknown` означает, что Doctor не смог получить данные — часто из-за недостаточных прав или недоступной службы. Запустите `sudo axottle` и повторите проверку.
Связанные страницы: [Реагирование на инциденты](/ru/operations/incident-response), [Эскалация](/ru/troubleshooting/escalation), [CLI axottle](/ru/reference/cli).
Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-12.