🖨️ تثبيت OctoPrint — لوحة التحكم والمراقبة عن بُعد للطابعات ثلاثية الأبعاد على Docker

نشر خادم OctoPrint على Ubuntu باستخدام Docker — واجهة الويب الشاملة للتحكم في الطابعات ثلاثية الأبعاد، وإرسال ملفات G-code لاسلكياً، ومراقبة حرارة الفوهات والكاميرا الحية.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر OctoPrint على المنفذ 8231 مع حفظ دائم للإعدادات وملفات الطباعة وتمرير منافذ USB التسلسلية للطابعة.
عرض على GitHub

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

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

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

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

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

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

chmod +x octoprint-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات الإعدادات والملفات وضبط صلاحيات منافذ USB التسلسلية وتشغيل حاوية OctoPrint على المنفذ 8231.

sudo bash octoprint-ubuntu.sh

4 إتمام معالج الإعداد

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8231 لبدء معالج الإعداد الأولي لـ OctoPrint. أنشئ حساب المشرف، وحدد أبعاد مساحة الطباعة وسرعة الاتصال التسلسلي.

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

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

المنفذالغرض
8231Web UI (host → container 80)
USB passthroughManual — add your printer device to the compose file first
⚠️ Never exposeControls a heated printer — keep it on your LAN or a VPN
./dataSettings, uploads, timelapses, and plugins

نظرة عامة

يعد OctoPrint الخادم وواجهة الويب مفتوحة المصدر الأكثر شهرة واستخداماً للتحكم في الطابعات ثلاثية الأبعاد وإدارتها عن بُعد. عند ربطه عبر كابل USB التسلسلي بلوحة تحكم الطابعة (مثل طابعات Creality Ender وPrusa وVoron وAnycubic)، يحررك OctoPrint تماماً من عناء نقل كروت الذاكرة SD يدوياً. يعمل التطبيق على المنفذ 8231 مع حفظ دائم للبيانات، ويتيح لك إرسال ملفات G-code مباشرة من برامج التقطيع (PrusaSlicer وCura وOrcaSlicer)، ومتابعة حرارة الفوهة والسرير، وبث فيديو الكاميرا المباشر، وتسجيل مقاطع التايم لابس الاحترافية.

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

الاعتماد على شاشة الطابعة الصغيرة ونقل الملفات بكروت الذاكرة يعيق متابعة تقدم الطباعة ويجعل من الصعب اكتشاف أخطاء الطباعة (مثل انفصال المجسم أو انسداد الفوهة) إلا بعد فوات الأوان. يحول OctoPrint طابعتك إلى جهاز ذكي متصل بالشبكة؛ حيث يمكنك بدء الطباعة لاسلكياً من حاسوبك، ومتابعة المجسم عبر الكاميرا من هاتفك، واستخدام الذكاء الاصطناعي (مثل Obico) لإيقاف الطباعة تلقائياً عند فشل المجسم وتوفير خيوط الفيللمنت.

متى تحتاجه

  • ترغب في التخلص من كروت الذاكرة SD وإرسال ملفات G-code لاسلكياً مباشرة من برامج التقطيع (Cura أو PrusaSlicer)
  • تحتاج إلى مراقبة حية لدرجات الحرارة، والتحكم في المحركات، وبث فيديو مباشر لسطح الطباعة عبر الكاميرا
  • تريد تسجيل مقاطع فيديو سريعة (Timelapse عبر Octolapse) متزامنة مع الطبقات لنشرها أو مراجعة الجودة
  • تريد الاستفادة من الذكاء الاصطناعي (Obico) لاكتشاف أخطاء الطباعة وإيقاف الطابعة تلقائياً لمنع إهدار الخيوط
  • تدير عدة طابعات ثلاثية الأبعاد (Print Farm) وتريد لوحة تحكم مركزية لمتابعة كافة الأجهزة عبر الشبكة

من يحتاجه

  • هواة وصناع المجسمات ثلاثية الأبعاد الباحثون عن تحكم لاسلكي سلس في طابعاتهم المنزلية
  • أصحاب مزارع الطباعة (Print Farms) والورش التعليمية والتجارية لإدارة عدة طابعات بكفاءة
  • المصممون ومهندسو النماذج الأولية لمتابعة حالة الطباعة أثناء تواجدهم خارج الورشة
  • المهندسون الذين يختبرون أوامر G-code المخصصة ومستشعرات تسوية السطح التلقائية (BLTouch)
  • أصحاب المنازل الذكية لربط حالة الطابعة وفصل الكهرباء تلقائياً عبر نظام Home Assistant

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

  • بدء وإيقاف واستئناف عمليات الطباعة لاسلكياً من المتصفح أو تطبيقات الهاتف (OctoApp وPrintoid)
  • بث فيديو مباشر بدقة عالية لفحص التصاق الطبقة الأولى ورصد أي تشوهات في المجسم مبكراً
  • رسم خريطة ثلاثية الأبعاد لسطح الطباعة باستخدام إضافة Bed Level Visualizer لوزن السرير بدقة
  • أتمتة فصل الطاقة: إطفاء الطابعة عبر مقبس ذكي فور انخفاض حرارة الفوهة عن 50 درجة مئوية بعد انتهاء العمل
  • تسجيل مقاطع تايم لابس احترافية يتحرك فيها رأس الطباعة بعيداً عند كل طبقة ليظهر المجسم كأنه ينمو بمفرده

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

  • لوحة تحكم ويب تفاعلية على المنفذ 8231 مع عارض G-code حي، ورسوم بيانية للحرارة، وطرفية أوامر تسلسلية
  • اتصال تسلسلي مباشر عبر USB يدعم مختلف سرعات النقل القياسية (115200 و250000) مع اكتشاف تلقائي
  • دعم كامل لبث كاميرات الويب الحية والتقاط الصور الثابتة والتحكم في زوايا الكاميرا
  • مدير إضافات متكامل يتيح الوصول لمئات الإضافات المجتمعية (Octolapse وBed Visualizer وDashboard)
  • تكامل مباشر مع برامج التقطيع عبر API (طباعة بنقرة واحدة من Cura وPrusaSlicer وOrcaSlicer)
  • نظام تحكم في صلاحيات المستخدمين مع حسابات مخصصة للمشرفين والمشغلين
  • أزرار إيقاف طوارئ فورية وخطافات لمراقبة حالات الهروب الحراري (Thermal Runaway)
  • نشر عبر Docker مع ربط مجلد ./data لحفظ الإعدادات وملفات G-code ومقاطع الفيديو بشكل دائم

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8231 لبدء معالج إعداد OctoPrint
  • أنشئ حساب المشرف العام بكلمة مرور قوية في خطوة التحكم في الوصول (Access Control)
  • اضبط ملف تعريف الطابعة (Printer Profile): أدخل اسم الطابعة ونوع السطح وأبعاد مساحة الطباعة بالمليمتر (X, Y, Z)
  • اضبط الاتصال التسلسلي (Serial Connection): اختر Auto للمنفذ وسرعة النقل أو حدد /dev/ttyUSB0 مع 115200
  • أضف كاميرا الويب الخاصة بك من قسم Settings ← Webcam & Timelapse لتفعيل البث المباشر
  • ولد مفتاح API Key من قسم Settings ← API لربط برامج التقطيع مثل PrusaSlicer أو نظام Home Assistant
  • ثبت الإضافات المفيدة من مدير الإضافات (مثل Dashboard وBed Level Visualizer وOctolapse)

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

  • تحذير شديد الأهمية: لا تفتح منفذ OctoPrint للإنترنت العام مباشرة أبداً — يتحكم OctoPrint في سخانات مادية تصل حرارتها لـ 250 درجة مئوية وقد تسبب حرائق إذا تم اختراقها؛ استخدم VPN مشفر دائماً (WireGuard)
  • فعل نظام التحكم في الوصول دائماً واختر كلمة مرور قوية لحساب المشرف أثناء معالج الإعداد الأولي
  • حافظ على سرية مفاتيح API وأعد توليدها فوراً إذا تسربت عن طريق الخطأ
  • تأكد من تفعيل ميزة الحماية من الهروب الحراري (Thermal Runaway Protection) في برنامج الطابعة المدمج (Marlin/Klipper)
  • اعزل الطابعة في شبكة VLAN للأجهزة الذكية واستخدم مقبساً ذكياً لقطع الكهرباء عنها في حالات الطوارئ
  • حدّث حاوية OctoPrint والإضافات بانتظام من داخل واجهة الويب للحصول على التحديثات الأمنية

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

يقدم OctoPrint واجهته عبر منفذ TCP 8231 (المحول من منفذ 80 الداخلي). ونظراً لأن التطبيق يتحكم في آلات حرارية مادية، يجب قصر الوصول للمنفذ 8231 على شبكتك المحلية الموثوقة أو عبر شبكة VPN آمنة فقط (ufw allow from 192.168.1.0/24 to any port 8231). وتجنب تماماً إعادة توجيه هذا المنفذ في الراوتر للإنترنت العام.

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

  • انسخ مجلد ./data (/octoprint) احتياطياً، والذي يحتوي على ملفات تعريف الطابعات والإضافات وملفات G-code والتايم لابس
  • استخدم إضافة النسخ الاحتياطي المدمجة في OctoPrint من Settings ← Backup لتصدير ملف zip شامل
  • احتفظ بنسخة من مفاتيح API وإعدادات برامج التقطيع
  • أتمت النسخ الاحتياطي الدوري لمجلد البيانات إلى وحدة تخزين خارجية عبر restic أو rsync
  • اختبر الاستعادة برفع ملف النسخة الاحتياطية في حاوية تجريبية للتأكد من استرجاع كافة الإعدادات بنجاح

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

  • فتح منفذ OctoPrint للإنترنت العام مباشرة دون استخدام شبكة VPN: مما يتيح للمخترقين تشغيل السخانات والتسبب في حرائق
  • توصيل كابل الطابعة دون تمرير مسار USB للحاوية في ملف docker-compose.yml (مثل `devices: - /dev/ttyUSB0:/dev/ttyUSB0`)
  • تغذية شاشة الطابعة بكهرباء 5V عبر كابل USB مما يجعل الشاشة مضاءة دائماً حتى بعد إطفاء زر الطابعة (عالج ذلك بوضع شريط لاصق على سن 5V في الكابل)
  • عدم ربط مجلد التخزين الدائم ./data، مما يسبب فقدان ملفات تعريف الطابعة والإضافات عند تحديث الحاوية
  • تشغيل مهام تقطيع معقدة وثقيلة على نفس السيرفر أثناء الطباعة، مما قد يسبب تقطيعاً في إرسال الأوامر وتشوهات في المجسم

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

  • الطابعة لا تتصل — تأكد من توصيل كابل USB ومنح صلاحيات dialout للمستخدم على السيرفر (sudo usermod -aG dialout $USER)
  • منفذ USB لا يظهر داخل الحاوية — افحص أمر `ls /dev/tty*` على السيرفر وتأكد من تمرير المنفذ في docker-compose.yml
  • بث الكاميرا لا يعمل — تأكد من صحة رابط البث في إعدادات الكاميرا (مثل http://ip-سيرفرك:8080/?action=stream)
  • توقف الطابعة مؤقتاً أثناء حركة الطباعة — عطل الإضافات الثقيلة واستخدم كابل USB عالي الجودة مزوداً بفلتر مغناطيسي
  • واجهة الويب لا تفتح — افحص سجلات الحاوية بالأمر: docker logs octoprint -f لمعرفة تفاصيل الخطأ

البدائل

واجهتا Mainsail وFluidd هما الواجهتان الأحدث والأخف المخصصتان للعمل مع برنامج تشغيل الطابعات Klipper. برنامج Repetier-Server حل تجاري لإدارة الطابعات مع دعم شاشات اللمس. منصة Prusa Connect سحابة رسمية لطابعات Prusa. برامج Bambu Studio وBambu Handy الحل السحابي المخصص لطابعات Bambu Lab.

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

تجنب استخدام OctoPrint إذا كانت طابعتك تعمل بنظام Klipper وMoonraker الحديث (استخدم Mainsail أو Fluidd بدلاً منه، حيث صُمما خصيصاً لـ Klipper). وإذا كنت تطبع نادراً جداً ولا تمانع استخدام كارت الذاكرة اليدوي، فقد لا تحتاج لتشغيل سيرفر دائم على مدار الساعة.

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

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

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

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

لماذا يعد فتح منفذ OctoPrint للإنترنت العام خطيراً للغاية؟

يتحكم OctoPrint في سخانات كهربائية عالية الطاقة (تتجاوز حرارتها 250 درجة مئوية) ومحركات حركية. إذا تمكن مخترق من الوصول للوحة، يمكنه تشغيل السخانات والتسبب في تلف الطابعة أو حدوث حريق. استخدم دائماً شبكة VPN آمنة مثل WireGuard للوصول عن بُعد.

كيف أقوم بتمرير منفذ USB الخاص بالطابعة إلى حاوية Docker؟

حدد منفذ الطابعة على السيرفر (مثل /dev/ttyUSB0 أو /dev/ttyACM0 عبر أمر `ls /dev/tty*`)، ثم أضف السطر `devices: - /dev/ttyUSB0:/dev/ttyUSB0` تحت خدمة octoprint في ملف docker-compose.yml.

هل يمكن إرسال المجسمات مباشرة من PrusaSlicer أو Cura إلى OctoPrint؟

نعم، في برنامج التقطيع، أضف طابعة فيزيائية وضع رابط السيرفر (http://ip-سيرفرك:8231) ومفتاح API Key المولد من إعدادات OctoPrint، لتتمكن من تقطيع المجسم وإرساله للطباعة بنقرة زر واحدة.

ما هي إضافة Octolapse؟

إضافة Octolapse هي إضافة تقوم بتحريك رأس الطباعة إلى زاوية ثابتة عند كل طبقة جديدة قبل التقاط صورة الكاميرا، مما ينتج مقطع فيديو تايم لابس ثابتاً واحترافياً يظهر فيه المجسم وهو ينمو بسلاسة.

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

يستهلك OctoPrint حوالي 150 إلى 300 ميجابايت فقط من الذاكرة العشوائية، مما يجعله خفيفاً جداً وقابلاً للتشغيل بجانب الخدمات الأخرى على سيرفر Ubuntu.