Xray Checker: A Prometheus exporter for monitoring Xray proxies https://xray-checker.kutovoy.dev
  • Go 75.9%
  • HTML 16.8%
  • Go Template 6.2%
  • Dockerfile 1.1%
Find a file
2025-12-21 00:23:31 +04:00
.github Нелепая попытка исправить Docker сборку 2025-12-20 23:59:20 +04:00
checker Add download check method to ProxyChecker 2025-09-23 00:19:18 +05:00
config feat(proxy): add ResolveDomains support 2025-11-11 02:42:09 +03:00
docs docs(proxy): add notes about DNS expansion and cert checks 2025-12-15 17:41:40 +03:00
metrics refactor: improve metrics push handling and URL parsing 2025-01-12 01:40:53 +05:00
models :D 2025-12-20 23:52:41 +04:00
parser :D 2025-12-20 23:52:41 +04:00
runner Enhance proxy checker functionality and update configuration options 2025-01-06 07:14:42 +03:00
subscription :D 2025-12-20 23:52:41 +04:00
utils Refactor AutoDecode function in base64.go to improve clarity and maintainability 2025-06-01 00:25:01 +05:00
web Add HTTP upgrade settings support and refactor base64 decoding to utils 2025-06-01 00:23:51 +05:00
xray :D 2025-12-20 23:52:41 +04:00
.gitignore chore: update documentation and configuration for Xray Checker 2025-01-21 23:06:50 +05:00
.goreleaser.yaml fix: env vars 2025-01-06 08:32:00 +03:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2025-01-13 23:56:53 +05:00
CONTRIBUTING.md Update documentation for Xray Checker 2025-01-22 03:38:57 +05:00
Dockerfile Забыл обновить зависимости 2025-12-21 00:23:31 +04:00
go.mod Забыл обновить зависимости 2025-12-21 00:23:31 +04:00
go.sum :D 2025-12-20 23:52:41 +04:00
LICENSE big refactor, prometheus metrics, parse subscription link 2025-01-05 23:45:34 +05:00
main.go Refactor subscription initialization to include version parameter 2025-09-28 04:10:42 +05:00
README.md :D 2025-12-20 23:52:41 +04:00
README_RU.md :D 2025-12-20 23:52:41 +04:00
SECURITY.md Update documentation for Xray Checker 2025-01-22 03:38:57 +05:00

Про этот форк.

Я никогда не программировал на Go, поэтому я не рекомендую вам использовать этот форк. Он исключительно для личных целей.

Из изменений:

  • Изменил зависимости, чтобы он собирался со свежей версией Xray
  • Добавил поддержку VLESS Encryption.

Xray Checker

GitHub Release GitHub Actions Workflow Status DockerHub Documentation GitHub License ru en

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

Dashboard Screenshot

🚀 Key Features

  • 🔍 Monitoring of Xray proxy servers (VLESS, VMess, Trojan, Shadowsocks)
  • 🔄 Automatic configuration updates from subscription
  • 📊 Prometheus metrics export
  • 🌓 Web interface with dark/light theme
  • 📥 Endpoints for monitoring system integration
  • 🔒 Basic Auth protection for metrics and web interface
  • 🐳 Docker and Docker Compose support
  • 📝 Flexible configuration loading:
    • URL-subscription
    • Base64-strings
    • JSON-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 \
  -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"

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

📈 Project Statistics

Star History Chart

🤝 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 TRYBLANCVPN for 15% off your subscription.