README_RU.md

Xray Checker

Xray Checker - это инструмент для мониторинга доступности прокси-серверов с поддержкой протоколов VLESS, VMess, Trojan и Shadowsocks. Он автоматически тестирует соединения через Xray Core и предоставляет метрики для Prometheus, а также API-эндпоинты для интеграции с системами мониторинга.

Tip

Попробуйте демо: Посмотрите Xray Checker в действии на demo-xray-checker.kutovoy.dev

🚀 Основные возможности

• 🔍 Мониторинг работоспособности Xray-прокси серверов (VLESS, VMess, Trojan, Shadowsocks)
• 🔄 Автоматическое обновление конфигурации из подписки (поддержка нескольких подписок)
• 📊 Экспорт метрик в формате Prometheus с поддержкой Pushgateway
• 🌐 REST API с документацией OpenAPI/Swagger
• 🌓 Веб-интерфейс с темной/светлой темой
• 🎨 Полная кастомизация веб-интерфейса (свой логотип, стили или весь шаблон)
• 📄 Публичная страница статуса для VPN-сервисов (без аутентификации)
• 📥 Эндпоинты для интеграции с системами мониторинга (Uptime Kuma и др.)
• 🔒 Защита метрик и веб-интерфейса с помощью Basic Auth
• 🐳 Поддержка Docker и Docker Compose
• 🌍 Автоматическое управление geo-файлами (geoip.dat, geosite.dat)
• 📝 Гибкая загрузка конфигурации:
  • URL-подписки (base64, JSON)
  • Share-ссылки (vless://, vmess://, trojan://, ss://)
  • JSON-файлы конфигурации
  • Папки с конфигурациями

Полный список возможностей доступен в документации.

🚀 Быстрый старт

Docker

docker run -d \
  -e SUBSCRIPTION_URL=https://your-subscription-url/sub \
  -p 2112:2112 \
  kutovoys/xray-checker

Docker Compose

services:
  xray-checker:
    image: kutovoys/xray-checker
    environment:
      - SUBSCRIPTION_URL=https://your-subscription-url/sub
    ports:
      - "2112:2112"

Подробная документация по установке и настройке доступна на xray-checker.kutovoy.dev

📈 Статистика проекта

🤝 Участие в разработке

Мы рады любому вкладу в развитие Xray Checker! Если вы хотите помочь:

1. Сделайте форк репозитория
2. Создайте ветку для ваших изменений
3. Внесите изменения и протестируйте их
4. Создайте Pull Request

Подробнее о том, как внести свой вклад, читайте в руководстве для контрибьюторов.

Спасибо всем контрибьюторам, которые помогли улучшить Xray Checker:

Сделано с помощью contrib.rocks

---

Рекомендация VPN

Для безопасного и надежного доступа в интернет мы рекомендуем BlancVPN. Используйте промокод KLUGSCL для получения скидки 15% на вашу подписку.