دروس فالذكاء الاصطناعي

ثبّت واستعمل Open WebUI للذكاء الاصطناعي المستضاف ذاتيًا

تعلّم كيفاش تثبّت Open WebUI باستعمال pip ولا Docker، وتربطو مع Ollama ولا واجهة API متوافقة مع OpenAI، وتبدا تهضر مع الموديلات. هاد الدليل كيعرفك حتى على استرجاع الوثائق، محتوى الويب، المحادثات مع بزاف ديال الموديلات، الخدمة بلا إنترنت، تسريع GPU، حلّ المشاكل، وميزات موجهة للاستعمال فالإنتاج.

August 20, 2026حوالي 20 دقايق ديال القراية

ثبيت واستعمال Open WebUI للذكاء الاصطناعي المستضاف ذاتيًا

شنو هو Open WebUI؟

Open WebUI هو منصّة ذكاء اصطناعي قابلة للتوسيع وكتستضاف محلياً، ومصمّمة باش تخدم بالكامل بلا إنترنت ملي كتكون مهيّأة بموارد محلية. كتوفّر واجهة عبر المتصفّح لنماذج Ollama المحلية، وواجهات API المتوافقة مع OpenAI، ومحرّك استدلال مدمج للتوليد المعزّز بالاسترجاع، اللي كيتسمّى غالباً RAG.

تقدر تستعملها كمساحة عمل شخصية للذكاء الاصطناعي ولا تنشرها لفريق. بالإضافة للمحادثات، المنصّة فيها الملاحظات، والقنوات المشتركة، والذاكرة الدائمة، والتقويمات، والأتمتة المجدولة، وتكاملات توليد الصور، ومكالمات الصوت والفيديو، والتحليلات، وتقييم النماذج، والتحكّم الدقيق فالصلاحيات.

أهم المزايا

ربط مرن مع النماذج: استعمل نماذج Ollama المحلية جنباً إلى جنب مع خدمات متوافقة مع OpenAI بحال LMStudio وGroqCloud وMistral وOpenRouter وvLLM.
RAG محلي: زِد الوثائق للمحادثات ولا استرجع الملفات من مكتبة المعرفة باستعمال الأمر #. المنصّة كتدعم البحث الهجين، وإعادة الترتيب، وعدّة محرّكات لاستخراج المحتوى، وتسع قواعد بيانات متجهية.
النماذج والوكلاء: غلّف نموذجاً أساسياً بتعليمات مخصّصة، ومعرفة، وأدوات، ومتغيّرات ديناميكية، وقواعد للصلاحيات حسب المستخدم أو المجموعة.
القابلية للتوسيع: زِد Filters وActions وPipes وTools وSkills، ولا ربط خوادم الأدوات MCP وMCPO وOpenAPI.
التعاون: استعمل الملاحظات، والقنوات الفورية، وسلاسل النقاش، والتفاعلات، والتثبيتات، والتقويمات المشتركة، والجدولة بمساعدة الذكاء الاصطناعي.
تعدّد الوسائط: هيّأ تحويل الكلام إلى نص، وتحويل النص إلى كلام، ومكالمات الصوت والفيديو، ومحرّكات توليد الصور أو تعديلها.
الإدارة: دبّر الأدوار، والمجموعات، والصلاحيات، والمصادقة، وتحليلات الاستعمال، وتقييمات النماذج، والتخزين، وقابلية المراقبة.
مرونة النشر: ثبّت المنصّة باستعمال pip أو uv أو Docker أو Docker Compose أو Kubernetes أو Kustomize أو Helm.
واجهة متجاوبة: استعمل Open WebUI فالحاسوب ولا فالهاتف، ولا ثبّتها كتطبيق ويب تقدّمي.

اختار طريقة التثبيت

إلى بغيتي تجربة محلية سريعة، استعمل pip ولا Docker. pip كيشغّل Open WebUI مباشرة من Python، بينما Docker كيوفّر نشر معزول وكيخلّيك تختار بين الصور العادية، أو المجهّزة بـ CUDA، أو المرفقة بـ Ollama.

مهم: خاص كل أمر Docker يركّب open-webui:/app/backend/data. هاد المجلّد الدائم كيحمي قاعدة البيانات وباقي بيانات التطبيق ملي كيتبدّل الكونتينر ولا كيتحيد.

الخيار 1: التثبيت باستعمال Python pip

Open WebUI كتحتاج Python 3.11 فالتثبيت باستعمال pip الموضّح فالمشروع. تأكّد باللي البيئة ديالك كتستعمل نسخة Python الصحيحة قبل ما تبدا.

ثبّت الحزمة:
```
pip install open-webui
```
شغّل الخادم:
```
open-webui serve
```
حلّ http://localhost:8080 فالمتصفّح ديالك.

الخيار 2: شغّل Open WebUI باستعمال Docker

الربط مع Ollama فالحاسوب المضيف

إلى كان Ollama خدام من قبل فنفس الحاسوب اللي فيه Docker، شغّل صورة Open WebUI العادية وزِد تعيين المضيف باش يقدر الكونتينر يوصل للحاسوب المضيف:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

من بعد ما يبدا الكونتينر، دخل لـ http://localhost:3000.

الربط مع Ollama فخادم آخر

عيّن OLLAMA_BASE_URL لعنوان خدمة Ollama البعيدة:

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

بدّل https://example.com بعنوان URL الحقيقي لخادم Ollama.

فعّل دعم بطاقة Nvidia GPU

Open WebUI كتوفّر صورة موسومة بـ CUDA. ثبّت حزمة حاويات Nvidia CUDA فـ Linux ولا WSL قبل ما تشغّلها:

docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:cuda

استعمل غير OpenAI API

إلى ما محتاجش Ollama، مرّر مفتاح OpenAI API للصورة العادية:

docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

بدّل your_secret_key ببيانات الاعتماد المناسبة. Open WebUI تقدر حتى تربط مع واجهات API أخرى متوافقة مع OpenAI، مع إعدادات خاصة بكل مزوّد موثّقة فالمشروع.

شغّل Open WebUI وOllama فكونتينر واحد

الصورة :ollama فيها Open WebUI وOllama مجموعين. كتستعمل مجلّداً واحداً لنماذج Ollama ومجلّداً آخر لبيانات تطبيق Open WebUI.

Ollama مرفق مع GPU

docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

Ollama مرفق باستعمال CPU فقط

docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

حلّ http://localhost:3000 من بعد ما يبدا الكونتينر.

الاستعمال الأساسي

حلّ الواجهة: استعمل البورت 8080 لإعداد pip، ولا البورت 3000 لأوامر Docker العادية اللي فوق.
استعمل موديل متاح: بدا محادثة مع موديل مفعّل فالاتصال اللي مكوّن، سواء كان Ollama ولا متوافق مع OpenAI.
كتب برومبتات أغنى: الردود كتدعم Markdown وLaTeX، وهاد الشي كيخلي الواجهة مناسبة للشروحات المنظمة، والكود، والجداول، والرموز الرياضية.
كمّل بين الأجهزة: الواجهة المتجاوبة كتخدم فالحاسوب والهاتف، ودعم Progressive Web App كيعطي تجربة شبيهة بالتطبيق.

استعمل الوثائق مع RAG

زيد الوثائق مباشرة لمحادثة، ولا جيبها من المكتبة ديالك باستعمال الأمر #. Open WebUI يقدر يستخرج ويفهرس المحتوى، ويجيب المقاطع المناسبة، ويدخلها فالسياق ديال الموديل. حزمة RAG ديالو كتدعم البحث الهجين BM25 والمتجهي، وإعادة الترتيب، ووضع السياق الكامل.

فالنشرات الكبيرة، الخيارات المدعومة لقواعد البيانات المتجهية كتشمل ChromaDB وPGVector وQdrant وMilvus وElasticsearch وOpenSearch وPinecone وS3Vector وOracle 23ai.

دخل موقع إلكتروني فمحادثة

استعمل الأمر # متبوع برابط باش تجيب محتوى الموقع لمحادثة. ويمكن حتى تهيئة Open WebUI باش يخلي الموديلات تجيب محتوى الويب ملي كيكون ضروري.

قارن بين عدة موديلات

المحادثات متعددة الموديلات كتخليك تتفاعل مع عدة موديلات فآن واحد. هاد الشي مفيد إلا بغيتي تقارن طريقة التفكير، ولا أسلوب الكتابة، ولا سلوك المزوّد. وحتى المسؤولين يقدرو يستعملو الساحة المدمجة، واختبارات A/B، ولوائح الترتيب المبنية على ELO لتقييم الموديلات.

نصائح متقدمة للإعداد

صايب موديلات ووكلاء متخصصين

جمع موديل أساسي مع تعليمات مخصصة، وأدوات، ومعارف باش تصايب وكيل متخصص. المتغيرات الديناميكية، وقواعد التحكم فالوصول حسب المستخدم ولا المجموعة، كتمكّن من تكييف الوكيل مع فرق مختلفة. ويمكن حتى استيراد الإعدادات المسبقة ديال المجتمع من مجتمع Open WebUI.

وسّع المنصة

Open WebUI كيدعم Filters وActions وPipes وTools وSkills. ويمكن ربط الخدمات الخارجية عبر خوادم أدوات MCP وMCPO وOpenAPI. هاد نقاط التوسعة كتقدر تدعم التكاملات المخصصة، ومسارات الموافقة، وحدود المعدل، واتصالات إضافية بالبيانات.

خطط للنشرات ديال الفرق والمؤسسات

فبيئات متعددة المستخدمين، استعمل الأدوار والمجموعات والصلاحيات للتحكم فالوصول. Open WebUI كيدعم التكامل مع LDAP وActive Directory، وتسجيل الدخول الموحد المبني على trusted-header وOAuth، وتوفير SCIM 2.0 لمزوّدي الهوية بحال Okta وAzure AD وGoogle Workspace.

يمكن استعمال SQLite للتخزين، اختيارياً مع التشفير، ولا PostgreSQL. ويمكن تخزين الملفات محلياً ولا فـ S3 أو Google Cloud Storage أو Azure Blob Storage. الجلسات المدعومة بـ Redis ودعم WebSocket كيمكّنو من النشرات متعددة العمال والعُقد وراء موازِنات التحميل، بينما OpenTelemetry كيوفّر التتبعات والمقاييس والسجلات.

خدم بلا إنترنت نهائياً

ملي كتخدم Open WebUI فبيئة بلا إنترنت، عيّن HF_HUB_OFFLINE على 1 باش تمنع محاولات تحميل الموديلات من الإنترنت:

export HF_HUB_OFFLINE=1

النشر بلا إنترنت باقي كيحتاج جميع الموديلات الضرورية، والاعتماديات، والخدمات المحلية تكون متاحة فالبيئة.

جرّب صورة التطوير بحذر

الصورة :dev فيها تغييرات غير مستقرة وحديثة بزاف، وقد يكون فيها أخطاء ولا ميزات ناقصة. استعملها غير إلا كنت قابل بهاد المخاطرة:

docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui --add-host=host.docker.internal:host-gateway --restart always ghcr.io/open-webui/open-webui:dev

حلّ أخطاء الاتصال مع Ollama

واحد المشكل الشائع فـ Docker كيوقع ملي ما كيقدرش Open WebUI يوصل لـ Ollama على 127.0.0.1:11434 ولا host.docker.internal:11434 من داخل الحاوية. واحد الحل الموثّق فالأنظمة المدعومة هو استعمال شبكة المضيف:

docker run -d --network=host -v open-webui:/app/backend/data -e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always ghcr.io/open-webui/open-webui:main

بهذا الأمر، دخل لـ Open WebUI من http://localhost:8080 بلاصة البورت 3000.

إلا بقى الاتصال ما خدامش، تأكد بلي Ollama خدام، وتحقق من العنوان ديالو، وراجع وثائق حل مشاكل Open WebUI. بيئات Docker تقدر تحتاج إعدادات إضافية للشبكة.

الصيانة والأمان

تبع دليل التحديث الرسمي ملي كتبدّل ولا كتحدّث النشر.
خلي وحدة تخزين Docker الدائمة مربوطة أثناء التحديثات باش ما تضيعش بيانات التطبيق.
راجع رخصة المشروع وتاريخ الرخص، حيث إن قاعدة الكود فيها مكوّنات خاضعة لرخص متعددة، ومن بينها متطلبات العلامة التجارية للكود الحالي المرخّص من Open WebUI.
بلّغ بشكل سري على الثغرات المشكوك فيها عبر برنامج الإفصاح المسؤول فـ GitHub ديال المشروع، وماشي عبر قنوات المجتمع العمومية.

الخلاصة

كيوفّر Open WebUI واجهة مرنة باش تشغّل نماذج الذكاء الاصطناعي المحلية والمستضافة باستعمال البنية التحتية اللي كتتحكّم فيها. بدا بـ Python 3.11 ولا بنشر دائم عبر Docker، وربط Ollama ولا واجهة API متوافقة مع OpenAI، ومن بعد وسّع الاستخدام ديالك ليشمل RAG والوكلاء والإضافات والتعاون والتحليلات وخدمات الإنتاج القابلة للتوسّع. لمزيد من خيارات النشر، راجع الوثائق الرسمية ديال البدء.