العودة إلى المدونة

استضافة Open WebUI ذاتيًا على خادم VPS: محادثة ذكاء اصطناعي خاصة لفريقك

فريق تحرير IM Host25 أكتوبر 20266 دقائق قراءة
استضافة Open WebUI ذاتيًا على خادم VPS: محادثة ذكاء اصطناعي خاصة لفريقك

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

ماذا تعني "خاصة" هنا؟

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

ما الذي تحتاجه؟

  • خادم Linux VPS مثبّت عليه Docker وإضافة Docker Compose.

  • نطاق أو نطاق فرعي يشير إلى الخادم، مثل chat.example.com.

  • مفتاح API من مزوّد يوفّر واجهة متوافقة مع OpenAI، إذا كنت ستستخدم نماذج مستضافة.

كقاعدة تقريبية، يعمل Open WebUI مع واجهات برمجية خارجية بارتياح لفريق صغير على 2 vCPU و4 جيجابايت ذاكرة. صورة الحاوية كبيرة الحجم، لذا اترك عدة جيجابايت فارغة على القرص. كما أن البحث في المستندات (RAG) يشغّل افتراضيًا نموذج تضمين (embedding) على الخادم، وهو ما يضيف حملًا على المعالج والذاكرة عند رفع الملفات.

تشغيل Open WebUI عبر Docker Compose

أنشئ مجلدًا مثل /opt/open-webui وأضف إليه ملف compose.yaml:

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    restart: unless-stopped
    ports:
      - "127.0.0.1:3000:8080"
    environment:
      WEBUI_URL: https://chat.example.com
      WEBUI_SECRET_KEY: replace-with-a-long-random-string
      OPENAI_API_BASE_URL: https://api.openai.com/v1
      OPENAI_API_KEY: replace-with-your-api-key
      ENABLE_OLLAMA_API: "false"
    volumes:
      - open-webui:/app/backend/data

volumes:
  open-webui:

أنشئ المفتاح السري بالأمر openssl rand -hex 32. هذا المفتاح يوقّع جلسات الدخول، لذا فإن تثبيت قيمته يُبقي المستخدمين مسجّلين بعد إعادة تشغيل الحاوية. ثم شغّل الخدمة:

cd /opt/open-webui
docker compose up -d
docker compose logs -f open-webui

ملاحظات على هذا الملف:

  • المنفذ مربوط بالعنوان 127.0.0.1، فلا يمكن الوصول إلى التطبيق من الإنترنت حتى يصبح الوكيل العكسي جاهزًا.

  • الوسم main يتبع أحدث إصدار. ولإعداد مستقر لفريق، ثبّت وسم إصدار محددًا وحدّث عن قصد.

  • جميع البيانات، بما فيها قاعدة المستخدمين والملفات المرفوعة، موجودة في وحدة التخزين open-webui، وهي ما تنسخه احتياطيًا.

  • كثير من الإعدادات تُحفظ في قاعدة البيانات بعد التشغيل الأول، وقد تُتجاهل التغييرات اللاحقة على متغيرات البيئة الخاصة بها، لذا عدّلها من لوحة الإدارة.

  • في الإنتاج انقل مفتاح API والمفتاح السري إلى ملف .env بصلاحيات مقيّدة.

أنشئ حساب المدير وأغلق التسجيل

أول حساب يُنشأ يصبح حساب المدير، لذا أنشئه فور التشغيل الأول قبل أن يصل أي شخص آخر إلى الصفحة. ثم من Admin Panel → Settings → General:

  • أوقف التسجيل الجديد وأنشئ حسابات الفريق بنفسك، أو

  • أبقِ التسجيل مفتوحًا مع جعل الدور الافتراضي للمستخدم pending، فينتظر كل حساب جديد موافقتك.

استخدم المجموعات والصلاحيات لتحديد النماذج المتاحة لكل مجموعة. وللفرق الأكبر يدعم Open WebUI الدخول الموحّد عبر OpenID Connect، فيستخدم الموظفون حسابات الشركة الحالية.

ربط مزوّدي API

من Admin Panel → Settings → Connections يمكنك إضافة أكثر من نقطة اتصال متوافقة مع OpenAI، لكل منها رابطها الأساسي ومفتاحها. كثير من المزوّدين وخوادم الاستدلال توفّر هذه الصيغة، فتعرض واجهة واحدة نماذج من مصادر متعددة. نقطتان عمليتان:

  • اضبط حدًا للإنفاق لدى كل مزوّد، فأداة محادثة مشتركة قد تستهلك رموزًا (tokens) أكثر مما تتوقع.

  • أخفِ النماذج التي لا تريد أن يستخدمها الفريق حتى تبقى التكلفة متوقعة.

إضافة HTTPS

يبث Open WebUI الردود تدريجيًا ويستخدم WebSockets، لذا يجب أن يمرّر الوكيل ترويسات الترقية وألا يخزّن الردود مؤقتًا. يتولى Caddy ذلك افتراضيًا ويحصل على الشهادة تلقائيًا:

chat.example.com {
    reverse_proxy 127.0.0.1:3000
}

ومع Nginx، هذه هي الأسطر المهمة داخل كتلة 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";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_read_timeout 300s;
client_max_body_size 50m;

دون ترويسات الترقية قد تتوقف المحادثات أو تظهر أخطاء اتصال في الصفحة. ودون proxy_buffering off تصل الإجابة كتلة واحدة في النهاية بدلًا من أن تظهر تدريجيًا. وارفع قيمة client_max_body_size إذا كان فريقك يرفع مستندات كبيرة.

تشغيل النماذج محليًا: الصورة الواقعية

يعمل Open WebUI جيدًا مع Ollama الذي يشغّل النماذج المفتوحة على خادمك. أضفه كخدمة ثانية:

  ollama:
    image: ollama/ollama
    restart: unless-stopped
    volumes:
      - ollama:/root/.ollama

أضف ollama: تحت volumes في المستوى الأعلى، ثم اضبط في خدمة Open WebUI القيمة OLLAMA_BASE_URL: http://ollama:11434 واحذف السطر ENABLE_OLLAMA_API: "false". بعد ذلك نزّل نموذجًا صغيرًا بالأمر docker compose exec ollama ollama pull llama3.2:3b.

والآن حقيقة العتاد: أداء النماذج اللغوية محكوم أساسًا بعرض نطاق الذاكرة، وبطاقات الرسوميات تملك منه أضعاف ما تملكه ذاكرة الخوادم.

  • النماذج الصغيرة تعمل على المعالج لكن ببطء. نموذج من 1 إلى 3 مليارات معامل بتكميم 4 بت يعمل على VPS بذاكرة كافية. توقّع أن تظهر الإجابة كلمة بكلمة، وهذا مقبول لشخص واحد ومزعج لفريق يستخدمه في الوقت نفسه.

  • الذاكرة هي الحد. كقاعدة تقريبية، يحتاج النموذج المكمّم بـ4 بت إلى ما يزيد قليلًا على نصف جيجابايت من الذاكرة لكل مليار معامل، إضافة إلى مساحة للسياق ونظام التشغيل. فنموذج بحجم 7–8 مليارات يحتاج إلى نحو 5–6 جيجابايت للنموذج وحده.

  • النماذج الكبيرة تحتاج إلى GPU. النماذج من فئة 30 إلى 70 مليار معامل، أو استخدام عدة أشخاص في الوقت نفسه، تتطلب خادمًا ببطاقة رسوميات مناسبة وذاكرة فيديو كافية. أما على VPS يعتمد على المعالج فقط، فهي أبطأ من أن تصلح للاستخدام اليومي.

لذلك فالإعداد العملي لمعظم الفرق هو Open WebUI على VPS بمعالج عادي مربوطًا بمزوّدي API، وربما مع نموذج محلي صغير للمهام البسيطة.

النسخ الاحتياطي والتحديث

انسخ وحدة التخزين احتياطيًا بانتظام واحتفظ بنسخة خارج الخادم:

docker run --rm -v open-webui_open-webui:/data -v /root/backups:/backup alpine \
  tar czf /backup/open-webui-$(date +%F).tar.gz -C /data .

يضيف Compose اسم المشروع قبل أسماء وحدات التخزين، فتأكّد من الاسم الدقيق عبر docker volume ls. وللتحديث: خذ نسخة احتياطية، وغيّر وسم الصورة إن كنت ثبّته، ثم نفّذ docker compose pull وdocker compose up -d. وللفرق الأكبر يمكن لـOpen WebUI تخزين بياناته في PostgreSQL عبر DATABASE_URL واستخدام pgvector للبحث في المستندات.

شغّله على IM HOST

تأتي استضافة وكلاء الذكاء الاصطناعي من IM HOST جاهزة بـDocker وNode.js وPython وPostgreSQL مع pgvector، وهو ما يغطي الإعداد في هذا الدليل، بما في ذلك الانتقال لاحقًا إلى PostgreSQL. وإذا أردت موارد مضمونة لفريقك، فخطط Cloud VPS تبدأ من 16 دولارًا شهريًا بأربع أنوية مخصّصة و8 جيجابايت ذاكرة و80 جيجابايت NVMe، مع نسخة احتياطية تلقائية مجانية كل 3 أيام وإمكانية الترقية في أي وقت. هذه خوادم تعتمد على المعالج، لذا فهي مناسبة لإعداد مزوّدي API والنماذج المحلية الصغيرة. مهندسونا متاحون على مدار الساعة، ويسري ضمان استرداد الأموال خلال 30 يومًا.

المزيد من مدونتنا

اكتشف المزيد من الأدلة العملية ورؤى الخدمات من فريق IM Host.

عرض كل المقالات