Изменения в этом форке

• Исправлено смешивание профилей на одном server:port: каждая share-ссылка теперь проверяется как отдельный профиль, а не заменяется последней ссылкой на тот же endpoint.
• Исправлена проверка разных вариантов одного и того же сервера: RAW, XHTTP, KCP, XDNS и Encryption больше не схлопываются в один результат.
• Добавлена поддержка XDNS share-ссылок: параметр fm сохраняется и попадает в итоговый Xray-конфиг как finalmask, поэтому XDNS-профили реально запускаются и проверяются.
• Добавлена поддержка Hysteria2 share-ссылок hysteria2:// и hy2://, включая TLS pin pcs.
• Настройки транспорта из share-ссылки сохраняются, но сервер и пользователь профиля не подменяются данными из raw outbound.
• Поддержка PROXY_CHECK_CONCURRENCY, сколько одновременных проверок можно запустить.
• Проверки прокси больше не накладываются друг на друга: новая итерация начинается только после завершения предыдущей и паузы PROXY_CHECK_INTERVAL.

Xray Checker

Xray Checker is a tool for monitoring proxy server availability with support for VLESS, VMess, Trojan, Shadowsocks, and Hysteria2 protocols. It automatically tests connections through Xray Core and provides metrics for Prometheus, as well as API endpoints for integration with monitoring systems.

Tip

Try the Live Demo: See Xray Checker in action at demo-xray-checker.kutovoy.dev

🚀 Key Features

• 🔍 Monitoring of Xray proxy servers (VLESS, VMess, Trojan, Shadowsocks, Hysteria2)
• 🔄 Automatic configuration updates from subscription (multiple subscriptions supported)
• 📊 Prometheus metrics export with Pushgateway support
• 🌐 REST API with OpenAPI/Swagger documentation
• 🌓 Web interface with dark/light theme
• 🎨 Full web customization (custom logo, styles, or entire template)
• 📄 Public status page for VPN services (no authentication required)
• 📥 Endpoints for monitoring system integration (Uptime Kuma, etc.)
• 🔒 Basic Auth protection for metrics and web interface
• 🐳 Docker and Docker Compose support
• 🌍 Automatic geo files management (geoip.dat, geosite.dat)
• 📝 Flexible configuration loading:
  • URL subscriptions (base64, JSON)
  • Share links (vless://, vmess://, trojan://, ss://, hysteria2://, hy2://)
  • JSON configuration files
  • Folders with configurations

Full list of features available in the documentation.

🚀 Quick Start

Docker

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

Docker Compose

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

Detailed installation and configuration documentation is available at xray-checker.kutovoy.dev

📈 Project Statistics

🤝 Contributing

We welcome any contributions to Xray Checker! If you want to help:

1. Fork the repository
2. Create a branch for your changes
3. Make and test your changes
4. Create a Pull Request

For more details on how to contribute, read the contributor's guide.

Thanks to the all contributors who have helped improve Xray Checker:

Made with contrib.rocks

VPN Recommendation

For secure and reliable internet access, we recommend BlancVPN. Use promo code KLUGSCL for 15% off your subscription.