أتمتة فحص الروابط المكسورة بـ lychee و cron

أضف السطر ده لتشغيل الفحص كل يوم الساعة 7 صباحًا بتوقيت السيرفر:

سيناريو واقعي بالأرقام

خلينا نقول عندك مدونة تقنية بـ 220 مقال، وكل مقال فيه متوسط 7 روابط. ده حوالي 1540 رابط. على VPS عادي بذاكرة 1GB، فحص الرقم ده بـ concurrency 16 ممكن يخلص في 2 إلى 5 دقائق، حسب سرعة المواقع الخارجية. لو رفعت concurrency إلى 64، ممكن تنزل المدة إلى دقيقتين، لكنك هتزود ضغط الشبكة واحتمال false positives بسبب rate limiting من مواقع خارجية.

بدل ما تقضي 45 دقيقة أسبوعيًا في فحص عينة عشوائية، السكربت بيكلفك تقريبًا 5 دقائق إعداد أول مرة، وبعدها دقيقة متابعة لما يجيلك تنبيه. بتكسب اكتشاف أسرع. بتخسر إنك محتاج تحافظ على Slack webhook وتراجع التقرير بدل الاعتماد على إحساسك.

الـ trade-offs وما يجب الانتباه له

• Docker بدل تثبيت lychee محليًا: بتكسب reproducibility، وبتخسر تحميل image أول مرة.
• فحص يومي بدل فحص مع كل deploy: بتكسب تنبيهات أقل إزعاجًا، وبتخسر اكتشاف فوري داخل pipeline.
• timeout يساوي 20 ثانية: مناسب لمعظم الروابط الخارجية. أقل من 10 ثواني ممكن يطلع إنذارات كاذبة.
• max-concurrency 16: رقم محافظ. لو موقعك كبير جدًا جرب 32، لكن راقب false positives.

لو عايزها تدعم مواقع متعددة، اعمل ملف sites.txt وحلقة while read تشغل الفحص لكل موقع. بس متبدأش بكده. ابدأ بموقع واحد، افهم الضوضاء، وبعدها وسّع.

متى لا تستخدم هذه الطريقة

لا تستخدم الطريقة دي لو موقعك خلف login بالكامل، لأن lychee مش هيشوف الروابط بنفس جلسة المستخدم. لا تستخدمها كبديل لاختبارات end-to-end لو الروابط بتتولد بعد تفاعل JavaScript معقد. ولا تعتمد عليها وحدها لو عندك SLA رسمي؛ في الحالة دي محتاج مراقبة uptime منفصلة مثل Better Stack أو Uptime Kuma.

مصادر اعتمدت عليها

• توثيق lychee على GitHub لفهم خيارات الفحص والـ exit codes.
• توثيق docker run لتشغيل الأداة داخل container بدون تثبيت محلي.
• توثيق Slack Incoming Webhooks لبناء تنبيه بسيط عند وجود روابط مكسورة.
• توثيق crontab لصيغة الجدولة اليومية.

الخطوة التالية

الخطوة التالية: شغّل السكربت يدويًا مرة واحدة على موقعك، وافتح آخر 25 سطرًا من التقرير. لو لقيت أكثر من 5 روابط خارجية فاشلة بسبب timeout فقط، زوّد --timeout إلى 30 ثانية قبل ما تعتبرها أخطاء حقيقية.