در دنیای امروز که وابستگی به سرویس‌های آنلاین و وب‌سایت‌ها روزبه‌روز بیشتر می‌شود، اطمینان از پایداری و در دسترس بودن آن‌ها امری حیاتی است. اختلال در عملکرد یک سرویس می‌تواند منجر به از دست رفتن کاربران، کاهش درآمد و آسیب به اعتبار کسب‌وکار شود. ابزارهای مانیتورینگ نقش کلیدی در شناسایی به‌موقع این مشکلات و اطلاع‌رسانی فوری دارند. تصور کنید بدون یک سیستم نظارتی قوی، چقدر طول می‌کشد تا متوجه شوید وب‌سایت شما از دسترس خارج شده یا API حیاتی شما پاسخگو نیست؟ در این شرایط، Uptime Kuma به عنوان یک راه‌حل متن‌باز و قدرتمند ظاهر می‌شود. این ابزار به شما امکان می‌دهد وضعیت سرویس‌های مختلف خود را به صورت لحظه‌ای رصد کرده و در صورت بروز هرگونه مشکل، از طریق کانال‌های ارتباطی متنوعی مانند تلگرام، ایمیل یا دیسکورد هشدار دریافت کنید. نصب و پیکربندی Uptime Kuma روی سیستم‌عامل‌های مختلف از جمله اوبونتو (Ubuntu)، به خصوص نسخه ۲۴٫۰۴ که یکی از پایدارترین و پرکاربردترین توزیع‌های لینوکس است، یک فرآیند نسبتاً ساده است که به شما کنترل کاملی بر وضعیت زیرساخت‌های آنلاینتان می‌دهد.
Uptime Kuma چیست؟
Uptime Kuma یک ابزار مانیتورینگ متن‌باز و خودمیزبانی (self-hosted) است که به شما کمک می‌کند تا وضعیت سرویس‌های آنلاین خود را پیگیری کنید. این ابزار با رابط کاربری وب‌محور و کاربرپسند خود، نظارت بر وب‌سایت‌ها، سرورها، APIها و سایر سرویس‌های مبتنی بر شبکه را آسان می‌سازد. Uptime Kuma اطلاعات دقیقی در مورد زمان در دسترس بودن (uptime) و زمان عدم در دسترس بودن (downtime) سرویس‌های مانیتور شده ارائه می‌دهد و تاریخچه عملکرد آن‌ها را نیز ثبت می‌کند. برخلاف بسیاری از ابزارهای مانیتورینگ تجاری، Uptime Kuma کاملاً رایگان است و تحت لایسنس MIT منتشر شده، که آن را به گزینه‌ای جذاب برای افراد و کسب‌وکارها در هر اندازه‌ای تبدیل می‌کند. معماری مدرن و انعطاف‌پذیر آن، امکان نصب و اجرای سریع را فراهم می‌کند و از روش‌های مختلفی برای مانیتورینگ و ارسال هشدار پشتیبانی می‌نماید.
ویژگی‌های کلیدی Uptime Kuma
Uptime Kuma مجموعه‌ای از ویژگی‌ها را ارائه می‌دهد که آن را به یک ابزار مانیتورینگ جامع تبدیل کرده است. یکی از مهم‌ترین این ویژگی‌ها، پشتیبانی گسترده از انواع پروتکل‌های مانیتورینگ شامل HTTP/HTTPS، Ping، TCP، DNS، Push و حتی مانیتورینگ گواهینامه‌های SSL است. این تنوع به شما اجازه می‌دهد تا طیف وسیعی از سرویس‌ها را تحت نظر داشته باشید. قابلیت ارسال نوتیفیکیشن به کانال‌های متعدد ارتباطی مانند تلگرام، ایمیل، دیسکورد، اسلک، وب‌هوک و بسیاری دیگر، تضمین می‌کند که در صورت بروز مشکل، فوراً مطلع شوید. رابط کاربری داشبورد Uptime Kuma بسیار بصری و قابل تنظیم است و وضعیت سرویس‌ها را با نمودارها و گزارش‌های گرافیکی نمایش می‌دهد. همچنین، قابلیت ایجاد صفحات وضعیت عمومی (Status Pages) به شما این امکان را می‌دهد تا وضعیت سرویس‌های خود را با کاربران یا تیمتان به اشتراک بگذارید. سادگی در نصب، مدیریت آسان و مصرف منابع پایین، از دیگر مزایای این ابزار مانیتورینگ محبوب است.
پیش‌نیازها
قبل از اقدام به نصب Uptime Kuma بر روی سرور Ubuntu 24.04، لازم است که برخی پیش‌نیازها را فراهم کنید. ابتدا، شما به یک سرور یا ماشین مجازی (VPS) با سیستم‌عامل اوبونتو ۲۴٫۰۴ نیاز دارید. اطمینان حاصل کنید که دسترسی SSH به سرور دارید تا بتوانید دستورات لازم را اجرا کنید. برای روش نصب با استفاده از Node.js، باید Node.js و NPM (Node Package Manager) بر روی سیستم شما نصب شده باشند. اگر قصد دارید Uptime Kuma را با Docker نصب کنید، نیاز به نصب و راه‌اندازی Docker Engine بر روی سرور خود دارید. توصیه می‌شود که قبل از شروع، سیستم‌عامل سرور خود را با اجرای دستورات sudo apt update و sudo apt upgrade -y به‌روزرسانی کنید تا از آخرین بسته‌های نرم‌افزاری و به‌روزرسانی‌های امنیتی بهره‌مند شوید. همچنین، اطمینان حاصل کنید که کاربر SSH شما دارای مجوزهای لازم برای اجرای دستورات با sudo است.
نصب Node.js و NPM
برای نصب Uptime Kuma بدون استفاده از Docker، به Node.js و NPM نیاز دارید. بهترین روش برای نصب آخرین نسخه‌های پایدار Node.js بر روی اوبونتو، استفاده از مخازن NodeSource است. ابتدا، کلید GPG مخزن NodeSource را دانلود کرده و به سیستم اضافه کنید:
mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpgسپس، مخزن NodeSource را به لیست منابع APT اضافه کنید. این دستور مخزن نسخه ۲۲٫x (یا آخرین نسخه پایدار در زمان نصب) را اضافه می‌کند:
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.listاکنون، لیست بسته‌های موجود را به‌روزرسانی کنید:
sudo apt updateدر نهایت، Node.js و NPM را نصب کنید:
sudo apt install -y nodejsپس از اتمام نصب، می‌توانید نسخه Node.js و NPM را برای تأیید بررسی کنید:
node --version
npm --versionاین دستورات نسخه‌های نصب شده را نمایش می‌دهند و نشان می‌دهند که Node.js و NPM با موفقیت بر روی سیستم شما نصب شده‌اند.
کلون کردن مخزن Uptime Kuma
بعد از اینکه Node.js و NPM را نصب کردید، مرحله بعدی دریافت کدهای منبع Uptime Kuma از مخزن رسمی آن در گیت‌هاب است. برای این کار، از دستور git clone استفاده می‌کنیم. اگر Git بر روی سرور شما نصب نیست، می‌توانید آن را با دستور sudo apt install git -y نصب کنید. سپس، برای دانلود مخزن Uptime Kuma، دستور زیر را در ترمینال اجرا کنید:
git clone https://github.com/louislam/uptime-kuma.gitاین دستور یک دایرکتوری جدید به نام uptime-kuma در مسیر فعلی شما ایجاد می‌کند و تمامی فایل‌های پروژه را در آن کپی می‌نماید. پس از اتمام فرآیند کلون، وارد دایرکتوری تازه ایجاد شده شوید:
cd uptime-kumaاکنون شما در دایرکتوری اصلی پروژه Uptime Kuma قرار دارید و آماده اجرای مراحل بعدی نصب و راه‌اندازی هستید. این دایرکتوری شامل تمامی فایل‌های مورد نیاز برای اجرای برنامه Uptime Kuma است.
راه‌اندازی Uptime Kuma
پس از کلون کردن مخزن و ورود به دایرکتوری پروژه، باید وابستگی‌های پروژه را نصب کرده و فرآیند راه‌اندازی اولیه را انجام دهید. Uptime Kuma از NPM برای مدیریت وابستگی‌ها استفاده می‌کند. در داخل دایرکتوری uptime-kuma، دستور زیر را اجرا کنید:
npm run setupاین دستور اسکریپت راه‌اندازی Uptime Kuma را اجرا می‌کند. این اسکریپت به صورت خودکار تمامی پکیج‌های مورد نیاز پروژه را که در فایل package.json مشخص شده‌اند، با استفاده از NPM دانلود و نصب می‌کند. همچنین، این دستور ممکن است شامل فرآیندهای ساخت (build) رابط کاربری و سایر تنظیمات اولیه باشد. مدت زمان اجرای این دستور بسته به سرعت اینترنت و منابع سرور شما متفاوت خواهد بود. پس از اتمام موفقیت‌آمیز اجرای این دستور، تمامی وابستگی‌ها نصب شده‌اند و Uptime Kuma آماده اجرا است. با این حال، اجرای مستقیم برنامه در این مرحله ممکن است باعث توقف آن در صورت بسته شدن ترمینال شود. برای مدیریت پایدار فرآیند، استفاده از یک مدیر فرآیند مانند PM2 توصیه می‌شود.
نصب PM2 برای مدیریت فرآیند
اجرای مستقیم Uptime Kuma با دستور node server/server.js باعث می‌شود که برنامه تنها تا زمانی که نشست ترمینال شما فعال است، اجرا شود. برای اطمینان از اینکه Uptime Kuma به صورت پایدار در پس‌زمینه اجرا شده و در صورت بروز خطا یا راه‌اندازی مجدد سرور، به صورت خودکار راه‌اندازی شود، از یک مدیر فرآیند مانند PM2 استفاده می‌کنیم. PM2 یک مدیر فرآیند محبوب برای برنامه‌های Node.js است که قابلیت‌های قدرتمندی مانند مانیتورینگ، مدیریت لاگ‌ها و راه‌اندازی خودکار را ارائه می‌دهد. برای نصب PM2 به صورت سراسری (globally) بر روی سیستم خود، دستور زیر را با NPM اجرا کنید:
sudo npm install pm2 -gاستفاده از -g باعث می‌شود که PM2 در مسیرهای سیستم نصب شود و از هر جایی قابل دسترسی باشد. پس از نصب PM2، می‌توانید فرآیندهای Node.js خود را با استفاده از دستورات آن مدیریت کنید. اکنون که PM2 نصب شده است، می‌توانیم Uptime Kuma را با استفاده از آن اجرا کنیم تا از اجرای پایدار و مدیریت‌پذیر آن اطمینان حاصل کنیم.
شروع Uptime Kuma با PM2
پس از نصب PM2، آماده‌اید تا Uptime Kuma را به عنوان یک فرآیند مدیریت شده توسط PM2 اجرا کنید. در داخل دایرکتوری uptime-kuma، دستور زیر را اجرا کنید تا سرور Uptime Kuma با استفاده از PM2 شروع شود:
pm2 start server/server.js --name uptime-kumaاین دستور به PM2 می‌گوید که فایل server/server.js را که نقطه ورود برنامه Uptime Kuma است، اجرا کند و نام مستعار uptime-kuma را به این فرآیند اختصاص دهد. PM2 برنامه را در پس‌زمینه اجرا می‌کند و اطلاعاتی در مورد وضعیت آن نمایش می‌دهد. برای مشاهده لیست فرآیندهای مدیریت شده توسط PM2 و اطمینان از اینکه Uptime Kuma در حال اجرا است، می‌توانید از دستور pm2 status استفاده کنید. برای اطمینان از اینکه Uptime Kuma پس از هر بار راه‌اندازی مجدد سیستم به صورت خودکار شروع می‌شود، باید PM2 را پیکربندی کنید. دستور pm2 startup دستوری را تولید می‌کند که باید آن را اجرا کنید تا PM2 به سرویس‌های سیستمی (مانند systemd) اضافه شود و در زمان بوت سیستم اجرا گردد. دستور تولید شده را کپی کرده و اجرا کنید تا تنظیمات راه‌اندازی خودکار اعمال شود.
نصب و پیکربندی Nginx
به صورت پیش‌فرض، Uptime Kuma بر روی پورت ۳۰۰۱ اجرا می‌شود. برای دسترسی به آن از طریق یک نام دامنه استاندارد و پورت‌های پیش‌فرض وب (۸۰ برای HTTP و ۴۴۳ برای HTTPS) و همچنین بهره‌مندی از قابلیت‌هایی مانند SSL/TLS Termination، کشینگ و فشرده‌سازی، می‌توان از یک وب سرور مانند Nginx به عنوان Reverse Proxy استفاده کرد. ابتدا، Nginx را نصب کنید:
sudo apt install -y nginxسپس، یک فایل پیکربندی جدید برای Uptime Kuma در دایرکتوری /etc/nginx/conf.d/ ایجاد کنید. می‌توانید از ویرایشگری مانند Nano استفاده کنید:
sudo nano /etc/nginx/conf.d/kuma.confمحتوای زیر را در این فایل وارد کنید. حتماً your_domain.com را با نام دامنه واقعی خود جایگزین کنید:
server {
listen 80;
server_name your_domain.com;
location / {
proxy_pass http://localhost:3001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}این پیکربندی ترافیک ورودی به پورت ۸۰ را برای دامنه مشخص شده به پورت ۳۰۰۱ که Uptime Kuma روی آن اجرا می‌شود، هدایت می‌کند. برای استفاده از HTTPS، نیاز به دریافت گواهینامه SSL (مثلاً با Certbot) و افزودن تنظیمات مربوطه به همین فایل یا فایل جداگانه دارید. پس از ذخیره فایل، پیکربندی Nginx را برای بررسی خطا تست کنید:
sudo nginx -tاگر تست موفقیت‌آمیز بود، Nginx را مجدداً بارگذاری یا راه‌اندازی کنید تا تغییرات اعمال شوند:
sudo systemctl reload nginxاکنون می‌توانید از طریق نام دامنه خود به Uptime Kuma دسترسی پیدا کنید.
نصب Uptime Kuma با Docker
نصب Uptime Kuma با استفاده از Docker یکی از ساده‌ترین و توصیه‌شده‌ترین روش‌ها است، زیرا وابستگی‌ها را در یک کانتینر ایزوله مدیریت می‌کند و فرآیند نصب را بسیار سریع و قابل تکرار می‌سازد. این روش به شما امکان می‌دهد بدون نگرانی در مورد تداخل با سایر برنامه‌های نصب شده روی سرور، Uptime Kuma را اجرا کنید. Docker همچنین مدیریت بروزرسانی و پشتیبان‌گیری را ساده‌تر می‌کند. برای نصب Uptime Kuma با Docker، ابتدا باید Docker Engine را بر روی سیستم خود نصب کنید. مراحل نصب Docker بر روی Ubuntu 24.04 در بخش بعدی توضیح داده شده است. پس از نصب Docker، تنها با اجرای یک دستور می‌توانید کانتینر Uptime Kuma را دانلود، ایجاد و اجرا کنید. این دستور شامل تنظیماتی برای اجرای کانتینر در پس‌زمینه، راه‌اندازی خودکار آن پس از بوت سیستم و نگاشت پورت‌های کانتینر به پورت‌های سرور میزبان است.
نصب Docker بر روی Ubuntu یا Debian
برای نصب Docker بر روی سیستم‌عامل‌های مبتنی بر دبیان مانند اوبونتو ۲۴٫۰۴، می‌توانید از مخزن رسمی Docker استفاده کنید که آخرین نسخه پایدار را ارائه می‌دهد. ابتدا، پکیج‌های لازم را برای استفاده از مخزن HTTPS نصب کنید:
sudo apt update
sudo apt install -y ca-certificates curl gnupgسپس، کلید GPG رسمی Docker را اضافه کنید:
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اکنون، مخزن Docker را به منابع APT اضافه کنید:
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در نهایت، Docker Engine، containerd و Docker Compose را نصب کنید:
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginبرای بررسی نصب، می‌توانید دستور sudo docker run hello-world را اجرا کنید. همچنین، برای اجرای دستورات docker بدون نیاز به sudo، می‌توانید کاربر خود را به گروه docker اضافه کنید (نیاز به خروج و ورود مجدد به SSH یا راه‌اندازی مجدد سیستم دارد):
sudo usermod -aG docker $USERایجاد کانتینر Uptime Kuma
پس از نصب موفقیت‌آمیز Docker، می‌توانید کانتینر Uptime Kuma را اجرا کنید. برای این کار، از دستور docker run استفاده می‌کنیم. این دستور ایمیج Uptime Kuma را از Docker Hub دانلود کرده و یک کانتینر جدید با تنظیمات مشخص شده ایجاد و اجرا می‌کند. دستور زیر کانتینر را در حالت دیتچ‌شده (detached mode) در پس‌زمینه اجرا می‌کند، آن را طوری تنظیم می‌کند که همیشه پس از توقف یا راه‌اندازی مجدد سرور، دوباره شروع شود، پورت ۳۰۰۱ سرور میزبان را به پورت ۳۰۰۱ داخل کانتینر نگاشت می‌کند و یک نام مشخص (uptime-kuma) به کانتینر اختصاص می‌دهد:
docker run -d --restart=always -p 3001:3001 --name uptime-kuma louislam/uptime-kumaاگر می‌خواهید داده‌های Uptime Kuma (مانند پایگاه داده، تنظیمات و لاگ‌ها) پایدار بمانند و با حذف کانتینر از بین نروند، توصیه می‌شود از Docker Volume استفاده کنید. دستور زیر یک Volume به نام uptime-kuma-data ایجاد کرده و آن را به مسیر /app/data داخل کانتینر متصل می‌کند:
docker run -d --restart=always -p 3001:3001 --name uptime-kuma -v uptime-kuma-data:/app/data louislam/uptime-kumaبا استفاده از Volume، می‌توانید کانتینر را بدون از دست دادن داده‌ها حذف و دوباره ایجاد کنید (مثلاً هنگام بروزرسانی).
دسترسی به Uptime Kuma
پس از اتمام فرآیند نصب (چه با Node.js/PM2 و چه با Docker)، Uptime Kuma بر روی سرور شما اجرا می‌شود و آماده استفاده است. به صورت پیش‌فرض، Uptime Kuma بر روی پورت ۳۰۰۱ در دسترس است. برای دسترسی به رابط کاربری وب آن، مرورگر خود را باز کرده و آدرس IP سرور یا نام دامنه (اگر Nginx را پیکربندی کرده‌اید) را به همراه پورت ۳۰۰۱ در نوار آدرس وارد کنید. فرمت آدرس به این صورت خواهد بود:
http://your_server_ip:3001یا اگر از Nginx استفاده می‌کنید:
http://your_domain.com(یا https://your_domain.com اگر SSL/TLS را تنظیم کرده‌اید). در اولین دسترسی، به صفحه خوش‌آمدگویی Uptime Kuma هدایت می‌شوید که از شما می‌خواهد یک حساب کاربری مدیر ایجاد کنید. یک نام کاربری و رمز عبور قوی برای حساب مدیر خود وارد کرده و بر روی دکمه ایجاد حساب کلیک کنید. پس از ایجاد حساب، به داشبورد اصلی Uptime Kuma وارد خواهید شد که مرکز کنترل مانیتورینگ شماست.
راه‌اندازی اولیه و تنظیمات Uptime Kuma
بعد از ورود به داشبورد Uptime Kuma برای اولین بار، ممکن است بخواهید برخی تنظیمات اولیه را انجام دهید تا ابزار مطابق با نیازهای شما عمل کند. در داشبورد، می‌توانید زبان رابط کاربری، منطقه زمانی و سایر تنظیمات عمومی را پیکربندی کنید. تنظیم صحیح منطقه زمانی بسیار مهم است تا گزارش‌ها، نمودارها و زمان‌بندی بررسی‌ها با زمان محلی شما مطابقت داشته باشند. داشبورد نمای کلی از وضعیت تمامی مانیتورهای شما را نشان می‌دهد و از طریق منوی کناری می‌توانید به بخش‌های مختلف مانند مانیتورها، صفحات وضعیت، نوتیفیکیشن‌ها و تنظیمات دسترسی پیدا کنید. اولین قدم کاربردی پس از ورود به داشبورد، اضافه کردن سرویس‌هایی است که قصد مانیتورینگ آن‌ها را دارید.
افزودن مانیتور جدید
برای شروع مانیتورینگ سرویس‌های خود، باید یک مانیتور جدید در Uptime Kuma اضافه کنید. این فرآیند بسیار ساده است. در داشبورد، بر روی دکمه «Add New Monitor» کلیک کنید. یک پنجره باز می‌شود که از شما می‌خواهد جزئیات مانیتور جدید را وارد کنید. ابتدا، نوع مانیتور را انتخاب کنید. Uptime Kuma از انواع مختلفی پشتیبانی می‌کند، از جمله HTTP(s) برای وب‌سایت‌ها و APIها، Ping برای بررسی پاسخگویی سرورها، TCP برای پورت‌های خاص، DNS برای سرورهای نام دامنه و Push برای سناریوهای مانیتورینگ سفارشی. بر اساس نوع انتخابی، فیلدهای مربوطه نمایش داده می‌شوند. برای مانیتورینگ یک وب‌سایت، نوع HTTP(s) را انتخاب کرده و URL وب‌سایت را وارد کنید. می‌توانید نامی برای این مانیتور انتخاب کنید. تنظیمات دیگری مانند فاصله زمانی بررسی (Interval)، تعداد تلاش مجدد در صورت خطا (Retries) و زمان‌بندی خاص برای بررسی (مثلاً فقط در ساعات کاری) نیز قابل تنظیم هستند. پس از پیکربندی تمامی جزئیات، بر روی دکمه «Save» کلیک کنید. Uptime Kuma بلافاصله شروع به مانیتورینگ سرویس شما بر اساس تنظیمات انجام شده خواهد کرد و وضعیت آن در داشبورد نمایش داده می‌شود.
پیکربندی نوتیفیکیشن‌ها
یکی از مهم‌ترین قابلیت‌های Uptime Kuma، امکان دریافت هشدار در صورت بروز مشکل در سرویس‌های مانیتور شده است. برای این کار، باید کانال‌های نوتیفیکیشن خود را پیکربندی کنید. Uptime Kuma از طیف وسیعی از سرویس‌های نوتیفیکیشن پشتیبانی می‌کند. برای افزودن یک کانال نوتیفیکیشن جدید، از منوی کناری به بخش «Notification» بروید و بر روی «Add New Notification» کلیک کنید. لیستی از انواع سرویس‌های پشتیبانی شده مانند Telegram، Email (SMTP)، Discord، Slack، Webhook و بسیاری دیگر نمایش داده می‌شود. سرویس مورد نظر خود را انتخاب کنید. برای هر سرویس، فیلدهای اطلاعاتی لازم (مانند توکن، Chat ID، آدرس سرور SMTP، نام کاربری و رمز عبور) نمایش داده می‌شوند که باید آن‌ها را با اطلاعات صحیح پر کنید. به عنوان مثال، برای تلگرام، نیاز به توکن ربات و Chat ID دارید که باید آن‌ها را از BotFather و API تلگرام دریافت کنید. پس از وارد کردن اطلاعات، می‌توانید با کلیک بر روی دکمه «Test» یک پیام تستی ارسال کنید تا از صحت پیکربندی مطمئن شوید. در نهایت، نامی برای این کانال نوتیفیکیشن انتخاب کرده و آن را ذخیره کنید. اکنون می‌توانید این کانال نوتیفیکیشن را به مانیتورهای خاصی که می‌خواهید هشدارهای آن‌ها را دریافت کنید، اختصاص دهید.
مدیریت Uptime Kuma و نکات پیشرفته
پس از نصب و راه‌اندازی اولیه، مدیریت روزمره Uptime Kuma شامل نظارت بر وضعیت مانیتورها، بررسی گزارش‌ها، بروزرسانی نرم‌افزار و پیکربندی‌های پیشرفته‌تر است. داشبورد اصلی به شما نمای کلی از وضعیت همه سرویس‌ها، زمان در دسترس بودن آن‌ها در دوره‌های زمانی مختلف و تاریخچه رویدادها را می‌دهد. می‌توانید بر روی هر مانیتور کلیک کنید تا جزئیات بیشتری مانند زمان پاسخگویی، کدهای وضعیت HTTP و نمودارهای عملکرد را مشاهده کنید. در بخش تنظیمات، گزینه‌های پیشرفته‌تری برای سفارشی‌سازی رفتار Uptime Kuma وجود دارد، از جمله تنظیمات پروکسی، مدیریت کاربران، و پیکربندی‌های مربوط به پایگاه داده. برای مانیتورهای خاص، می‌توانید تنظیمات پیشرفته‌ای مانند هدرهای سفارشی HTTP، بدنه درخواست، و معیارهای موفقیت/شکست را تعریف کنید. درک این تنظیمات پیشرفته به شما کمک می‌کند تا مانیتورینگ را با دقت بیشتری بر روی سرویس‌های پیچیده‌تر انجام دهید.
بروزرسانی و نگهداری Uptime-Kuma
تیم توسعه Uptime Kuma به صورت فعال در حال بهبود و افزودن ویژگی‌های جدید به این ابزار است، بنابراین بروزرسانی منظم آن برای بهره‌مندی از آخرین قابلیت‌ها، بهبودهای امنیتی و رفع اشکالات توصیه می‌شود. روش بروزرسانی Uptime Kuma بستگی به نحوه نصب آن دارد. اگر Uptime Kuma را با Node.js نصب کرده‌اید، باید ابتدا دایرکتوری پروژه را با Git pull به‌روز کنید و سپس وابستگی‌ها را مجدداً نصب و برنامه را با PM2 راه‌اندازی مجدد کنید. اگر از Docker استفاده می‌کنید، فرآیند بروزرسانی بسیار ساده‌تر است. کافی است آخرین ایمیج Uptime Kuma را دانلود کرده، کانتینر فعلی را متوقف و حذف کرده و سپس یک کانتینر جدید با استفاده از ایمیج به‌روز شده و با همان تنظیمات (به خصوص Docker Volume برای حفظ داده‌ها) اجرا کنید. دستورات معمول برای بروزرسانی Docker شامل docker pull louislam/uptime-kuma برای دانلود ایمیج جدید و سپس دستورات stop، rm و run برای جایگزینی کانتینر قدیمی با کانتینر جدید از روی ایمیج به‌روز شده است. اطمینان از استفاده از Volume در هنگام اجرای کانتینر جدید، اطلاعات شما را در طول فرآیند بروزرسانی حفظ می‌کند.
پشتیبان‌گیری از داده‌ها
داده‌های Uptime Kuma شامل لیست مانیتورها، تاریخچه وضعیت‌ها، تنظیمات نوتیفیکیشن‌ها و اطلاعات کاربران است. این داده‌ها برای عملکرد صحیح ابزار و داشتن تاریخچه مانیتورینگ شما حیاتی هستند. بنابراین، انجام پشتیبان‌گیری منظم از این داده‌ها بسیار مهم است تا در صورت بروز مشکل در سرور یا دیتابیس، بتوانید اطلاعات خود را بازیابی کنید. اگر Uptime Kuma را با Node.js نصب کرده‌اید، داده‌ها معمولاً در یک فایل دیتابیس (مانند SQLite) در دایرکتوری پروژه ذخیره می‌شوند. باید از این فایل و همچنین فایل‌های پیکربندی مهم پشتیبان تهیه کنید. اگر از Docker با Volume استفاده کرده‌اید، داده‌ها در Docker Volume ذخیره می‌شوند. می‌توانید از دستورات Docker برای ایجاد پشتیبان از Volume استفاده کنید یا به صورت دستی محتویات Volume را کپی کنید. روش دیگر، استفاده از قابلیت پشتیبان‌گیری داخلی Uptime Kuma (اگر موجود باشد) یا ابزارهای پشتیبان‌گیری سیستم‌عامل برای گرفتن کپی از دایرکتوری داده‌های Uptime Kuma است. محل دقیق ذخیره داده‌ها بسته به نوع نصب و پیکربندی ممکن است متفاوت باشد، اما معمولاً در دایرکتوری data داخل مسیر نصب یا Volume قرار دارد.
عیب‌یابی و حل مشکلات رایج
در طول فرآیند نصب یا پس از آن، ممکن است با برخی مشکلات رایج مواجه شوید. اگر Uptime Kuma پس از نصب با Node.js اجرا نمی‌شود، ابتدا لاگ‌های PM2 را بررسی کنید تا ببینید آیا خطایی در فرآیند Node.js وجود دارد. دستور pm2 logs uptime-kuma می‌تواند اطلاعات مفیدی ارائه دهد. همچنین، مطمئن شوید که Node.js و NPM به درستی نصب شده‌اند و وابستگی‌های پروژه با npm run setup نصب شده‌اند. اگر از Docker استفاده می‌کنید و کانتینر اجرا نمی‌شود، از دستور docker logs uptime-kuma برای مشاهده لاگ‌های کانتینر استفاده کنید. بررسی وضعیت کانتینر با docker ps -a نیز می‌تواند نشان دهد که آیا کانتینر با خطا متوقف شده است. مشکلات دسترسی از طریق مرورگر ممکن است به دلیل فایروال سرور باشد که پورت ۳۰۰۱ (یا پورتی که در Nginx استفاده می‌کنید) را مسدود کرده است. مطمئن شوید که پورت‌های لازم در فایروال سرور شما (مانند UFW) باز هستند. اگر از Nginx استفاده می‌کنید، پیکربندی Nginx را با sudo nginx -t بررسی کرده و مطمئن شوید سرویس Nginx در حال اجرا است. مشکلات مربوط به نوتیفیکیشن‌ها معمولاً به دلیل اطلاعات نادرست (مانند توکن یا Chat ID اشتباه برای تلگرام، یا تنظیمات SMTP نادرست برای ایمیل) رخ می‌دهند. از قابلیت تست نوتیفیکیشن در داشبورد Uptime Kuma استفاده کنید تا مشکل را شناسایی کنید.
