كيفية إصلاح أخطاء مصادقة Moonraker ومفتاح API في Printer Tools
استكشاف أخطاء مصادقة Moonraker وإصلاحها
الإجابة السريعة
معظم تثبيتات Moonraker على شبكة محلية موثوقة لا تتطلب أي بيانات اعتماد على الإطلاق. إذا كان إعدادك يتطلبها، بسبب إعدادات trusted_clients أو force_logins في moonraker.conf، يمكن لـ Printer Tools إرسال مفتاح API أو رمز Bearer أو بيانات اعتماد Basic Auth مع الاتصال، لكن يجب أن تطابق تمامًا ما يتوقعه Moonraker، وإلا سيُرفض كل طلب.
ما تحتاجه
- الوصول إلى moonraker.conf، أو إلى إعدادات Mainsail أو Fluidd، للتحقق من إعداد المصادقة الحالي
- مفتاح API الحالي، أو رمز Bearer، أو اسم المستخدم وكلمة المرور لـ Basic Auth، أيًا كان ما يستخدمه تثبيت Moonraker لديك
- طابعة Klipper مضافة بالفعل في Printer Tools
- التأكد مما إذا كان عنوان IP لجهازك يقع ضمن أي نطاق trusted_clients مهيأ في moonraker.conf
إصلاح خطأ المصادقة
- 1
تحقق مما إذا كانت المصادقة مطلوبة فعليًا
انظر إلى trusted_clients وforce_logins في moonraker.conf. إذا كانت شبكة جهازك تقع بالفعل ضمن نطاق موثوق، فلا ينبغي أن تكون بيانات الاعتماد ضرورية، ويشير خطأ المصادقة عندها إلى عدم تطابق في الشبكة أو نطاق IP بدلًا من ذلك.
- 2
استرجع بيانات الاعتماد الحالية
أنشئ أو انسخ مفتاح API من أدوات Moonraker نفسها، المتوفرة عادةً عبر صفحة إعدادات Mainsail أو Fluidd، أو تأكد من رمز Bearer أو اسم المستخدم وكلمة مرور Basic Auth المهيأة على الخادم.
- 3
أدخله بدقة في Printer Tools
افتح إعدادات الطابعة في Printer Tools وأدخل بيانات الاعتماد دون مسافات زائدة في البداية أو النهاية. حرف إضافي واحد يكفي للتسبب في رفض يبدو مطابقًا لمفتاح مفقود.
- 4
أعد الاتصال وتحقق من النتيجة
أعد اتصال الطابعة وتأكد من تحميل لوحة المعلومات. إذا استمر الفشل، اختبر بيانات الاعتماد نفسها مباشرة مقابل واجهة برمجة تطبيقات Moonraker بطلب أساسي للتأكد من صحة المفتاح نفسه.
- 5
أعد إنشاء المفتاح إذا فُقد أو دُوِّر
إذا أُعيد إنشاء المفتاح على الخادم بعد نسخه، أنشئ مفتاحًا جديدًا وحدّثه في كل مكان يُستخدم فيه، بما في ذلك Printer Tools وأي عميل Moonraker آخر.
حالة الاتصال داخل Printer Tools
تظهر حقول المصادقة إلى جانب عنوان المضيف عند إضافة أو تعديل طابعة Klipper في Printer Tools.
ما يدعمه Printer Tools
- مفتاح API اختياري يُرسل كترويسة قياسية مع كل طلب إلى Moonraker
- مصادقة رمز Bearer اختيارية للإعدادات المهيأة بهذه الطريقة
- اسم مستخدم وكلمة مرور Basic Auth اختياريان للإعدادات المهيأة بهذه الطريقة
- لا حاجة لأي بيانات اعتماد على الإطلاق عندما تكون شبكتك بالفعل ضمن نطاق trusted_clients في Moonraker
ما لا يُدعم
- لا يطبق Printer Tools تدفق الرمز لمرة واحدة أو تسجيل الدخول عبر جلسة المتصفح في Moonraker
- لا يمكنه اكتشاف أو إنشاء مفتاح API لـ Moonraker من تلقاء نفسه، إذ يجب أن يكون المفتاح موجودًا بالفعل على الخادم
- بيانات الاعتماد الصحيحة التي لا تطابق الطريقة المهيأة حاليًا في Moonraker سيتم رفضها أيضًا
أخطاء المصادقة الشائعة
غير مصرح على الرغم من إدخال مفتاح
تأكد من أن المفتاح لم يُعَد إنشاؤه على الخادم بعد نسخه، وتحقق من عدم وجود مسافات زائدة أو أحرف مخفية عند إدخاله في Printer Tools.
كان يعمل من قبل ثم توقف فجأة
قد تؤدي إعادة تشغيل Moonraker إلى تدوير المفتاح إذا لم يُحفظ بشكل صحيح، أو قد يكون عنوان IP لجهازك قد تغيّر ولم يعد يقع ضمن نطاق trusted_clients. تحقق من الأمرين.
يُرفض Basic Auth
تأكد من أن moonraker.conf يحدد فعليًا Basic Auth لإعدادك بدلًا من مفتاح API. إرسال نوع بيانات اعتماد خاطئ ينتج عنه رفض مماثل تمامًا لعدم إرسال شيء.
تعمل المصادقة في Mainsail أو Fluidd لكن ليس في Printer Tools
غالبًا ما تعتمد عملاء المتصفح على جلسة تُنشأ بعد خطوة تسجيل الدخول. يحتاج Printer Tools بدلًا من ذلك إلى مفتاح API الثابت أو رمز Bearer أو بيانات اعتماد Basic Auth الأساسية.
المصادقة للوصول عن بُعد
تنطبق بيانات الاعتماد نفسها سواء اتصلت مباشرة على شبكتك المحلية أو عبر VPN يعيدك إليها. يتعامل OctoEverywhere وObico مع طبقة التفويض الخاصة بهما بشكل منفصل عن مفتاح API الخاص بـ Moonraker.
الأسئلة الشائعة
هل مفتاح API مطلوب دائمًا؟
لا. لا تتطلب العديد من إعدادات Moonraker المحلية أي مفتاح على الإطلاق. يصبح ضروريًا فقط إذا كان moonraker.conf يفرض المصادقة على العملاء خارج trusted_clients.
أين أجد مفتاح API الخاص بـ Moonraker؟
يتوفر عادةً من صفحة إعدادات Mainsail أو Fluidd، أو مباشرة من قاعدة بيانات Moonraker نفسها إذا كنت تدير الخادم دون واجهة ويب.
هل يدعم Printer Tools رموز تسجيل الدخول والجلسة في Moonraker؟
لا. يستخدم Printer Tools بيانات اعتماد ثابتة، إما مفتاح API أو رمز Bearer أو Basic Auth، بدلًا من تدفق الجلسة التفاعلي الذي تستخدمه عملاء المتصفح.
هل يمكنني إزالة المصادقة تمامًا؟
يعتمد ذلك على moonraker.conf الخاص بك وخيارات أمان الشبكة لديك. يتبع Printer Tools ببساطة أي مصادقة يتطلبها تثبيت Moonraker الحالي لديك.
هل يؤثر تغيير مفتاح API على طباعتي الجارية؟
لا. تستمر الطباعة الجارية على الطابعة نفسها. تتأثر فقط قدرة التطبيق على جلب التحديثات المباشرة حتى إدخال بيانات الاعتماد الصحيحة مرة أخرى.
أدلة ذات صلة
اطّلع على التوافق الكامل مع Klipper وMoonraker
راجع ميزات Moonraker المدعومة، ومتطلبات الكاميرا وSpoolman الاختيارية، وخيارات الوصول عن بُعد، والقيود الحالية.
كل طابعاتك ثلاثية الأبعاد في لوحة تحكم واحدة
راقب طابعات Bambu Lab وKlipper وOctoPrint وCreality وSnapmaker وAnycubic وFlashforge وElegoo وPrusa من تطبيق واحد
متاح على Android وiPhone وiPad وMac مع تطبيقات مصاحبة لـ Apple Watch وWear OS ووصول عن بُعد اختياري عبر VPN أو OctoEverywhere أو Obico
