لا يمكن استخدام اسم الملف الذي قام العميل بتحميله مباشرة كمسار تخزين: لمنع اجتياز المسار وتغطية الاسم المكرر

الملف الذي تم تحميله يسمى `../../report.pdf`، وهذا لا يعني أن الخادم يجب أن يحفظه بهذا الاسم. يأتي اسم الملف من المستخدم وينتمي إلى بيانات الإدخال؛ ينتمي مسار القرص إلى حدود إذن النظام. يمكن أن يؤدي الخلط بين الاثنين بسهولة إلى مشاكل مثل اجتياز المسار وتغطية الأسماء المكررة والسلوكيات المختلفة بين Windows وLinux.

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

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

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

هل يمكن استخدام اسم الملف الذي تم تحميله مباشرة كمسار تخزين؟ استنتاج جملة واحدة

ولا يمكن استخدامه مباشرة. يتم استخدام اسم العرض لعرض الواجهة، ويتم إنشاء مسار التخزين بواسطة الخادم بناءً على المعرف الداخلي.

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

تم فصل اسم العرض واسم التخزين

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

المثال التالي ينشئ مسارًا فقط ولا يقوم بإنشاء دليل أو ملف.

مُنشئ المسار الأدنى

from pathlib import Path
import re

def storage_path(root, internal_id, extension):
    if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
        raise ValueError("invalid internal id")
    if extension not in {".pdf", ".docx", ".udoc"}:
        raise ValueError("unsupported extension")
    base = Path(root).resolve()
    candidate = (base / (internal_id + extension)).resolve()
    if candidate.parent != base:
        raise ValueError("outside storage root")
    return candidate

root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
    try:
        storage_path(root, bad, ".pdf")
    except ValueError:
        pass
    else:
        raise AssertionError(bad)

يفترض هذا المثال أن المعرف الداخلي قد تم إنشاؤه بواسطة الخادم. إنه ليس تطبيقًا آمنًا لملف الكتابة لبيئات الهجوم العشوائي على القرص:

  • قد يحدث سباق بين الفحص والفتح الفعلي.
  • يجب التحكم في أذونات الدليل الأصلي وسياسات الارتباط الرمزي بشكل منفصل.
  • لا يعني المعرف الفريد أيضًا أنه يمكن تجاهل سياسة "عدم التجاوز".

تعقيم اسم الملف لا يعني مصادقة الملف

يمكن أن يؤدي تنظيف اسم الملف إلى حل جزء من المشكلة فقط، ويجب معالجة الظواهر المختلفة على مستويات مختلفة:

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

📊 المقارنة الأساسية

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

تخزين الكائنات له نفس الحدود أيضًا

لا يحتوي R2 أو مخازن الكائنات الأخرى على الدلالات الكاملة لاجتياز الدليل التقليدي، لكن مفاتيح الكائنات لا تزال تؤثر على العزل والتجاوزات وعناوين URL المكشوفة.

  • لا تقم بتهجئة السلسلة المقدمة من المستأجر مباشرة في بادئة مشتركة.
  • لا يمكن لبرنامج التنزيل استنتاج التفويض بناءً على اسم المفتاح وحده.

يجب أن يكون للملف هوية قبل إدخال الترجمة

عند الاتصال بسير عمل OmniDoc (بوابة المنتج)، يمكنك الاستمرار في عرض أسماء الملفات المألوفة للمستخدمين واستخدام معرفات المهام المستقلة ومعرفات الملفات داخليًا.

الهوية الوثائقية الواضحة تجلب الفوائد التالية:

  • عند فشل إعادة المحاولة، يمكن أن تتوافق بدقة مع المهمة الأصلية.
  • يمكن أن يتوافق تنزيل مخطوطة الترجمة والمراجعة اللاحقة مع الملف الصحيح.
  • تقليل مخاطر معالجة ملف شخص آخر بنفس اسم النتيجة الحالية.

🎯 ما هي الطريقة المناسبة لك؟

إذا كنت بحاجة لعرض اسم الملف

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

إذا كنت بحاجة إلى حفظ الملف الذي تم تحميله

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

إذا كنت تستخدم تخزين الكائنات

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

❓ الأسئلة الشائعة (الأسئلة الشائعة)

1. إذا تمت إزالة الشرطة المائلة، فهل سيكون اسم الملف آمنًا؟

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

2. فقط لأن الامتداد PDF، هل يعني ذلك أنه PDF؟

لا أستطيع. يمكن تزوير الامتدادات وتتطلب اكتشاف المحتوى وتحليله.

3. ماذا علي أن أفعل إذا كان اسم العرض يحتوي على HTML؟

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

4. بعد استخدام معرف فريد، هل ما زلت بحاجة إلى تعطيل الكتابة الفوقية؟

يحتاج. لا يعني المعرف الفريد أنه يمكن تجاهل سياسة "عدم التجاوز".

📝 ملخص

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

جربه الآن: قم بتحميل المستند لبدء الترجمة، مع الاحتفاظ بالتخطيط الأصلي

المراجع: Python pathlib

تاريخ التحديث: 2026-11-15