تثبيت Open WebUI وتهيئة OmniProxy

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

إنها مناسبة للاستخدام طويل الأمد من قبل الفرق والمؤسسات. تظهر القدرات التي تتلقى تحديثات أسرع أولاً في Computer، وهو المنتج الذي يستخدمه Open WebUI لتجربة الميزات الجديدة.

قبل البدء

يتوفر Open WebUI على macOS وLinux وWindows. يمكنك تثبيته باستخدام Docker أو Python أو Kubernetes. يقوم Docker بتغليف التطبيق وبيئة تشغيله في حاوية معزولة نسبياً وهو الطريقة الموصى بها. إذا لم يكن Docker متاحاً، يمكنك أيضاً استخدام أمر Python الذي تم اختباره أدناه. Kubernetes هو نظام لنشر وإدارة الحاويات؛ راجع التشغيل السريع المرتبط في نهاية هذا الدليل للحصول على الخطوات المقابلة.

موصى به رسمياً

Docker

• أمر docker run واحد
• افتح 3000 في المتصفح
• يتم تخزين البيانات في وحدة التخزين (volume)

فقط أريد الدردشة

صورة slim

• حجم تنزيل أصغر
• قم بتغيير العلامة إلى :slim
• تظل وظيفة الدردشة متاحة

غير مغطى هنا

خياران آخران

• تثبيت Python اليدوي
• نشر Kubernetes
• راجع التشغيل السريع الرسمي

قبل البدء، قم بإعداد ما يلي:

• Docker مثبت ويعمل.
• سلسلة سرية تستخدمها أنت فقط. قم بتشغيل openssl rand -hex 32 لإنشاء واحدة، ثم أدخلها كـ WEBUI_SECRET_KEY. احفظ هذه القيمة بشكل دائم. إذا قمت بتغييرها عند إعادة بناء الحاوية، فسيتم تسجيل خروج المستخدمين الذين قاموا بتسجيل الدخول بالفعل.
• مثيل OmniProxy يعمل ومعرف نموذج من قائمة النماذج الحالية الخاصة به. معرف النموذج هو الاسم الكامل المستخدم لتحديد نموذج معين.

التثبيت والتشغيل لأول مرة

افتح سطر أوامر وقم بتشغيل الأمر من التشغيل السريع. استبدل أولاً your-secret-key بالسر الذي أنشأته للتو:

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

تخدم الأجزاء التالية من هذا الأمر أغراضاً مختلفة:

• -p 3000:8080: يتيح لك فتح الواجهة من خلال المنفذ 3000 على هذا الكمبيوتر. إذا كان المنفذ 3000 قيد الاستخدام بالفعل، فقم بتغيير الرقم الموجود على اليسار.
• -v open-webui:/app/backend/data: يخزن الدردشات والمستخدمين والإعدادات في وحدة تخزين بيانات. وحدة تخزين البيانات هي موقع خارج الحاوية حيث يتم الاحتفاظ بالبيانات على المدى الطويل، لذلك تظل محتوياتها بعد تحديث الحاوية. لا تقم بإزالة هذا الخيار.
• --add-host=host.docker.internal:host-gateway: يسمح للحاوية بالوصول إلى الخدمات الأخرى التي تعمل على هذا الكمبيوتر.
• --restart always: يبدأ الحاوية مرة أخرى بعد إعادة تشغيل الكمبيوتر.

بعد انتهاء الأمر، افتح http://localhost:3000 في متصفح واتبع التعليمات التي تظهر على الشاشة لإنشاء الحساب الأول.

إذا كنت تحتاج فقط إلى الدردشة من خلال API، يمكنك تغيير علامة الصورة من :main إلى :slim. slim هي صورة أصغر لا تتضمن نماذج الكلام والتضمين المحلية داخل الحاوية، ولكن تظل واجهة الدردشة متاحة. استمر في استخدام :main إذا كنت بحاجة إلى تلك القدرات المحلية.

للتحديثات اليدوية، قم أولاً بتشغيل docker rm -f open-webui، ثم قم بتشغيل docker pull ghcr.io/open-webui/open-webui:main، وأعد تشغيله بنفس أمر docker run. احتفظ بكل من وحدة تخزين البيانات وWEBUI_SECRET_KEY دون تغيير.

إذا كان Docker غير متاح

يوفر التشغيل السريع أيضاً طريقة تثبيت Python. في 2026-10-09، تم استخدام الأمر التالي على macOS لتثبيت Open WebUI v0.11.4 وإكمال محادثة واحدة. لم يكن Docker Desktop مثبتاً على ذلك الكمبيوتر في ذلك الوقت.

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

بعد بدء التشغيل، افتح http://localhost:8080 في متصفح. هذا هو المنفذ الذي يستخدمه تثبيت Python، وليس منفذ Docker 3000.

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

يجب أن يشير DATA_DIR إلى دليل سيتم الاحتفاظ به على المدى الطويل ويستخدم لتخزين بيانات Open WebUI. إذا لم يتم تعيينه، فقد يتم تخزين البيانات في دليل مؤقت وفقدانها بعد إيقاف التشغيل. إذا لم يتم تعيين WEBUI_SECRET_KEY، يكتب البرنامج .webui_secret_key في الدليل الحالي. ابدأ تشغيله من دليل تنوي الاحتفاظ به، أو قم بتعيين هذا المتغير بنفسك.

الحصول على تفاصيل الاتصال من OmniProxy

انسخ العناصر الثلاثة التالية من مثيل OmniProxy الخاص بك:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

URL هو العنوان الذي يستخدمه Open WebUI للاتصال بنقطة النهاية ويجب أن ينتهي بـ /v1. لا تضف /chat/completions بعده؛ يقوم Open WebUI بإلحاق هذا الجزء تلقائياً.

انسخ معرف النموذج الكامل من قائمة OmniProxy الحالية. إذا كان المعرف يتضمن بادئة مصدر وشرطة مائلة، فاحتفظ بها أيضاً. الاسمان المختصران التاليان هما مجرد مراجع من وثائق المزود اعتباراً من 2026-10-09. لا تستخدمهما إذا لم تكن في القائمة الحالية:

• معرف Claude API لـ Claude Sonnet 5.5: claude-sonnet-5-5
• اسم API لـ Gemini 3.8 Flash: gemini-3.8-flash

لا تدخل مفتاح مزود في Open WebUI. إذا لم تقم البوابة بالتحقق من المفاتيح، فاترك مفتاح API فارغاً بدلاً من اختراع مفتاح آخر.

المتصفح

المنفذ المحلي 3000

• افتح صفحة الدردشة
• أكمل التسجيل أولاً
• ثم افتح الإعدادات

داخل الحاوية

Open WebUI

• لا تستخدم localhost
• استخدم اسم الجهاز المضيف بدلاً من ذلك
• URL ينتهي بـ /v1

نفس الكمبيوتر

OmniProxy

• احتفظ بالمفتاح في البوابة
• استخدم قائمة نماذج البوابة
• ثم راجع سجلات الطلبات

إذا كانت خدمة النموذج تعمل على المضيف بينما يعمل Open WebUI في حاوية Docker، فاستبدل localhost في URL بـ host.docker.internal. المضيف هو الكمبيوتر الذي يشغل Docker مباشرة. إذا كان OmniProxy يستمع فقط على هذا الكمبيوتر، فيمكن كتابة URL كـ http://host.docker.internal:port/v1، مع استبدال port بالمنفذ الذي يستخدمه OmniProxy فعلياً.

إذا كان Open WebUI يعمل محلياً من خلال أمر Python في القسم السابق وكان OmniProxy يعمل أيضاً محلياً، فاستخدم 127.0.0.1 أو localhost في العنوان. لا تستخدم host.docker.internal في هذه الحالة.

إدخال التكوين

في واجهة v0.11.4 التي تم اختبارها في 2026-10-09، كانت الأسماء تختلف عن Settings > Admin > Connections في التعليمات الإنجليزية. اتبع الخيارات الموضحة في الواجهة التي تم اختبارها، والمترجمة أدناه:

1. قم بتوسيع الشريط الجانبي الأيسر.
2. انقر فوق قائمة المستخدم في الأسفل.
3. انقر فوق Settings.
4. في قسم المسؤول أدناه، انقر فوق External Connections.
5. افتح OpenAI API.
6. انقر فوق + على يمين Manage OpenAI API Connections.
7. في مربع الحوار Edit Connection، أدخل URL الذي ينتهي بـ /v1. احتفظ بنوع API مضبوطاً على Chat Completions.
8. احتفظ بـ Authentication Method مضبوطاً على Key (Bearer). تضع مصادقة Bearer مفتاح API في الطلب للتحقق من الهوية. إذا أعطاك OmniProxy مفتاحاً، فأدخله تحت API Key. إذا لم تقم البوابة بالتحقق من المفاتيح، فاترك هذا الحقل فارغاً. في 2026-10-09، نجح كل من التحقق ومحادثة واحدة مع ترك الحقل فارغاً.
9. انقر فوق Verify Connection بجوار URL. إذا قدم OmniProxy /models، فسيتم استرداد قائمة النماذج هنا.
10. افتح Advanced. إذا تم ترك Model ID فارغاً، فسيتم استخدام جميع النماذج التي تم إرجاعها بواسطة /models في ذلك العنوان. فقط إذا فشل التحقق، أدخل معرفاً كاملاً من القائمة تحت Add Model ID، ثم انقر فوق Add. أضف كل معرف مرة واحدة فقط؛ تتم إزالة المسافات البادئة واللاحقة.
11. انقر فوق Save في هذه النافذة، ثم انقر فوق Save في الزاوية اليمنى السفلية من صفحة External Connections.

حفظ التكوين وحده لا يحل محل التحقق. يطلب Verify Connection نقطة نهاية /models الخاصة بالخدمة الأخرى، والتي تسرد النماذج المتاحة. لا توفر بعض الخدمات نقطة النهاية هذه، لذا قد يبلغ التحقق عن خطأ على الرغم من أن الدردشة قد لا تزال تعمل. في هذه الحالة، أضف معرف النموذج يدوياً.

التحقق من مهمة حقيقية

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

في 2026-10-09، تم إكمال هذه المحادثة باستخدام تثبيت Python لـ v0.11.4. يظل Docker هو الطريقة الموصى بها، ولكن لم يتم تكرار الاختبار في Docker.

بعد ذلك، افتح سجلات طلبات OmniProxy وتأكد من المصدر ومعرف النموذج لهذا الطلب. رؤية حفظ ناجح فقط، أو رؤية النموذج في القائمة فقط، لا يعتبر إكمالاً.

الواجهة

يمكن تحديد النموذج

• تم حفظ الاتصالات
• يظهر النموذج في القائمة
• أرسل سؤالاً قصيراً

الاستجابة

يظهر مربع الدردشة إجابة

• ليست رسالة فارغة
• ليس خطأ اتصال
• حاول مرة أخرى مع نموذج آخر

السجلات

مرئية في البوابة

• المصدر هو هذا الاتصال
• معرف النموذج يطابق
• لم يتم إدخال مفتاح في الصفحة

الأخطاء الشائعة

• تم استخدام localhost أو 127.0.0.1 داخل الحاوية: تشير هذه العناوين إلى الحاوية نفسها، وليس المضيف. قم بتغيير العنوان إلى host.docker.internal وتأكد من أن أمر بدء التشغيل يتضمن --add-host=host.docker.internal:host-gateway. ينطبق العكس عندما لا يعمل Open WebUI في حاوية: استخدم عنواناً محلياً بدلاً من ذلك.
• لا يمكن للمتصفح فتح الصفحة: بالنسبة لـ Docker، تحقق من المنفذ 3000؛ بالنسبة لـ Python، تحقق من المنفذ 8080. أثناء بدء التشغيل الأول، انتظر حتى ينتهي تنزيل نموذج التضمين. يمكنك استخدام docker ps للتأكد مما إذا كانت الحاوية تعمل. إذا كان المنفذ 3000 قيد الاستخدام بالفعل، فقم بتغيير المنفذ على الجانب الأيسر من -p.
• المعرف في قائمة النماذج أطول من الاسم المختصر للمزود: استخدم المعرف الكامل من القائمة، بما في ذلك أي شرطات مائلة.
• تم تسجيل خروج الجميع بعد تحديث: تغير WEBUI_SECRET_KEY. أعد التشغيل باستخدام السر الذي تم إنشاؤه في المرة الأولى.
• يفشل Verify Connection: أضف معرف النموذج يدوياً أولاً تحت Advanced، ثم أكده بمحادثة حقيقية من جملة واحدة. لا توفر بعض الخدمات /models، لذا قد تظل الدردشة تعمل عندما يبلغ التحقق عن خطأ.
• النموذج غير موجود: انسخ المعرف مرة أخرى من قائمة OmniProxy الحالية بدلاً من الاستمرار في استخدام اسم قديم.

المراجع الرسمية

لأوامر التثبيت، راجع التشغيل السريع لـ Open WebUI. لخطوات الاتصال، راجع تعليمات الاتصال المتوافقة مع OpenAI. لمعرفات النماذج المستخدمة في الأمثلة، راجع نظرة عامة على نموذج Claude وقائمة نماذج Gemini.

استبدل كل عنصر نائب بقيم من تكوين OmniProxy الخاص بك. لا تنشر أبدًا مفتاحًا حقيقيًا.

نتيجة محفوظة أو HTTP 200 وحدها لا تثبت توافق الوكيل الكامل. تحقق من المصدر والنموذج في سجل طلبات OmniProxy.

المصادر الرسمية · Open WebUI ↗