راهاندازی 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 وصل میشود.
اتصال اعلان به تلگرام
راهاندازی اعلان تلگرام چند دقیقه بیشتر طول نمیکشد:
- در تلگرام با ربات
@BotFatherیک بات جدید بسازید و توکنی که میدهد را نگه دارید. - بات را به یک گروه یا چت خصوصی اضافه کنید و یک پیام بفرستید.
- از طریق آدرس
https://api.telegram.org/bot<TOKEN>/getUpdatesعددchat idرا پیدا کنید. - در 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، همانجا در دسترس خواهد بود.




