🌊 تثبيت SeaweedFS — خادم التخزين الكائني الموزع والمتوافق مع Amazon S3 على Docker
نشر خادم SeaweedFS على Ubuntu باستخدام Docker — نظام التخزين الكائني الموزع فائق السرعة المتوافق مع بروتوكول Amazon S3 API مع لوحة Master على المنفذ 9334 ومعمارية Haystack لمعالجة مليارات الملفات.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/seaweedfs/seaweedfs-ubuntu.sh
chmod +x seaweedfs-ubuntu.sh
sudo bash seaweedfs-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/seaweedfs/seaweedfs-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x seaweedfs-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للبيانات (`./data`) وتشغيل حاوية SeaweedFS مع تفعيل واجهة S3 API على المنفذ 8333 ولوحة تحكم Master على المنفذ 9334 (المحول من 9333).
sudo bash seaweedfs-ubuntu.sh
4 التحقق من لوحة Master واختبار رفع ملفات S3
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:9334 لمراجعة حالة الخادم الرئيسي وسعة وحدات التخزين، واختبر إنشاء حاويات S3 ورفع الملفات عبر AWS CLI أو MinIO Client على المنفذ 8333.
http://<your-server-ip>:9334
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8333 | S3-compatible API — ⚠️ anonymous access, no credentials configured |
| 9334 | Master UI (host → container 9333) — no authentication |
| ./data | Volume files, filer metadata, and indexes |
نظرة عامة
تعد SeaweedFS منصة تخزين كائني موزعة (Distributed Object Storage) ونظام ملفات سحابياً مفتوح المصدر فائق الأداء. تم استلهام تصميمها من أوراق أبحاث فيسبوك Haystack ونظام ملفات جوجل GFS، لتتمكن من إدارة وتخزين مليارات الملفات الصغيرة مع سرعة قراءة فورية في عملية قرص واحدة O(1) والتوسع لاستيعاب بيتابايت من الملفات الضخمة. تعمل المنصة عبر المنفذ 8333 (لواجهة S3 REST API) والمنفذ 9334 (للوحة تحكم Master)، وتوفر توافقاً تاماً مع واجهات Amazon S3 API، وتثبيت أقراص POSIX FUSE، ودعم WebDAV، مع التوزيع الجغرافي الآلي.
لماذا تستخدمه
تتسم أنظمة التخزين الموزعة التقليدية (مثل Ceph) بتعقيد تشغيلي هائل، بينما أصبحت الحلول الأخرى مثل MinIO أكثر استهلاكاً للموارد عند تخزين مليارات الصور المصغرة والملفات الصغيرة. تحل SeaweedFS 'مشكلة الملفات الصغيرة' بدمج الملفات المتعددة داخل ملفات كتل ضخمة مع الاحتفاظ بفهارس البيانات في الذاكرة العشوائية، لتسترجع أي ملف في خطوة بحث فيزيائية واحدة وبأقل استهلاك ممكن للرام والمعالج.
متى تحتاجه
- تحتاج إلى مساحة تخزين كائني متوافقة مع Amazon S3 ومستضافة ذاتياً لنسخك الاحتياطية وتطبيقاتك البرمجية
- تخزن مليارات الملفات الصغيرة (الصور، الصور المصغرة، المستندات، سجلات IoT) وتحتاج لأقصى سرعة قراءة O(1)
- تبحث عن بديل مفتوح المصدر وخفيف جداً على الموارد لـ MinIO أو Ceph على سيرفرات Ubuntu
- تريد إمكانية توصيل مجلدات التخزين كنظام ملفات محلي بنظام FUSE أو عبر WebDAV بجانب حاويات S3
- تحتاج إلى عنقود تخزين سحابي يتوسع أفقياً عبر عدة سيرفرات مع التكرار وحماية البيانات
من يحتاجه
- مهندسو البرمجيات ومطورو النظم لتوفير مساحة S3 لتطبيقات الويب وسجلات Docker ومواقع الميديا
- فرق الـ DevOps لتهيئة وجهات تخزين نسخ احتياطي مركزية لأدوات restic وBorg وVelero
- منصات الميديا والمتاجر الإلكترونية لتخزين وعرض ملايين صور المنتجات للمستخدمين بسرعة فائقة
- مطورو الذكاء الاصطناعي وعلوم البيانات لتخزين مجموعات بيانات التدريب الكبيرة ونقاط حفظ النماذج
- أصحاب السيرفرات المنزلية لبناء خزان تخزين كائني S3 موحد وشامل على سيرفرات لينكس
حالات الاستخدام الشائعة
- توفير حاوية S3 خاصة (`s3.yourdomain.com`) على المنفذ 8333 لنسخ قواعد البيانات تلقائياً عبر restic
- تخزين وعرض ملايين صور المنتجات لمتاجر Saleor أو WordPress مع استرجاع سريع في أجزاء من الثانية
- ربط مرفقات ملفات Nextcloud أو Seafile أو Ghost CMS بمساحة تخزين SeaweedFS S3
- توصيل مجلدات التخزين الموزعة مباشرة على نظام لينكس عبر أمر `weed mount` للتعامل معها كقرص محلي
- تكرار كتل البيانات تلقائياً عبر عدة أقراص صلبة وخوادم جغرافية متباعدة لضمان عدم فقدان البيانات
الميزات الرئيسية
- توافق تام مع Amazon S3 API: دعم كافة أدوات AWS SDKs وMinIO Client (mc) وS3cmd على المنفذ 8333
- معمارية Haystack المتقدمة: دمج الملفات الصغيرة داخل كتل تخزين مع قراءة فورية في عملية قرص واحدة O(1)
- لوحة تحكم Master ويب على المنفذ 9334: مراقبة بصرية لسيرفرات التخزين، ومساحة الأقراص، والبيانات الوصفية
- تعدد بروتوكولات الوصول: الوصول للملفات عبر S3 REST API أو WebDAV أو واجهة HTTP أو تثبيت FUSE المحلي
- التخزين المرحلي (Tiering): إمكانية الترحيل التلقائي للبيانات القديمة غير النشطة إلى مساحات سحابية خارجية
- ملف تنفيذي فائق الخفة مكتوب بـ Go: استهلاك ضئيل جداً للذاكرة العشوائية وسرعة معالجة استثنائية
- مستويات تكرار قابلة للتخصيص: تحديد مستويات التكرار (مثل `001` لتكرار البيانات على كبائن تخزين مختلفة)
- نشر منظم عبر Docker مع ربط مجلد `./data` لحفظ بيانات Master وفهارس Filer وكتل الملفات
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:9334 لعرض لوحة تحكم SeaweedFS Master
- تحقق من حالة الخادم الرئيسي وسيرفرات التخزين المتصلة وسعة الأقراص الحرة المتاحة
- أعد تهيئة أداة AWS CLI على حاسوبك: `aws configure --profile seaweedfs` واضبط الرابط على `http://ip-سيرفرك:8333`
- أنشئ حاوية S3 تجريبية: `aws --endpoint-url http://ip-سيرفرك:8333 s3 mb s3://my-test-bucket`
- ارفع ملفاً تجريبياً: `aws --endpoint-url http://ip-سيرفرك:8333 s3 cp test.txt s3://my-test-bucket/`
- ضع واجهة S3 ولوحة Master خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- اضبط مفاتيح الدخول والأمان في ملف `s3_config.json` داخل مسار `./data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: المنافذ الافتراضية تعمل بدون مصادقة؛ احرص على تهيئة مفاتيح الدخول (`s3_config.json`) قبل الإنتاج
- لا تكشف لوحة Master (منفذ 9334) أو منفذ Filer للإنترنت العام نهائياً؛ واقصرها على الشبكة المحلية أو VPN
- ضع واجهة S3 API (منفذ 8333) خلف وكيل عكسي مشفر بـ HTTPS لتأمين نقل البيانات والتوكنات
- احمِ مجلد البيانات `./data` الذي يحتوي على كتل التخزين بصلاحيات نظام مناسبة بالسيرفر
- افرض سياسات وصول دقيقة ومفاتيح وصول مستقلة لكل تطبيق يتصل بمساحة التخزين
- حدّث صورة الحاوية دورياً للحصول على أحدث التحسينات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يستخدم SeaweedFS منفذ TCP 8333 لواجهة S3 API، ومنفذ TCP 9334 (المحول من 9333 الداخلي) للوحة Master، ومنفذ TCP 8888 لواجهة Filer/WebDAV. يجب السماح بالمنفذ 8333 في جدار الحماية للشبكة الداخلية الموثوقة (`ufw allow 8333/tcp`). وفي الإنتاج، وجه حركة S3 عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 وأبقِ المنفذ 9334 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./data` احتياطياً، والذي يحتوي على فهارس Filer والبيانات الوصفية وكتل التخزين
- احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على مسارات التخزين والمنافذ
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية وتشغيل أمر `weed fix` للتأكد من سلامة الفهارس
الأخطاء الشائعة
- التشغيل في بيئة الإنتاج بالسماح بالوصول المجهول بدون إنشاء مفاتيح أمان في `s3_config.json`
- كشف لوحة التحكم Master (منفذ 9334) للإنترنت العام مما يتيح للغرباء فحص هيكل وسعة التخزين
- التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL لمعاملات S3
- عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان الحاويات والكائنات عند تحديث الحاوية
- تخصيص مساحة قرص غير كافية لحجز كتل التخزين المسبقة (يقوم البرنامج بحجز كتل بحجم 32 جيجابايت)
استكشاف الأخطاء وإصلاحها
- أداة AWS CLI تظهر خطأ في الوصول — تأكد من كتابة المنفذ `8333` في الرابط ومطابقة مفاتيح الدخول
- لوحة Master لا تفتح على المنفذ 9334 — افحص سجلات الحاوية بالأمر: `docker logs seaweedfs -f`
- سيرفر التخزين يظهر 'Disk Full' — تأكد من توفر مساحة حرة لا تقل عن 32 جيجابايت على القرص لحجز الكتل الجديدة
- فشل إنشاء حاويات S3 — تأكد من تفعيل خدمة Filer في أمر التشغيل (`weed server -s3 -filer`)
- بطء سرعة الرفع — تأكد من تشغيل الحاوية على أقراص NVMe/SSD سريعة وتجنب الأقراص الشبكية البطيئة
البدائل
منصة MinIO الشهيرة للتخزين الكائني S3 المكتوبة بـ Go. منظومة Ceph (RGW) للمؤسسات الكبرى. مشروع Garage للتخزين السحابي الموزع. منصة OpenIO. خدمة Amazon S3 السحابية التجارية.
متى لا تستخدمه
تجنب استخدام SeaweedFS إذا كنت تبحث فقط عن برنامج مزامنة ومشاركة ملفات شخصي بسيط مع برامج سطح مكتب للمستخدمين (حيث صُممت Seafile أو Nextcloud لتعاون المستخدمين النهائيين). وإذا كنت تحتاج لنظام تخزين كتل متقدم (Block Storage / iSCSI) لخوادم Proxmox الافتراضية، فإن Ceph أكثر تخصصاً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي منصة SeaweedFS وكيف تقارن بـ MinIO؟
تعد SeaweedFS منصة تخزين كائني ونظام ملفات موزع. ورغم أن كلاهما يوفر واجهات S3، تتميز SeaweedFS بمعمارية Haystack التي تتيح لها تخزين مليارات الملفات الصغيرة مع سرعة قراءة فورية في خطوة قرص واحدة O(1) واستهلاك ذاكرة أقل بكثير من MinIO.
هل يمكن استخدام SeaweedFS مع أدوات AWS CLI ومكتبات S3؟
نعم! توفر SeaweedFS توافقاً كاملاً مع بروتوكول Amazon S3 API عبر المنفذ 8333، مما يتيح لك استخدام AWS CLI وMinIO Client (`mc`) ومكتبات بايثون (Boto3) بتحديد رابط الـ endpoint المخصص.
هل يدعم SeaweedFS التوصيل كقرص محلي في نظام لينكس؟
نعم! يمكنك توصيل مجلدات SeaweedFS مباشرة في نظام ملفات لينكس كدليل POSIX أصلي باستخدام أمر `weed mount` وتقنية FUSE.
كيف تعالج SeaweedFS الملفات الصغيرة بكفاءة فائقة؟
تقوم SeaweedFS بدمج الملفات الصغيرة داخل كتل تخزين مجمعة بحجم 32 جيجابايت مع تخزين فهارس المواقع في الذاكرة العشوائية، مما يتيح قراءة أي ملف في عملية قرص واحدة دون إجهاد نظام الملفات.
كم تستهلك SeaweedFS من الذاكرة العشوائية (RAM)؟
تم تطوير SeaweedFS بلغة Go وهي فائقة الخفة، حيث تستهلك عادة ما بين 50 إلى 150 ميجابايت فقط من الذاكرة العشوائية داخل Docker في النشر الفردي.