الأقراص الدائمة في رصيف: كيف تحفظ الملفات بعد النشر؟

اضبط تخزين ملفات التطبيق في رصيف، واختبر بقاءها بعد إعادة التشغيل والنشر، وافهم حدود النسخة الواحدة والنسخ الاحتياطي والتراجع.

هل تبقى الملفات المرفوعة بعد النشر التالي؟

إذا كان تطبيقك يستقبل فواتير أو مرفقات أو صور مستخدمين، فنجاح الرفع لا يكفي. يجب أن يظل الملف متاحًا عند استبدال حاوية التطبيق. في رصيف، يحفظ القرص الدائم الملفات عبر إعادة التشغيل والنشر، بشرط أن يكتب التطبيق داخل مسار تركيبه. لكنه ليس نسخة احتياطية، وله أثر مباشر في طريقة نشر الخدمة وتوسعتها.

هذا الدليل للمطور الذي يختار مكان حفظ ملفات تطبيقه. راجعنا سلوك المنصة في وثائق رصيف الرسمية بتاريخ 19 نوفمبر 2026. اختبار القبول أدناه إجراء قابل لإعادة الإنتاج، وليس ادعاءً بتشغيل حمل عميل أو قياس متانة التخزين في الإنتاج.

حدّد البيانات التي تحتاج إلى البقاء

ضع الشيفرة ومخرجات البناء داخل صورة التطبيق. يمكن أن تبقى الملفات المؤقتة والصور المصغرة القابلة لإعادة التوليد في تخزين مؤقت إذا كان فقدها مقبولًا. أما ملفات المستخدمين والحالة المحلية التي لا يمكن تعويضها فتحتاج إلى خطة حفظ واضحة.

  • السجلات العلائقية: استخدم قاعدة بيانات، ولا تجعل مجلد ملفات JSON قاعدة بيانات بالصدفة.
  • ملفات تحتاج إليها نسخة واحدة من التطبيق: قد يناسبها قرص دائم.
  • ملفات مشتركة بين عدة نسخ أو تحتاج إلى تقديم مستقل عن التطبيق: قيّم تخزين الكائنات ونموذج الوصول إليه. هذه توصية معمارية، وليست ادعاءً بأن رصيف يقدم منتجًا لتخزين الكائنات.

تركيب قرص لا يجعل كل مسارات الحاوية دائمة؛ الحفظ مرتبط بالمجلد المركّب. ولا تفترض أن محتويات مجلد موجود في الصورة ستُنسخ تلقائيًا إلى قرص جديد. هيّئ الملفات اللازمة صراحةً واختبر ظهورها.

إضافة قرص دائم في رصيف

وفق وثائق الأقراص، الخطوات الحالية هي:

  1. افتح قسم Storage في الخدمة.
  2. أدخل Mount path مطلقًا، مثل /data أو /app/uploads.
  3. اختر Add volume.
  4. نفّذ Deploy لبدء استخدام القرص.

تسمح رصيف بقرص واحد لكل خدمة. يمكن أن يصل عمق المسار إلى ثمانية مستويات، ولا يُسمح بمسارات النظام مثل /etc و/usr و/proc أو /tmp. لا يمكن إرفاق قرص بمهمة مجدولة. السعة الابتدائية والحد الأعلى مرتبطان بالخطة؛ تحقّق من قيم خدمتك بدل افتراض سعة من هذا المقال.

إذا كانت الخدمة قائمة، فإضافة قرص ليست خطة ترحيل للملفات القديمة. احصر الملفات ومساراتها أولًا، ثم جهّز إجراء نسخ مستقلًا يمكن التحقق منه. لا تحذف الأصل قبل فحص النسخة الجديدة وسلوك التطبيق.

اجعل مسار الكتابة صريحًا

استخدم جذر تخزين واضحًا بدل مسار نسبي يتغير بحسب مجلد تشغيل العملية. المثال التالي لتطبيق Node.js يكشف مبكرًا مشكلة إنشاء المجلد أو صلاحية الكتابة:

import { mkdir, writeFile, readFile, unlink } from 'node:fs/promises';
import { join } from 'node:path';
import { randomUUID } from 'node:crypto';

const root = process.env.UPLOAD_DIR || '/data/uploads';
await mkdir(root, { recursive: true });
const probe = join(root, `.write-check-${randomUUID()}`);
await writeFile(probe, 'storage-check', { flag: 'wx' });
if (await readFile(probe, 'utf8') !== 'storage-check') {
  throw new Error('Storage check failed');
}
await unlink(probe);

يثبت الفحص أن العملية تستطيع الكتابة والقراءة في تلك اللحظة، لكنه لا يثبت وجود قرص دائم خلف المسار؛ سينجح أيضًا على مجلد مؤقت قابل للكتابة. إثبات البقاء يحتاج إلى اختبار استبدال الحاوية أدناه.

إذا ضبطت UPLOAD_DIR في رصيف، طبّقه بنشر جديد. راجع متى تُطبّق متغيرات البيئة. لا تسمح لمدخلات المستخدم بتحديد مسار التخزين مباشرة. معالج رفع حقيقي يحتاج أيضًا إلى مصادقة وصلاحيات وحدود أحجام ومعالجة آمنة للأسماء؛ هذا المثال فحص تخزين، وليس واجهة رفع.

اختبار قبول قابل لإعادة الإنتاج

نفّذ الخطوات على خدمة اختبار معزولة وببيانات اصطناعية. استخدم واجهات الرفع والتنزيل المعتادة في تطبيقك، ولا تضف واجهة عامة لكتابة ملفات عشوائية أو تنفيذ أوامر.

  1. سجّل مسار تركيب القرص والمراجعة العاملة. تأكد أن مجلد الرفع الفعلي يقع داخل مسار التركيب.
  2. أنشئ ملفًا نصيًا اصطناعيًا بعلامة فريدة، واحفظ بصمته SHA-256 محليًا. ارفعه وسجّل المعرّف الذي منحه التطبيق.
  3. نزّله عبر التطبيق وقارن البصمة. تشابه الاسم لا يكفي لإثبات تطابق المحتوى.
  4. أعد تشغيل الخدمة، وانتظر جاهزيتها، ثم نزّل الملف بالمعرّف نفسه وقارن البصمة مجددًا.
  5. انشر مراجعة جديدة بتغيير غير مؤثر، من دون تعديل مسار القرص. تأكد من تغير المراجعة العاملة ثم كرر التنزيل والمقارنة.
  6. احفظ النتائج والمراجعات والتوقيتات. تعذّر القراءة أو اختلاف البصمة يعني فشل اختبار القبول ويستدعي التحقيق قبل حفظ بيانات مهمة.

يمكن حساب بصمة الملف محليًا باستخدام Node.js دون حزم إضافية:

node --input-type=module -e 'import {readFileSync} from "node:fs"; import {createHash} from "node:crypto"; console.log(createHash("sha256").update(readFileSync(process.argv[1])).digest("hex"))' ./storage-probe.txt

تختبر هذه الخطوات استرجاع ملف عبر أحداث محددة. لا تنتج عنها نسبة متانة للتخزين أو إثبات للتعافي من الكوارث أو لصحة الكتابة المتزامنة أو لاستعادة كل صيغ قواعد البيانات. احتفظ بالنتائج كما هي، ولا تحوّل نجاح حالة واحدة إلى ضمان عام.

المفاضلة: نسخة واحدة وانقطاع عند النشر

تعمل الخدمة المرتبطة بقرص في رصيف بنسخة واحدة. عند النشر تتوقف النسخة القديمة قبل بدء الجديدة، لأن القرص يُستخدم بواسطة نسخة واحدة في الوقت نفسه. توقّع انقطاعًا قصيرًا مع كل نشر، ولا تعد بنشر دون انقطاع لهذه البنية.

يختلف ذلك عن النشر التدريجي المعتاد في وثائق النشر. يبقى فحص الجاهزية مهمًا، لكنه لا يلغي قيد النسخة الواحدة. لفهم الفرق بين فتح المنفذ وجاهزية التطبيق، راجع دليل جاهزية Node.js.

إذا كانت توسعة واجهة الويب أفقيًا مطلبًا أساسيًا، فراجع معمارية التخزين قبل إرفاق القرص. قد يساعد فصل الملفات أو البيانات عن خدمة الويب في إبقائها عديمة الحالة، لكن الاتصال والصلاحيات وسلوك الأعطال تحتاج إلى تقييم مستقل.

القرص الدائم والتراجع والنسخ الاحتياطي ليست شيئًا واحدًا

التراجع عن إصدار التطبيق يعيد إعدادات الخدمة وصورتها، ولا يعيد بيانات القرص أو قاعدة البيانات. إذا حذف إصدار ملفات أو غيّر تنسيقها، فلن يُرجع التراجع عن الصورة تلك البيانات. خطّط لتغييرات متوافقة مع الإصدار السابق أو لإجراء استعادة صريح.

تفرّق وثائق الأقراص الحالية بين الخطط المدفوعة والخطة المجانية: للأقراص في الخطط المدفوعة نسخ يومية وأسبوعية، أما المجانية فلا تشمل نسخًا احتياطية. تصف الوثائق النسخة بأنها لقطة للقرص كاملًا بحالة تشبه انقطاع الطاقة، والاستعادة تتم عبر الدعم. لا تستنتج تغطية خدمتك أثناء التجربة الخاصة من مجرد وجود قرص؛ تحقّق من استحقاقها مباشرة.

توصي الوثائق أيضًا بحفظ نسخ منطقية لقواعد البيانات خارج رصيف. حدّد مقدار البيانات الذي يمكنك تحمّل فقده والوقت المقبول للتعافي، ثم اختبر الاستعادة المناسبة. وجود نسخة لم تختبر استعادتها ليس دليلًا على قدرة التطبيق على التعافي.

حذف القرص يزيله من إعدادات الخدمة فورًا، ويعمل النشر التالي من دونه. تتيح الوثائق الحالية استعادة بياناته من بطاقة القرص خلال 48 ساعة، ثم يصبح الحذف نهائيًا. هذه المهلة ليست استراتيجية نسخ احتياطي، ولا مبررًا لاختبار الحذف على بيانات الإنتاج.

استكشاف الملفات المفقودة وأخطاء الكتابة

  • تختفي الملفات بعد النشر: قارن مسار الكتابة الفعلي بمسار التركيب، وافحص المسارات النسبية ومجلد التشغيل وأي قيمة بديلة لمجلد الرفع.
  • تظهر Permission denied: افحص مستخدم العملية وملكية المجلد. أصلح الصلاحيات بأضيق نطاق مطلوب، ولا تجعل جميع المجلدات قابلة للكتابة للجميع.
  • تبدو الملفات مفقودة فور تركيب القرص: تحقّق من أن التركيب لا يحجب ملفات مضمنة في الصورة، ومن أن الملفات القديمة لم تكن في مسار آخر. افحص الموقعين قبل استنتاج ضياع البيانات.
  • لا يمكن زيادة عدد النسخ: هذا قيد موثق للخدمة المرتبطة بقرص، وليس بالضرورة عطلًا في التوسعة.
  • امتلأ القرص: راجع نمو الملفات وسياسة الاحتفاظ. تدعم رصيف زيادة السعة بخطوات 512 MiB أثناء عمل الخدمة، ولا تدعم تقليصها. تأكد من الحد الأعلى للخطة قبل الاعتماد على التوسعة.
  • لم يُرجع التراجع ملفًا محذوفًا: هذا متوقع؛ استعادة البيانات مسار مستقل عن التراجع عن التطبيق.

المصادر والخطوة التالية

المصادر الأولية التي روجعت في 19 نوفمبر 2026: الأقراص الدائمة، والنشر والتراجع، وحدود المنصة. الغلاف رسم توضيحي مولّد، وليس لقطة لوحة أو دليلًا على تشغيل خدمة.

رصيف متاحة حاليًا كتجربة خاصة. اطلب الوصول، واذكر حجم الملفات ومتطلبات الاستعادة والتوسعة لتقييم التخزين المناسب مع خدمتك الأولى.