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

# Диагностика проблем

> Как локализовать отказ входа, SSH, SFTP, агента, плейбука, расписания или обновления Telepúrte.

Сначала определите, на каком этапе возник отказ. Вход в панель, видимость ноды, SSH-подключение, файловая операция и задание агента проверяют разные условия. Успех одного этапа не подтверждает остальные.

## Быстрая карта

| Симптом | Начните с |
| - | - |
| Панель не открывается | Служба Telepúrte, HTTPS, DNS, reverse proxy и `public_url` |
| Локальный вход работает, SSO нет | Пользователь Axottle, MFA, связь и свежесть синхронизации |
| Нода видна, терминал недоступен | Host key, подготовка SSH, грант, системный логин и бастион |
| Агент online, операция запрещена | Поддержка действия, локальные списки и права Linux |
| SSH работает, Web SFTP нет | SFTP, Web-маршрут, корневые каталоги и файловые запреты |
| Редактор не сохраняет | Изменение исходного файла, размер, права и результат проверки |
| Плейбук остаётся в очереди | Агент, политика, права автора и срок задания |
| Расписание активно, запуска нет | Часовой пояс, история наступлений, пересечение и доступность целей |
| Запись терминала отсутствует | Права просмотра, срок хранения, очистка и тип сессии |
| Обновление не завершилось | Журнал обновлятора и состояние восстановления |

## Панель и вход

На сервере проверьте службу и журнал:

```bash theme={null}
sudo systemctl status telepurte --no-pager
sudo journalctl -u telepurte --since '30 minutes ago' --no-pager
sudo -u telepurte telepurte check --config /etc/telepurte/config.json
```

Сверьте точный HTTPS-origin в `public_url`, домен запроса и сохранение Host на reverse proxy. При отсутствии `public_url` веб-вход не включается. Не создавайте новую базу или master key ради исправления ошибки входа.

Для локального пользователя проверьте блокировку, срок учётки и пароля, время устройства с TOTP и лимит попыток. Для Axottle — активность внешней учётки, MFA и свежесть списка пользователей. Если локальный владелец потерял оба фактора, используйте [CLI-восстановление](https://docs.axottle.com/ru/telepurte/backups.md#восстановление-владельца).

## Нода и SSH

Откройте карточку ноды и последовательно проверьте присутствие, адрес, ключ, SSH-готовность и разрешённый системный логин. Смена IP или host key требует новой проверки доверия; старое разрешение не должно незаметно переноситься на другую машину.

Затем проверьте бастион и транспорт. Для прямого пути нужен маршрут к sshd. Для агентного — живой туннель и правильный локальный порт. При отказе туннеля автоматического перехода на прямой SSH нет.

Если отказ относится только к одному пользователю, проверьте все роли, прямой грант, срок, область проекта, запреты и лимиты сессий. При личном логине также нужна подтверждённая подготовка учётки на этой ноде.

## Агент и плейбук

Online не гарантирует поддержку новой команды. Проверьте версию и способность выполнять нужное действие. Для systemd сверяйте точный unit, для файла — полный путь, для пакета — точное имя. Разрешение в политике не заменяет права ОС и ограничения службы агента.

`policy_changed` требует нового предпросмотра. `policy_denied` — исправления конкретного разрешения. Для `script_failed` проверьте код и вывод; для `ansible_unavailable` — установленный Ansible на самой ноде.

`execution_uncertain` означает, что подтверждение изменения потеряно. Сначала прочитайте фактическое состояние сервера, затем решайте о повторе. Не запускайте весь парк заново, пока не разобран частичный результат.

## Файлы и редактор

Сравните системного пользователя в SSH и файлах. Проверьте разрешённый корневой каталог, действие, путь, Linux-права и тип объекта. Для переименования важны оба пути, для каталога при удалении — его пустота.

Если файл изменился после открытия, сохраните свои правки отдельно, перечитайте текущую версию и объедините изменения. Ошибка сохранения не является разрешением заменить чужую версию. Ограничение предпросмотра 16 МиБ и редактора 8 МиБ меньше возможного лимита передачи файла.

При работающем терминале и неработающих файлах проверьте на reverse proxy маршруты файлового Web-шлюза, а не только WebSocket терминала.

## Расписание

Откройте историю наступлений, а не только общий список. `skipped_overlap` означает ещё работающее предыдущее задание, `skipped_missed` — обработанный пропуск, `skipped_window` — закрытое окно. `recipe_changed` требует нового расписания для актуальной версии.

После изменения состава группы проверьте точные сохранённые цели: старое расписание не подхватывает новые ноды. Если недоступна одна цель, предварительная проверка всего наступления может завершиться без создания частичного задания.

## Что сохранить для разбора

Запишите время и часовой пояс, версию панели/агента/бастиона, ID ноды или задания, точный код ошибки и этап. Для задания сохраните результаты каждой цели, для обновления — журнал операции. Перед передачей материалов исключите пароли, токены, гостевые ссылки и приватные ключи.

## Проверка

После исправления повторите именно отказавший путь с тем же пользователем и нодой: вход, SSH, конкретное файловое действие или новый предпросмотр задания. Затем проверьте конечный результат и отсутствие новых ошибок. Не ограничивайтесь обновившимся зелёным статусом.

## Откат

Верните последнюю изменённую настройку, если она вызвала проблему, и повторите проверку. Перед изменением ключей, базы или идентичности сохраните копию и выберите штатное восстановление. Выполненные действия на серверах возвращаются отдельно от настройки панели.

Проверяйте версии всех участвующих компонентов и фактические настройки своей установки.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.