🧵 تثبيت Spoolman — نظام إدارة وجرد بكرات خيوط الطباعة ثلاثية الأبعاد على Docker

نشر منصة Spoolman على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة لتتبع وإدارة بكرات خيوط الطباعة ثلاثية الأبعاد وحساب الأوزان المتبقية تلقائياً مع Klipper وMoonraker وOctoPrint على المنفذ 7912.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Spoolman على المنفذ 7912 مع تخزين البيانات الدائم وتوليد ملصقات QR والربط مع Moonraker جاهزاً.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/3d-printing/spoolman/spoolman-ubuntu.sh
chmod +x spoolman-ubuntu.sh
sudo bash spoolman-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/3d-printing/spoolman/spoolman-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x spoolman-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./data`) وتشغيل حاوية Spoolman الرسمية على المنفذ 7912 (المحول من 8000 الداخلي).

sudo bash spoolman-ubuntu.sh

4 إضافة البكرات والربط مع Moonraker / Mainsail

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:7912. أضف الشركات المصنعة والبكرات بألوانها وأوزانها، واربط رابط Spoolman في ملف `moonraker.conf` بطابعتك لخصم الاستهلاك آلياً.

http://<your-server-ip>:7912

المنافذ المستخدمة

المنفذالغرض
7912Web UI + API (host → container 8000)
No authenticationKeep it on a trusted LAN — anyone who reaches it can edit
./dataEmbedded database with your whole spool inventory

نظرة عامة

تعد Spoolman منصة عصرية ومفتوحة المصدر لإدارة وجرد وتتبع استهلاك بكرات خيوط الطباعة ثلاثية الأبعاد (3D Printing Filament). تعمل المنصة عبر المنفذ 7912 (المحول من 8000 الداخلي)، وتقوم بتنظيم وتصنيف البكرات حسب الشركات المصنعة، ونوع المادة (PLA وPETG وABS وASA وTPU وألياف الكربون)، وأكواد الألوان الدقيقة، وأسعار الشراء، والوزن المتبقي بالجرامات والأمتار. وتتكامل أصلياً مع أنظمة Klipper وMoonraker ولوحات Mainsail وFluidd وبرنامج OctoPrint لخصم وزن الخيوط المستهلكة تلقائياً في الوقت الفعلي أثناء تنفيذ مجسمات الطباعة.

لماذا تستخدمه

يؤدي تخمين ما إذا كانت بكرة الخيط المفتوحة كافية لإنهاء مجسم يستغرق 14 ساعة من الطباعة إلى نفاد الخيط منتصف العمل وتلف المجسمات وهدر الوقت والمواد. يحسب Spoolman الوزن المتبقي بالجرام بدقة متناهية: حيث يمكنك طباعة ملصقات QR ولصقها على البكرات، وتحديد البكرة النشطة في Mainsail أو Fluidd قبل الضغط على أمر الطباعة، لتقوم الطابعة بخصم الجرامات المستهلكة آلياً.

متى تحتاجه

  • تمتلك طابعة ثلاثية الأبعاد أو أكثر وتريد سجلاً رقمياً دقيقاً لكافة بكرات الخيوط المفتوحة والمغلقة
  • تريد أن يقوم نظام Klipper / Moonraker بخصم وزن الخيط المستهلك في كل طباعة تلقائياً بدون تدخل يدوي
  • تريد تفادي نفاد الخيط أثناء الطباعة بالتحقق من الوزن المتبقي ومطابقته مع تقدير برنامج التقطيع (Slicer)
  • تدير ورشة أو مزرعة طابعات ثلاثية الأبعاد وتريد تتبع تكلفة المواد وأرقام التشغيلات وإعادة الطلب
  • تريد طباعة ملصقات رموز QR ولصقها على البكرات الفيزيائية لمسحها بكاميرا الهاتف وتحديثها فورياً

من يحتاجه

  • هواة وصناع الطباعة ثلاثية الأبعاد الذين يمتلكون عشرات البكرات المفتوحة بمختلف الألوان والمواد
  • أصحاب مزارع وورش الطباعة التجارية لحساب التكلفة الفعلية للمجسمات ومتابعة استهلاك المواد بدقة
  • مختبرات التصنيع ومساحات الإبداع (Makerspaces) لتتبع استهلاك خيوط الطلاب والمشاريع
  • مستخدمو طابعات Klipper وVoron لربط إدارة الخيوط مباشرة بلوحات تحكم Mainsail وFluidd
  • مستخدمو طابعات Bambu Lab وأنظمة تعدد الألوان (AMS/MMU) لجرد وتصنيف الألوان المتعددة

حالات الاستخدام الشائعة

  • مسح رمز QR ملصق على بكرة خيط بكاميرا الهاتف لفتح صفحة البكرة في Spoolman ومعرفة الوزن المتبقي فورياً
  • تهيئة قسم `[spoolman]` في ملف `moonraker.conf` لتظهر قائمة اختيار البكرات وأوزانها مباشرة في واجهة Mainsail
  • فلترة جرد الخيوط للعثور على كافة بكرات 'Black PETG' التي تحتوي على 250 جراماً على الأقل لطباعة مجسم كبير
  • حساب تكلفة المادة الخام لطلبات العملاء التجارية بناءً على سعر شراء البكرة ووزن المجسم
  • استعراض تحذيرات بصرية ملونة عند انخفاض وزن الخيط المتبقي بالبكرة عن 50 جراماً

الميزات الرئيسية

  • تكامل أصلي مع Klipper وMoonraker: خصم آلي لحظي لوزن الخيط المستخدم من البكرة النشطة أثناء الطباعة
  • بيانات وصفية شاملة للخيوط: تتبع الشركة، والمادة، واللون، والقطر، والكثافة، والسعر، ووزن البكرة الفارغة
  • معاينة بصرية دقيقة للألوان: دعم أكواد الألوان Hex لسهولة التعرف على درجات الألوان بصرياً
  • مولد ملصقات رموز QR مدمج: طباعة ملصقات فورية لمسح البكرات مباشرة من كاميرات الهواتف
  • دعم إضافة OctoPrint الرسمية: توافق كامل مع خوادم OctoPrint الكلاسيكية عبر إضافة مخصصة
  • واجهة برمجية REST API كاملة: لبناء سكريبتات وأدوات أتمتة وربط موازين الخيوط الذكية بسهولة
  • فائق الخفة والسرعة: مبني بـ Python FastAPI وVue.js لاستجابة لحظية في أجزاء من الثانية
  • معمارية Docker Compose تجمع Spoolman مع ربط مجلد `./data` بالمسار `/home/app/Data` لحفظ قاعدة البيانات

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:7912 لعرض لوحة تحكم Spoolman
  • انتقل إلى 'Vendors' وأضف شركات تصنيع الخيوط المفضلة لديك (مثل eSUN وPolymaker وSunlu وBambu Lab)
  • انتقل إلى 'Filaments' واضبط ملفات المواد بكثافتها وأقطارها (مثل PLA بكثافة 1.24 g/cm³)
  • انتقل إلى 'Spools' ← 'Add Spool' وأدخل الوزن الصافي وسعر البكرة واطبع ملصق الـ QR
  • في ملف `moonraker.conf` بطابعتك أضف `[spoolman] server: http://ip-سيرفرك:7912` وأعد تشغيل Moonraker
  • في واجهة Mainsail أو Fluidd، اختر البكرة النشطة من قائمة الطارد (Extruder) قبل بدء الطباعة
  • ضع Spoolman خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة

أفضل ممارسات الأمان

  • تنبيه أمني حاسم: لا يحتوي Spoolman على مصادقة مستخدمين مدمجة؛ احرص على إبقائه على الشبكة المحلية أو حمايته بـ Basic Auth
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي لتأمين الوصول للوحة التحكم من خارج المنزل
  • لا تكشف المنفذ 7912 للإنترنت العام مباشرة دون حماية بكلمة مرور عبر الوكيل العكسي
  • احمِ مجلد البيانات `./data` الذي يحتوي على قاعدة بيانات البكرات بصلاحيات نظام مناسبة بالسيرفر
  • اسمح لطابعات Klipper / Moonraker بالوصول لمنفذ 7912 بالشبكة المحلية لتسجيل الاستهلاك آلياً
  • حدّث صورة الحاوية دورياً للحصول على أحدث التحسينات وميزات إدارة الخيوط

المنافذ وإعدادات جدار الحماية

يقدم Spoolman واجهة الويب والواجهة البرمجية API عبر منفذ TCP 7912 (المحول من 8000 الداخلي). يجب السماح بالمنفذ 7912 في جدار الحماية للشبكة المحلية الموثوقة (`ufw allow 7912/tcp`) لتتمكن طابعات Klipper من تسجيل الاستهلاك. وفي الإنتاج، وجه حركة الويب عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 وأبقِ المنفذ 7912 مغلقاً خارجياً.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على ملف `spoolman.db` (كافة الشركات، والخيوط، والبكرات، وسجل الاستهلاك)
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على متغيرات البيئة ومسارات التخزين
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع جرد البكرات والأوزان بنجاح

الأخطاء الشائعة

  • كشف لوحة Spoolman للإنترنت العام بدون كلمة مرور مما يتيح للغرباء تعديل أوزان وبيانات البكرات
  • نسيان إدخال وزن البكرة البلاستيكية الفارغة (Tare Weight)، مما يعطل دقة الحساب عند وزن البكرة بالميزان
  • عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان جرد البكرات عند تحديث الحاوية
  • نسيان إضافة قسم `[spoolman]` في ملف `moonraker.conf` بطابعة Klipper مما يمنع الخصم الآلي للاستهلاك
  • إدخال قيم كثافة خاطئة للخيوط (مثل استخدام كثافة PLA 1.24 لخيوط ABS 1.04) مما يسبب خطأ في تحويل الأمتار لجرامات

استكشاف الأخطاء وإصلاحها

  • نظام Moonraker لا يتصل بـ Spoolman — تأكد من صحة الرابط والمنفذ 7912 في `moonraker.conf` واختبر الاتصال بـ curl
  • الخيط لا يُخصم بعد انتهاء الطباعة — تأكد من تحديد البكرة النشطة في لوحة Mainsail أو Fluidd قبل بدء الطباعة
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs spoolman -f`
  • مسح رمز الـ QR لا يفتح البكرة — تأكد من ضبط رابط السيرفر الخارجي بشكل صحيح في إعدادات البرنامج
  • خطأ في صلاحيات كتابة قاعدة البيانات — اضبط ملكية المجلد بالأمر: `chown -R 1000:1000 ./data`

البدائل

مشروع Filamentry المفتوح المصدر. منصة 3DPrintOS التجارية السحابية. إضافة OctoPrint-FilamentManager الكلاسيكية. جداول Google Sheets اليدوية. تطبيق Bambu Handy السحابي لطابعات بامبو.

متى لا تستخدمه

تجنب استخدام Spoolman إذا كنت تمتلك طابعة ثلاثية أبعاد واحدة فقط وتستخدم بكرة خيط واحدة حتى تنتهي تماماً دون تبديل المواد (حيث تكفي الملاحظة البصرية البسيطة). وإذا كنت تعتمد حصرياً على طابعات Bambu Lab مع بكرات RFID الأصلية وتفضل تتبعها عبر تطبيق Bambu Handy السحابي، فإن Spoolman اختياري.

هل تحتاج مساعدة احترافية؟

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

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

كيف يتصل Spoolman بنظام Klipper وMoonraker؟

في ملف إعدادات طابعتك `moonraker.conf`، أضف السطرين `[spoolman] server: http://ip-سيرفرك:7912`. سيتصل Moonraker تلقائياً بـ Spoolman، لتظهر بكراتك في لوحات Mainsail وFluidd وتُخصم الجرامات آلياً فور انتهاء الطباعة.

كيف يحسب Spoolman الوزن المتبقي في بكرة الخيط؟

يحسب Spoolman الوزن بطرح الجرامات المستهلكة المسجلة آلياً بواسطة Moonraker من الوزن الصافي الأولي، أو بوزن البكرة بالميزان وطرح وزن البكرة البلاستيكية الفارغة (Tare Weight).

هل يمكن طباعة ملصقات QR لبكرات الخيوط الفيزيائية ولصقها؟

نعم! يوفر Spoolman مولد ملصقات QR مدمجاً لكل بكرة، يمكنك طباعته على طابعات الملصقات (مثل Dymo أو Brother) ومسحه بكاميرا الهاتف لفتح صفحة البكرة فورياً.

هل يدعم Spoolman برنامج OctoPrint؟

نعم! تتوفر إضافة رسمية (`OctoPrint-Spoolman`) في متجر إضافات OctoPrint تتيح ربط Spoolman مباشرة ومزامنة استهلاك الخيوط بطابعات OctoPrint.

كم يستهلك Spoolman من الذاكرة العشوائية (RAM)؟

تم تطوير Spoolman بـ Python FastAPI وقاعدة بيانات SQLite وهو خفيف جداً، حيث يستهلك عادة ما بين 30 إلى 70 ميجابايت فقط من الذاكرة العشوائية داخل Docker.