برای نصب Uptime Kuma در اوبونتو، ابتدا پیش نیازهای سیستم شامل Node.js و Git یا Docker را نصب کنید. روش توصیه شده و مدرن، استفاده از Docker و Docker Compose است که با اجرای چند دستور ساده، محیطی ایزوله و پایدار فراهم می کند. پس از اجرای کانتینر، پورت 3001 را در فایروال باز کرده و از طریق مرورگر به آدرس http://IP_Server:3001 متصل شوید تا حساب کاربری مدیر را ایجاد و پیکربندی نهایی را انجام دهید. برای محیط های تولیدی، تنظیم یک پروکسی معکوس مانند Nginx همراه با گواهینامه SSL برای افزایش امنیت الزامی است.
آشنایی با Uptime Kuma و اهمیت مانیتورینگ سرور
در دنیای مدیریت زیرساخت و شبکه، اطمینان از در دسترس بودن مداوم سرویس ها، وبسایت ها و پایگاه داده ها یکی از حیاتی ترین وظایف مدیران سیستم است. Uptime Kuma یک ابزار مانیتورینگ وضعیت متن باز، قدرتمند و کاملا رایگان است که به عنوان جایگزینی ایده آل برای سرویس های مانیتورینگ تجاری و پولی شناخته می شود. این نرم افزار با ارائه رابط کاربری بصری و مدرن، امکان پایش لحظه ای منابع مختلف را فراهم کرده و در صورت بروز هرگونه قطعی یا اختلال، از طریق کانال های ارتباطی متنوع به سرعت تیم فنی را مطلع می سازد.
توسعه فعال این پروژه و جامعه کاربری گسترده آن، باعث شده است تا قابلیت های آن به طور مداوم گسترش یابد. برخلاف بسیاری از ابزارهای پیچیده مانیتورینگ که نیازمند دانش عمیق برنامه نویسی یا پیکربندی های زمان بر هستند، Uptime Kuma با تمرکز بر سادگی و کارایی، امکان راه اندازی سریع را حتی برای کاربران با سطح دانش متوسط فراهم می کند. این ابزار بر روی سیستم عامل های مختلف از جمله اوبونتو به خوبی اجرا می شود و انعطاف پذیری بالایی در روش های استقرار دارد.
قابلیت های کلیدی و مزایای استفاده
- پشتیبانی از پروتکل های متنوع: امکان مانیتورینگ HTTP/HTTPS، پورت های TCP، پینگ ICMP، سرورهای DNS، پروتکل های Push و حتی بررسی اعتبار گواهینامه های SSL.
- سیستم هشداردهی گسترده: ادغام داخلی با بیش از نود سرویس اطلاع رسانی شامل تلگرام، دیسکورد، اسلک، ایمیل، وب هوک های سفارشی و پیامک.
- صفحات وضعیت عمومی: امکان ایجاد صفحات وضعیت زیبا و قابل اشتراک گذاری برای نمایش سلامت سرویس ها به کاربران نهایی.
- تاریخچه و نمودارهای دقیق: ثبت و نمایش گرافیکی زمان پاسخگویی و درصد در دسترس بودن سرویس ها در بازه های زمانی مختلف.
- سبک و بهینه: مصرف منابع بسیار پایین نسبت به راهکارهای سنگین مانیتورینگ، که آن را برای سرورهای مجازی با منابع محدود ایده آل می سازد.
مقایسه Uptime Kuma با سایر راهکارهای مانیتورینگ
انتخاب ابزار مناسب مانیتورینگ بستگی به نیازهای خاص زیرساخت شما دارد. جدول زیر مقایسه ای دقیق بین Uptime Kuma و دو رقیب رایج آن ارائه می دهد تا انتخاب آگاهانه تری داشته باشید.
| ویژگی | Uptime Kuma | Uptime Robot | Prometheus + Grafana |
|---|---|---|---|
| نوع استقرار | میزبانی شخصی (Self-Hosted) | سرویس ابری (SaaS) | میزبانی شخصی (پیچیده) |
| هزینه | کاملا رایگان و متن باز | رایگان محدود / اشتراکی | رایگان (هزینه زیرساخت) |
| رابط کاربری | بسیار ساده و بصری | ساده | پیچیده و نیازمند یادگیری |
| انواع مانیتورینگ | HTTP, TCP, Ping, DNS, SSL | HTTP, Ping, Keyword | متریک های سفارشی گسترده |
پیش نیازهای نصب Uptime Kuma در اوبونتو
قبل از شروع فرآیند نصب، اطمینان حاصل کنید که سرور اوبونتو شما شرایط اولیه زیر را دارا باشد. این پیش نیازها برای هر دو روش نصب دستی و داکر مشترک هستند.
- سیستم عامل اوبونتو نسخه 20.04، 22.04 یا 24.04 (نسخه های LTS توصیه می شوند).
- دسترسی روت یا یک کاربر با امتیازات sudo برای اجرای دستورات مدیریتی.
- اتصال پایدار به اینترنت برای دانلود بسته های نرم افزاری و مخازن کد.
همیشه قبل از نصب هر بسته جدید، لیست مخازن و بسته های نصب شده را به روز کنید تا از تداخل نسخه ها جلوگیری شود:
sudo apt update && sudo apt upgrade -y
روش اول: نصب دستی با Node.js و PM2
این روش برای کسانی مناسب است که ترجیح می دهند نرم افزار را مستقیماً روی سیستم عامل میزبان اجرا کنند و کنترل کاملی بر محیط اجرایی Node.js داشته باشند.
گام 1: نصب Node.js و NPM
Uptime Kuma بر پایه جاوا اسکریپت و محیط اجرایی Node.js توسعه یافته است. برای دریافت آخرین نسخه پایدار، استفاده از مخزن رسمی NodeSource توصیه می شود. در این مثال از نسخه 18 که پشتیبانی بلندمدت (LTS) دارد استفاده می کنیم:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs
پس از اتمام نصب، صحت نصب را با بررسی نسخه های نصب شده تایید کنید:
node -v npm -v
گام 2: نصب Git و دریافت کد منبع
برای دریافت آخرین نسخه کد Uptime Kuma از گیت هاب، به ابزار Git نیاز دارید. ابتدا آن را نصب کرده و سپس یک پوشه اختصاصی برای نصب ایجاد کنید:
sudo apt install git -y sudo mkdir -p /opt/uptime-kuma sudo chown $USER:$USER /opt/uptime-kuma cd /opt/uptime-kuma git clone https://github.com/louislam/uptime-kuma.git .
وجود نقطه در انتهای دستور git clone بسیار مهم است. این علامت به گیت دستور می دهد که محتویات مخزن را مستقیماً در پوشه فعلی استخراج کند، نه در یک زیرپوشه جدید.
گام 3: نصب وابستگی ها و اجرای اولیه
پروژه های Node.js برای اجرا به کتابخانه های جانبی نیاز دارند که در فایل package.json تعریف شده اند. دستور زیر فقط وابستگی های ضروری برای محیط تولید را نصب می کند تا فضای دیسک بهینه بماند:
npm install --production
برای تست اولیه و اطمینان از عملکرد صحیح، می توانید برنامه را به صورت موقت اجرا کنید:
npm run start
گام 4: مدیریت سرویس با PM2
اجرای دستی برنامه با بستن ترمینال متوقف می شود. برای اجرای دائمی در پس زمینه و راه اندازی خودکار پس از ریستارت سرور، از مدیر فرآیند PM2 استفاده می کنیم:
sudo npm install -g pm2 pm2 start server/server.js --name uptime-kuma pm2 startup pm2 save
دستور pm2 startup یک اسکریپت سیستمی تولید می کند. ممکن است لازم باشد دستور خروجی داده شده توسط این فرمان را با پیشوند sudo کپی و اجرا کنید تا سرویس در سطح سیستم ثبت شود.
روش دوم: نصب با Docker و Docker Compose (توصیه شده)
نکته تخصصی: استفاده از داکر برای استقرار Uptime Kuma در محیط های تولیدی به شدت توصیه می شود. این روش وابستگی های سیستم را ایزوله کرده، فرآیند بروزرسانی را به یک دستور ساده تبدیل می کند و از تداخل نسخه های Node.js با سایر نرم افزارهای سرور جلوگیری می نماید.
گام 1: نصب Docker و Docker Compose
ابتدا بسته های پیش نیاز برای استفاده از مخازن امن داکر را نصب کنید:
sudo apt install ca-certificates curl gnupg -y sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg
سپس مخزن داکر را به لیست منابع سیستم اضافه کرده و بسته های اصلی را نصب کنید:
echo deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
گام 2: ایجاد فایل پیکربندی و اجرای سرویس
یک پوشه اختصاصی برای نگهداری داده های Uptime Kuma ایجاد کنید تا در صورت حذف کانتینر، اطلاعات شما از بین نرود:
mkdir -p ~/uptime-kuma-data cd ~/uptime-kuma-data
فایلی با نام docker-compose.yml ایجاد کرده و محتوای زیر را در آن قرار دهید:
version: '3.8' 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
پیکربندی فایروال UFW برای دسترسی امن
اگر از فایروال پیش فرض اوبونتو (UFW) استفاده می کنید، باید ترافیک ورودی به پورت 3001 را مجاز کنید. در غیر این صورت، درخواست های مرورگر شما توسط سیستم عامل مسدود خواهند شد.
sudo ufw allow 3001/tcp sudo ufw status
هشدار امنیتی: هرگز پورت پیش فرض 3001 را بدون تنظیم پروکسی معکوس و احراز هویت قوی در معرض اینترنت عمومی قرار ندهید. این کار می تواند سرور شما را در برابر حملات براوت فورس و دسترسی غیرمجاز آسیب پذیر کند.
تنظیم پروکسی معکوس Nginx و فعال سازی SSL
برای محیط های تولیدی، دسترسی مستقیم از طریق آدرس IP و پورت عددی حرفه ای و امن نیست. استفاده از Nginx به عنوان پروکسی معکوس امکان استفاده از نام دامنه، فشرده سازی ترافیک و مهم تر از همه، فعال سازی گواهینامه SSL رایگان را فراهم می کند.
ابتدا Nginx را نصب کنید:
sudo apt install nginx -y
سپس یک فایل پیکربندی جدید در مسیر /etc/nginx/sites-available/uptime-kuma ایجاد کنید و پیکربندی زیر را در آن قرار دهید (به جای kuma.yourdomain.com دامنه واقعی خود را وارد کنید):
server {
listen 80;
server_name kuma.yourdomain.com;
location / {
proxy_pass http://127.0.0.1:3001;
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;
}
}
فایل را ذخیره کرده و با ایجاد یک لینک نمادین، آن را فعال کنید:
sudo ln -s /etc/nginx/sites-available/uptime-kuma /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl restart nginx
برای فعال سازی SSL، از ابزار Certbot استفاده کنید که به صورت خودکار گواهینامه را دریافت و پیکربندی Nginx را به روز می کند:
sudo apt install certbot python3-certbot-nginx -y sudo certbot --nginx -d kuma.yourdomain.com
دسترسی به رابط کاربری و پیکربندی اولیه
پس از اتمام مراحل نصب، مرورگر وب خود را باز کرده و به آدرس http://IP_Server:3001 یا https://kuma.yourdomain.com (در صورت تنظیم Nginx) مراجعه کنید. در اولین ورود، سیستم از شما می خواهد یک حساب کاربری مدیر ایجاد کنید. این حساب دارای بالاترین سطح دسترسی است، بنابراین از یک رمز عبور قوی و منحصر به فرد استفاده کنید.
پس از ورود به داشبورد، می توانید با کلیک روی دکمه Add New Monitor اولین سرویس خود را برای پایش اضافه کنید. در بخش Settings، گزینه های مربوط به ارسال اعلان ها را پیکربندی کنید تا در صورت قطعی، بلافاصله از طریق تلگرام یا ایمیل مطلع شوید.
بروزرسانی و نگهداری Uptime Kuma
نگهداری منظم و به روز رسانی نرم افزار برای دریافت قابلیت های جدید و بسته های امنیتی ضروری است. روش بروزرسانی بسته به روش نصب اولیه شما متفاوت است.
بروزرسانی در روش دستی (Node.js)
cd /opt/uptime-kuma git pull origin master npm install --production pm2 restart uptime-kuma
بروزرسانی در روش داکر (Docker)
بروزرسانی در داکر بسیار ساده تر و کم ریسک تر است. کافیست به پوشه ای که فایل docker-compose.yml در آن قرار دارد بروید و دستورات زیر را اجرا کنید:
docker compose pull docker compose up -d docker image prune -f
دستور آخر، ایمیج های قدیمی و بدون استفاده را حذف می کند تا فضای دیسک سرور آزاد شود.
عیب یابی مشکلات رایج
در صورت مواجهه با مشکلات در حین نصب یا بهره برداری، مراحل زیر می تواند به شناسایی ریشه مشکل کمک کند:
- عدم دسترسی به رابط کاربری: ابتدا وضعیت فایروال را با دستور sudo ufw status بررسی کنید. اطمینان حاصل کنید که پورت 3001 در لیست مجازها قرار دارد.
- توقف ناگهانی سرویس: در روش دستی، وضعیت فرآیند را با دستور pm2 status بررسی کنید. اگر وضعیت errored است، با دستور pm2 logs uptime-kuma لاگ های خطا را مطالعه کنید تا علت توقف مشخص شود.
- مشکل در روش داکر: برای مشاهده لاگ های کانتینر در حال اجرا، از دستور docker logs uptime-kuma استفاده کنید. این لاگ ها معمولاً دلیل دقیق عدم شروع سرویس را نشان می دهند.
- تداخل پورت: اگر پورت 3001 توسط نرم افزار دیگری اشغال شده باشد، Uptime Kuma شروع نمی شود. می توانید پورت را در فایل پیکربندی تغییر دهید یا نرم افزار مزاحم را متوقف کنید.
سوالات متداول
آیا استفاده از Uptime Kuma کاملا رایگان است؟
بله، این نرم افزار تحت مجوز متن باز منتشر شده است و تمام قابلیت های آن بدون هیچ محدودیت یا هزینه اشتراکی در دسترس کاربران قرار دارد.
آیا می توان سرورهای ویندوزی را با Uptime Kuma نصب شده روی اوبونتو مانیتور کرد؟
بله، Uptime Kuma مستقل از سیستم عامل هدف عمل می کند. تا زمانی که سرویس مورد نظر (مانند وب سرور یا پورت خاص) روی سرور ویندوزی در دسترس شبکه باشد، Uptime Kuma می تواند آن را پایش کند.
اطلاعات و تنظیمات Uptime Kuma در کجا ذخیره می شوند؟
به صورت پیش فرض، تمام داده ها در یک پایگاه داده SQLite در پوشه data داخل مسیر نصب ذخیره می شوند. این موضوع فرآیند پشتیبان گیری را بسیار ساده می کند، زیرا کافی است از این پوشه کپی تهیه کنید.
چگونه می توانم امنیت پنل مدیریت را افزایش دهم؟
علاوه بر استفاده از پروکسی معکوس Nginx و SSL، توصیه می شود دسترسی به پنل را از طریق فایروال به آدرس های IP مشخص محدود کنید و از احراز هویت دو مرحله ای در صورت پشتیبانی نسخه های جدید استفاده نمایید.
جمع بندی
نصب و راه اندازی Uptime Kuma در اوبونتو فرآیندی مستقیم و قابل مدیریت است که با انتخاب روش مناسب (داکر برای محیط های تولیدی و Node.js برای محیط های توسعه) به راحتی انجام می شود. این ابزار با ترکیب سادگی رابط کاربری و قدرت مانیتورینگ، نیازهای اکثر کسب و کارها و مدیران سرور را برطرف می کند. رعایت نکات امنیتی مانند پیکربندی صحیح فایروال و استفاده از پروکسی معکوس همراه با SSL، تضمین می کند که سرویس مانیتورینگ شما نه تنها کارآمد، بلکه در برابر تهدیدات خارجی نیز مقاوم باشد. با پیروی از این راهنمای گام به گام، می توانید زیرساخت نظارتی پایداری را برای سرویس های حیاتی خود ایجاد کنید.