🛡️ WireGuard Docker Monitor

Профессиональный мониторинг WireGuard серверов в Docker с умными уведомлениями в Telegram

Никогда больше не теряйте соединение с вашими VPN серверами

🚀 Быстрая установка • 📖 Документация • 💡 Примеры • 🤝 Поддержка

🎯 Зачем это нужно?

Проблема: WireGuard серверы могут "молча" ломаться - контейнеры работают, но клиенты не могут подключиться. Вы узнаете об этом только когда сами попытаетесь подключиться.

Решение: WireGuard Monitor автоматически проверяет ваши серверы каждые 2 минуты и мгновенно уведомляет в Telegram о любых проблемах.

🔍 Что мониторится:

✅ Статус Docker контейнеров - работают ли контейнеры с WireGuard
✅ Состояние интерфейсов - активны ли WireGuard интерфейсы
✅ Подключения клиентов - свежие ли handshakes с пирами
✅ Здоровье контейнеров - Docker health checks
✅ Сетевая связность - доступность Telegram API

📱 Как приходят уведомления:

🚨 WireGuard Monitor Alert

🖥️ Host: production-server
🕐 Time: 2024-08-26 15:30:25
📊 Level: ERROR

🐳 Container `wireguard` is not running!
📊 Status: exited (Exit code: 1)

✨ Ключевые особенности

🚀 Простота использования

Установка одной командой за 30 секунд
Интерактивный установщик для новичков
Автоматическое обнаружение контейнеров
Готовые шаблоны конфигураций

🎯 Enterprise функции

Мониторинг нескольких контейнеров одновременно
Умная система алертов с cooldown периодами
Детальное логирование и диагностика
Health check endpoints для внешних систем

🔧 Гибкость настроек

Настраиваемые пороги для handshake мониторинга
Различные уровни логирования (DEBUG, INFO, WARN, ERROR)
Кастомизируемые интервалы проверок
Поддержка групповых чатов в Telegram

🛡️ Надежность

Systemd интеграция с автозапуском
Retry механизмы для отправки сообщений
Graceful error handling и восстановление
Lock файлы для предотвращения конфликтов

🚀 Установка

WireGuard Monitor предлагает несколько способов установки на ваш выбор:

🎯 Способ 1: Интерактивная установка (Рекомендуется)

Идеально для новичков - установщик сам спросит все необходимые данные:

curl -fsSL https://raw.githubusercontent.com/Anton-Babaskin/Docker-WireGuard-Monitor/main/install-interactive.sh | sudo bash

Что делает:

🤖 Помогает создать Telegram бота с инструкциями
🔍 Автоматически найдет WireGuard контейнеры
⚙️ Предложит оптимальные настройки
🧪 Протестирует конфигурацию
📱 Отправит тестовое сообщение

⚡ Способ 2: Быстрая установка одной командой

Для опытных пользователей - если у вас уже есть данные:

curl -fsSL https://raw.githubusercontent.com/Anton-Babaskin/Docker-WireGuard-Monitor/main/quick-install.sh | \
sudo bash -s -- \
  --bot-token "123456789:ABCdefGhIjKlmnoPQRsTUVwxyz" \
  --chat-id "123456789" \
  --containers "wireguard"

📁 Способ 3: Ручная установка

Для максимального контроля:

git clone https://github.com/Anton-Babaskin/Docker-WireGuard-Monitor.git
cd Docker-WireGuard-Monitor
sudo ./install-interactive.sh

📋 Подготовка к установке

🤖 Создание Telegram бота:

Найдите @BotFather в Telegram
Отправьте /newbot
Следуйте инструкциям
Скопируйте токен: 123456789:ABCdefGhIjKlmnoPQRsTUVwxyz

📞 Получение Chat ID:

Найдите @userinfobot в Telegram
Отправьте /start
Скопируйте ID: 123456789

🐳 Проверка контейнеров:

docker ps | grep -i wire

🎛️ Управление

Основные команды:

# Статус мониторинга
sudo systemctl status wg-telemon.timer

# Просмотр логов в реальном времени
sudo tail -f /var/log/wg-monitor.log

# Тестирование конфигурации
sudo /usr/local/bin/wg_telemon.sh --test

# Перезапуск сервиса
sudo systemctl restart wg-telemon.timer

Конфигурация:

# Редактирование настроек
sudo nano /etc/telemon.env

# После изменений перезапустить:
sudo systemctl restart wg-telemon.timer

💡 Примеры использования

🏠 Домашний VPN:

# Простая установка для домашнего сервера
curl -fsSL https://raw.githubusercontent.com/Anton-Babaskin/Docker-WireGuard-Monitor/main/quick-install.sh | \
sudo bash -s -- \
  --bot-token "YOUR_TOKEN" \
  --chat-id "YOUR_ID" \
  --containers "wireguard" \
  --threshold 600

🏢 Офисный VPN:

# Мониторинг с групповыми уведомлениями
sudo bash quick-install.sh \
  --bot-token "YOUR_TOKEN" \
  --chat-id "-GROUP_CHAT_ID" \
  --containers "wg-office wg-remote" \
  --threshold 300 \
  --log-level INFO

🏭 Production среда:

# Строгий мониторинг для критических серверов
sudo bash quick-install.sh \
  --bot-token "YOUR_TOKEN" \
  --chat-id "YOUR_ID" \
  --containers "wg-prod-1 wg-prod-2 wg-backup" \
  --threshold 180 \
  --cooldown 900 \
  --log-level WARN

📊 Системные требования

Минимальные:

🐧 ОС: Linux с systemd
🐳 Docker: 20.04+
🔧 Bash: 4.4+
📡 Сеть: доступ к api.telegram.org
💾 RAM: 512MB+ свободных
💿 Диск: 100MB+ свободного места

📚 Документация

📖 GUIDE.md - Подробный гайд установки
💡 EXAMPLES.md - Примеры конфигураций
🛠️ CONTRIBUTING.md - Как помочь проекту
🔒 SECURITY.md - Политика безопасности
🗺️ ROADMAP.md - План развития
📝 CHANGELOG.md - История изменений

🆘 Troubleshooting

Частые проблемы:

Тест не проходит:

# Проверка конфигурации
sudo cat /etc/telemon.env
sudo /usr/local/bin/wg_telemon.sh --test --log-level DEBUG

Сервис не запускается:

# Просмотр ошибок
sudo journalctl -u wg-telemon.service -n 50
sudo systemctl status wg-telemon.service

Не приходят уведомления:

# Проверка контейнеров
docker ps | grep -i wire
sudo docker exec YOUR_CONTAINER wg show

🤝 Поддержка

Где получить помощь:

🐛 GitHub Issues - баги и проблемы
💬 GitHub Discussions - вопросы и обсуждения
📖 Wiki - подробная документация

При обращении за помощью приложите:

Версию ОС: uname -a
Версию Docker: docker --version
Логи ошибки: sudo journalctl -u wg-telemon.service -n 20

🤝 Contributing

Мы приветствуем вклад в развитие проекта! См. CONTRIBUTING.md для деталей.

Как помочь:

🐛 Сообщать о багах
✨ Предлагать новые функции
📖 Улучшать документацию
🧪 Тестировать на разных системах
🌍 Переводить на другие языки

📄 Лицензия

Этот проект распространяется под лицензией MIT. См. файл LICENSE для деталей.

🙏 Благодарности

WireGuard - за отличный VPN протокол
Docker - за контейнеризацию
Telegram - за Bot API
systemd - за управление сервисами
Сообщество - за отзывы и предложения

⭐ Поставьте звезду если проект оказался полезным!

Сделано с ❤️ для сообщества WireGuard

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
.github		.github
scripts		scripts
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
EXAMPLES.md		EXAMPLES.md
GUIDE.md		GUIDE.md
LICENSE		LICENSE
README.md		README.md
ROADMAP.md		ROADMAP.md
SECURITY.md		SECURITY.md
install-interactive.sh		install-interactive.sh
quick-install.sh		quick-install.sh
telemon.env		telemon.env
wg-telemon.service		wg-telemon.service
wg-telemon.timer		wg-telemon.timer
wg_telemon		wg_telemon

Folders and files

Latest commit

History

Repository files navigation