Open WebUI المستضاف ذاتيًا هو واجهة المحادثة الأكثر انتشارًا لتقديم تجربة قريبة من ChatGPT لفريق ما، مع إبقاء البيانات داخل المؤسسة. يُوصَل أمام Ollama أو أمام أي واجهة متوافقة مع OpenAI، مثل خادم vLLM أو llama.cpp، ويضيف ما ينقص محرك الاستدلال المجرد: حسابات المستخدمين وسجل المحادثات وإدارة المستندات واختيار النموذج.
وهو من أكثر المشاريع المفتوحة المصدر متابعةً على GitHub في مجاله، وكثيرًا ما يكون أول لبنة ظاهرة في منصة ذكاء اصطناعي داخلية. ولهذا الظهور نتيجة مباشرة لفرق التشغيل: حين تبطؤ الواجهة لا يعرف المستخدمون هل المشكلة في المتصفح أم في التطبيق أم في البحث في المستندات أم في النموذج. ويجب أن تستطيع الإجابة بسرعة.
لنرَ ما يقدمه Open WebUI وكيف يُثبَّت في دقائق عبر Docker، ثم كيف يُراقَب: السجلات وفحص الصحة وتصدير OpenTelemetry وربطه بمحرك الاستدلال في أداة مثل Dynatrace.
ماذا يفعل Open WebUI المستضاف ذاتيًا؟
Open WebUI تطبيق ويب (خلفية بلغة Python وواجهة أمامية بـ Svelte) يوفر:
- واجهة محادثة متعددة النماذج، مع سجل ومجلدات ومشاركة؛
- إدارة المستخدمين والأدوار، مع مسؤول يتحكم في النماذج المتاحة؛
- اتصالات بـ Ollama وبواجهات متوافقة مع OpenAI، تُضبط من واجهة الإدارة؛
- وظيفة RAG مدمجة: ترفق مستندات أو قواعد معرفة يطّلع عليها النموذج أثناء المحادثة؛
- آليات امتداد (أدوات ودوال وخطوط معالجة pipelines) لإضافة سلوكيات بلغة Python.
وحدود يجب تذكرها: Open WebUI ليس محرك استدلال. يتوقف أداؤه على الواجهة الخلفية للنماذج، وفي RAG على نموذج التضمينات (embeddings) والتخزين المتجهي. كما تطور ترخيصه عبر الإصدارات، مع بند يخص العلامة التجارية: اقرأه قبل أي نشر واسع أو بعلامة بيضاء.
عمليًا: تثبيت Open WebUI أمام Ollama
الخطوة 1: وفّر واجهة خلفية للنماذج
أبسط حالة هي Ollama يعمل على المضيف عبر المنفذ 11434. يصف دليلنا Ollama محليًا تثبيته. تحقق من أنه يستجيب:
curl -s http://localhost:11434/api/tags
الخطوة 2: شغّل الحاوية
تقترح الوثائق الرسمية أمرًا من هذا النوع، ينشر الواجهة على المنفذ 3000 ويحتفظ بالبيانات في وحدة تخزين (volume):
docker run -d --name open-webui --restart always \
-p 3000:8080 \
--add-host=host.docker.internal:host-gateway \
-e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
-v open-webui:/app/backend/data \
ghcr.io/open-webui/open-webui:main
توجد متغيرات أخرى للصورة (مع Ollama مدمج، ومع دعم CUDA). والتثبيت عبر pip ممكن أيضًا. الوسوم والأوامر الدقيقة موجودة في وثائق Open WebUI.
الخطوة 3: أنشئ حساب المسؤول
افتح http://localhost:3000: أول حساب يُنشأ يصبح المسؤول. في إعدادات الإدارة، تحقق من الاتصال بـ Ollama واختر النماذج الظاهرة، وقرر هل التسجيلات الجديدة مفتوحة أم تنتظر الموافقة أم مغلقة.
الخطوة 4: أضف واجهة متوافقة مع OpenAI
لربط خادم vLLM أو llama.cpp، أضف اتصال OpenAI في الإدارة، أو مرّر العنوان والمفتاح عند التشغيل:
-e OPENAI_API_BASE_URL=http://vllm.interne:8000/v1 \
-e OPENAI_API_KEY=cle-du-serveur-vllm
تظهر حينئذ النماذج التي يعرضها هذا الخادم إلى جانب نماذج Ollama. راجع vLLM في الإنتاج لجانب الخادم.
الخطوة 5: جهّز الإنتاج
للاستخدام المشترك، ثبّت مفتاحًا سريًا ثابتًا للجلسات (المتغير WEBUI_SECRET_KEY)، وضع التطبيق خلف وكيل عكسي بـ TLS، وفعّل مصادقة المؤسسة (OIDC مدعوم)، وفكّر في PostgreSQL بدل قاعدة SQLite الافتراضية. واحتفظ بنسخة احتياطية من وحدة البيانات: فهي تحوي الحسابات والمحادثات والمستندات.
كيف تراقب Open WebUI؟
الصحة والتوافر
تعرض الواجهة الخلفية نقطة /health يمكن لفحص Kubernetes أو healthcheck في Docker أو مراقب HTTP اصطناعي استخدامها. ومراقب متصفح يسجّل الدخول ويفتح محادثة يختبر المسار الفعلي أيضًا.
السجلات
docker logs -f open-webui
يُضبط مستوى التفصيل بمتغير بيئة (مستوى عام ومستويات لكل مكوّن). تُظهر السجلات الاستدعاءات إلى الواجهات الخلفية للنماذج وأخطاء الاتصال ومعالجة المستندات في RAG. تجنب مستوى التصحيح في الإنتاج: فقد يحتوي مقتطفات من المحادثات.
تتبعات ومقاييس OpenTelemetry
تتضمن إصدارات Open WebUI الحديثة أداة قياس OpenTelemetry تُفعَّل بمتغيرات بيئة: متغير تفعيل عام، ثم متغير لكل إشارة (التتبعات والمقاييس والسجلات، وهي معطلة افتراضيًا) ونقطة OTLP القياسية. مثال استرشادي، يجب التحقق منه في صفحة «Observability» من الوثائق:
-e ENABLE_OTEL=true \
-e ENABLE_OTEL_TRACES=true \
-e OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4317 \
-e OTEL_SERVICE_NAME=open-webui
نحصل على spans لطلبات HTTP في الواجهة الخلفية واستدعاءاتها الصادرة (قاعدة البيانات وعميل HTTP نحو النماذج). وإذا كان محرك الاستدلال يصدر تتبعات بدوره، كما يفعل vLLM، فإن نشر سياق W3C يتيح تتبع سؤال من الواجهة حتى وحدة GPU.
ربط الواجهة بالنموذج في Dynatrace
يستقبل OpenTelemetry Collector تتبعات Open WebUI ويرسلها إلى نقطة OTLP في Dynatrace برمز API مميّز. وبالتوازي يجمع OneAgent أو Collector سجلات الحاوية ومقاييس المضيف، وتصل مقاييس الواجهة الخلفية للنماذج بمسارها الخاص. وفي التتبعات الموزّعة (distributed tracing) نميّز عندئذ الزمن المقضي في التطبيق وفي البحث في المستندات وفي التوليد. والطريقة هي طريقة مقالنا OpenTelemetry من طرف إلى طرف، مطبَّقة على مسار ذكاء اصطناعي.
المؤشرات المفيدة: توافر /health، وزمن استجابة طلبات المحادثة، ومعدل الأخطاء نحو كل واجهة خلفية للنماذج، ومدة فهرسة المستندات، وعدد المستخدمين النشطين.
أفضل الممارسات
- أغلق التسجيلات العامة أو اشترط موافقة المسؤول.
- ثبّت إصدارًا محددًا للصورة بدل
mainفي الإنتاج، واقرأ ملاحظات الإصدار قبل كل تحديث. - حدّد سياسة لحفظ المحادثات وأبلغ المستخدمين بها.
- فعّل OpenTelemetry على الواجهة وعلى محرك الاستدلال للحصول على تتبعات من طرف إلى طرف.
- انسخ احتياطيًا وحدة البيانات وقاعدة البيانات بانتظام.
الأسئلة الشائعة
هل يعمل Open WebUI بدون Ollama؟
نعم. يكفي ضبط اتصال أو أكثر بواجهات متوافقة مع OpenAI (vLLM أو llama.cpp أو خدمة مستضافة)؛ فـ Ollama اختياري.
هل يمكن ربط مصادقة المؤسسة؟
نعم، يدعم Open WebUI بروتوكول OIDC وآليات أخرى موصوفة في وثائقه، إضافة إلى إدارة المجموعات والصلاحيات.
هل يصدّر Open WebUI تتبعات OpenTelemetry؟
الإصدارات الحديثة تفعل ذلك عبر متغيرات البيئة. تحقق من الأسماء الدقيقة في وثائق إصدارك.
الخلاصة
يحوّل Open WebUI محرك الاستدلال إلى خدمة يستطيع فريق كامل استخدامها. وهو أيضًا أول مكان يلحظ فيه المستخدمون أي مشكلة: زوّده بأدوات القياس منذ البداية واربطه بمحرك النماذج لتعرف أين يضيع الوقت. ولتجميع الكل راجع مقارنتنا لحزم الذكاء الاصطناعي المفتوحة المصدر المستضافة ذاتيًا.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.