فهرست مطالب
- معرفی Uptime Kuma
- ویژگی‌های کلیدی Uptime Kuma
- پیش‌نیازهای نصب
- نصب Uptime Kuma
- راه‌اندازی و پیکربندی اولیه
- اضافه کردن مانیتور جدید
- پیکربندی ارسال نوتیفیکیشن با تلگرام
- پیکربندی ارسال نوتیفیکیشن با کاوه‌نگار
- توضیح خط به خط اسکریپت نصب
- نکات مهم در استفاده از Uptime Kuma
- عیب‌یابی و حل مشکلات رایج
- نتیجه‌گیری
1. معرفی Uptime Kuma
Uptime Kuma یک ابزار مانیتورینگ متن‌باز است که به شما امکان می‌دهد تا وضعیت سرورها، وب‌سایت‌ها و سرویس‌های خود را به صورت Real-Time نظارت کنید. این ابزار با رابط کاربری زیبا و کاربرپسند، جایگزین مناسبی برای ابزارهای تجاری مانند Uptime Robot است.
2. ویژگی‌های کلیدی Uptime Kuma
- رابط کاربری مدرن و زیبا
- پشتیبانی از پروتکل‌های متعدد مانند HTTP(s)، TCP، Ping، DNS و ...
- ارسال نوتیفیکیشن از طریق تلگرام، ایمیل، کاوه‌نگار و ...
- نصب و راه‌اندازی آسان
- متن‌باز و رایگان
3. پیش‌نیازهای نصب
قبل از شروع، مطمئن شوید که سرور شما دارای موارد زیر است:
- سیستم‌عامل Ubuntu 20.04 یا بالاتر
- Node.js نسخه 14 یا بالاتر
- NPM (Node Package Manager)
- دسترسی به خط فرمان (ترمینال)
- Git برای کلون کردن مخزن Uptime Kuma
4. نصب Uptime Kuma
در این بخش، نحوه نصب Uptime Kuma را به صورت گام به گام توضیح می‌دهیم.
مرحله 1: به‌روزرسانی سیستم
ابتدا سیستم خود را به‌روزرسانی کنید:
توضیح خط به خط:
sudo apt update: به‌روزرسانی لیست بسته‌های موجود در مخازن.sudo apt upgrade -y: ارتقاء بسته‌های نصب‌شده به آخرین نسخه.
مرحله 2: نصب Node.js و NPM
برای نصب Node.js نسخه 14:
توضیح خط به خط:
curl -sL https://deb.nodesource.com/setup_14.x: دانلود اسکریپت نصب Node.js نسخه 14.sudo -E bash -: اجرای اسکریپت با دسترسی ریشه.sudo apt install -y nodejs: نصب Node.js و NPM.
مرحله 3: نصب Git
برای کلون کردن مخزن، نیاز به Git داریم:
توضیح:
sudo apt install -y git: نصب Git برای کلون کردن مخزن Uptime Kuma.
مرحله 4: کلون کردن مخزن Uptime Kuma
مخزن Uptime Kuma را کلون کنید:
توضیح:
git clone: دانلود کد منبع Uptime Kuma از GitHub.
مرحله 5: نصب وابستگی‌ها
به دایرکتوری پروژه بروید و وابستگی‌ها را نصب کنید:
توضیح خط به خط:
cd uptime-kuma: ورود به پوشه پروژه.npm install: نصب تمامی بسته‌های مورد نیاز پروژه.
مرحله 6: راه‌اندازی Uptime Kuma
برای اجرای برنامه:
توضیح:
npm run start-server: راه‌اندازی سرور Uptime Kuma.
5. راه‌اندازی و پیکربندی اولیه
پس از اجرای برنامه، با مراجعه به آدرس زیر می‌توانید به Uptime Kuma دسترسی پیدا کنید:
ایجاد حساب کاربری
- یک نام کاربری و کلمه عبور برای حساب ادمین خود ایجاد کنید.
- وارد داشبورد شوید.
6. اضافه کردن مانیتور جدید
برای نظارت بر یک سرویس جدید:
- روی دکمه "Add New Monitor" کلیک کنید.
- نوع مانیتور (مثلاً HTTP(s)) را انتخاب کنید.
- اطلاعات مورد نیاز مانند URL یا IP را وارد کنید.
- تنظیمات پیشرفته مانند فواصل پینگ و اعلان‌ها را پیکربندی کنید.
- روی "Save" کلیک کنید.
7. پیکربندی ارسال نوتیفیکیشن با تلگرام
یکی از امکانات جذاب Uptime Kuma، ارسال نوتیفیکیشن از طریق تلگرام است.
مرحله 1: ایجاد ربات تلگرام
- به BotFather در تلگرام بروید.
- دستور
/newbotرا ارسال کنید. - نام و نام کاربری ربات را تعیین کنید.
- توکن API ربات را دریافت کنید.
مرحله 2: دریافت Chat ID
- ربات را در تلگرام جستجو و Start کنید.
- به آدرس زیر در مرورگر بروید و توکن را جایگزین کنید:
- Chat ID خود را از پاسخ دریافت کنید.
مرحله 3: پیکربندی در Uptime Kuma
- به تب "Notification" بروید.
- روی "Add New Notification" کلیک کنید.
- نوع Telegram را انتخاب کنید.
- Bot Token و Chat ID را وارد کنید.
- روی "Test" کلیک کنید تا از صحت پیکربندی مطمئن شوید.
- روی "Save" کلیک کنید.
8. پیکربندی ارسال نوتیفیکیشن با کاوه‌نگار
کاوه‌نگار یک سرویس ایرانی برای ارسال پیامک است.
مرحله 1: ثبت‌نام در کاوه‌نگار
- به وب‌سایت کاوه‌نگار مراجعه کنید.
- ثبت‌نام کنید و وارد حساب کاربری خود شوید.
- API Key را از پنل کاربری دریافت کنید.
مرحله 2: پیکربندی در Uptime Kuma
- به تب "Notification" بروید.
- روی "Add New Notification" کلیک کنید.
- نوع Webhook را انتخاب کنید.
- URL وب‌هوک کاوه‌نگار را به شکل زیر وارد کنید:
توضیح:
{API_KEY}را با کلید API خود جایگزین کنید.{PHONE_NUMBER}را با شماره موبایل گیرنده جایگزین کنید.{MESSAGE}پیام ارسال‌شده توسط Uptime Kuma است.
مرحله 3: تنظیم قالب پیام
- در قسمت "Custom Message" می‌توانید قالب پیام را تنظیم کنید.
- از متغیرهای Uptime Kuma مانند
{STATUS}و{TIME}استفاده کنید.
مرحله 4: تست و ذخیره
- روی "Test" کلیک کنید تا مطمئن شوید پیام ارسال می‌شود.
- روی "Save" کلیک کنید.
9. توضیح خط به خط اسکریپت نصب
در این بخش، تمامی دستورات استفاده‌شده در فرآیند نصب را توضیح می‌دهیم.
اسکریپت کامل:
10. نکات مهم در استفاده از Uptime Kuma
- راه‌اندازی به عنوان سرویس: برای اجرای خودکار Uptime Kuma پس از راه‌اندازی سرور، می‌توانید آن را به عنوان یک سرویس Systemd تنظیم کنید.
- بروزرسانی منظم: با مراجعه به مخزن GitHub، از آخرین نسخه استفاده کنید.
- پشتیبان‌گیری از تنظیمات: به صورت منظم از تنظیمات و داده‌های خود بکاپ بگیرید.
11. عیب‌یابی و حل مشکلات رایج
- عدم دسترسی به وب‌سایت Uptime Kuma: مطمئن شوید که پورت 3001 در فایروال باز است.
- مشکلات در ارسال نوتیفیکیشن: تنظیمات API و Tokenها را دوباره بررسی کنید.
- سرعت پایین یا قطعی: منابع سرور را بررسی و در صورت نیاز افزایش دهید.
12. نتیجه‌گیری
در این مقاله، به صورت جامع به نصب، راه‌اندازی و پیکربندی Uptime Kuma پرداختیم. همچنین نحوه ارسال نوتیفیکیشن‌ها از طریق کاوه‌نگار و تلگرام را آموزش دادیم. با استفاده از Uptime Kuma، می‌توانید به سادگی وضعیت سرورها و سرویس‌های خود را نظارت کرده و در صورت بروز مشکل، به سرعت اقدام کنید.
