Xray Checker: A Comprehensive Monitoring Solution for Xray Servers

[kutovoys]

Hello Xray-core community! I'd like to introduce Xray Checker, a monitoring tool built on top of Xray Core that helps you monitor and verify the health of your proxy servers.

What is Xray Checker?

Xray Checker is a specialized tool designed to automatically test and monitor Xray proxy servers. It leverages Xray Core to establish and verify connections, providing real-time status information and metrics for your proxy infrastructure.

Key Features

• 🔍 Supports all major Xray protocols: VLESS, VMess, Trojan, and Shadowsocks
• 🔄 Automatic health checks with configurable intervals
• 📊 Prometheus metrics export with status and latency information
• 🌓 Modern web interface with dark/light theme
• 🔒 Basic Authentication support for metrics and web interface
• 📋 Multiple configuration sources:
  • URL subscriptions
  • Base64-encoded strings
  • JSON files
  • Configuration folders

Monitoring Integration

• 📈 Native Prometheus metrics export
• 📡 Prometheus Pushgateway support
• 🔔 Ready-to-use endpoints for Uptime Kuma
• ⏱️ Latency measurements and simulation

Deployment Options

• 🐳 Docker and Docker Compose support
• 🚀 Standalone binary
• 🔧 Flexible configuration via environment variables or CLI flags

Quick Start

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

Documentation and Links

• 🔗 GitHub Repository: https://github.com/kutovoys/xray-checker
• 📚 Documentation: https://xray-checker.kutovoy.dev

Why Xray Checker?

Built specifically for Xray Core, this tool fills the gap in proxy monitoring solutions by providing a robust, easy-to-use system that integrates seamlessly with modern monitoring stacks. Whether you're running a single proxy or managing multiple servers, Xray Checker helps ensure your infrastructure stays reliable and performant.

Give it a try and let us know what you think! We welcome feedback, feature requests, and contributions.

---

If you find Xray Checker useful, please consider giving it a ⭐ on GitHub!

[RPRX]

可以提交 PR，收录至 README

[kutovoys]

I've created a pull-request #4319