أنور بآي
تخيّل أن لديك نموذجًا محليًا على جهازك، وحساب API لدى مزود سحابي، وملفات تريد طرح أسئلة عنها. بدل التنقل بين واجهات مختلفة، يمكنك جمع هذه الاستخدامات في OpenWebUI: واجهة تستضيفها بنفسك، تربطها بالنماذج التي تختارها، ثم تستخدمها من المتصفح.
القيمة العملية ليست الحصول على نموذج جديد. إنها إدارة المحادثات والمصادر والأدوات في مكان واحد، مع حرية اختيار أين يعمل النموذج وأين تُحفظ بيانات الواجهة.
هذا المقال يشرح ما يمكن أن تستبدله OpenWebUI، وأبرز ميزاتها وبدائلها، ثم يقدم مسار تثبيت محلي باستخدام Docker وربط أول نموذج. خطوات التثبيت مستندة إلى الوثائق الرسمية؛ لم نُعِد تنفيذها على جهاز قارئ أو خادم إنتاج في إعداد هذا المقال.
OpenWebUI واجهة ومنصة، وليست نموذجًا
OpenWebUI تطبيق ويب ذاتي الاستضافة. يمكنك تشغيله على جهازك أو على خادم تديره، ثم ربطه بخادم نماذج محلي مثل Ollama، أو بمزود يقدم API متوافقًا مع OpenAI، أو بخيارات الاتصال الأخرى التي تدعمها المنصة.
عندما تكتب رسالة، ترسل الواجهة الطلب إلى الجهة المرتبطة بالنموذج، وتعرض الرد داخل المحادثة. يمكنك تغيير النموذج دون تغيير واجهة العمل كلها.
الأدوار مختلفة:
OpenWebUI تدير الواجهة والمحادثات والاتصالات والميزات المحيطة.
Ollama أو llama.cpp أو vLLM تشغّل النموذج المحلي وتتيح الوصول إليه.
المزود السحابي يشغّل النموذج عند اختيار اتصال API خارجي.
تشغيل OpenWebUI وحدها لا يعني وجود نموذج جاهز للرد. صورة Docker القياسية في هذا الدليل لا تتضمن Ollama؛ ستحتاج إلى ربط مزود بعد التثبيت.
ما الذي يمكن أن تستبدله؟
يمكن أن تصبح واجهتك اليومية بدل واجهة محادثة مرتبطة بمزود واحد، خصوصًا إذا كنت تريد استخدام نماذج محلية وسحابية في المكان نفسه. ويمكن أن تستبدل واجهة بسيطة تبنيها بنفسك للتعامل مع خادم Ollama أو API.
لكنها لا تستبدل نموذج GPT أو Claude أو Qwen نفسه. كما أن استخدام API لا يمنحك تلقائيًا جميع خصائص منتج ChatGPT أو Claude الموجّه للمستهلك. لكل واجهة ومنتج تكاملاته وحدوده وطريقة تسعيره.
وإذا كنت تستخدم نموذجًا عبر API مدفوع، تبقى تكلفة الاستدعاءات مرتبطة بالمزود. تثبيت واجهة على جهازك لا يحوّل تلك الاستدعاءات إلى خدمة مجانية.
بالنسبة إلى فريق، يمكن أن تؤدي دور بوابة مشتركة للنماذج والمعرفة. هذا يتطلب إدارة المستخدمين والصلاحيات والتحديثات والنسخ الاحتياطية؛ لا تكفي حاوية تعمل لتصبح الخدمة جاهزة للمؤسسة.
الميزات التي تجعلها مفيدة
نماذج متعددة داخل واجهة واحدة
يمكنك ربط أكثر من مزود، واختيار نموذج مختلف لكل محادثة. وتدعم المنصة محادثات متعددة النماذج لمقارنة الردود على الطلب نفسه.
هذا مفيد لاختبار مهمة محددة: تلخيص مستند، أو شرح كود، أو كتابة نص عربي. المقارنة لا تثبت أن نموذجًا أفضل في كل شيء، لكنها تساعدك على اختيار الأنسب للعمل الذي تؤديه.
السؤال عن مستنداتك
تدعم OpenWebUI العمل مع ملفات ومعرفة مرتبطة بالمحادثة، بما في ذلك الاسترجاع المعزز بالتوليد، أو RAG. الفكرة أن تسترجع المقاطع ذات الصلة من مستنداتك وتضعها ضمن سياق سؤال النموذج.
النتيجة تعتمد على جودة استخراج النص، وتقسيمه، ونموذج التضمين، والاسترجاع. رفع PDF لا يضمن أن جميع جداوله أو صفحاته الممسوحة ستُفهم كما تتوقع. ابدأ بمستند صغير معروف المحتوى، وراجع الإجابات مقابل الأصل.
أدوات تتجاوز المحادثة
تدعم المنصة أدوات وإضافات، ويمكنها الاتصال بخوادم MCP وOpenAPI. بدل أن يكتفي النموذج بوصف العملية، قد يستدعي أداة تمنحه بيانات أو تنفذ مهمة مسموحة.
هذه القدرة تحتاج حدودًا واضحة. أداة تقرأ حالة خدمة تختلف عن أداة تعدّل قاعدة بيانات أو تنفذ كودًا. لا تمنح صلاحيات واسعة لمجرد أن التكامل ظهر في الواجهة.
بحث وصوت وصور عند تهيئتها
تتوفر تكاملات للبحث على الويب، وتحويل الصوت إلى نص، وإخراج الرد صوتيًا، وتوليد الصور. بعضها يعتمد على خدمات خارجية أو نماذج محلية إضافية.
وجود الميزة في القائمة لا يعني أنها تعمل دون إعداد، أو أن بياناتها تبقى على جهازك. افحص مزود كل ميزة على حدة.
مستخدمون وصلاحيات واستخدام من الهاتف
تدعم المنصة إدارة المستخدمين والمجموعات والصلاحيات. ويمكن استخدامها من المتصفح على الحاسوب والهاتف، مع إمكانية إضافتها كتطبيق ويب تقدمي PWA.
للاستخدام الفردي، يكفي غالبًا بدء محادثة وربط نموذج. أما مشاركة الخدمة، فتضيف مسؤوليات مثل الموافقة على المستخدمين، والتحكم في الأدوات، وحماية الوصول إلى الخادم.
هل تشغيلها محليًا يجعل كل شيء خاصًا؟
لا. مكان استضافة الواجهة ومكان تنفيذ النموذج قراران منفصلان.
إذا استضفت OpenWebUI محليًا ثم اخترت نموذجًا سحابيًا، يذهب الطلب والسياق المرفق إلى ذلك المزود. وقد تستخدم خدمة تضمين أو بحث أو استخراج مستندات خارجية حتى عندما يكون نموذج المحادثة محليًا.
لذلك ارسم المسار كاملًا: الرسالة، والمرفقات، والتضمين، والاسترجاع، والأدوات، والسجلات. التشغيل المحلي يمنحك خيارات أكثر للتحكم، لكنه لا يثبت وحده أن أي بيانات لا تغادر الشبكة.
بدائل تستحق المقارنة
LibreChat بديل ذاتي الاستضافة يجمع المحادثات مع مزودين مختلفين، ويدعم وكلاء وMCP وميزات أخرى. ضعه في المقارنة إذا كنت تبحث عن بوابة محادثة قابلة للتخصيص تربط أكثر من مزود. الاختيار بينه وبين OpenWebUI يحتاج تجربة اتصالاتك ومهامك وصلاحيات فريقك، وليس مقارنة عدد الميزات فقط.
AnythingLLM يقدم مسارًا للعمل مع المستندات وRAG والوكلاء، وله خيارات Desktop وDocker. يستحق التجربة إذا كانت نقطة البداية هي مستنداتك ومساحات المعرفة، أو كنت تفضّل تطبيقًا مكتبيًا. لا يعني ذلك أن RAG فيه سيتفوق تلقائيًا على إعداد OpenWebUI؛ جودة الاستخراج والاسترجاع تحتاج اختبارًا بالمستندات نفسها.
أما الواجهات المستضافة مثل ChatGPT أو Claude، فقد تكون أبسط لمن لا يريد إدارة خادم أو ربط API. المقابل أنك تستخدم تجربة المنتج وسياساته، بدل إدارة بوابتك بنفسك.
اختر OpenWebUI إذا كانت أولويتك واجهة تديرها أنت، تجمع النماذج المحلية والسحابية، ويمكن توسيعها. وإذا كنت تحتاج محادثة عابرة فقط، فقد تكون الاستضافة الذاتية عبئًا لا تحتاجه.
تثبيت OpenWebUI باستخدام Docker
سنستخدم مسارًا محليًا: الواجهة متاحة من الجهاز نفسه فقط على http://localhost:3000. هذا ليس إعدادًا لنشرها على الإنترنت أو إتاحتها لفريق.
1. تحقق من المتطلبات
تحتاج إلى Docker يعمل على جهازك، واتصال لتنزيل صورة الحاوية، ومساحة للبيانات، وطريقة للوصول إلى نموذج. يمكنك استخدام API سحابي دون بطاقة رسومية محلية؛ تشغيل نموذج على جهازك يتطلب موارد تناسب ذلك النموذج.
تحقق من Docker:
docker version
docker infoإذا كان Docker غير مثبت، اتبع دليل تثبيته الرسمي لنظامك. الأوامر التالية مكتوبة لصدفة Bash، مثل Linux أو macOS أو WSL، وتستخدم openssl لتوليد مفتاح سرّي.
2. أنشئ مفتاح الواجهة مرة واحدة
توصي الوثائق بتثبيت قيمة WEBUI_SECRET_KEY بدل تركها تتغير عند إعادة إنشاء الحاوية. في مجلد خاص بالإعداد، نفّذ:
umask 077
if [ ! -e .openwebui.env ]; then
printf 'WEBUI_SECRET_KEY=%s\n' "$(openssl rand -hex 32)" > .openwebui.env
fiالملف .openwebui.env يحتوي على سر محلي. احتفظ به بصلاحيات مقيدة، ولا ترفعه إلى GitHub أو ترفقه بمقال أو تقرير. هذا المفتاح ليس مفتاح API لمزود النموذج. احتفظ بالقيمة نفسها عند إعادة إنشاء الحاوية والتحديث.
3. شغّل الحاوية مع حفظ البيانات
نستخدم إصدارًا محددًا بدل وسم متغير. ظهر v0.11.4 كأحدث إصدار غير تمهيدي عند مراجعة صفحة الإصدارات في 10 أكتوبر 2026. راجع الإصدارات الرسمية قبل تثبيت جديد؛ قد يتوفر إصدار أحدث عند قراءتك.
docker run -d \
--name open-webui \
-p 127.0.0.1:3000:8080 \
--add-host=host.docker.internal:host-gateway \
--env-file .openwebui.env \
-v open-webui:/app/backend/data \
--restart unless-stopped \
ghcr.io/open-webui/open-webui:v0.11.4إذا كانت لديك حاوية بهذا الاسم أو كان المنفذ 3000 مستخدمًا، لا تحذف النشر القائم. اختر اسمًا ومنفذًا مناسبين للبيئة الجديدة.
ما الذي يهم في الأمر؟
127.0.0.1:3000:8080 يقصر منفذ الواجهة على الجهاز المحلي. لا تزل قيد 127.0.0.1 قبل تصميم الوصول والمصادقة وTLS.
open-webui:/app/backend/data يحفظ البيانات في Docker volume. حذف الحاوية يختلف عن حذف هذا الـvolume، الذي قد يزيل المحادثات والإعدادات.
--add-host يتيح اسمًا للوصول إلى خدمات على الجهاز المضيف في البيئات الداعمة. لا يشغّل Ollama ولا يتجاوز جدار الحماية.
--env-file يمرر المفتاح من الملف بدل وضع قيمته مباشرة في سطر الأمر.
صورة main الكاملة متاحة أيضًا، لكنها وسم متغير يتبع الفرع الرئيسي. لا تعتبر latest ضمانًا لإصدار مستقر مثبت. كذلك، توجد صورة slim أخف، لكنها تحتاج خدمات خارجية لبعض قدرات المستندات والصوت والتضمين؛ ليست اختيارنا في هذا الدليل العام.
4. افتح الواجهة وأنشئ حساب الإدارة
افتح:
http://localhost:3000أنشئ أول حساب إدارة. وفق دليل البداية الحالي، الحساب الأول هو المسؤول عن إعدادات النسخة والمستخدمين. احتفظ ببيانات دخوله بطريقة آمنة.
إذا شغّلت الأمر على خادم بعيد، فإن localhost في متصفحك يشير إلى جهازك، لا إلى الخادم. استخدم وسيلة وصول آمنة مثل SSH port forwarding، أو صمّم وصول الشبكة وTLS بصورة منفصلة. لا تفتح منفذ الخدمة للعامة لمجرد الوصول إلى شاشة الإعداد.
ربط أول نموذج واستخدامه
المسار الأبسط: API سحابي
من صورة حسابك، افتح Settings > Admin > Connections. لإضافة OpenAI:
أضف اتصالًا من Manage OpenAI API Connections.
أدخل العنوان https://api.openai.com/v1.
أدخل مفتاح API الخاص بك داخل إعداد الاتصال، ثم احفظه.
ابدأ محادثة جديدة واختر نموذجًا متاحًا لحسابك.
للمزودين الآخرين، اتبع دليلهم وعنوان API الصحيح. لا تفترض أن كل مزود يقبل إعداد OpenAI نفسه. وقد تحتاج إلى إدخال Model IDs يدويًا إذا لم يوفر المزود قائمة نماذج.
استخدم سؤالًا قصيرًا للاختبار، مثل: "اشرح الفرق بين الواجهة والنموذج في فقرتين". الرد المتوقع هنا هو إجابة من النموذج المختار؛ جودة الإجابة وحدها لا تثبت سلامة كل إعدادات الخدمة. راقب أخطاء الاتصال والفوترة وحدود حساب المزود.
خيار محلي: Ollama
إذا كان Ollama مثبتًا ويعمل على الجهاز، يمكنك تنزيل نموذج للتجربة، مثل:
ollama pull qwen3:4bهذا مثال متاح في مكتبة Ollama، وليس توصية بأنه الأفضل لكل جهاز أو مهمة عربية. اختيار الحجم المناسب يعتمد على الذاكرة والأداء المطلوب.
في اتصال Ollama داخل OpenWebUI، عنوان الوصول من حاوية Docker إلى المضيف هو عادة:
http://host.docker.internal:11434لكن Ollama الذي يستمع إلى loopback فقط قد لا يقبل الاتصال من حاوية منفصلة، خصوصًا على Linux. إذا لم تظهر النماذج، راجع دليل الشبكة الرسمي. أي تغيير في عنوان الاستماع يحتاج إلى جدار حماية يقيّد الوصول؛ لا تجعل واجهة Ollama غير المحمية متاحة للإنترنت.
يمكنك أيضًا استخدام خادم Ollama داخلي آخر أو API محلي متوافق مع OpenAI، مع ضبط البروتوكول والعنوان الصحيحين.
أول استخدام مفيد
بعد ظهور النموذج، ابدأ بمهمة تستطيع تقييمها: تلخيص نص تعرفه، أو شرح مقطع كود صغير. ثم جرّب ملفًا غير حساس واسأل عن معلومة محددة فيه، مع مراجعة الإجابة مقابل النص الأصلي.
إذا قارنت نموذجًا محليًا وسحابيًا، تذكّر أن السياق يُرسل إلى كل جهة تختارها. تجنّب بدء التجربة ببيانات عميل أو مفاتيح أو مستندات داخلية غير مصرح باستخدامها.
عندما لا يعمل الإعداد كما تتوقع
إذا لم تفتح الواجهة، افحص حالة الحاوية وسجلاتها:
docker ps --filter name=open-webui
docker logs --tail 100 open-webuiهذه أوامر تشخيص، وليست نتيجة اختبار نفذناه في هذا المقال. لا تنشر السجلات كاملة قبل مراجعتها؛ قد تحتوي على عناوين أو معلومات خاصة.
إذا كانت قائمة النماذج فارغة، ابدأ بالاتصال لا بالإضافات: عنوان المزود، وصلاحية المفتاح، وإمكانية وصول الحاوية إلى الخادم، ووجود نموذج منزل في Ollama.
وإذا فشل التعامل مع ملف، افحص نوعه ومحرك الاستخراج والتضمين. نجاح محادثة نصية لا يثبت جاهزية مسار RAG.
قبل التحديث أو مشاركة الخدمة
انسخ البيانات احتياطيًا قبل التحديث، واحتفظ بالمفتاح والـvolume، واقرأ تغييرات الإصدار. لا تجرّب نسخة تطوير على بيانات الإنتاج نفسها.
قبل مشاركة الخدمة، راجع TLS والمصادقة والتسجيل الجديد وصلاحيات الأدوات. Functions وWorkspace Tools قادرة على تنفيذ كود على الخادم، لذلك لا تمنح صلاحية استيرادها لمستخدم غير موثوق.
راجع أيضًا ترخيص المشروع. لا يصح وصف الترخيص الحالي بأنه MIT أو BSD بلا شروط؛ يتضمن شروطًا متعلقة بالحفاظ على علامة Open WebUI، وتحتاج إعادة توزيع الخدمة أو تعديل علامتها إلى قراءة الشروط المطبقة.
البداية التي ننصح بها
ثبّت نسخة محلية، واربط نموذجًا واحدًا، واختبر محادثة قصيرة وملفًا غير حساس. بعد أن تفهم مسار البيانات والتكلفة، أضف ميزة تحل حاجة فعلية: معرفة من مستنداتك، أو أداة محددة، أو نموذجًا آخر للمقارنة.
في المقال التالي من هذه السلسلة، ننتقل إلى اختيار Functions وTools بدل Pipelines: أين يعمل الكود، ومتى تحتاج خدمة خارجية، وما الذي يجب مراجعته قبل استيراد إضافة. أما الآن، فراجع حدود الوكيل الآمنة قبل منح نموذجك أدوات ذات أثر على أنظمتك.
المصادر
شعار الغلاف من مستودع Open WebUI الرسمي. المقال مستقل ولا يمثل المشروع، ولا يقدم ضمانًا للأداء أو للخصوصية بمجرد التثبيت.
لا تعليقات بعد. شارك سؤالك أو تجربتك مع هذا الدليل.