Gotify؛ سرور اعلان شخصی برای پیام‌های سرور و اسکریپت‌ها

چند نمونهٔ رایج که با یک خط curl قابل پیاده‌سازی است:

وقتی Gotify را در مرحلهٔ سفارش انتخاب می‌کنید، اسکریپت نصب روی Ubuntu 22.04‏، Docker را نصب و ایمیج رسمی gotify/server را با راه‌اندازی خودکار اجرا می‌کند. سرور روی پورت ۸۰ پاسخ می‌دهد و قواعد فایروال برای پورت‌های ۸۰ و ۴۴۳ خودکار تنظیم می‌شوند. یک کاربر مدیر با نام admin و رمز تصادفی بیست‌نویسه‌ای ساخته می‌شود که در فایلی با دسترسی فقط برای root نگه داشته و در تب اپلیکیشن صفحهٔ سرور به شما نشان داده می‌شود.

پوشهٔ /opt/gotify-data همهٔ داده‌ها را نگه می‌دارد: پایگاه دادهٔ SQLite با کاربران، برنامه‌ها، توکن‌ها و پیام‌ها، به‌علاوهٔ تصاویر برنامه‌ها. منطقهٔ زمانی روی تهران است تا زمان پیام‌ها درست نمایش داده شود. همهٔ این کارها خودکار انجام می‌شوند و نصب هزینهٔ جداگانه‌ای ندارد؛ شما فقط هزینهٔ ساعتی سرور را می‌پردازید.

Gotify دو نوع توکن دارد و فرق آن‌ها مهم است. توکن برنامه فقط اجازهٔ ارسال پیام دارد و برای فرستنده‌ها ساخته می‌شود؛ برای هر سرور یا ابزار یک برنامهٔ جدا بسازید تا در رابط وب پیام‌ها با نام و آیکن خودشان دیده شوند و اگر یک توکن لو رفت، فقط همان را باطل کنید. توکن کلاینت برای گیرنده‌هاست و اجازهٔ خواندن پیام‌ها و مدیریت حساب را می‌دهد؛ آن را هرگز در اسکریپت قرار ندهید.

ارسال پیام یک درخواست POST به مسیر message است که توکن برنامه را در پارامتر token یا سرآیند X-Gotify-Key می‌گیرد و فیلدهای title‏، message و priority را دریافت می‌کند. متن می‌تواند Markdown باشد تا لینک و فهرست در اپ خواناتر نمایش داده شود. استفاده از سرآیند به‌جای پارامتر نشانی، توکن را از لاگ‌های وب‌سرور دور نگه می‌دارد.

یک الگوی کاربردی برای اسکریپت‌های bash این است که در انتهای هر کار زمان‌بندی‌شده، کد خروج دستور اصلی بررسی شود: اگر صفر بود پیامی با اولویت کم و اگر نبود پیامی با اولویت بالا و چند خط آخر لاگ فرستاده شود. این‌طور فقط وقتی گوشی‌تان صدا می‌دهد که واقعاً کاری لازم است و گزارش‌های روزمره بی‌صدا در تاریخچه جمع می‌شوند.

پیام‌ها تا وقتی پاکشان نکنید روی سرور می‌مانند. در رابط وب می‌توانید پیام‌های هر برنامه را جداگانه پاک کنید و از طریق API هم حذف خودکار پیام‌های قدیمی را با یک اسکریپت کوچک زمان‌بندی کنید تا پایگاه داده سبک بماند.

Gotify یکی از سبک‌ترین برنامه‌هایی است که می‌توانید روی سرور اجرا کنید و حداقل حافظهٔ لازم برای نصب خودکارش ۵۱۲ مگابایت است. به همین دلیل در همهٔ پلن‌ها، از کوچک‌ترین پلن mini با یک گیگابایت حافظه، در تب اپلیکیشن‌ها قابل انتخاب است و اگر سرور دیگری دارید که بار سنگینی ندارد، می‌توانید Gotify را کنار سرویس‌های دیگر روی همان سرور اجرا کنید.

دیسک هم مسئله نیست، چون پیام‌ها متنی‌اند؛ فقط اگر میلیون‌ها پیام بدون پاک‌کردن جمع شوند پایگاه داده بزرگ می‌شود. هزینه ساعتی از کیف پول کم می‌شود و قیمت‌های زیر مستقیم از جدول پلن‌ها می‌آیند.

یک توصیهٔ مهم‌تر از اندازهٔ پلن: Gotify را روی همان سروری اجرا نکنید که قرار است خرابی‌اش را گزارش کند. اگر آن سرور از کار بیفتد، پیام هشدار هم هیچ‌وقت ارسال نمی‌شود. یک سرور کوچک جدا برای ابزارهای پایش و اعلان، ارزان‌ترین بیمه برای بقیهٔ زیرساخت است.

ربات پیام‌رسان راحت به نظر می‌رسد چون اپش از قبل روی گوشی هست، اما پیام‌های سرور شما از سرور شرکت دیگری عبور می‌کند و اگر آن سرویس در دسترس نباشد یا محدود شود، هشدارها هم نمی‌رسند. Gotify و ntfy هر دو این وابستگی را حذف می‌کنند و تفاوتشان بیشتر در مدل کاربری و پشتیبانی iOS است.

سه راه رایج برای گرفتن اعلان از سرورها با هم فرق‌های مهمی دارند:

نصب در مرحلهٔ سفارش خودکار انجام می‌شود؛ از سفارش تا اولین اعلان روی گوشی این مسیر را طی می‌کنید:

رمز کاربر admin و توکن‌های کلاینت کلید کل صندوق پیام‌اند. روی HTTP ساده این‌ها بدون رمزگذاری منتقل می‌شوند، پس پیش از استفادهٔ جدی HTTPS را راه بیندازید: یک زیردامنه در مدیریت DNS بسازید و Edge Proxy را روشن کنید که گواهی را روی لبه برقرار می‌کند، از WebSocket پشتیبانی می‌کند و با سرور روی پورت ۸۰ حرف می‌زند. سپس نشانی اپ اندروید را به https تغییر دهید.

در پیام‌ها رمز عبور یا اطلاعات حساس ننویسید؛ پیام‌ها در پایگاه داده ذخیره می‌شوند و روی صفحهٔ قفل گوشی هم دیده می‌شوند. اگر فرستنده‌ها همه در شبکهٔ خودتان‌اند، دسترسی به Gotify را در فایروال شبکه به نشانی‌های مشخص محدود کنید یا آن را پشت WireGuard قرار دهید.

همهٔ وضعیت Gotify در پوشهٔ /opt/gotify-data است. برای انتقال به سرور تازه، ایمیج را آن‌جا اجرا و این پوشه را کپی کنید؛ برنامه‌ها و توکن‌ها همان می‌مانند و لازم نیست اسکریپت‌ها را تغییر دهید، فقط نشانی سرور در DNS عوض می‌شود. یک نسخه از این پوشه را گاه‌به‌گاه در فضای ذخیره‌سازی ابری نگه دارید. پیش از تغییرات بزرگ، از پنل یک بکاپ دستی از کل سرور بسازید؛ این بکاپ‌ها خودکار نیستند و ۲ تومان برای هر گیگابایت در ساعت حساب می‌شوند؛ جزئیات در صفحهٔ پشتیبان‌گیری.

محدودیت‌ها: نصب خودکار، دامنه و HTTPS را راه نمی‌اندازد و Gotify ابتدا روی HTTP ساده و IP سرور در دسترس است؛ اپ رسمی iOS وجود ندارد؛ Gotify خودش زمان‌بندی، تکرار هشدار یا تأیید دریافت ندارد و فقط پیام را می‌رساند. اگر خود سرور Gotify از دسترس خارج شود، پیامی هم نمی‌رسد؛ برای همین بهتر است آن را روی سروری جدا از سرورهایی که پایش می‌کند اجرا کنید.