
به اشتراک بگذارید

به اشتراک بگذارید
ساعت سه و ده دقیقه بامداد فروشگاه خطای 502 میدهد. هشدار داون شدن سایت، چون فقط به ایمیل رفته، تا نه صبح نخوانده میماند. ناظر خرابی را همان اول دیده بود. پیامک و ربات بله این فاصله را کوتاه میکنند. شرطش این است که چند شکست پیاپی پیش از هر پیام تأیید شود تا لرزشهای شبکه کسی را بیدار نکنند.
| دقیقه | اتفاق | چه کسی خبردار میشود | اگر این تنظیم نبود |
|---|---|---|---|
| یک ساعت قبل | لرزش دهثانیهای شبکه | هیچکس؛ مانیتور فقط Pending شد | با Retries صفر، دو پیام در هر کانال |
| دقیقه ۰ | سایت از دسترس میرود | هنوز هیچکس | با بازه پنجدقیقهای، کشف تا پنج دقیقه دیرتر |
| تا دقیقه ۲ | مانیتور بله پس از دو تلاش مجدد Down میشود | گروه بله تیم | فقط ایمیلی که صبح باز میشود |
| تا دقیقه ۶ | مانیتور پیامک پس از پنج تلاش Down میشود | نفر کشیک، با پیامک | پیامک حتی برای قطعی سهدقیقهای |
| دقیقه ۴۰ | سایت برمیگردد | هر دو کانال، با پیام Up | تنظیمی ندارد؛ بازگشت همیشه اعلام میشود |
| ساعت چهار | ریاستارت طولانی داخل بازه Maintenance | هیچکس | دو پیام برای کار خودتان |
💡 کانال هر نفر و زمان رسیدن پیام
هشدار شبانه پیامی است که چند دقیقه بعد از خرابی، یک آدم مشخص را بیدار کند.
✅ بله برای گروه تیم، پیامک برای نفر کشیک و چند دقیقه دیرتر.
✅ پیش از هر کانال تازه، Retries را از صفر بالاتر ببرید.
هر هشدار قولی است که اگر سایت افتاد، کسی بیدار شود. در آن شب، هر دقیقه به یک تنظیم بسته بود. سرور بدون Uptime Kuma هم با اسکریپتی چندخطی به همین قول میرسد.
📌 یک شب خرابی، دقیقه به دقیقه
◀️ ایمیل برای هشدار شبانه کافی نیست
◀️ اتصال وبهوک به پنل پیامک
◀️ پیام هشدار در بله با API ربات
◀️ چند شکست پشت سر هم یعنی خرابی واقعی؟

ساعت سه بامداد کسی صندوق ایمیل را باز نمیکند. ایمیل برای گزارش صبح خوب است. هشدار داون شدن سایت اما کانال دیگری لازم دارد، کانالی که صاحب گوشی برایش صدا گذاشته است. پیامک برای یک نفر، پیام بله برای گروه.
سروری که خودش افتاده، از خاموشی خودش پیامک نمیفرستد. پس پیش از هر کانال، جای ناظر را با جانمایی و نصب uptime kuma بیرون از سرور اصلی تعیین کنید.
پیامک روی شبکه تلفن همراه میآید و اینترنت گوشی نمیخواهد، ولی از اعتبار پنل کم میکند. پیامرسان بله اینترنت میخواهد و در عوض چند نفر پیام را میبینند. ایمیل برای سابقه بماند.
⚠️ هر کانال تازه، یک رمز تازه در ناظر
فرم Uptime Kuma توکن بله را پنهان نشان میدهد، اما کلید پنل پیامک در «Additional Headers» کانال Webhook آشکار است. هر دو بهصورت JSON در دیتابیس ناظر میمانند. رمز ورود Uptime Kuma را محکم نگه دارید و نسخه پشتیبان دیتابیس را مثل فایل رمز نگهداری کنید.
💡 پیامک دیرتر از بله، با مانیتور دوم
هر مانیتور در Uptime Kuma همه کانالهایش را همزمان خبر میکند و پلهبندی داخلی ندارد. راهش دو مانیتور روی یک نشانی است. مانیتور بله: بازه و فاصله تلاش مجدد ۳۰ ثانیه و Retries برابر ۲. مانیتور پیامک: بازه و فاصله ۶۰ ثانیه و Retries برابر ۵. فقط قطعی طولانی نفر کشیک را بیدار میکند.
نسخه 2.5.9 برای دو درگاه ایرانی، SMS.IR و Amoot SMS، کانال آماده دارد. برای پنلهای دیگر، کانال Webhook درخواست POST مستندات پنل را لحظه خرابی میفرستد. پنل قالبی، مثل SMS.IR در این کانال، اول قالب تأییدشده میخواهد.
فیلدهای کانال Webhook، مطابق کد این کانال در مخزن Uptime Kuma:
Post URL: نشانی ارسال پیامک پنل.HTTP Method: روش GET فقط پارامترهای نامثابت مثل msg را در نشانی میگذارد؛ پس POST لازم است.Request Body: حالت آماده JSON کلیدهای ثابتی دارد؛ Custom Body بدنه را از قالب شما میسازد.Additional Headers: پس از روشن کردنش، هدرها را بهشکل JSON میگیرد.موتور قالب Liquid بدنه سفارشی را میسازد و کلیدهای هشدار داون شدن سایت را به نامهایی مینویسد که پنل انتظار دارد.
🔸 بدنه سفارشی برای یک پنل پیامک فرضی
قالب زیر در Custom Body و هدرها در Additional Headers مینشینند. نام کلیدها فرضی است و از مستندات پنل JSONپذیر شما میآید. هدر Content-Type اجباری است؛ بدون آن، متن بهصورت فرم urlencoded میرود. متغیر status ایموجی دارد که ممکن است پیامک را خراب یا رد کند؛ شرط Liquid وضعیت را متن ساده میکند. گیومه انگلیسی در نام مانیتور، JSON را میشکند.
Custom Body:
{"to": "PHONE_NUMBER", "text": "{{ name }} {% if heartbeatJSON['status'] == 0 %}DOWN{% else %}UP{% endif %} {{ heartbeatJSON['localDateTime'] }}"}
Additional Headers:
{"Content-Type": "application/json", "X-API-Key": "SMS_API_KEY"}
دکمه Test پیامی با مقدارهای ساختگی میفرستد. گاهی Test روی ناظر خطا میدهد و همان درخواست از لپتاپ جواب میگیرد. یک علت ممکن، IP ناظر است که هنوز در وایتلیست IP پنل پیامک ثبت نشده.

بله برای رباتها API دارد و هشدار داون شدن سایت با یک فراخوان متد sendMessage روی tapi.bale.ai به گروه میرسد. Uptime Kuma از نسخه 2.1.0 کانال آماده Bale دارد. برای هشدار ربات جدا بسازید؛ اگر برنامهای مدام getUpdates ربات را بخواند، Auto Get پیامی پیدا نمیکند.
ble.ir/BotFather را کنار Bot Token نشان میدهد.Auto Get که پس از وارد کردن توکن ظاهر میشود، شناسه چت را از getUpdates میخواند؛ شناسه گفتوگوی مستقیم، گروه یا کانال پذیرفته است.برای یک یا دو سایت، cron و curl کافیاند، روی سروری غیر از سرور سایت. توکن و شناسه چت در فایلی جدا با دسترسی 600 میمانند، نه در خود اسکریپت:
sudo install -m 600 -o root -g root /dev/null /etc/site-check.env
# BALE_TOKEN="..." و CHAT_ID="..." را با ویرایشگر در این فایل بنویسید
برای شناسه چت، به ربات پیام بدهید و این را اجرا کنید؛ عدد id داخل بخش chat همان CHAT_ID است:
sudo sh -c '. /etc/site-check.env; printf "url = \"https://tapi.bale.ai/bot%s/getUpdates\"\n" "$BALE_TOKEN" | curl -sS -K -'
#!/bin/sh
. /etc/site-check.env
URL="https://example.com/"
F=/var/tmp/site-check.fails
N=$(cat "$F" 2>/dev/null || echo 0)
send() {
printf 'url = "https://tapi.bale.ai/bot%s/sendMessage"\n' "$BALE_TOKEN" |
curl -fsS -m 10 -K - --data-urlencode "chat_id=$CHAT_ID" --data-urlencode "text=$1" |
grep -q '"ok": *true' || echo "$(date) send failed: $1" | tee -a /var/log/site-check.log >&2
}
[ "$1" = test ] && { send "پیام آزمایشی هشدار"; exit; }
if curl -fsL -o /dev/null -m 10 "$URL"; then
[ "$N" -ge 3 ] && send "سایت برگشت: $URL"
echo 0 > "$F"
else
N=$((N + 1))
echo "$N" > "$F"
[ "$N" -eq 3 ] && send "سایت پس از سه بررسی پیاپی پاسخ نمیدهد: $URL"
fi
اسکریپت را با مالک root و دسترسی 700 نصب کنید و یک بار پیام آزمایشی بفرستید. بعد با sudo crontab -e خط آخر را به crontab کاربر root بدهید:
sudo install -m 700 -o root -g root site-check.sh /usr/local/bin/site-check.sh
sudo /usr/local/bin/site-check.sh test
* * * * * /usr/local/bin/site-check.sh
فرمان test بیخروجی، با رسیدن پیام در بله، یعنی مسیر سالم است. توکن یا شناسه اشتباه، خطا را در /var/log/site-check.log مینویسد. طبق راهنمای curl، -K - تنظیمها را از ورودی استاندارد میخواند و توکن در فهرست پردازهها نمیآید. -f کد 400 به بالا را خطا میگیرد و -L تغییر مسیر 3xx را دنبال میکند. مستندات API بله نتیجه را در فیلد ok برمیگرداند. اجرا با گیرنده ساختگی، پیام شکست سوم و خطای توکن را درست نشان داد؛ سرور واقعی بله آزموده نشد.

در Uptime Kuma جواب را عدد Retries میدهد. با Retries برابر ۲، سومین بررسی ناموفق پیاپی خرابی را قطعی میکند و تازه آن وقت پیام میرود. شکستهای قبلی مانیتور را فقط به حالت Pending میبرند و Pending پیامی نمیفرستد.
بنابر فایل monitor.js مخزن Uptime Kuma، گذار Up به Pending و Pending به Up بیصداست. Pending یا Up به Down پیام خرابی میفرستد و Down به Up پیام بازگشت. لرزشی که پیش از پایان تلاشهای مجدد برطرف شود، ردی نمیگذارد. فاصله تلاش مجدد هم فقط در Pending به کار میرود.
پیشفرض Retries در فرم مانیتور تازه نسخه 2.5.9 صفر است. با پیشفرض صفر، لرزش دهثانیهای ساعت سه بامداد هم هشدار داون شدن سایت میسازد. چند شب بعد، پیامک سوم واقعی است. نفر کشیک آن را بیجواب میگذارد و قصه چوپان دروغگو با گرگ واقعی تمام میشود.
💡 بازه Maintenance برای ریاستارتهای برنامهریزیشده
با «Schedule Maintenance» برای بهروزرسانی شبانه بازه بسازید. داخل بازه پیامی نمیرود و گذار Maintenance به Up هم بیصداست؛ اما سایتی که بعد از بازه هنوز پایین است، پیام خرابی میدهد. یادآور تکرار خرابی را هم فقط روی مانیتور بله بگذارید.
«دیشب چهار پیامک برای دو لرزش دهثانیهای گرفتم. صبح دیدم سایت اصلاً نیفتاده بود.» کسی که این را میگوید، به پیامک پنجم اعتماد نمیکند. تنظیمهایش باید پیش از شب بعد عوض شود.
بله، از نسخه 2.1.0، با توکن ربات و شناسه چت. در نسخههای قدیمیتر، Webhook یا اسکریپت curl جایگزین است.
نه. SMS.IR و Amoot SMS کانال آماده دارند. پنل دیگر با Webhook کار میکند اگر پیامک را با یک درخواست POST بفرستد. پنلی که اول توکن جدا میگیرد یا GET با پارامترهای خودش میخواهد، جور نیست.
به ربات در گروه پیامی بدهید که صدایش بزند، بعد Auto Get فرم Uptime Kuma را بزنید یا خروجی getUpdates را بخوانید.
نه؛ گذار Down به Up همیشه اعلام میشود. برای کار برنامهریزیشده، بازه Maintenance پیامها را حذف میکند.
پنل قالبی فقط متن قالب تأییدشده را میفرستد. قالب را در پنل تأیید کنید و از Uptime Kuma فقط مقدار متغیرها را بفرستید.
بهصورت JSON در دیتابیس Uptime Kuma. هر کس وارد ناظر شود آن را میبیند و نسخه پشتیبان دیتابیس هم آن را دارد.
اسکریپت برای یک یا دو سایت کافی است ولی تاریخچه و صفحه وضعیت ندارد؛ برای چند سرویس، Uptime Kuma سادهتر است.
جمعبندی؛ هشدار داون شدن سایت و کسی که ساعت سه بیدار میشود شب خرابی با ناظری شروع میشود که با سرور اصلی خاموش نشود. بعد نوبت کانالهایی است که صدا دارند. بله با کانال آماده به گروه تیم خبر میدهد. پیامک، از کانال آماده یا Webhook و چند دقیقه دیرتر، فقط نفر کشیک را بیدار میکند. تأیید پیش از اعلان هم به همان اندازه مهم است: Retries بالاتر از صفر و بازه Maintenance برای ریاستارتهای خودتان. بدون این تأیید، کانالها بعد از چند شب بیاثر میشوند، چون کسی دیگر پیامشان را نمیخواند. مسیر را هم یک بار با پیام آزمایشی امتحان کنید. هشداری که هرگز آزموده نشده، شب خرابی هم ممکن است نرسد.
🚀 نصب داکری و ورود دومرحلهای ناظر
توکن بله و کلید پیامک هر دو در همین ناظر میمانند. کانتینرش را با داکر بالا بیاورید و حساب مدیرش را با رمز دوم قفل کنید.
تنظیم فعلی شما از لحظه خرابی تا بیدار شدن نفر کشیک چند دقیقه طول میکشد؟
منابع