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

🖥️ تطبيق سطح المكتب

يضع تطبيق Libre WebUI لسطح المكتب واجهة الويب داخل نافذة أصلية على macOS وWindows وLinux. ويتصل بخادم Libre WebUI يعمل على الجهاز نفسه أو بأي خادم تحدده.

يُطوّر التطبيق في مستودعه الخاص، وتُرفق مثبتات كل إصدار بـ إصدارات GitHub في المستودع الرئيسي.

📦 التنزيل والتثبيت​

نزّل حزمة منصتك من أحدث إصدار:

  • macOS (Apple Silicon): ‏Libre-WebUI-Desktop-{version}-mac-arm64.dmg أو .zip، أو brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: ‏Libre-WebUI-Desktop-Setup-{version}.exe (مثبّت) أو Libre-WebUI-Desktop-{version}.exe (محمول)
  • Linux: ‏Libre-WebUI-Desktop-{version}.AppImage أو Libre-WebUI-Desktop-{version}-{arch}.deb

كانت الإصدارات السابقة لإعادة التسمية تنشر هذه الملفات بالبادئة Libre-WebUI-Frontend، وكان اسم حزمة التطبيق Libre WebUI Frontend.app.

يحظر macOS التطبيق باعتباره تالفًا​

يستخدم Libre WebUI مؤقتًا توقيعًا مخصصًا لبنيات macOS. يحافظ ذلك على سلامة بنية حزمة التطبيق، لكنه لا يعرّف الناشر لدى Apple ولا يسمح بالتوثيق. بعد نسخ التطبيق إلى Applications، وافق عليه من إعدادات النظام ← الخصوصية والأمان ← فتح على أي حال.

إذا لم يقدم macOS هذا الخيار، فأزل سمة الحجر الصحي فقط بعد التحقق من أن التطبيق جاء من إصدار Libre WebUI الرسمي:

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

لا تعطل Gatekeeper على مستوى النظام. ما يزال التوزيع السلس يتطلب شهادة Developer ID Application وتوثيق Apple.

🔌 الاتصال بخادم​

التطبيق عميل، ولذلك يحتاج إلى خادم Libre WebUI. وعند أول تشغيل تقدم شاشة البداية مسارين:

  • محلي: يبحث التطبيق عن خادم على جهازك (المنفذ 3001، وهو الافتراضي لصورة Docker وnpx libre-webui) ويتصل عندما يجيب فحص سلامته.
  • بعيد: أدخل عنوان أي خادم Libre WebUI يمكن الوصول إليه، مثل مختبر منزلي أو نشر لفريق. يتحقق منه التطبيق قبل الاتصال.

يُحفظ اختيارك. ولتغيير الخادم لاحقًا، استخدم Libre WebUI ← تبديل الخادم… من شريط القوائم. وإذا توقف خادم محفوظ عن الاستجابة، يعود التطبيق إلى شاشة البداية بدلًا من نافذة فارغة.

لتشغيل خادم محلي، راجع البدء السريع: تعمل Docker Compose وnpx libre-webui وHomebrew جميعًا.

🧰 Work في تطبيق سطح المكتب​

لا تتضمن حزمة سطح المكتب الخادم الخلفي أو Docker أو بيئة حاويات Work. ويحدد الخادم المتصل به مدى توفر Work:

  • يستطيع خادم خلفي أصلي قادر على تشغيل docker info إنشاء حاويات Work ووحدات تخزين مسماة خاصة بكل مهمة؛
  • يوفر نشر Compose القياسي في المستودع Work عبر Docker بتركيب مقبس Docker للمضيف، بينما يبلّغ نشر حاوية مخصص بلا بيئة تشغيل قابلة للوصول أن Work غير متاح؛
  • يوفر خادم Kubernetes ‏Work بوحدات Pod/PVC عند تثبيت مخطط Helm مع work.enabled=true؛
  • يستمر التطبيق في دعم Chat عندما لا يتوفر Work.

توجد ملفات Work على مضيف Docker أو تخزين Kubernetes الخاص بالخادم، لا داخل تطبيق سطح المكتب. وتمر المعاينات عبر وكيل Libre WebUI الموقّع من الأصل نفسه، لذلك يمكن للعملاء المحليين والبعيدين استخدامها عندما يحافظ الوكيل العكسي للخادم على حركة HTTP وWebSocket.

🎨 التكامل مع سطح المكتب​

  • شريط قوائم أصلي يتضمن قوائم التطبيق والتحرير والعرض والنافذة والمساعدة
  • شريط عنوان macOS مخصص (hiddenInset) مع أزرار النافذة في الشريط الجانبي
  • يتبع الوضع الداكن تفضيل النظام
  • تُفتح الروابط الخارجية في متصفحك الافتراضي، وليس داخل التطبيق
  • تعمل عملية العرض بعزل السياق ومن دون تكامل Node

🚧 القيود​

  • بنية macOS: تدعم حزم macOS الحالية Apple Silicon ‏(arm64) فقط
  • يتطلب خادمًا: لا تتضمن الحزمة الخادم الخلفي
  • يعتمد Work على بيئة الخادم: لا تتضمن الحزمة بيئة Docker أو Kubernetes
  • لا تحديث تلقائي: يتطلب التحديث تنزيل حزمة جديدة

راجع Work: مساحات العمل المعزولة لتفاصيل بيئة التشغيل والمزوّد والتخزين وأمان المعاينات.