تبدأ مشاكل خوادم كثيرة بسكربت صدفة صغير: متغير غير معرّف يحوّل الحذف إلى شيء أكبر بكثير أو خطوة فاشلة تُتجاهل أو تشغيلان من cron يتداخلان. تجعل بضع عادات السكربت أكثر أماناً بكثير: الوضع الصارم والاقتباس والتنظيف بـ trap وقفل وتشغيل تجريبي. يعرض هذا الدليل قالباً صغيراً آمناً. الأوامر وفق وثائق Bash وShellCheck؛ لم أشغّلها على خادمكم.
١. ابدؤوا بالوضع الصارم
يوقف الوضع الصارم السكربت عند الأخطاء والمتغيرات غير المعرّفة والفشل في منتصف الأنبوب:
#!/usr/bin/env bash
set -Eeuo pipefail
IFS=$'\n\t'
# -e stop on error, -u fail on unset variables, pipefail fail if any pipe stage fails
لا يلتقط كل شيء لكنه يزيل كثيراً من حالات الفشل الصامتة.
٢. نظّفوا وامنعوا التداخل
استخدموا مجلداً مؤقتاً واحذفوه عند الخروج وخذوا قفلاً كي لا يتداخل تشغيلان:
WORKDIR=$(mktemp -d)
cleanup() { rm -rf -- "$WORKDIR"; }
trap cleanup EXIT
trap 'echo "failed at line $LINENO" >&2' ERR
exec 9>/var/lock/myjob.lock
flock -n 9 || { echo 'already running' >&2; exit 0; }
يتناسب هذا مع cron أو مؤقت؛ راجعوا دليل مؤقتات systemd ودليل نسخ rsync الاحتياطي لعادة التشغيل التجريبي.
٣. اقتبسوا وتحققوا وسجّلوا
اقتبسوا كل متغير وافحصوا المدخلات وسجّلوا ما حدث:
file="$1" # always quote variables
[ -r "$file" ] || { echo "cannot read: $file" >&2; exit 2; }
rsync -a --dry-run -- "$SRC/" "$DEST/" # dry run before the real run
log() { printf '%s %s\n' "$(date -Is)" "$*" >> /var/log/myjob.log; }
يجب تدوير ملفات السجل؛ راجعوا دليل logrotate.
٤. افحصوا قبل التشغيل
اختبروا الصياغة وشغّلوا ShellCheck وتتبعوا السكربت على بيانات تجريبية قبل أن يلمس الإنتاج:
bash -n myjob.sh # syntax check
shellcheck myjob.sh # finds quoting and logic mistakes
bash -x myjob.sh # trace what runs
./myjob.sh; echo "exit code: $?"
شغّلوا السكربتات الخطرة أولاً على نسخة ومع نسخة احتياطية جاهزة.
٥. أخطاء يجب تجنبها
تصنع هذه الأنماط أسوأ الحوادث:
rm -rf $DIR/* # if DIR is empty this becomes rm -rf /*
cd "$DIR" && rm -rf * # safer, but still verify DIR first
Unquoted $file # breaks on spaces and wildcards
No lock in cron # two runs overlap and corrupt data
اكتبوا مسارات صريحة وتحققوا أن المتغير غير فارغ قبل الحذف وتجنبوا تشغيل السكربتات الروتينية بحساب root؛ راجعوا دليل sudoers.
٦. مثال توضيحي وليس قياساً حقيقياً
افترضوا سكربت تنظيف (مختلقاً) يحذف الملفات القديمة في $BACKUP_DIR/old. إن كان المتغير غير معرّف يصبح المسار /old وفي أسوأ الحالات يستهدف الأمر مكاناً خاطئاً. مع set -u يتوقف السكربت فوراً ومع فحص أن المتغير غير فارغ لا يصل الخطأ إلى أمر الحذف.
٧. أخطاء شائعة
- استخدام متغيرات غير مقتبسة.
- الحذف بمتغيرات غير مفحوصة.
- غياب القفل في السكربتات المجدولة.
- تجاهل رموز الخروج.
- تخطي التشغيل التجريبي.
- تشغيل كل شيء بحساب root.
٨. أسئلة شائعة
هل يلتقط set -e كل الأخطاء؟ لا؛ بعض السياقات مثل الشروط مستثناة لذا اختبروا السكربت.
لماذا trap؟ لتنظيف الملفات المؤقتة حتى عند فشل السكربت.
ما shellcheck؟ أداة تشير إلى الأخطاء الشائعة في سكربتات الصدفة.
هل Bash مناسب للبرامج الكبيرة؟ للمنطق الطويل قد تكون لغة باختبار أفضل أكثر أماناً.
٩. قائمة تحقق سريعة
- استخدموا الوضع الصارم.
- اقتبسوا المتغيرات.
- تحققوا من المدخلات.
- استخدموا trap للتنظيف.
- أضيفوا قفلاً.
- نفّذوا تشغيلاً تجريبياً.
- شغّلوا shellcheck.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
Bash manual: The set builtin · Bash manual: trap · ShellCheck wiki · flock(1)
