راهنمای توسعه

راه‌اندازی محیط توسعه

1. پیش‌نیازها:

   • Go ۱.۲۰ یا بالاتر
   • Git
   • Make (اختیاری، برای استفاده از Makefile)

2. کلون کردن مخزن:

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

3. نصب وابستگی‌ها:

go mod download

4. ساخت پروژه:

make build
# یا
go build -o xray-checker

ساختار پروژه

.
├── checker/       # منطق بررسی پروکسی
├── config/        # مدیریت پیکربندی
├── logger/        # لاگ ساختاریافته
├── metrics/       # متریک‌های Prometheus
├── models/        # مدل‌های داده
├── subscription/  # تجزیه و مدیریت اشتراک
├── web/           # رابط وب و API
├── xray/          # یکپارچه‌سازی و اجراکننده Xray
├── go.mod         # فایل ماژول‌های Go
└── main.go        # نقطه ورود برنامه

ایجاد تغییرات

1. ایجاد branch جدید:

git checkout -b feature/your-feature-name

2. تغییرات خود را ایجاد کنید
3. تست‌ها را اجرا کنید
4. در صورت نیاز مستندات را به‌روز کنید
5. یک pull request ارسال کنید

تست محلی

1. راه‌اندازی پیکربندی تست:

export SUBSCRIPTION_URL=your_test_subscription

2. اجرا در حالت توسعه:

go run main.go

3. اجرا با ویژگی‌های خاص:

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