آموزش جامع نصب Uptime Kuma در اوبونتو

برای نصب Uptime Kuma در اوبونتو، ابتدا پیش نیازهای سیستم شامل Node.js و Git یا Docker را نصب کنید. روش توصیه شده و مدرن، استفاده از Docker و Docker Compose است که با اجرای چند دستور ساده، محیطی ایزوله و پایدار فراهم می کند. پس از اجرای کانتینر، پورت 3001 را در فایروال باز کرده و از طریق مرورگر به…

به روزرسانی کارگروه تحریریه سایت
فهرست مطلب 25 بخش

برای نصب 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، تضمین می کند که سرویس مانیتورینگ شما نه تنها کارآمد، بلکه در برابر تهدیدات خارجی نیز مقاوم باشد. با پیروی از این راهنمای گام به گام، می توانید زیرساخت نظارتی پایداری را برای سرویس های حیاتی خود ایجاد کنید.

دسته های مرتبط: