FA Home

راهنمای pulsecheck

pulsecheck در بازه‌هایی که تعیین می‌کنید سایت‌ها، پورت‌های TCP و سرورهای شما را بررسی می‌کند و با shoutrrr خبر می‌دهد: اسلک، تلگرام، دیسکورد، ایمیل، ntfy و ده‌ها سرویس دیگر. تنظیمات در یک فایل YAML است، داشبورد وب ندارد و چیزی در گیت کامیت نمی‌کند. وضعیت در یک فایل SQLite می‌ماند.

زبان: English · فارسی

صفحه	محتوا
شروع سریع	نصب، اولین تنظیمات، اولین اجرا
دستورها	init، env، validate، test-notify، run، status، report، update
مرجع YAML	نوع، مقدار پیش‌فرض و قاعده‌ی هر کلید، پشتیبانی پلتفرم‌ها، کدهای خروج
تنظیمات	توضیح کلیدها و نحوه‌ی تصمیم‌گیری برای هشدار
اعلان‌ها	نصب shoutrrr، نمونه آدرس‌ها، مسیردهی هشدارها
زمان‌بندی	GitHub Actions، GitLab CI، cron
سرورلس	Vercel و Cloudflare Workers: راه‌اندازی و محدودیت‌ها
یادداشت‌های طراحی	ساختار برنامه، درس‌های deploy واقعی، آنچه تست شده
عیب‌یابی	مشکل‌های رایج

هر اجرا چه می‌کند

1. pulsecheck.yml را می‌خواند و ${ENV_VAR}‌ها را از متغیرهای محیطی پر می‌کند.
2. سایتی که از آخرین بررسی‌اش کمتر از interval گذشته باشد رد می‌شود.
3. بقیه را هم‌زمان بررسی می‌کند (HTTP، TCP یا ping؛ برای سایت‌های https که بخواهند، تاریخ انقضای گواهی هم).
4. نتیجه را با وضعیت ذخیره‌شده مقایسه می‌کند. فقط تغییر وضعیت (مثلاً up به down یا برعکس)، یادآوری سررسیدشده یا هشدار گواهی باعث هشدار می‌شود.
5. هشدار را با shoutrrr می‌فرستد، مگر اینکه بازه‌ی نگهداری (maintenance) فعال باشد.
6. نتیجه و وضعیت جدید را ذخیره می‌کند.