🔍 Устранение неполадок¶
Контейнеры не запускаются¶
# Проверить логи
docker compose logs -f [имя_сервиса]
# Типовое решение
docker compose down
docker compose pull
docker compose up -d
Проблемы с подключением к базе данных¶
# Проверить состояние базы
docker compose exec postgres pg_isready -U dashboard
# Сброс базы (все данные будут потеряны!)
docker compose down -v
docker compose up -d postgres redis
Боты не обнаруживаются¶
# Проверить доступ к Docker socket
docker compose exec backend docker ps
# Проверить пути сканирования
docker compose exec backend ls -la /opt
# Проверить статус обнаружения в интерфейсе
# Страница «Обнаружение» → статусы поиска в Docker и по файлам
Частые ошибки¶
| Ошибка | Решение |
|---|---|
Connection refused |
Дождитесь запуска сервисов (30–60 секунд) |
Permission denied |
Проверьте права: chmod -R 755 data/ |
JWT validation failed |
Сгенерируйте новый JWT_SECRET в .env |
Database locked |
Перезапустите postgres |
Rate limit exceeded |
Проверьте «Уведомления» → «Снять лимит» для бота |
Bot API unreachable |
|
Token is invalid (telegram-bot) |
|
telegram_bot_token is empty (telegram-bot) |
|
| Бот не отвечает на команды |
Логи сервисов¶
# Все логи
docker compose logs -f
# Логи конкретного сервиса
docker compose logs -f backend
docker compose logs -f frontend
docker compose logs -f data-collector
docker compose logs -f mastra
# Перезапуск сервиса
docker compose restart backend
Администрирование базы данных¶
Через Adminer (http://localhost:18091):
- Сервер:
postgres - Пользователь:
dashboard - Пароль: из
.env(DB_PASSWORD) - База:
dashboard
Резервное копирование и восстановление:
# Резервная копия
docker compose exec postgres pg_dump -U dashboard dashboard > backup.sql
# Восстановление
docker compose exec -T postgres psql -U dashboard dashboard < backup.sql
Обновление¶
# 1. Сделать резервную копию
docker compose exec postgres pg_dump -U dashboard dashboard > backup_$(date +%Y%m%d).sql
# 2. Стянуть последнюю версию
git pull origin main
# 3. Пересобрать и перезапустить
docker compose down
docker compose build --no-cache
docker compose up -d
# 4. Применить миграции (если есть)
docker compose exec backend alembic upgrade head
Производительность¶
Проблема: Дашборд загружается медленно
Решения: - Уменьшите интервал обновления в настройках - Проверьте нагрузку на PostgreSQL - Убедитесь, что Redis включён для кэширования - Отключите неиспользуемых ботов
Проблема: Высокое потребление памяти
Решения: - Ограничьте количество одновременно отслеживаемых ботов - Уменьшите количество рабочих процессов в конфиге бэкенда - Настройте лимиты памяти в Docker Compose
Безопасность¶
Контрольный список для продакшена:
- [ ] Сменить пароль администратора
- [ ] Сгенерировать надёжный JWT_SECRET (openssl rand -hex 64)
- [ ] Использовать надёжный DB_PASSWORD
- [ ] Настроить HTTPS (обратный прокси: Nginx, Caddy)
- [ ] Ограничить доступ к Adminer (VPN/внутренняя сеть)
- [ ] Настроить межсетевой экран
- [ ] Регулярно делать резервные копии