# Поиск неисправностей

Canonical page: https://phishdestroy.github.io/TgWitness/ru/docs/troubleshooting/

Начните с симптома. Проверяйте по одному уровню за раз.

## Панель запрашивает токен

Используйте токен панели из локального файла, отображаемого программой запуска. Для Docker запустите команду «`docker compose exec tgwitness cat /data/panel-token.txt`». Код входа в Telegram, токен BotFather и токен witness, доступный только для чтения, служат разным целям.

## Telegram не подключается

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

## Подключено, но новых сообщений нет

1. Убедитесь, что наблюдение выполняется в нужном рабочем пространстве.
2. Убедитесь, что источник выбран и доступен для просмотра данной учётной записи.
3. Отправьте новое уникальное сообщение в контролируемой группе и найдите именно этот текст.
4. Проверьте журнал работы на наличие перерывов, задержек в работе или ошибок Telegram.

Исторические моментальные снимки и события появления новых сообщений — это разные вещи. «Тихий» источник можно подключить без генерации новых сообщений. Если важна полнота данных, используйте тест контролируемой доставки.

## FloodWait или задержка после перезапуска

FloodWait означает, что Telegram требует паузы. Подождите указанный период времени и проверьте нагрузку на систему сбора данных; повторные попытки подключения не снимают ограничение. Сохраненное состояние обновлений помогает наверстать упущенное после перезапуска, однако просроченные обновления и некоторые периоды прерывания остаются ограничениями. Зафиксируйте пробел, а не рассматривайте журнал как полный.

## Бот настроен, но ничего не публикует

Убедитесь, что процесс Witness действительно запущен, что бот может публиковать сообщения в канале, а Witness имеет доступ к коллектору и API бота. Проверьте журнал на наличие неудачных публикаций. Один лишь успешный запрос к коллектору не подтверждает публикацию в канале.

## Где находится интеграция с токенами GitHub?

**В стадии планирования. В разделе** «Дополнительная информация» описывается предлагаемый рабочий процесс проверки форка и сборки. В настоящее время отсутствует форма для ввода токена GitHub или автоматизированная проверка соответствия работающей установки репозиторию. Ознакомьтесь с [текущим статусом функциональности](https://phishdestroy.github.io/TgWitness/ru/docs/reference/features/).

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