بلاگ/راه‌اندازی Uptime Kuma روی سرور مجازی و اختصاصی: مانیتورینگ آپ‌تایم و صفحه وضعیت عمومی
به‌روز شده

راه‌اندازی Uptime Kuma روی سرور مجازی و اختصاصی: مانیتورینگ آپ‌تایم و صفحه وضعیت عمومی

1405/08/260 بازدید
راه‌اندازی Uptime Kuma روی سرور مجازی و اختصاصی: مانیتورینگ آپ‌تایم و صفحه وضعیت عمومی

راه‌اندازی Uptime Kuma روی سرور مجازی و اختصاصی: مانیتورینگ آپ‌تایم و صفحه وضعیت عمومی

وقتی سایت یا سرویسی چند ساعت پایین باشد و شما آخرین نفری باشید که متوجه می‌شوید، مشکل از زیرساخت نیست، از نبود مانیتورینگ است. Uptime Kuma همین خالی را پر می‌کند: یک ابزار متن‌باز سبک که روی سرور خودتان بالا می‌آید و لحظه‌ای که سرویسی جواب ندهد به شما خبر می‌دهد.

Uptime Kuma چیست و چه فرقی با UptimeRobot دارد؟

Uptime Kuma جایگزین خودمیزبان ابزارهایی مثل UptimeRobot یا Pingdom است. تفاوت اصلی این‌جاست که داده‌ها و تاریخچهٔ آپ‌تایم روی سرور خودتان می‌ماند، نه روی سرور یک شرکت دیگر، و محدودیتی در تعداد مانیتور یا بازهٔ بررسی ندارید.

این ابزار می‌تواند آدرس‌های HTTP/HTTPS، پورت TCP (مثلا دیتابیس یا سرویس SSH)، پینگ، DNS و حتی وضعیت کانتینرهای Docker را چک کند. هر بار که یک مانیتور قطع یا وصل شود، در داشبورد ثبت می‌شود و اگر اعلان را وصل کرده باشید، پیام هم می‌رسد.

نمودار مفهومی مانیتورینگ متمرکز چند سرور و گزارش وضعیت آپ‌تایم

سرور مجازی یا اختصاصی: کدام برای Uptime Kuma کافی است؟

خود Uptime Kuma سبک است و منابع زیادی نمی‌خواهد؛ نکته مهم‌تر این است که روی چه سروری نصبش می‌کنید و این سرور چه نقشی در زیرساخت شما دارد.


ویژگیسرور مجازیسرور اختصاصی
هزینهٔ شروعپایین، برای چند ده مانیتور کافی استبالاتر، برای زیرساخت بزرگ‌تر منطقی است
مناسب برایمانیتورینگ سایت‌ها و API‌های پراکندهوقتی Uptime Kuma کنار سرویس‌های دیگر خودتان روی یک سخت‌افزار اختصاصی اجرا می‌شود
ایزوله بودن از سرویس‌های مانیتورشدهبله، روی سروری جدا از سرویس اصلیبستگی به نحوهٔ چیدمان شما دارد
زمان راه‌اندازیچند دقیقهچند دقیقه، بعد از آماده شدن سرور

برای بیشتر تیم‌ها یک سرور مجازی جدا از سرویسی که مانیتور می‌کنید منطقی‌تر است؛ اگر سرور اصلی قطع شود، ابزار مانیتورینگ‌تان هم روی همان سرور قطع نباشد.

نصب Docker و اجرای Uptime Kuma

ساده‌ترین راه اجرای Uptime Kuma، Docker است. اگر Docker روی سرورتان نصب نیست، اول آن را نصب کنید (یا روی سرور ابری آریانت از نصب یک‌کلیکی Docker CE استفاده کنید):

curl -fsSL https://get.docker.com | sh

بعد یک پوشه برای پروژه بسازید و فایل docker-compose.yml را داخلش بگذارید:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    volumes:
      - ./uptime-kuma-data:/app/data
    ports:
      - "3001:3001"
    restart: always

و اجرا کنید:

docker compose up -d

بعد از چند ثانیه آدرس http://IP-سرور:3001 را باز کنید، یک نام کاربری و رمز برای ادمین بسازید و وارد داشبورد شوید. پورت ۳۰۰۱ را با یک فایروال مثل UFW فقط برای IP خودتان باز بگذارید یا پشت یک reverse proxy با HTTPS قرارش بدهید؛ داشبورد مانیتورینگ‌تان نباید در دسترس عموم باشد.

تعریف اولین مانیتور

از داشبورد روی «Add New Monitor» بزنید. برای یک سایت معمولی:

  • نوع مانیتور را روی HTTP(s) بگذارید.
  • آدرس کامل سایت را وارد کنید، با https://.
  • بازهٔ بررسی را مشخص کنید؛ برای سایت اصلی ۶۰ ثانیه معقول است، برای سرویس‌های کم‌اهمیت‌تر می‌شود آن را به ۵ دقیقه رساند تا بار کمتری روی سرور بگذارد.
  • تعداد تلاش قبل از اعلام قطعی (Retries) را روی عدد بیشتر از صفر بگذارید؛ یک تایم‌اوت موقت شبکه را با قطعی واقعی اشتباه نگیرید.

برای چک کردن یک دیتابیس یا سرویس SSH، نوع مانیتور را روی TCP Port بگذارید و پورت مربوطه را بدهید. برای کانتینرهای Docker هم نوع Docker Container هست که مستقیم به سوکت Docker وصل می‌شود.

اتصال اعلان به تلگرام

راه‌اندازی اعلان تلگرام چند دقیقه بیشتر طول نمی‌کشد:

  1. در تلگرام با ربات @BotFather یک بات جدید بسازید و توکنی که می‌دهد را نگه دارید.
  2. بات را به یک گروه یا چت خصوصی اضافه کنید و یک پیام بفرستید.
  3. از طریق آدرس https://api.telegram.org/bot<TOKEN>/getUpdates عدد chat id را پیدا کنید.
  4. در Uptime Kuma به Settings → Notifications بروید، نوع Telegram را انتخاب کنید، توکن و chat id را وارد کنید و روی Test بزنید.

از این‌جا به بعد هر مانیتوری که به این اعلان وصل باشد، همزمان با قطع و وصل شدن یک پیام در تلگرام می‌فرستد.

ساخت صفحهٔ وضعیت عمومی

اگر می‌خواهید مشتری‌ها یا تیم‌های دیگر خودشان وضعیت سرویس را ببینند بدون این‌که به شما پیام بدهند، از بخش Status Pages یک صفحه بسازید. مانیتورهایی که می‌خواهید نشان داده شوند را اضافه کنید، یک عنوان و توضیح کوتاه بنویسید، و اگر لازم است صفحه را روی یک دامنهٔ اختصاصی مثل status.yourdomain.com بیاورید.

این صفحه به‌صورت پیش‌فرض عمومی است؛ اگر می‌خواهید فقط افراد مشخصی ببینندش، گزینهٔ رمز را از همان تنظیمات فعال کنید.

نگهداری و امنیت

چند نکته که بعد از راه‌اندازی اولیه فراموش می‌شوند:

  • پوشهٔ uptime-kuma-data همهٔ تاریخچهٔ مانیتورها را نگه می‌دارد؛ از همین پوشه به‌طور منظم بکاپ بگیرید.
  • به‌روزرسانی با docker compose pull && docker compose up -d انجام می‌شود؛ قبل از آپدیت یک بکاپ از دیتا بگیرید.
  • اگر Uptime Kuma را پشت Nginx یا Caddy گذاشتید، گواهی SSL رایگان با Let's Encrypt را روی همان دامنه تنظیم کنید تا لاگین هم رمزنگاری‌شده باشد.
  • رمز ادمین را از همان روز اول قوی انتخاب کنید؛ این داشبورد نشان می‌دهد چه سرویس‌هایی دارید و کِی قطع می‌شوند.

برای این‌که مانیتورینگ‌تان وابسته به همان سروری نباشد که مانیتور می‌کنید، یک سرور مجازی جدا برای Uptime Kuma کافی است؛ اگر همین سرور را کنار سرویس‌های دیگرتان هم می‌خواهید نگه دارید، گزینهٔ سرور اختصاصی منابع بیشتری در اختیارتان می‌گذارد.

سؤالات متداول

آیا Uptime Kuma رایگان است؟ بله، متن‌باز است و فقط هزینهٔ سروری که رویش نصب می‌کنید برایتان باقی می‌ماند.

چند مانیتور می‌توانم تعریف کنم؟ محدودیتی در نرم‌افزار نیست؛ محدودیت واقعی منابع سرور شما است. برای چند ده مانیتور یک سرور مجازی پایه کافی است.

آیا بدون Docker هم می‌شود نصبش کرد؟ بله، با Node.js هم قابل نصب است، اما Docker به‌روزرسانی و نگهداری را خیلی ساده‌تر می‌کند.

صفحهٔ وضعیت عمومی را می‌شود روی دامنهٔ خودم آورد؟ بله، از تنظیمات همان صفحه یک دامنهٔ اختصاصی ثبت می‌کنید و بعد از اشاره‌دادن DNS، همان‌جا در دسترس خواهد بود.