نسخ احتياطي تلقائي لقاعدة بيانات PostgreSQL
pg_dump يوميًا بصيغة custom، جدولة عبر systemd timer، ونسخ الملف بـ rclone أو scp خارج قرص الإنتاج. جرّب pg_restore على قاعدة تجريبية بعد أول dump ناجح. النسخة على نفس القرص ليست خطة استعادة.
أكثر عطل يخيف من أجهز لهم السيرفر ليس توقف Nginx، بل ضياع قاعدة البيانات. القرص يتعطل، أو تُنفَّذ هجرة بالاتجاه الخطأ، أو تُحذف صفوف بطلب بلا شرط. في أكثر من مشروع وجدت نسخة على نفس الـVPS فقط، أو نسخة عمرها أسبوع، أو لا توجد نسخة أصلًا. النسخ الاحتياطي التلقائي لقاعدة بيانات PostgreSQL الذي أرتبه بسيط: pg_dump كل ليلة، ملف بتاريخ واضح، ونسخة خارج السيرفر، وتجربة استعادة من وقت لآخر.
هذا الدليل يكمّل نشر مشروع Node.js على VPS بـ Docker و Nginx و SSL. إن كنت تنشر التحديثات من GitHub Actions كما في Deploy to a VPS with GitHub Actions، أبقِ النسخ الاحتياطي خارج مسار النشر. سكربت النشر يجب ألا يمسح الـvolumes، ومهمة النسخ يجب ألا تنتظر نجاح النشر حتى تعمل.
إذا كانت القاعدة تخزّن طلبات دفع، اقرأ أيضًا Building reliable payment webhooks. الاستعادة المتأخرة لا تعوّض عملية سُجّلت مرتين، لكن غياب النسخة يعني أن الطلبات نفسها تضيع مع السيرفر.
ماذا يغطي هذا الدليل
المسار لـPostgreSQL على VPS واحد، داخل Docker أو على المضيف: نسخة منطقية يومية بـpg_dump، وجدولة بـsystemd timer، ونقل الملف إلى مكان آخر، واستعادة إلى قاعدة تجريبية. هذا يكفي لمعظم المتاجر والبوتات التي أعمل عليها.
لا أبدأ بنظام WAL كامل واستعادة إلى دقيقة محددة (PITR) إلا إذا كان فقدان ساعات من البيانات غير مقبول، وكان هناك من يراجع الأرشيف. ذلك ترتيب أوسع، ويحتاج مساحة ومراقبة منتظمة. للنسخة اليومية نبدأ من هنا.
مستخدم وملف صلاحيات، لا كلمة مرور في السجلات
لا تضع كلمة مرور Postgres في سطر cron، ولا في وحدة systemd ظاهرة في النافذة. إن كانت القاعدة على المضيف، استخدم ملف .pgpass بصلاحيات 600 لمستخدم نظام مخصص، مثل backup:
`` # /home/backup/.pgpass localhost:5432:appdb:appuser:the-password ``
``bash sudo adduser --disabled-password --gecos "" backup sudo mkdir -p /home/backup sudo chown backup:backup /home/backup # بعد إنشاء الملف: sudo chmod 600 /home/backup/.pgpass sudo chown backup:backup /home/backup/.pgpass ``
إن كانت القاعدة داخل Docker Compose، السكربت يستدعي docker compose exec وينقل الناتج إلى ملف على المضيف. كلمة المرور تبقى في .env على السيرفر، وهو أصلًا خارج Git، والسكربت لا يطبعها.
اجعل مجلد النسخ ضيق الصلاحيات أيضًا. ملف dump فيه بيانات زبائن وطلبات ودفعات. لا يُترك في /tmp مفتوحًا للجميع، ولا يُرفع إلى المستودع، ولا يُرسل في بريد بلا تشفير.
``bash sudo mkdir -p /var/backups/postgres sudo chown backup:backup /var/backups/postgres sudo chmod 700 /var/backups/postgres ``
إذا كان السكربت يحتاج docker compose، امنح مستخدم backup صلاحية sudo محددة لهذه الأوامر فقط، بنفس منطق مستخدم النشر في مقال GitHub Actions، لا NOPASSWD: ALL.
سكربت النسخة اليومية
أضع السكربت في /usr/local/sbin/pg-backup.sh أو داخل المشروع تحت scripts/pg-backup.sh، وأجعله يفشل عند أول خطأ، ويرفض الملف الفارغ.
```bash #!/usr/bin/env bash set -euo pipefail
APP_DIR=/var/www/app BACKUP_DIR=/var/backups/postgres STAMP=$(date +%Y%m%d-%H%M) FILE="$BACKUP_DIR/appdb-$STAMP.dump" KEEP_DAYS=14 REMOTE_PATH="remote:postgres-backups/appdb"
umask 077 mkdir -p "$BACKUP_DIR"
cd "$APP_DIR" sudo docker compose exec -T postgres \ pg_dump -U appuser -Fc --no-owner appdb > "$FILE"
if [[ ! -s "$FILE" ]]; then echo "backup file is empty: $FILE" >&2 exit 1 fi
# انقل نسخة خارج السيرفر. إن لم يكن rclone مضبوطًا بعد، احذف هذا السطر مؤقتًا ولا تترك المهمة صامتة. rclone copy "$FILE" "$REMOTE_PATH/" --checksum
find "$BACKUP_DIR" -name 'appdb-*.dump' -type f -mtime +"$KEEP_DAYS" -delete echo "wrote $FILE" ```
الصيغة -Fc (custom) أفضل من SQL نصي للملفات اليومية: أصغر، وتسمح باستعادة جدول واحد لاحقًا بـpg_restore. --no-owner يسهّل الاستعادة على مستخدم مختلف في بيئة التجربة.
إن كان Postgres على المضيف بلا Docker، استبدل مقطع docker compose exec بهذا:
``bash pg_dump -Fc --no-owner -h localhost -U appuser -d appdb -f "$FILE" ``
pg_dump يأخذ لقطة متسقة بينما الكتابة مستمرة، بفضل MVCC في Postgres. لا حاجة لإيقاف التطبيق من أجل نسخة يومية عادية. اختر ساعة هادئة رغم ذلك، لأن النسخة تقرأ من القاعدة وتكتب إلى القرص، وعلى سيرفر صغير يُلاحظ أثرها إن تزامنت مع ذروة الطلبات.
بعد أول تشغيل يدوي، انظر إلى حجم الملف واحفظه في بالك. إن جاء تشغيل لاحق بحجم أقرب إلى الصفر، أو أصغر بكثير من المعتاد من دون سبب تعرفه، اعتبر المهمة فاشلة حتى تراجعها. السكربت أعلاه يرفض الملف الفارغ فقط؛ مقارنة الحجم الأدنى تقدر تضيفها لاحقًا برقم تعرفه أنت من ملفاتك، لا برقم عام.
الجدولة بـ systemd timer
أفضل systemd timer على cron في هذا السياق: الحالة واضحة بـsystemctl status، والسجل في journal، ويمكن ربط الفشل بوحدة أخرى. أنشئ وحدتين.
/etc/systemd/system/pg-backup.service:
```ini [Unit] Description=Nightly PostgreSQL dump OnFailure=pg-backup-alert.service
[Service] Type=oneshot User=backup Group=backup ExecStart=/usr/local/sbin/pg-backup.sh Nice=10 IOSchedulingClass=best-effort IOSchedulingPriority=6 ```
/etc/systemd/system/pg-backup.timer:
```ini [Unit] Description=Run PostgreSQL dump every night
[Timer] OnCalendar=--* 02:15:00 Persistent=true RandomizedDelaySec=10m
[Install] WantedBy=timers.target ```
ثم:
``bash sudo chmod 700 /usr/local/sbin/pg-backup.sh sudo systemctl daemon-reload sudo systemctl enable --now pg-backup.timer sudo systemctl list-timers pg-backup.timer sudo systemctl start pg-backup.service sudo journalctl -u pg-backup.service -n 50 --no-pager ``
Persistent=true يلحق المهمة إذا كان السيرفر مطفأ عند الساعة المحددة. RandomizedDelaySec يجنبك أن تبدأ كل المهام عند نفس الدقيقة. الساعة 02:15 بتوقيت السيرفر؛ تأكد من timedatectl حتى لا تعمل النسخة في منتصف النهار عندك وأنت تظنها ليلًا.
وحدة OnFailure يمكن أن ترسل رسالة تيليغرام أو بريدًا. أبسط شكل يستدعي سكربتًا يرسل نص الخطأ. راقب هذا الإشعار من يومه الأول، وإلا صارت المهمة الفاشلة صامتة مثل عدم وجود نسخة.
أخرج الملف من السيرفر
نسخة على نفس قرص الإنتاج ليست نسخة من ذلك القرص. إذا تلف المجلد أو حُذفت الحاوية مع volume أُسيء تعريفها، يذهب الأصل والdump معًا. لذلك السطر rclone copy في السكربت جزء من المهمة، لا تحسين لاحق.
لا أفرض عليك مزودًا. S3 أو Cloudflare R2 أو Backblaze B2 أو VPS ثانٍ يصل إليه scp، كلها تفي إذا كان الوصول مقيدًا والمخزن ليس عامًا. مثال إعداد rclone لمخزن تسميه remote:
``bash # على السيرفر، بمستخدم backup rclone config rclone lsd remote: rclone mkdir remote:postgres-backups rclone copy /var/backups/postgres/appdb-YYYYMMDD-HHMM.dump remote:postgres-backups/appdb/ rclone ls remote:postgres-backups/appdb/ ``
احتفظ في المخزن الخارجي بمدة أطول مما على السيرفر إن كانت المساحة تسمح. على القرص المحلي أبقي 14 يومًا في المثال أعلاه حتى لا يمتلئ القرص ويُوقف Postgres نفسه. المدة في المخزن الخارجي قرارك حسب المساحة وحساسية البيانات. لا تترك dumps قديمة في مجلد مشترك أو في محادثة.
إذا ضبطت النشر بـGitHub Actions، لا تجعل النسخ اليومي يعتمد على workflow في المستودع وحده. تعطيل Actions أو انتهاء سرّ كفيل بأن تتوقف النسخ وأنت لا تلاحظ. المؤقت على السيرفر يستمر. يمكن لاحقًا إضافة فحص أسبوعي من Actions يتأكد أن في المخزن ملفًا جديدًا، وهذا فحص لا بديل عن المهمة المحلية.
جرّب الاستعادة على قاعدة ليست الإنتاج
نسخة لم تُستعد من قبل هي أمل، لا خطة. بعد أول dump ناجح، استعد إلى قاعدة جديدة على نفس السيرفر أو على جهاز آخر، لا فوق قاعدة الزبائن.
```bash DUMP=/var/backups/postgres/appdb-YYYYMMDD-HHMM.dump
sudo docker compose exec -T postgres \ dropdb -U appuser --if-exists appdb_restore
sudo docker compose exec -T postgres \ createdb -U appuser appdb_restore
sudo docker compose exec -T -i postgres \ pg_restore -U appuser --no-owner --dbname=appdb_restore < "$DUMP" ```
إذا رفض pg_restore بعض الأوامر، اقرأ الناتج قبل أن تعتبر النسخة سليمة. بعدها تحقق من شيء تعرفه: عدد الطلبات في آخر يوم، أو وجود المستخدم الذي أنشأته للتجربة. عندما تنتقل من نسخة قديمة إلى مخطط جديد، جرّب الاستعادة مرة أخرى بعد الهجرة، لأن dump الأمس قد لا يطابق كود اليوم إن كنت تعول على استعادة سريعة.
الاستعادة فوق الإنتاج خطوة واعية ومختلفة: توقّف الكتابة، خذ dump أخير إن كان لا يزال ممكنًا، ثم أعد القاعدة من الملف المقصود. لا تجعل تجربة دورية تلمس قاعدة الزبائن.
ما الذي أتركه خارج هذا المسار عمدًا
لا أضع ملفات dump داخل Git، ولا أفتح منفذ Postgres على الإنترنت من أجل أن يسحب جهازك النسخة. لا أشغّل هجرة هدّامة تلقائيًا من سكربت النشر ثم أعتمد على أن النسخة الليلية ستنقذ الخطأ بعد ساعات. إن كانت الهجرة خطرة، خذ dump يدويًا قبلها وانتظر حتى تتأكد.
النسخ المستمر وPITR مفيدان عندما تحتاج الرجوع إلى دقيقة قبل خطأ معين. يتطلبان أرشفة WAL، ومساحة، واختبار استعادة أطول. إن وصلت إلى هذا الاحتياج، يبقى pg_dump اليومي مفيدًا كنسخة مستقلة يمكن نقلها بسهولة، لا يُلغى.
أسئلة تتكرر
هل pg_dump يكفي أم أحتاج نسخة فيزيائية؟
للمتجر الصغير أو بوت التيليغرام أو واجهة دفع على VPS واحد، النسخة المنطقية اليومية مع نسخة خارج السيرفر كافية في البداية. النسخة الفيزيائية وPITR عندما تريد الرجوع إلى لحظة محددة، أو عندما يكبر حجم القاعدة فيصير dump الكامل بطيئًا على نافذة الليل.
هل أوقف التطبيق أثناء النسخ؟
لا، في الاستخدام العادي. pg_dump يقرأ لقطة متسقة. أوقف التطبيق فقط إن كنت تأخذ إجراءً خاصًا طلبته لنفسك، لا كروتين يومي.
أين أخزّن الملف إن لم أرد Object Storage؟
على جهاز أو VPS ثانٍ عبر scp أو rsync، بمفتاح مستقل ومجلد ضيق الصلاحيات. المهم أن القرص ليس قرص الإنتاج، وأنك تجرب سحب الملف من هناك لا الاكتفاء برفع نجح مرة.
كم يومًا أحتفظ بالنسخ؟
على السيرفر أبدأ بأسبوعين حتى لا يمتلئ القرص. في المخزن الخارجي أبقي أطول إن قدرت. لا يوجد رقم واحد يناسب كل مشروع. إن كانت الملفات تحتوي بيانات دفع أو هواتف زبائن، عاملها كبيانات حسّاسة: وصول محدود، وحذف واضح بعد المدة التي تقررها.
كيف أعرف أن المهمة توقفت؟
systemctl is-active pg-backup.timer وjournalctl. اربط الفشل بإشعار من اليوم الأول، وراجع يدويًا في الأسابيع الأولى وجود ملف جديد في المخزن الخارجي. الإشعار وحده لا يكفي إن كانت الرسالة تذهب إلى محادثة لا يفتحها أحد.
إذا بدك أركّب هذا المسار على سيرفرك، أو أراجع نسخًا قائمة لأتأكد أنها تُستعاد، راسلني من صفحة الموقع أو على fayezalshami.dev@gmail.com. اذكر نظام التشغيل، وهل Postgres داخل Docker أم على المضيف، وأين تريد حفظ النسخة الخارجية. إعداد VPS يبدأ من 40 دولارًا مرة واحدة، والعناية المستمرة بالسيرفر 25 دولارًا في الشهر.