إعدادات التخزين
تتحكم الإعدادات → متقدم → التخزين في مكان تخزين LeadHub للملفات المرفوعة — مرفقات العملاء المحتملين وصور الأفاتار وأرشيفات التصدير ورفوعات النماذج.
برامج تشغيل التخزين
| البرنامج | متى يُستخدم |
|---|---|
| محلي (نظام ملفات الخادم) | الافتراضي. تُخزَّن الملفات على قرص الخادم في storage/app/. مناسب للتثبيتات أحادية الخادم. |
| متوافق مع S3 | للنشر السحابي أو تسليم CDN أو عندما يكون قرص الخادم محدودًا. يدعم AWS S3 وDigitalOcean Spaces وMinIO وBackblaze B2 وCloudflare R2 وأي مزوّد متوافق مع S3. |
التخزين المحلي
هذا هو الافتراضي. لا يلزم تهيئة. تُخزَّن الملفات تحت:
/path/to/leadhub/storage/app/public/
يمكن الوصول إليها على https://yourdomain.com/storage/... عبر رابط التخزين الرمزي المُنشأ أثناء التثبيت.
التخزين المتوافق مع S3
الخطوة 1 — اختر مزوّدك
| المزوّد | الملاحظات |
|---|---|
| AWS S3 | الأكثر شيوعًا. اترك رابط Endpoint فارغًا. |
| DigitalOcean Spaces | Endpoint: https://nyc3.digitaloceanspaces.com (استبدل المنطقة) |
| MinIO (ذاتي الاستضافة) | Endpoint: رابط خادم MinIO الخاص بك |
| Backblaze B2 | Endpoint: https://s3.us-west-004.backblazeb2.com (يتفاوت حسب المنطقة) |
| Cloudflare R2 | Endpoint: https://ACCOUNT_ID.r2.cloudflarestorage.com |
الخطوة 2 — إنشاء حاوية (Bucket)
- في لوحة تحكم مزوّدك، أنشئ حاوية جديدة.
- عيّن الحاوية على عامة إذا أردت وصولًا عامًا مباشرًا للملفات المرفوعة (موصى به للأفاتار ومرفقات النماذج).
- لاحظ اسم الحاوية والمنطقة.
الخطوة 3 — إنشاء مفاتيح الوصول
ولّد معرّف مفتاح الوصول ومفتاح الوصول السري بصلاحيات قراءة/كتابة على الحاوية.
الخطوة 4 — التهيئة في LeadHub
-
انتقل إلى الإعدادات → متقدم → التخزين.
-
عيّن قرص التخزين على متوافق مع S3.
-
أدخل:
الحقل القيمة رابط Endpoint اتركه فارغًا لـ AWS S3. حدده لمزوّدين آخرين. اسم الحاوية اسم حاوياتك المنطقة رمز منطقة AWS أو منطقة المزوّد (مثل us-east-1،nyc3)معرّف مفتاح الوصول من الخطوة 3 مفتاح الوصول السري من الخطوة 3 (اتركه فارغًا للاحتفاظ بالسر المخزّن) -
انقر على اختبار الاتصال للتحقق قبل الحفظ.
-
انقر على حفظ الإعدادات.
اختبار الاتصال
انقر على اختبار الاتصال — يكتب LeadHub ملف اختبار صغير على قرص التخزين ويحذفه فورًا. إشعار ✅ يعني أن الاتصال يعمل. إشعار ❌ يُظهر الخطأ.
احر ص على الاختبار دائمًا قبل الحفظ — قد تُعطّل التهيئة غير الصحيحة رفوعات الملفات في مساحة العمل بأكملها.
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| "فشل اختبار الاتصال: تم رفض الوصول" | تحقق من أن مفتاح الوصول لديه صلاحيات الكتابة على الحاوية |
| الملفات غير متاحة للعموم | تأكد من أن الحاوية لها صلاحية قراءة عامة، أو هيّئ CDN |
| خطأ "NoSuchBucket" | تحقق من صحة اسم الحاوية والمنطقة |
| أخطاء رابط Endpoint | للمزوّدين غير AWS، تأكد من صحة رابط Endpoint وأنه يتضمن https:// |
| السر لا يُحفظ | اترك مفتاح الوصول السري فارغًا للاحتفاظ بالسر المخزّن الموجود |