Development Guide

Setting Up Development Environment

1. Requirements:

   • Go 1.20 or later
   • Git
   • Make (optional, for using Makefile)

2. Clone the repository:

git clone https://github.com/kutovoys/xray-checker.git
cd xray-checker

3. Install dependencies:

go mod download

4. Build the project:

make build
# or
go build -o xray-checker

Project Structure

.
├── checker/       # Proxy checking logic
├── config/       # Configuration handling
├── metrics/      # Prometheus metrics
├── models/       # Data models
├── parser/       # Subscription parser
├── runner/       # Xray process runner
├── subscription/ # Subscription management
├── web/         # Web interface
├── xray/        # Xray integration
├── go.mod       # Go modules file
└── main.go      # Application entry point

Making Changes

1. Create a new branch:

git checkout -b feature/your-feature-name

2. Make your changes
3. Run tests
4. Update documentation if needed
5. Submit a pull request

Local Testing

1. Set up test configuration:

export SUBSCRIPTION_URL="your_test_subscription"

2. Run in development mode:

go run main.go

3. Run with specific features:

go run main.go --proxy-check-method=status --metrics-protected=true