🖨️ تثبيت Manyfold — نظّم مكتبة نماذجك ثلاثية الأبعاد
انشر Manyfold على Ubuntu بـ Docker — حوّل مجلد تنزيلات STL الفوضوي إلى مكتبة قابلة للتصفح والبحث مع معاينات وعلامات ومعلومات المصمم، على المنفذ 3214.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/3d-printing/manyfold/manyfold-ubuntu.sh
chmod +x manyfold-ubuntu.sh
sudo bash manyfold-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/3d-printing/manyfold/manyfold-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x manyfold-ubuntu.sh
3 تشغيل المثبت
يثبّت السكريبت Docker إن لزم الأمر ويشغّل Manyfold مع قاعدة بيانات PostgreSQL الخاصة به وRedis على المنفذ 3214. يولّد مفتاح سر (secret key base) وكلمة مرور لقاعدة البيانات، ويربط مجلد libraries حيث تعيش ملفات نماذجك.
sudo bash manyfold-ubuntu.sh
4 فتح واجهة الويب والتسجيل
ضع مجلدات STL الخاصة بك داخل دليل libraries، ثم افتح Manyfold وسجّل أول مستخدم — هذا الحساب يصبح المسؤول:
http://<your-server-ip>:3214
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3214 | Web UI — first user to register becomes admin |
| ./libraries | Your STL folders — indexed in place, never moved |
| PostgreSQL + Redis | Internal — metadata and background scan/preview jobs |
نظرة عامة
Manyfold هو مدير أصول رقمية ذاتي الاستضافة مصمم خصيصاً لملفات الطباعة ثلاثية الأبعاد. بدلاً من ترك مجلد تنزيلات STL وOBJ و3MF في فوضى، يفحص Manyfold مكتبتك، ويعرض معاينات ثلاثية الأبعاد لكل نموذج، ويحوّلها إلى كتالوج قابل للبحث والوسم — مع توثيق للمصمم وتتبع للترخيص ومجموعات. يعمل على Ruby on Rails مع PostgreSQL لتخزين البيانات الوصفية ومهام خلفية مدعومة بـ Redis للفحص وعرض المعاينات، ولا يحرّك أو ينسخ ملفاتك الأصلية أبداً — بل يفهرسها في مكانها.
لماذا تستخدمه
إذا كنت تُنزّل نماذج ثلاثية الأبعاد من Thingiverse أو Printables أو MakerWorld أو مصممين على Patreon، فمكتبتك تنمو بسرعة وتصبح أسماء الملفات وحدها غير كافية. يمنح Manyfold كل نموذج صورة معاينة ثلاثية الأبعاد مُصيَّرة، ويتيح لك وسم الملفات وتجميعها في مجموعات، ويتتبع من صمم كل نموذج وتحت أي ترخيص — وهو ما لا يفعله أي متصفح ملفات عام أو برنامج NAS. ولأنه ذاتي الاستضافة ومفتوح المصدر (AGPL-3.0)، تبقى كتالوجاتك تحت سيطرتك الكاملة، ويمكن لـ Manyfold اختيارياً الاتحاد عبر ActivityPub لمشاركة أجزاء من مكتبتك — أو متابعة مكتبات الآخرين — عبر الفديفرس الأوسع.
متى تحتاجه
- مجلد تنزيلات STL/OBJ/3MF لديك تحوّل إلى مئات أو آلاف الملفات بدون تسمية أو تنظيم متسق
- تحتاج للعثور على نموذج معين مرة أخرى بعد أسابيع من تنزيله، دون تذكر اسم الملف بالضبط
- تريد تتبع من صمم كل نموذج وتحت أي ترخيص صدر، خاصة للنماذج التي قد تعيد طباعتها أو تشاركها
- تدير إعداد طباعة ثلاثية الأبعاد منزلياً أو مساحة صنع أو مزرعة طباعة صغيرة وتحتاج كتالوجاً مشتركاً وقابلاً للبحث بدلاً من شجرة مجلدات مسطحة
- تريد تصفح ومعاينة النماذج بثلاثية الأبعاد قبل التقطيع، بدلاً من فتح كل ملف على حدة في برنامج التقطيع
من يحتاجه
- هواة الطباعة ثلاثية الأبعاد أصحاب المكتبات الشخصية الكبيرة من النماذج المُنزّلة والمصمَّمة
- مساحات الصنع والمدارس التي تحافظ على كتالوج مشترك من النماذج للأعضاء أو الطلاب
- مزارع الطباعة الصغيرة ومشغلو الطباعة عند الطلب الذين يحتاجون تحديد النموذج الصحيح وشروط ترخيصه بسرعة
- المصممون الذين يريدون فهرسة ملفات STL الخاصة بهم إلى جانب ملفات مرجعية وملفات العملاء
- عشاق الاستضافة الذاتية الذين يُشغّلون مختبراً منزلياً بالفعل ويريدون إدارة النماذج ثلاثية الأبعاد إلى جانب خدماتهم الأخرى
- الجامعون الذين يُنزّلون بكثافة من Thingiverse وPrintables وMakerWorld ويحتاجون مكاناً قابلاً للبحث لكل ذلك
حالات الاستخدام الشائعة
- فحص مجلد مكتبة والحصول على معاينات ثلاثية الأبعاد مُصيَّرة لكل نموذج تلقائياً
- وسم النماذج حسب الطابعة أو المادة أو المشروع أو الحالة (مطبوع، غير مُختبر، يحتاج دعامات)
- تجميع النماذج متعددة الأجزاء — مثل تمثال مصغّر مع قاعدة منفصلة — في مدخل كتالوج واحد
- تسجيل المصمم الأصلي والترخيص لكل نموذج مُنزّل للبقاء ملتزماً عند إعادة الطباعة أو المشاركة
- البحث والتصفية في مكتبة من آلاف الملفات في ثوانٍ بدلاً من التمرير عبر المجلدات
- مشاركة مجموعات مختارة علناً أو بشكل خاص أو مع مثيلات Manyfold أخرى عبر الفديفرس
الميزات الرئيسية
- عرض معاينة ثلاثية الأبعاد تلقائي للنماذج المفحوصة باستخدام عارض Three.js داخل المتصفح
- الوسم والمجموعات والبيانات الوصفية للمصمم والترخيص لتنظيم المكتبات الكبيرة
- فهرسة في المكان — يقرأ Manyfold ملفاتك من مجلد libraries المربوط دون تحريكها أو تكرارها
- اتحاد ActivityPub اختياري لمشاركة أو متابعة المكتبات عبر مثيلات Manyfold الأخرى على الفديفرس
- إعادة تنظيم تلقائية للملفات على القرص بناءً على الوسوم أو البيانات الوصفية، مع قواعد تسمية قابلة للتخصيص
- كشف المشكلات مثل الملفات المكررة والأرشيفات المتداخلة والصيغ غير الفعالة داخل مكتبتك
- دعم متعدد المستخدمين — أول حساب يسجّل يصبح المسؤول
كيفية الاستخدام بعد التثبيت
- سجّل أول حساب مستخدم فور الانتهاء من الإعداد — يصبح تلقائياً حساب المسؤول
- انسخ أو اربط مجلدات STL وOBJ و3MF الخاصة بك داخل دليل libraries المربوط ليتمكن Manyfold من فهرستها
- شغّل فحص المكتبة وانتظر انتهاء عرض المعاينات — المجموعات الكبيرة قد تستغرق وقتاً في المرة الأولى
- أضف وسوماً وأسماء مصممين ومعلومات ترخيص للنماذج أثناء التصفح، أو دع Manyfold يلتقط البيانات الوصفية المضمنة عند توفرها
- اجمع الملفات المرتبطة (مثل أجزاء منفصلة لنموذج واحد قابل للطباعة) في مدخل نموذج واحد لتصفح أنظف
- ادعُ مستخدمين إضافيين من إعدادات المسؤول إذا كنت تشارك المكتبة مع أفراد الأسرة أو فريق
أفضل ممارسات الأمان
- أغلق التسجيل العام بعد إنشاء حساب المسؤول، لأن Manyfold لا يملك قائمة موافقة مدمجة افتراضياً وأول مسجَّل يصبح مسؤولاً
- ضع Manyfold خلف وكيل عكسي مع HTTPS قبل كشفه خارج شبكتك المحلية
- لا تكشف منفذي PostgreSQL أو Redis الداخليين للإنترنت أبداً — يجب أن يكونا قابلين للوصول فقط من حاوية Manyfold
- عيّن مفتاح سر وكلمة مرور قاعدة بيانات قويين وفريدين — السكريبت يولّدهما تلقائياً، فحافظ عليهما بأمان
- استخدم VPN أو وكيلاً عكسياً مع مصادقة إذا أردت الوصول لمكتبتك عن بُعد دون كشفها للعامة
- حافظ على تحديث صورة Manyfold Docker لتحصل على تصحيحات الأمان لتطبيق Rails وتبعياته
المنافذ وإعدادات جدار الحماية
تستمع واجهة Manyfold على المنفذ 3214، وهو المنفذ الوحيد الذي يحتاج أن يكون متاحاً لاستخدام التطبيق. يعمل PostgreSQL وRedis كحاويات داخلية على منفذيهما الافتراضيين (5432 و6379) ويجب ألا يُكشفا للشبكة أبداً — يحتاجان فقط أن يكونا متاحين من حاويتي الويب والعامل الخاصتين بـ Manyfold. إذا أردت الوصول لمكتبتك من خارج شبكتك المنزلية، ضع المنفذ 3214 خلف وكيل عكسي مثل Nginx Proxy Manager مع شهادة TLS صالحة بدلاً من تحويله مباشرة، وفكّر في تقييد الوصول بـ VPN إذا كانت المكتبة تحتوي نماذج لا تريد أن تكون قابلة للاكتشاف علنياً.
النسخ الاحتياطي والصيانة
- انسخ قاعدة بيانات PostgreSQL احتياطياً بانتظام باستخدام pg_dump — تحتوي كل وسومك ومجموعاتك وتوثيق المصممين والتراخيص
- انسخ مجلد مكتبة STL/OBJ/3MF الأصلية احتياطياً بشكل منفصل — Manyfold يفهرس الملفات لكن المجلد نفسه هو بياناتك الأساسية
- احفظ docker-compose.yml ومفتاح السر/كلمة مرور قاعدة البيانات المولّدَين لتتمكن من إعادة إنشاء نفس الإعداد بالضبط بعد الترحيل
- بيانات Redis قابلة للتخلص منها — تحتوي فقط طوابير المهام والتخزين المؤقت، فلا تحتاج أن تكون جزءاً من روتين النسخ الاحتياطي
- اختبر الاستعادة دورياً بتشغيل نسخة من الحزمة والتأكد من عودة الوسوم والمعاينات والمجموعات بشكل صحيح
- خزّن النسخ الاحتياطية على قرص مختلف عن مكتبة نماذجك، خاصة إذا كانت المكتبة كبيرة ولا يمكن تعويضها
الأخطاء الشائعة
- ترك التسجيل العام مفتوحاً بعد الإعداد، مما يسمح لغريب بالتسجيل والحصول على وصول محتمل بمستوى المسؤول
- توجيه حجم libraries إلى دليل مؤقت أو يُمسح بشكل متكرر، مما يكسر الفهرس مع كل إعادة تشغيل
- كشف منفذي PostgreSQL أو Redis مباشرة للإنترنت بدلاً من إبقائهما داخليين على شبكة Docker
- توقع فحص فوري للمكتبة — المجموعات الكبيرة تحتاج وقتاً لعرض معاينات كل نموذج في الخلفية
- تشغيل الحاوية بمستخدم لا يملك صلاحية القراءة/الكتابة على مجلد libraries المربوط، مما يسبب فشل الفحص
- نسيان النسخ الاحتياطي لقاعدة بيانات PostgreSQL، ثم فقدان كل الوسوم وتنظيم المجموعات بعد عطل في السيرفر
استكشاف الأخطاء وإصلاحها
- فحص المكتبة يبدو عالقاً — تحقق من سجلات عامل Sidekiq/Redis؛ المكتبات الكبيرة ذات الملفات الكثيرة قد تستغرق وقتاً طويلاً للمعالجة الكاملة
- المعاينات لا تُعرض — تأكد أن ملف النموذج غير تالف وتحقق من سجلات حاوية العامل بحثاً عن أخطاء العرض
- لا يمكن تسجيل الدخول أو فقدت حساب المسؤول — استخدم وحدة تحكم Rails داخل الحاوية لإعادة تعيين كلمة مرور مستخدم
- الملفات الجديدة لا تظهر — شغّل فحصاً يدوياً من إعدادات المكتبة بدلاً من انتظار الاكتشاف التلقائي
- أخطاء رفض الإذن أثناء الفحص — أصلح ملكية/صلاحيات مجلد libraries المربوط على المضيف
- الحاوية لا تبدأ بعد تحديث — تحقق أولاً أن PostgreSQL وRedis سليمان، لأن Manyfold يعتمد على وصولهما
البدائل
لعدد قليل من الملفات، هيكل مجلدات منظّم جيداً يكفي وسيكون Manyfold مبالغة فيه. من البدائل ذاتية الاستضافة بتركيز مشابه، PrintStash وPrintventory أدوات مكتبة خاصة أخف وزناً، رغم أن أياً منهما لا يقدم اتحاد Manyfold أو إعادة التنظيم التلقائي للملفات. STLOrganizer وOrynt3D يغطيان أرضية مشابهة بمقايضات ميزات مختلفة. إذا كنت لا تريد الاستضافة الذاتية إطلاقاً، تتيح لك Thingiverse وPrintables وMakerWorld تنظيم المفضلات والمجموعات داخل منصاتها الخاصة، لكنك لا تتحكم في البيانات وهذا يعتمد على بقاء طرف ثالث متصلاً بالإنترنت. كخيار مفتوح المصدر بالكامل وذاتي الاستضافة مع وسم ومعاينات وتتبع ترخيص ومشاركة اختيارية عبر الفديفرس، Manyfold هو الخيار الأكمل المتاح اليوم.
متى لا تستخدمه
إذا كان لديك فقط عدد قليل من ملفات STL، فإن إعداد حزمة Manyfold من Rails وPostgreSQL وRedis عبء أكبر مما يستحق — مجلد جيد التسمية يكفي. Manyfold مدير مكتبة، وليس برنامج تقطيع أو متحكم مزرعة طباعة — لن يقطّع النماذج أو يرسل مهاماً لطابعتك، لذا ستظل تحتاج OctoPrint أو Klipper أو برنامج التقطيع المفضل لديك إلى جانبه لسير عمل الطباعة الفعلي. وإذا أردت خياراً بلا صيانة إطلاقاً ولا يهمك أن تعيش نماذجك على منصة شخص آخر، فتصفح المجموعات مباشرة على Thingiverse أو Printables يتجنب تشغيل سيرفر تماماً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Manyfold؟
إنه مدير مكتبة لملفات النماذج ثلاثية الأبعاد — أساساً ما يفعله سيرفر الوسائط للفيديو، لكن لمجموعة STL الخاصة بك. يفحص مجلدات نماذجك ويحوّلها إلى مكتبة قابلة للتصفح مع معاينات مُصيَّرة ووسم وبحث ومجموعات وتتبع للمصمم والترخيص، فيتحوّل مجلد تنزيلات فوضوي إلى كتالوج منظم وقابل للبحث.
ما المنفذ الذي يستخدمه وكيف أسجّل الدخول؟
يعمل Manyfold على المنفذ 3214 على المضيف. لا يوجد تسجيل دخول افتراضي — وضع تعدد المستخدمين مُفعّل وأول شخص يسجّل عبر واجهة الويب يصبح المسؤول.
هل ينقل أو ينسخ ملفات نماذجي؟
لا — يفهرس Manyfold ملفاتك في مكانها من مجلد libraries المربوط بدلاً من نقلها أو تكرارها. تضع مجلدات STL الخاصة بك في ذلك الدليل ويقرأها Manyfold من مكانها، ويبني قاعدة بيانات وصفية خاصة به إلى جانبها.
لماذا يحتاج PostgreSQL وRedis؟
يخزّن PostgreSQL البيانات الوصفية للمكتبة التي تبنيها — الوسوم والمجموعات ومعلومات المصمم والترخيص وفهرس نماذجك. يتعامل Redis مع المهام الخلفية مثل فحص المجلدات وعرض المعاينات، والتي تعمل بشكل غير متزامن حتى تبقى الواجهة سريعة الاستجابة أثناء معالجة مكتبة كبيرة.
لماذا يستغرق الفحص وقتاً طويلاً في البداية؟
الفحص الأولي يجب أن يقرأ كل ملف نموذج ويعرض صور معاينة له، وهذا مكلف حسابياً — مجموعة كبيرة قد تستغرق وقتاً طويلاً في التشغيل الأول. هذا أمر طبيعي، ويحدث في الخلفية عبر مهام مدعومة بـ Redis، لذا يمكنك تصفح ما تمت معالجته بالفعل.