الانتقال إلى المحتوى الرئيسي

HTTPS وشبكة

يمكن لبرنامج تشغيل الطابعة بالكمبيوتر كشف HTTPS من خلال إشارات Caddy وPeerJS من خلال /mesh.

شروط HTTPS

يبدأ HTTPS فقط عندما تكون كل هذه الأمور صحيحة:
  • features.httpsEnabled هو true.
  • caddy.enabled هو true.
  • منصة وقت التشغيل هي Windows.
  • الشهادات موجودة في assets/certs.
  • يمكن تركيب العلبة أو إعادة استخدامها.
إذا فشل إعداد HTTPS، يقوم برنامج التشغيل بتسجيل الخطأ ويستمر مع HTTP.

ملفات الشهادة

الملفات المطلوبة:
assets/certs/ca.crt
assets/certs/server.crt
assets/certs/server.key
يقوم برنامج التشغيل بنسخها إلى مجلد عمل Caddy:
assets/caddy/ca.crt
assets/caddy/server.crt
assets/caddy/server.key
يمكن تنزيل شهادة CA من:
http://<driver-ip>:8080/ca.crt

تثبيت العلبة

يستخدم إعداد العلبة هذا الترتيب:
  1. أعد استخدام assets/caddy/bin/caddy.exe إذا كان مثبتًا بالفعل مع .installed.
  2. انسخ caddy.exe المجمعة من المسارات المحلية المعروفة.
  3. قم بتنزيل Caddy من إصدار GitHub URL.
إصدار Caddy الذي تم تكوينه افتراضيًا هو 2.6.4.

تم إنشاء ملف Caddyfile

يكتب السائق ملف Caddyfile مثل:
{
  auto_https disable_redirects
}

plato-printer.local {
  reverse_proxy localhost:8080

  handle /mesh/* {
    reverse_proxy localhost:8080 {
      header_up Connection {http.request.header.Connection}
      header_up Upgrade {http.request.header.Upgrade}
    }
  }

  tls "assets/caddy/server.crt" "assets/caddy/server.key"
}
إذا لم يكن caddy.httpsPort 443، فإن عنوان الموقع يتضمن المنفذ.

وقت تشغيل العلبة

يعمل Caddy كعملية فرعية مع:
  • تم ضبط XDG_DATA_HOME على assets/caddy/data
  • تم ضبط XDG_CONFIG_HOME على assets/caddy/config
  • تم ضبط دليل العمل على assets/caddy
إذا خرجت العلبة بشكل غير متوقع، فسيقوم السائق بإعادة المحاولة حتى 5 مرات مع تأخير 2000ms.

شبكة الإشارات

عندما يكون features.meshEnabled صحيحًا، يقوم برنامج التشغيل بتثبيت PeerJS على:
ws://<driver-host>:8080/mesh
wss://plato-printer.local/mesh
عوائد GET /mesh-status:
  • ما إذا تم تمكين الشبكة
  • مسار شبكي
  • ميناء
  • معرفات الأقران المتصلة
  • عدد الأقران
الشبكة تعمل على الإشارة فقط. لا تزال مهام الطباعة تستخدم نقاط النهاية HTTP.

مشاكل HTTPS الشائعة

أعراضالسبب المحتمليصلح
يحظر المتصفح برنامج تشغيل HTTPS URLشهادة CA غير موثوقةقم بتثبيت ca.crt على جهاز POS.
لم يتم حل https://plato-printer.localDNS/المضيفون مفقودونأضف إدخال DNS المحلي أو المضيفين إلى IP الخاص بالسائق.
المنفذ 443 غير متاحخدمة أخرى تستخدمهاأوقف الخدمة الأخرى أو قم بتغيير caddy.httpsPort.
تم تخطي HTTPS على نظام التشغيل macOS/Linuxالكود مخصص لنظام التشغيل Windows فقطاستخدم HTTP في التطوير أو اختبر Caddy بشكل منفصل.
خطأ في بدء تشغيل ويندوز 7نسخة العلبة ليست 2.6.4اضبط caddy.version مرة أخرى على 2.6.4.