يعمل BamBuddy على ZimaOS عبر Docker Compose، رغم أنه ليس حزمة مدمجة في متجر التطبيقات. استخدم الصورة الجاهزة المبنية مسبقًا من المشروع الأصلي، واحتفظ بمجلدي /app/data و/app/logs بشكل دائم، واستخدم شبكة مضيف Linux إذا كنت تريد الاكتشاف التلقائي لطابعة Bambu.
لم يتضمن النقاش الأصلي حلًا، لكن BamBuddy ينشر الآن سير عمل Docker مُصانًا. يدعم ZimaOS تطبيقات Compose المخصصة، لذا لا حاجة إلى تعديل نظام التشغيل المضيف أو بناء BamBuddy من المصدر، إلا إذا كنت تريد تطويره.
استخدم صورة Docker الأصلية
يوصي دليل BamBuddy الخاص بـ Docker الحالي باستخدام Docker باعتباره أسهل طريقة للنشر.
إعدادات Compose الأساسية على ZimaOS
services:
bambuddy:
image: ghcr.io/maziggy/bambuddy:latest
container_name: bambuddy
restart: unless-stopped
network_mode: host
environment:
- TZ=YOUR_TIMEZONE
- PUID=1000
- PGID=1000
volumes:
- /DATA/AppData/bambuddy/data:/app/data
- /DATA/AppData/bambuddy/logs:/app/logs
افتح http://ZIMA-IP:8000 بعد بدء التشغيل.
لماذا تهم شبكة المضيف؟
يستخدم BamBuddy اكتشاف الشبكة المحلية لطابعات Bambu. ويستخدم Compose الأصلي الخاص به network_mode: host على Linux، لأن شبكة الجسر العادية لا تستقبل حركة اكتشاف SSDP المتوقعة بالموثوقية نفسها.
يمكنك إضافة الطابعة يدويًا
إذا لم يعثر الاكتشاف على الطابعة، فأضفها باستخدام عنوان IP المحلي. تأكد من أن الطابعة وZimaOS موجودان على شبكتين يمكنهما الوصول إلى بعضهما، وأن وضع الطابعة المحلي/وضع المطور المطلوب مفعّل.
احفظ البيانات قبل التحديث
يخزن BamBuddy قاعدة بياناته وأرشيفاته وبيانات التشغيل ضمن مجلد البيانات المُعدّ. احتفظ بهذه المسارات خارج طبقة الحاوية القابلة للتخلص منها.
تحديث نشر Docker
docker compose pull
docker compose up -dأصدر المشروع الأصلي تحديثات متعلقة بالأمان، لذا حافظ على تحديث الصورة وأنشئ نسخة احتياطية للتطبيق قبل إجراء تغييرات كبيرة.
لا تعرّض المنفذ 8000 مباشرةً للإنترنت
أبقِ BamBuddy على الشبكة المحلية أو خلف HTTPS موثّق/وصول خاص عن بُعد. يجب عدم إعادة توجيه منافذ واجهات إدارة الطابعات إلى الإنترنت بلا حذر.
يوفر دليل Docker المخصص النموذج العام للتطبيقات المخصصة.
تحقق من الحاوية قبل إضافة طابعة
docker ps | grep bambuddy
docker logs --tail 100 bambuddyتأكد من أن خدمة الويب تبدأ بصورة سليمة على المنفذ 8000 قبل استكشاف مشكلات اكتشاف الطابعة. إذا لم تفتح لوحة المعلومات نفسها، فشبكة الطابعة ليست المشكلة بعد.
أنشئ نسخة احتياطية من قاعدة بيانات BamBuddy قبل التحديثات
يتضمن المشروع الأصلي وظيفة نسخ احتياطي خاصة به. استخدمها قبل إجراء تغييرات كبيرة على الصورة، واحتفظ أيضًا بنسخة من مجلد البيانات الدائم. يمكن دائمًا سحب صورة الحاوية مجددًا، لكن لا يمكن استعادة سجل مطبوعاتك وقاعدة بياناتك المحلية بالطريقة نفسها.
توسّع شبكة المضيف نطاق وصول الحاوية إلى الشبكة
نظرًا إلى أن وضع المضيف يشارك مساحة أسماء شبكة ZimaOS، راجع منافذ التطبيق وحافظ على تحديث البرنامج. يُبرَّر استخدام وضع المضيف هنا بسبب اكتشاف الطابعة، لكنه يوفر عزلًا شبكيًا أقل من شبكة الجسر العادية.
استخدم عنوان IP ثابتًا للطابعة
احجز عنوان IP الخاص بالطابعة في جهاز التوجيه متى أمكن. حتى إذا نجح الاكتشاف التلقائي اليوم، فإن العنوان الثابت يجعل استكشاف مشكلات الكاميرا وMQTT وإعادة الاتصال اليدوي أسهل بكثير بعد إعادة تشغيل جهاز التوجيه أو الطابعة.
الأسئلة الشائعة
هل يوجد BamBuddy في متجر تطبيقات ZimaOS؟
لم يتمكن المستخدم في المصدر من العثور على حزمة مخصصة؛ ويُعد Docker Compose المخصص الخيار المباشر.
ما المنفذ الذي يستخدمه BamBuddy؟
واجهة الويب الافتراضية على المنفذ 8000.
لماذا استخدام شبكة المضيف؟
لتمكين اكتشاف الحاوية على Linux وميزات شبكة الطابعة التي يتوقعها BamBuddy.
هل يمكنني بناؤه من المصدر؟
نعم، لكن المشروع الأصلي يوصي باستخدام الصورة المبنية مسبقًا للنشرات العادية.
