داکر

استفاده پایه از Docker

دریافت آخرین ایمیج:

docker pull kutovoys/xray-checker

اجرا با حداقل پیکربندی:

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

چندین اشتراک

می‌توانید چندین آدرس اشتراک را با جدا کردن آن‌ها با کاما مشخص کنید:

docker run -d \
  -e SUBSCRIPTION_URL=https://provider1.com/sub,https://provider2.com/sub,file:///config/local.json \
  -v /path/to/configs:/config \
  -p 2112:2112 \
  kutovoys/xray-checker

یا از آرگومان‌های CLI برای راه‌اندازی تمیزتر چند اشتراک استفاده کنید:

docker run -d \
  -p 2112:2112 \
  kutovoys/xray-checker \
  --subscription-url=https://provider1.com/sub \
  --subscription-url=https://provider2.com/sub

پیکربندی کامل Docker

docker run -d \
  -e SUBSCRIPTION_URL=https://your-subscription-url/sub \
  -e SUBSCRIPTION_UPDATE=true \
  -e SUBSCRIPTION_UPDATE_INTERVAL=300 \
  -e PROXY_CHECK_INTERVAL=300 \
  -e PROXY_CHECK_METHOD=ip \
  -e PROXY_TIMEOUT=30 \
  -e PROXY_IP_CHECK_URL=https://api.ipify.org?format=text \
  -e PROXY_STATUS_CHECK_URL=http://cp.cloudflare.com/generate_204 \
  -e PROXY_DOWNLOAD_URL=https://proof.ovh.net/files/1Mb.dat \
  -e PROXY_DOWNLOAD_TIMEOUT=60 \
  -e PROXY_DOWNLOAD_MIN_SIZE=51200 \
  -e PROXY_RESOLVE_DOMAINS=false \
  -e SIMULATE_LATENCY=true \
  -e XRAY_START_PORT=10000 \
  -e XRAY_LOG_LEVEL=none \
  -e METRICS_HOST=0.0.0.0 \
  -e METRICS_PORT=2112 \
  -e METRICS_PROTECTED=true \
  -e METRICS_USERNAME=custom_user \
  -e METRICS_PASSWORD=custom_pass \
  -e METRICS_INSTANCE=node-1 \
  -e METRICS_PUSH_URL=https://push.example.com \
  -e METRICS_BASE_PATH=/xray/monitor \
  -e WEB_SHOW_DETAILS=false \
  -e LOG_LEVEL=info \
  -e RUN_ONCE=false \
  -p 2112:2112 \
  kutovoys/xray-checker

Docker Compose

docker-compose.yml پایه:

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

docker-compose.yml کامل:

services:
  xray-checker:
    image: kutovoys/xray-checker
    environment:
      - SUBSCRIPTION_URL=https://your-subscription-url/sub
      - SUBSCRIPTION_UPDATE=true
      - SUBSCRIPTION_UPDATE_INTERVAL=300
      - PROXY_CHECK_INTERVAL=300
      - PROXY_CHECK_METHOD=ip
      - PROXY_TIMEOUT=30
      - PROXY_IP_CHECK_URL=https://api.ipify.org?format=text
      - PROXY_STATUS_CHECK_URL=http://cp.cloudflare.com/generate_204
      - PROXY_DOWNLOAD_URL=https://proof.ovh.net/files/1Mb.dat
      - PROXY_DOWNLOAD_TIMEOUT=60
      - PROXY_DOWNLOAD_MIN_SIZE=51200
      - PROXY_RESOLVE_DOMAINS=false
      - SIMULATE_LATENCY=true
      - XRAY_START_PORT=10000
      - XRAY_LOG_LEVEL=none
      - METRICS_HOST=0.0.0.0
      - METRICS_PORT=2112
      - METRICS_PROTECTED=true
      - METRICS_USERNAME=custom_user
      - METRICS_PASSWORD=custom_pass
      - METRICS_INSTANCE=node-1
      - METRICS_PUSH_URL=https://push.example.com
      - METRICS_BASE_PATH=/xray/monitor
      - WEB_SHOW_DETAILS=false
      - LOG_LEVEL=info
      - RUN_ONCE=false
    ports:
      - "2112:2112"
    restart: unless-stopped

پیکربندی شبکه Docker

راه‌اندازی شبکه سفارشی:

services:
  xray-checker:
    networks:
      - monitoring
    ports:
      - "2112:2112"

networks:
  monitoring:
    name: monitoring-network

بررسی سلامت Docker

اضافه کردن بررسی سلامت به docker-compose.yml:

services:
  xray-checker:
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:2112/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

نمونه تنظیمات داکر برای روش بررسی دانلود

مثالی با استفاده از روش بررسی دانلود:

docker run -d \
  -e SUBSCRIPTION_URL=https://your-subscription-url/sub \
  -e PROXY_CHECK_METHOD=download \
  -e PROXY_DOWNLOAD_URL=https://proof.ovh.net/files/1Mb.dat \
  -e PROXY_DOWNLOAD_TIMEOUT=60 \
  -e PROXY_DOWNLOAD_MIN_SIZE=51200 \
  -p 2112:2112 \
  kutovoys/xray-checker

این پیکربندی موارد زیر را انجام خواهد داد:

• دانلود یک فایل تست از طریق هر پروکسی
• در نظر گرفتن بررسی به عنوان «موفقیت‌آمیز» در صورتی که حداقل ۵۰KB دانلود شود
• ایجاد وقفه (Timeout) پس از ۱ دقیقه
• تست عملکرد واقعی انتقال داده‌ها از طریق پروکسی‌ها

داشبورد عمومی

برای عمومی کردن داشبورد (مثلاً به عنوان صفحه وضعیت برای سرویس VPN شما):

docker run -d \
  -e SUBSCRIPTION_URL=https://your-subscription-url/sub#My%20VPN%20Status \
  -e METRICS_PROTECTED=true \
  -e METRICS_USERNAME=admin \
  -e METRICS_PASSWORD=secret \
  -e WEB_PUBLIC=true \
  -p 2112:2112 \
  kutovoys/xray-checker

این پیکربندی موارد زیر را انجام خواهد داد:

• داشبورد را در مسیر / عمومی می‌کند (بدون نیاز به احراز هویت)
• از نام اشتراک در فرگمنت URL به عنوان عنوان صفحه استفاده می‌کند (“My VPN Status”)
• نقاط پایانی /metrics و /api/ را با احراز هویت پایه محافظت می‌کند
• کنترل‌های مدیریتی و جزئیات فنی را از نمای عمومی پنهان می‌کند