Open WebUI مثبَّت عند إنشاء خادمك
إذا اخترت Open WebUI عند طلب خادمك من ServOrbit، فلا شيء عليك تثبيته. عند إنشاء الخادم، تثبّت ServOrbit أداة Docker إن لم تكن موجودة، ثم تشغّل الحاوية الرسمية ghcr.io/open-webui/open-webui:main مع حفظ بياناتها في وحدة التخزين open-webui. تستمع الواجهة على 127.0.0.1:3000، أي على واجهة الاسترجاع المحلية للخادم: لا يُنشر شيء على عنوان IP الخاص به. ولا يُثبَّت Ollama معه: يحتاج Open WebUI وحده إلى 2 GB من الذاكرة، وإذا أضفت Ollama على الخادم نفسه فاحسب له 8 GB إضافية على الأقل. تكفي الخطوات الأربع التالية لفتحه. أما التثبيت اليدوي، لخادم آخر أو لإعادة بناء كل شيء بنفسك، فموصوف في آخر المقال.
فتح Open WebUI الذي ثبّتته ServOrbit
العثور على العنوان وبيانات الوصول
تُبيّن رسالة البريد «Open WebUI مثبَّتة» وصفحة خادمك في مساحة العميل، ضمن قسم «التطبيقات المثبّتة»، كيف تفتح التطبيق: عنوانه إن كان هناك نطاق مُعَدّ، وإلا فأمر نفق SSH والمنفذ. وتجد هناك أيضًا رابط هذا الدليل وزر «الدعم».
فتح Open WebUI دون نطاق
من حاسوبك، نفّذ
ssh -L 3000:127.0.0.1:3000 root@<vps-ip>واترك الجلسة مفتوحة، ثم افتحhttp://localhost:3000. قد يُعاد تخصيص المنفذ أثناء التثبيت: استخدم المنفذ المعروض في مساحة العميل، إذ ليس 3000 سوى القيمة الافتراضية في الكتالوج.تسجيل الدخول لأول مرة
افعل ذلك دون تأخير: يصبح أول حساب يُنشأ في شاشة التسجيل حساب المسؤول، وتبقى الحسابات التالية في انتظار موافقتك. اربط بعد ذلك نماذجك من لوحة الإدارة، ضمن قسم الاتصالات (Connections): مفتاح واجهة برمجية من OpenAI أو من خدمة متوافقة، أو عنوان مثيل Ollama يمكن الوصول إليه من داخل الحاوية.
النشر عبر HTTPS على نطاق
عندما يُثبَّت Open WebUI من مساحة العميل مع عنوان تختاره — نطاقك الخاص أو نطاق فرعي مجاني من ServOrbit — تتولّى المنصة إعداد المضيف الافتراضي في nginx وشهادة Let's Encrypt. أما التثبيت الذي جرى عند إنشاء الخادم، أو دون عنوان، فيُنشر من صفحة الخادم: زر «ربط نطاق» في خانة التطبيق (نطاق من حسابك، أو النطاق الفرعي المجاني، أو اسم توجّهه إلى الخادم).
لماذا تستضيف Open WebUI على خادم VPS بدلاً من الاستضافة المحلية؟
تعمل الاستضافة المحلية للاختبار، لكنها تعاني من قيود حقيقية في بيئة الإنتاج: استهلاك موارد الجهاز، وغياب الوصول عن بُعد، وانعدام التوافر العالي. يحل خادم VPS هذه المشكلات: فهو يعمل على مدار الساعة طوال أيام الأسبوع، ويمكن الوصول إليه من أي جهاز، وتتحكم فيه تحكماً كاملاً.
الفرق مع خدمة SaaS السحابية لا يقل وضوحاً. تُصدر أداة الذكاء الاصطناعي المُدارة فواتير عند الاستخدام، وتخزن محادثاتك على خوادم جهات خارجية، وتحدد النماذج المتاحة. يزيل Open WebUI المستضاف ذاتياً القيود الثلاث في آنٍ واحد: تدفع مقابل VPS لا مقابل الطلبات، وتبقى بياناتك على جهازك، وتختار النموذج الذي يناسبك.
محلي أم VPS أم SaaS: أي حل لـ Open WebUI؟
مرّر الجدول أفقيًا
| المعيار | الجهاز المحلي | VPS مخصص | SaaS سحابي |
|---|---|---|---|
| الوصول 24/7 من أي مكان | لا | نعم | نعم |
| البيانات على بنيتك التحتية | نعم | نعم | لا |
| حرية اختيار النموذج LLM | حرة | حرة | مقيدة بالعرض |
| التكلفة بعد الموارد الثابتة | معدومة | معدومة | فوترة عند الاستخدام |
| متعدد المستخدمين والأدوار | صعب | نعم (مدمج) | يعتمد على الخطة |
| التثبيت والصيانة | يدوي | يدوي أو من المتجر | لا شيء |
ما الذي يمكنك فعله باستخدام Open WebUI
- الدردشة مع النماذج المحلية عبر Ollama (Mistral، LLaMA 3، Gemma، إلخ) أو مع واجهة OpenAI API
- إدارة عدة نماذج والتبديل بينها بنقرة واحدة من واجهة موحّدة
- إنشاء ومشاركة مساعدين مخصّصين بتعليمات نظام مصمّمة حسب الطلب
- رفع وتحليل المستندات (PDF، نص) مباشرة داخل الدردشة بفضل دعم RAG المدمج
- فتح الوصول لفريقك عبر نظام حسابات مستخدمين وأدوار
- الاطّلاع على السجلّ الكامل لمحادثاتك، المخزَّن على خادمك الخاص
تثبيت مفتاح التوقيع منذ أول تشغيل
يوقّع Open WebUI كل رمز جلسة بالمفتاح WEBUI_SECRET_KEY. إن لم تصرّح به، يُولَّد عشوائياً عند أول تشغيل ويُكتب في دليل البيانات: وما دامت وحدة التخزين باقية فلا مشكلة. لكن يوم يُعاد إنشاء تلك الوحدة يتغيّر المفتاح، فتُرفض محاولتك رغم صحة بيانات الدخول — وهو عرَض مضلّل يدفع للبحث في كلمة المرور. المفتاح نفسه يشفّر أيضاً الأسرار المخزّنة (رموز OAuth وبيانات واجهات البرمجة)، ففقدانه لا يقطع الجلسات فحسب بل يجعل تلك الأسرار غير قابلة للقراءة. ولِّده مرة واحدة عبر openssl rand -hex 32، ضعه في ملف البيئة، وتعامل معه كسرٍّ إنتاج. وإن كنت تشغّل عدة نسخ خلف موزّع أحمال، فيجب أن تحمل جميعها القيمة نفسه، وإلا رفضت إحداها رمزاً أصدرته أخرى.
إعداد وصول متعدد المستخدمين
يتضمّن Open WebUI نظام حسابات وأدوار مدمجاً يتيح لعدة أعضاء في الفريق مشاركة نفس الحالة. افتراضياً، أول حساب يُنشأ يصبح مديراً. ويُوضع المستخدمون التاليون في قائمة انتظار التحقق إن فعّلت الإشراف على التسجيل — وهو خيار موصى به لمنع أي شخص من الوصول عبر المنفذ 3000 المكشوف على الإنترنت.
ثلاثة مستويات وصول متاحة: مدير (وصول كامل للإعدادات والنماذج والحسابات)، مستخدم (وصول للدردشات والمساعدين المشتركين)، وفي الانتظار (وصول محظور حتى موافقة يدوية). لضبط الإشراف:
1. سجّل الدخول بحساب المدير.
2. انتقل إلى الإعدادات ← الإدارة ← المستخدمون.
3. فعّل خيار « التسجيل بموافقة المدير ».
يمكنك أيضاً إنشاء مساعدين (إعدادات مسبقة للنموذج وتعليمات نظام) ومشاركتهم مع الحالة بأكملها أو مجموعات بعينها، دون حاجة المستخدمين لإعادة ضبط جلستهم.
استكشاف الأخطاء: المشكلات الشائعة
الحاوية تُعيد التشغيل في حلقة. تحقق من السجلات: docker logs open-webui. السبب الأكثر شيوعاً هو غياب WEBUI_SECRET_KEY أو تنسيقها الخاطئ — يجب أن تكون سلسلة سداسية عشرية غير فارغة. إن وُلِّدت عند الإطلاق دون حفظها في وحدة تخزين أو ملف .env، فإنها تتغير عند كل إعادة تشغيل الحاوية.
فشل الاتصال بـ Ollama («Could not connect to Ollama»). العنوان الافتراضي http://localhost:11434 لا يعمل من داخل حاوية Docker: localhost تشير إلى الحاوية نفسها لا إلى المضيف. استخدم http://host.docker.internal:11434 (على Linux: أضف --add-host=host.docker.internal:host-gateway إلى أمر docker run) أو شغّل الحاويتين في نفس شبكة Docker وأشر إلى حاوية Ollama باسمها.
خطأ 502 Bad Gateway بعد الوكيل العكسي. الوكيل Nginx يشير إلى المنفذ 3000 لكن Open WebUI يستمع داخلياً على المنفذ 8080 — أمر docker run يربط 3000:8080. تأكد أن الإعداد يشير إلى http://127.0.0.1:3000 لا 8080.
قطع WebSocket (تجمّد الواجهة). الترويسات Upgrade وConnection ضرورية لعمل WebSockets التي تعتمد عليها الواجهة. تحقق من أن كتلة proxy_set_header تتضمنهما معاً.
التوثيق الرسمي
لمزيد من التهيئة المتقدمة والخيارات الخاصة بالأداة وتغييرات الإصدارات، راجع التوثيق الرسمي لـ Open WebUI. يُغطّي هذا الدليل النشر على VPS من ServOrbit؛ ويبقى توثيق الناشر المرجع للإعدادات الدقيقة.
التثبيت اليدوي (حل بديل)
تصف الأقسام التالية تثبيت Open WebUI يدويًا عبر Docker: لخادم لم تثبّت عليه ServOrbit تطبيق Open WebUI، أو لإعادة بناء كل شيء بنفسك. أما على خادم ثبّتته عليه ServOrbit، فلا حاجة إليها.
المتطلبات المسبقة
يتطلب Open WebUI وجود Docker للعمل. ونموذج Ollama (إذا كنت ترغب في تشغيل نموذج LLM محلياً على الخادم) يستهلك قدراً كبيراً من ذاكرة RAM. خصّص ما لا يقل عن 4 غيغابايت من ذاكرة RAM لنموذج 7B، و8 غيغابايت لنموذج 13B. أما إذا كنت تستخدم واجهات برمجة التطبيقات الخارجية فقط (OpenAI، Anthropic)، فإن 2 غيغابايت من ذاكرة RAM تكفي للواجهة.
على صعيد التخزين، تزن نماذج Ollama بين 4 و40 غيغابايت بحسب حجمها. خصّص وحدة تخزين SSD بمساحة خالية لا تقل عن 20 غيغابايت إن كنت تعتزم تنزيل نموذج 7B كـ Mistral أو LLaMA 3.
النشر في 5 خطوات
تجهيز خادم VPS
اطلب خادم VPS سحابياً بنظام Ubuntu 22.04 LTS. حدّث النظام:
apt update && apt upgrade -yفعّل جدار الحماية UFW واسمح بمنافذ SSH (22) وHTTP (80) وHTTPS (443):
ufw allow 22 && ufw allow 80 && ufw allow 443 && ufw enableتثبيت Docker
ثبّت Docker Engine من مستودع Docker الرسمي. أضف مستخدمك إلى مجموعة docker لتجنّب تكرار أوامر sudo:
curl -fsSL https://get.docker.com | sh usermod -aG docker $USERتحقق من التثبيت:
docker run hello-world.تشغيل Open WebUI
اسحب صورة Docker الرسمية وشغّل الحاوية مع كشف المنفذ 3000. اربط وحدة تخزين (volume) للحفاظ على البيانات بين عمليات إعادة التشغيل:
docker run -d \ --name open-webui \ --restart always \ -p 3000:8080 \ -v open-webui:/app/backend/data \ -e WEBUI_SECRET_KEY=$(openssl rand -hex 32) \ ghcr.io/open-webui/open-webui:mainيمكن الوصول إلى Open WebUI على
http://your-ip:3000. يُولَّد المتغيرWEBUI_SECRET_KEYهنا عند التثبيت — سجّل قيمته أو ضعه في ملف.envقبل إعادة تشغيل الحاوية.إعداد وكيل عكسي (Nginx)
ثبّت Nginx وأعدّ مضيفاً افتراضياً (virtual host) يوجّه الطلبات إلى المنفذ 3000:
apt install -y nginx certbot python3-certbot-nginxأنشئ
/etc/nginx/sites-available/open-webuiبالمحتوى التالي:server { server_name your-domain.com; location / { proxy_pass http://127.0.0.1:3000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } }فعّل الموقع واحصل على شهادة SSL مجانية:
certbot --nginx -d your-domain.com. ستكون واجهتك متاحة عبر HTTPS على نطاقك.ربط نماذجك
في واجهة Open WebUI، أعدّ اتصالات واجهات برمجة التطبيقات: Ollama المحلي، أو OpenAI، أو Anthropic، أو أي مزوّد متوافق آخر. لتشغيل Ollama على الخادم نفسه:
docker run -d \ --name ollama \ --restart always \ -v ollama:/root/.ollama \ -p 11434:11434 \ ollama/ollamaثم نزّل النموذج المطلوب:
docker exec ollama ollama pull mistral. في إعدادات Open WebUI، عنوان URL لـ Ollama هوhttp://host.docker.internal:11434إن كانت الحاويتان على الجهاز نفسه. أنشئ صلاحيات المستخدمين حسب حاجتك.
