#pkg: "@nocobase/plugin-file-storage-s3-pro"

#تخزين الملفات: S3 (Pro)

#مقدمة

بناءً على إضافة إدارة الملفات، يضيف هذا الإصدار دعمًا لأنواع تخزين الملفات المتوافقة مع بروتوكول S3. يمكن دمج أي خدمة تخزين كائنات تدعم بروتوكول S3 بسهولة، مثل Amazon S3 و Alibaba Cloud OSS و Tencent Cloud COS و MinIO و Cloudflare R2 وغيرها، مما يعزز توافق ومرونة خدمات التخزين.

#الميزات

1. الرفع من جانب العميل: تُرفع الملفات مباشرة إلى خدمة التخزين دون المرور بخادم NocoBase، مما يوفر تجربة رفع أكثر كفاءة وسرعة.
2. الوصول الخاص: جميع عناوين URL للملفات هي عناوين مؤقتة وموقعة للتخويل، مما يضمن أمان الوصول إلى الملفات ومحدودية صلاحيتها.

#حالات الاستخدام

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

#إعدادات الإضافة

1. قم بتمكين إضافة plugin-file-storage-s3-pro.
2. انتقل إلى "Setting -> FileManager" للوصول إلى إعدادات إدارة الملفات.
3. انقر على زر "Add new" واختر "S3 Pro".

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

#إعدادات مزود الخدمة

#Amazon S3

#إنشاء Bucket

1. انتقل إلى وحدة تحكم Amazon S3.
2. انقر على زر "Create bucket" في الجانب الأيمن.

3. املأ Bucket Name (اسم الحاوية)، واترك الحقول الأخرى كإعدادات افتراضية، ثم مرر إلى الأسفل، وانقر على زر "Create" لإكمال العملية.

#إعدادات CORS

1. في قائمة الحاويات (buckets)، ابحث عن الحاوية التي أنشأتها للتو وانقر عليها للوصول إلى تفاصيلها.

2. انتقل إلى علامة التبويب "Permission" ومرر إلى الأسفل للعثور على قسم إعدادات CORS.

3. أدخل الإعدادات التالية (يمكن تخصيصها حسب الحاجة) ثم احفظها.

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

#استرجاع AccessKey و SecretAccessKey

1. انقر على زر "Security credentials" في الزاوية العلوية اليمنى من الصفحة.

2. مرر إلى الأسفل، وابحث عن قسم "Access Keys"، ثم انقر على زر "Create Access Key".

3. وافق على الشروط (يُنصح باستخدام IAM لبيئات الإنتاج).

4. احفظ Access Key و Secret Access Key المعروضين في الصفحة.

#استرجاع المعلمات وإعدادها

1. استخدم AccessKey ID و AccessKey Secret التي حصلت عليها في الخطوة السابقة، وتأكد من إدخالها بدقة.
2. انتقل إلى لوحة الخصائص (properties) في صفحة تفاصيل الحاوية (bucket)، حيث يمكنك الحصول على اسم الحاوية (Bucket Name) ومعلومات المنطقة (Region).

#الوصول العام (اختياري)

هذا إعداد اختياري. قم بتكوينه عندما تحتاج إلى جعل الملفات المرفوعة عامة بالكامل.

1. في لوحة الأذونات (Permissions)، مرر إلى "Object Ownership"، انقر على "Edit"، ثم قم بتمكين ACLs.

2. مرر إلى "Block public access"، انقر على "Edit"، ثم اضبطه للسماح بتحكم ACLs.

3. حدد "Public access" في NocoBase.

#إعدادات الصور المصغرة (اختياري)

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

1. انتقل إلى Dynamic Image Transformation for Amazon CloudFront.

2. انقر على زر Launch in the AWS Console في أسفل الصفحة لبدء النشر.

3. اتبع التعليمات لإكمال الإعدادات. تتطلب الخيارات التالية اهتمامًا خاصًا:

   1. عند إنشاء المكدس (stack)، تحتاج إلى تحديد اسم حاوية Amazon S3 التي تحتوي على الصور المصدر. يرجى إدخال اسم الحاوية الذي أنشأته سابقًا.
   2. إذا اخترت نشر واجهة المستخدم التجريبية (demo UI)، فبعد النشر، يمكنك استخدام الواجهة لاختبار وظيفة معالجة الصور. في وحدة تحكم AWS CloudFormation، حدد المكدس الخاص بك، انتقل إلى علامة التبويب "Outputs"، ابحث عن القيمة المقابلة لمفتاح DemoUrl، وانقر على الرابط لفتح واجهة العرض التوضيحي.
   3. يستخدم هذا الحل مكتبة sharp Node.js لمعالجة الصور بكفاءة. يمكنك تنزيل الكود المصدري من مستودع GitHub وتخصيصه حسب الحاجة.

   

   

4. بعد اكتمال الإعدادات، انتظر حتى يتغير حالة النشر إلى CREATE_COMPLETE.

5. في إعدادات NocoBase، يرجى ملاحظة ما يلي:

   1. Thumbnail rule: املأ معلمات معالجة الصور ذات الصلة، مثل ?width=100. للحصول على التفاصيل، ارجع إلى وثائق AWS.
   2. Access endpoint: أدخل القيمة من Outputs -> ApiEndpoint بعد النشر.
   3. Full access URL style: يجب تحديد Ignore (لأن اسم الحاوية قد تم ملؤه بالفعل في الإعدادات، ولن تكون هناك حاجة إليه عند الوصول).

   

#مثال على الإعدادات

#Alibaba Cloud OSS

#إنشاء Bucket

1. افتح وحدة تحكم OSS.

2. حدد "Buckets" من القائمة اليسرى وانقر على زر "Create Bucket" لبدء إنشاء الحاوية.

3. املأ تفاصيل الحاوية ثم انقر على زر "Create".
   • Bucket Name: اختر اسمًا يناسب احتياجات عملك.
   • Region: حدد المنطقة الأقرب لمستخدميك.
   • يمكن أن تظل الإعدادات الأخرى افتراضية أو تُخصص حسب الحاجة.

#إعدادات CORS

1. انتقل إلى صفحة تفاصيل الحاوية (bucket) التي أنشأتها في الخطوة السابقة.

2. انقر على "Content Security -> CORS" في القائمة الوسطى.

3. انقر على زر "Create Rule"، املأ الحقول ذات الصلة، مرر إلى الأسفل ثم انقر على "OK". يمكنك الرجوع إلى لقطة الشاشة أدناه أو إجراء إعدادات أكثر تفصيلاً.

#استرجاع AccessKey و SecretAccessKey

1. انقر على "AccessKey" أسفل صورة ملفك الشخصي في الزاوية العلوية اليمنى.

2. لأغراض العرض التوضيحي، سنقوم بإنشاء AccessKey باستخدام الحساب الرئيسي. في بيئة الإنتاج، يُنصح باستخدام RAM لإنشاء AccessKey. للحصول على التعليمات، يرجى الرجوع إلى وثائق Alibaba Cloud.

3. انقر على زر "Create AccessKey".

4. أكمل عملية التحقق من الحساب.

5. احفظ Access Key و Secret Access Key المعروضين في الصفحة.

#استرجاع المعلمات وإعدادها

1. استخدم AccessKey ID و AccessKey Secret التي حصلت عليها في الخطوة السابقة.
2. انتقل إلى صفحة تفاصيل الحاوية (bucket) للحصول على اسم Bucket.

3. مرر إلى الأسفل للحصول على Region (لا يلزم الجزء ".aliyuncs.com" اللاحق).

4. احصل على عنوان نقطة النهاية (endpoint)، وعند إدخاله في NocoBase، ستحتاج إلى إضافة البادئة https://.

#إعدادات الصور المصغرة (اختياري)

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

1. املأ المعلمات ذات الصلة لـ Thumbnail rule. للحصول على إعدادات المعلمات المحددة، ارجع إلى وثائق Alibaba Cloud حول معالجة الصور.

2. اجعل إعدادات Full upload URL style و Full access URL style متطابقة.

#مثال على الإعدادات

#MinIO

#إنشاء Bucket

1. انقر على قائمة Buckets في الجانب الأيسر -> انقر على Create Bucket لفتح صفحة الإنشاء.
2. بعد إدخال اسم Bucket، انقر على زر Save.

#استرجاع AccessKey و SecretAccessKey

1. انتقل إلى Access Keys -> انقر على زر Create access key لفتح صفحة الإنشاء.

2. انقر على زر Save.

3. احفظ Access Key و Secret Key من النافذة المنبثقة لاستخدامهما في الإعدادات اللاحقة.

#إعدادات المعلمات

1. انتقل إلى صفحة File manager في NocoBase.
2. انقر على زر Add new واختر S3 Pro.
3. املأ النموذج:
   • AccessKey ID و AccessKey Secret: استخدم القيم المحفوظة من الخطوة السابقة.
   • Region: لا يمتلك MinIO المنشور بشكل خاص مفهوم المنطقة (Region)؛ يمكنك ضبطه على "auto".
   • Endpoint: أدخل اسم النطاق أو عنوان IP لخدمتك المنشورة.
   • يجب تعيين Full access URL style إلى Path-Style.

#مثال على الإعدادات

#Tencent COS

يمكنك الرجوع إلى إعدادات خدمات الملفات المذكورة أعلاه. المنطق متشابه.

#مثال على الإعدادات

#Cloudflare R2

يمكنك الرجوع إلى إعدادات خدمات الملفات المذكورة أعلاه. المنطق متشابه.

#مثال على الإعدادات

#دليل المستخدم

ارجع إلى وثائق إضافة إدارة الملفات.