مانیتورینگ API و ساخت صفحه وضعیت با Gatus روی سرور مجازی ایران (راهنمای کامل ۲۰۲۶)

📌 در این راهنما یاد می‌گیرید:

🔹 نصب Gatus روی سرور مجازی لینوکس با Docker

🔹 مانیتور کردن API با بررسی JSON و زمان پاسخ

🔹 مانیتور کردن پورت‌های TCP مثل MySQL و Redis

🔹 ساخت Status Page و اتصال دامنه

🔹 رفع خطاهای رایج و نکات امنیتی

🔹 پشتیبانی از پروتکل‌های HTTP، TCP، ICMP، DNS، SSH و TLS

🔹 تعریف شرط برای پاسخ API با JSONPath (مثل بررسی status: ok در بدنه پاسخ)

🔹 بررسی زمان پاسخ و انقضای گواهی SSL

🔹 ارسال اعلان به Telegram، Slack، Discord، Email و Webhook

🔹 Status Page داخلی با قابلیت گروه‌بندی سرویس‌ها

🔹 پینگ پایین‌تر برای بررسی سرویس‌های داخلی مثل درگاه پرداخت و پیامک

🔹 عدم وابستگی به سرویس‌های مانیتورینگ خارجی که ممکن است در دسترس نباشند

🔹 کنترل کامل روی داده‌های مانیتورینگ و تاریخچه سرویس‌ها

🔹 هزینه ثابت — یک VPS با ۵۱۲ مگابایت رم برای مانیتور کردن ده‌ها Endpoint کافی است

# نصب Docker با اسکریپت رسمی
curl -fsSL https://get.docker.com | sh

# بررسی وضعیت سرویس
systemctl status docker

# بررسی نسخه
docker --version

mkdir -p /opt/gatus
cd /opt/gatus
nano config.yaml

storage:
  type: sqlite
  path: /data/data.db

endpoints:
  - name: Website
    group: Web
    url: "https://example.com"
    interval: 30s
    conditions:
      - "[STATUS] == 200"
      - "[RESPONSE_TIME] < 2000"

  - name: API Health
    group: API
    url: "https://api.example.com/health"
    interval: 30s
    conditions:
      - "[STATUS] == 200"
      - "[BODY].status == ok"

docker run -d \
  --name gatus \
  --restart unless-stopped \
  -p 127.0.0.1:8080:8080 \
  -v /opt/gatus/config.yaml:/config/config.yaml:ro \
  -v /opt/gatus/data:/data \
  twinproduction/gatus:latest

docker ps --filter name=gatus
docker logs gatus

{
  "status": "ok",
  "version": "2.1.0",
  "database": "connected"
}

endpoints:
  - name: Main API
    group: API
    url: "https://api.example.com/health"
    interval: 30s
    conditions:
      - "[STATUS] == 200"
      - "[BODY].status == ok"
      - "[BODY].database == connected"
      - "[RESPONSE_TIME] < 1500"

endpoints:
  - name: MySQL
    group: Database
    url: "tcp://127.0.0.1:3306"
    interval: 30s
    conditions:
      - "[CONNECTED] == true"

  - name: Redis
    group: Database
    url: "tcp://127.0.0.1:6379"
    interval: 30s
    conditions:
      - "[CONNECTED] == true"

  - name: SSH
    group: Infrastructure
    url: "tcp://127.0.0.1:22"
    interval: 60s
    conditions:
      - "[CONNECTED] == true"

⚠️ نکته: برای مانیتور کردن سرویس‌هایی مثل MySQL، از یک کاربر با دسترسی محدود استفاده کنید. Gatus فقط اتصال TCP را بررسی می‌کند و نیازی به احراز هویت ندارد.

🔹 سرور مجازی ایران با منابع اختصاصی

برای اجرای Gatus و مانیتورینگ سرویس‌های خود به یک VPS پایدار با RAM و CPU اختصاصی نیاز دارید. ایرانیکاسرور سرورهای مجازی ایران با دیسک NVMe، پهنای باند نامحدود و پشتیبانی ۲۴/۷ ارائه می‌دهد. همین حالا سرور مناسب خود را انتخاب کنید.

📞 تماس با پشتیبانی: 021-91302460 | ایرانیکاسرور

status.example.com  →  SERVER_IP

server {
    listen 80;
    server_name status.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

nginx -t
systemctl reload nginx

apt install certbot python3-certbot-nginx -y
certbot --nginx -d status.example.com

alerting:
  telegram:
    token: "YOUR_BOT_TOKEN"
    id: "YOUR_CHAT_ID"

endpoints:
  - name: Website
    url: "https://example.com"
    interval: 30s
    conditions:
      - "[STATUS] == 200"
    alerts:
      - type: telegram
        description: "سایت از دسترس خارج شد!"
        send-on-resolved: true

docker logs gatus

docker restart gatus

🔹 آدرس اشتباه: URL را با curl تست کنید

🔹 کد HTTP متفاوت: API ممکن است ۲۰۱ یا ۲۰۴ برگرداند، نه ۲۰۰

🔹 Firewall: ممکن است درخواست‌های Gatus مسدود شوند

🔹 Cloudflare/WAF: ممکن است به عنوان ربات شناسایی شود

🔹 Timeout: اگر API کند باشد، شرط RESPONSE_TIME را افزایش دهید

# بررسی listen بودن پورت
ss -lntp | grep 8080

# بررسی وضعیت فایروال
ufw status

endpoints:
  - name: Website
    group: Website
    url: "https://example.com"
    interval: 30s
    conditions:
      - "[STATUS] == 200"

  - name: API
    group: API
    url: "https://example.com/api/health"
    interval: 30s
    conditions:
      - "[STATUS] == 200"
      - "[BODY].status == ok"

  - name: Admin Panel
    group: Admin
    url: "https://example.com/admin"
    interval: 60s
    conditions:
      - "[STATUS] == 200"

  - name: MySQL
    group: Database
    url: "tcp://127.0.0.1:3306"
    interval: 30s
    conditions:
      - "[CONNECTED] == true"

  - name: Redis
    group: Database
    url: "tcp://127.0.0.1:6379"
    interval: 30s
    conditions:
      - "[CONNECTED] == true"

🔹 هاست وردپرس و لینوکس با پشتیبانی تخصصی

اگر به دنبال میزبانی پایدار برای وب‌سایت خود هستید، ایرانیکاسرور هاست وردپرس و هاست لینوکس ایران با منابع تضمین‌شده و آپ‌تایم ۹۹.۹٪ ارائه می‌دهد. زیرساخت ما به گونه‌ای طراحی شده که Gatus و ابزارهای مانیتورینگ بدون تداخل با منابع اصلی اجرا شوند.

📞 تماس با پشتیبانی: 021-91302460 | ایرانیکاسرور

⚠️ پورت 8080 را عمومی نکنید. به جای -p 8080:8080 از -p 127.0.0.1:8080:8080 استفاده کنید تا فقط از داخل سرور در دسترس باشد.

⚠️ از Basic Auth استفاده کنید. Gatus از احراز هویت HTTP Basic پشتیبانی می‌کند .

⚠️ فقط پورت‌های ۸۰ و ۴۴۳ را باز نگه دارید. بقیه ترافیک را از طریق Nginx یا Caddy هدایت کنید.

🔹 مشکل در نصب یا کانفیگ Gatus دارید؟

تیم فنی ایرانیکاسرور آماده کمک به شماست. اگر در نصب Gatus، تنظیمات کانفیگ، اتصال دامنه یا راه‌اندازی Nginx به مشکل خورده‌اید، درخواست خود را ثبت کنید. کارشناسان ما در سریع‌ترین زمان بررسی می‌کنند.

📞 تماس با پشتیبانی: 021-91302460 | ایرانیکاسرور

Gatus یک ابزار مانیتورینگ سبک، متن‌باز و Config-as-Code است که به شما امکان می‌دهد وضعیت وب‌سایت، API، پورت‌ها و سرویس‌های مختلف را روی سرور مجازی ایران بررسی کنید و یک Status Page حرفه‌ای بسازید.

با ترکیب Docker، Nginx و HTTPS می‌توانید صفحه وضعیت اختصاصی خود را روی دامنه‌ای مثل status.example.com راه‌اندازی کنید و در صورت خرابی سرویس، از طریق Telegram یا Webhook مطلع شوید.

مهم‌ترین مزیت Gatus نسبت به سایر ابزارها، مصرف بسیار پایین منابع و قابلیت بررسی دقیق پاسخ API با JSONPath است. اگر سرویس‌های متعددی روی یک VPS دارید، با یک فایل YAML می‌توانید همه آن‌ها را مدیریت و مانیتور کنید.