الذكاء الاصطناعي والبيانات الأدلة التقنية

Ollama وOpen WebUI: مساعد ذكي داخل شبكتك

نبني مساعداً لفريقك من Ollama وOpen WebUI بحسابات ومجموعات وصلاحيات على النماذج، ويجيب بالعربية من مستنداتك، مع ثلاث مشكلات حقيقية واجهتنا وحلها.

Ollama وOpen WebUI: مساعد ذكي داخل شبكتك

بعد أن يعمل Ollama على سيرفر داخل الشركة، يأتيك أول طلب من زميل لا يستخدم سطر الأوامر Command Line: «أريد أن أسأله كما أسأل ChatGPT». ثم يأتي الطلب الثاني من المدير: «لا أريد أن يرى قسم المبيعات النموذج الذي نجرب عليه عقود العملاء»، ثم الثالث من فريق الدعم: «هل يستطيع أن يجيب من دليل المنتج الذي عندنا؟». والحل البسيط أن تنشر منفذ Ollama على الشبكة وتعطي كل شخص برنامجاً يتصل به، والمشكلة أن واجهة Ollama لا تطلب أي مصادقة Authentication، وهي بحسب أسئلته الشائعة مربوطة على 127.0.0.1 افتراضياً لهذا السبب، فكل من يصل إلى المنفذ يستطيع أن يسأل أي نموذج، وأن يحمل نماذج جديدة، وأن يحذف الموجود، ولا يوجد أي سجل Log بمن سأل ماذا.

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

وسوف نناقش في هذا المقال ما يلي:

  • لماذا لا تنشر Ollama على الشبكة مباشرة، وما الذي تضيفه Open WebUI فوقه.
  • ملف Docker Compose كامل: Ollama دون أي منفذ منشور، وOpen WebUI، وقاعدة متجهات pgvector، وCaddy بشهادة TLS.
  • ثلاث مشكلات حقيقية واجهتنا في الطريق: شبكة Network داخلية تمنع تحميل النماذج، والنسخة المصغرة slim التي تحتاج قاعدة متجهات خارجية، ونموذج مخصص Custom Model لا يبحث في المستندات.
  • الحسابات والأدوار Roles والمجموعات Groups، والتحكم في من يرى أي نموذج Model Access Control.
  • قاعدة معرفة Knowledge Base من مستندات عربية، ونموذج مخصص يجيب منها مع ذكر المصدر.
  • الواجهة العربية، والنسخ الاحتياطي Backup والاستعادة Restore، والتحديث، وملاحظات الأمان.

لماذا Open WebUI أمام Ollama؟

قبل أن نبدأ، لنعرف الخيارات Options بسرعة، لأن Open WebUI ليست الواجهة الوحيدة. فهناك تطبيقات مكتبية مثل Jan وLM Studio تعمل على جهاز كل موظف وحده، وهذه مناسبة لشخص واحد، ولكنها لا تعطيك حسابات مركزية ولا مستندات مشتركة Shared Documents ولا سجلاً واحداً. وهناك واجهات ويب أخرى مثل LibreChat وAnythingLLM، ولكل منها نقاط قوة. واخترنا Open WebUI في هذا المقال لأنها الأكثر انتشاراً مع Ollama، وتجمع في مكان واحد ما يحتاجه فريق صغير: حسابات بأدوار، ومجموعات، وصلاحيات على كل نموذج وكل قاعدة معرفة، وبحثاً في المستندات RAG، وواجهة عربية.

ولاحظ قبل أن تبدأ نقطة عن الرخصة License: رخصة Open WebUI مبنية على BSD-3 ولكن أصحابها أضافوا شرطاً يمنع إزالة اسم Open WebUI وشعارها Logo من الواجهة إلا لمن لا يزيد مستخدموه عن 50 خلال 30 يوماً أو من يملك رخصة مؤسسية Enterprise License، كما شرحنا في قسم الأدوات. والاستخدام الداخلي كما هو باسمها وشعارها لا يتأثر بهذا الشرط.

والصورة التالية تبين ما سوف نبنيه:

مخطط من أربع بطاقات: الموظف بمتصفح، ثم Caddy بشهادة TLS على المنفذ 443، ثم Open WebUI بالحسابات والمعرفة، ثم Ollama وpgvector دون أي منفذ منشور، وتحتها ما لا تفعله وما تنسخه احتياطياً
منفذ واحد منشور، وكل ما خلفه على شبكة Docker داخلية

المتطلبات

  • سيرفر Linux عليه Docker وDocker Compose، وقد شرحنا التثبيت في تثبيت Docker على Ubuntu.
  • ذاكرة على قدر النماذج التي ستشغلها: نموذج 3B بتكميم Q4 مع نموذج تضمين صغير يعملان في 8 GB، ولعدة مستخدمين معاً احسب ذاكرة السياق لكل طلب متواز كما في قاعدة الذاكرة Memory. والتجربة في هذا المقال على معالج فقط دون بطاقة رسومية.
  • اسم داخلي للخدمة مثل ai.example.com يشير إلى السيرفر في DNS الداخلي، وشهادة TLS. وفي التجربة استخدمنا شهادة داخلية من Caddy نفسه، وعلى الشبكة الحقيقية تستخدم شهادة من جهة شهادات مؤسستك أو من Let's Encrypt عبر التحقق بال DNS.
  • مساحة قرص لنماذج Ollama، ولقاعدة بيانات Open WebUI والملفات التي يرفعها المستخدمون.

التثبيت مع Docker Compose

الملفات كلها في مجلد واحد على السيرفر، ونبدأ بالأسرار Secrets في ملف .env، فنولد مفتاح توقيع الجلسات Session Signing Key وكلمة مرور Password المدير وكلمة مرور قاعدة المتجهات Vector Database عشوائياً:

mkdir -p /opt/assistant && cd /opt/assistant
printf 'WEBUI_SECRET_KEY=%s\[email protected]\nWEBUI_ADMIN_PASSWORD=%s\nPOSTGRES_PASSWORD=%s\n' \
  "$(openssl rand -hex 32)" "$(openssl rand -base64 18 | tr -d '/+=')" "$(openssl rand -hex 24)" > .env
chmod 600 .env

ثم ملف Caddy، وهو ثلاثة أسطر: اسم الخدمة، ومصدر الشهادة، والعنوان الذي يمرر إليه الطلبات. وفي التجربة استخدمنا tls internal، أي شهادة من جهة شهادات داخلية ينشئها Caddy نفسه، وعلى سيرفرك تضع مكانها شهادة مؤسستك أو تحذف السطر ليطلب Caddy شهادة من Let's Encrypt، وقد شرحنا ذلك في تثبيت Caddy:

ai.example.com {
	tls internal
	reverse_proxy open-webui:8080
}

ثم ملف compose.yaml بصورته النهائية بعد إصلاح المشكلات التي سوف تراها بعد قليل:

# Ollama + Open WebUI behind Caddy. Only Caddy publishes a port; Ollama has no port on the host.
name: ad2-owui
services:
  ollama:
    image: ollama/ollama:0.40.13
    restart: unless-stopped
    environment:
      OLLAMA_KEEP_ALIVE: 30m
      OLLAMA_NUM_PARALLEL: 2
    volumes:
      - ollama:/root/.ollama
    networks: [backend, egress]

  vectordb:
    image: pgvector/pgvector:0.8.7-pg18
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_USER: webui
      POSTGRES_DB: webui
    volumes:
      - vectordb:/var/lib/postgresql
    networks: [backend]
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U webui"]
      interval: 10s
      retries: 5

  open-webui:
    image: ghcr.io/open-webui/open-webui:v0.13.4-slim
    restart: unless-stopped
    depends_on:
      ollama:
        condition: service_started
      vectordb:
        condition: service_healthy
    env_file: .env
    environment:
      OLLAMA_BASE_URL: http://ollama:11434
      WEBUI_URL: https://ai.example.com
      ENABLE_SIGNUP: "false"
      DEFAULT_USER_ROLE: pending
      DEFAULT_LOCALE: ar-SA
      ENABLE_VERSION_UPDATE_CHECK: "false"
      RAG_EMBEDDING_ENGINE: ollama
      RAG_EMBEDDING_MODEL: qwen3-embedding:0.6b
      VECTOR_DB: pgvector
      PGVECTOR_DB_URL: postgresql://webui:${POSTGRES_PASSWORD}@vectordb:5432/webui
    volumes:
      - webui:/app/backend/data
    networks: [backend, frontend]

  caddy:
    image: caddy:2.11.9-alpine
    restart: unless-stopped
    depends_on: [open-webui]
    ports:
      - "127.0.0.1:9561:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy:/data
    networks: [frontend]

volumes:
  vectordb:
  ollama:
  webui:
  caddy:

networks:
  backend:
    internal: true
  frontend:
  egress:

في الملف أعلاه لاحظ التالي:

  • الخدمة الوحيدة التي تنشر منفذاً هي Caddy، والمنفذ مربوط في التجربة على 127.0.0.1:9561، وعلى السيرفر الحقيقي تجعله 443:443 على عنوان الشبكة الداخلية فقط.
  • شبكة backend داخلية internal: true، فلا يخرج منها شيء ولا يدخل إليها شيء من خارج Docker، وعليها Ollama وقاعدة المتجهات وOpen WebUI، فيصل Open WebUI إلى Ollama باسم الخدمة http://ollama:11434.
  • Ollama وحده على شبكة ثالثة egress حتى يستطيع تحميل النماذج، دون أي منفذ منشور، وسوف ترى في المشكلة الأولى لماذا احتجنا إليها.
  • Image الخاصة بـ Open WebUI هي v0.13.4-slim، وهي بحسب صفحة التثبيت قرابة 197 MB مقابل 1.62 GB للنسخة الكاملة، لأنها لا تحمل نماذج التضمين والتحويل إلى نص في داخلها، ولكنها تحتاج قاعدة متجهات خارجية، وهذه هي المشكلة الثانية.
  • الإعدادات ENABLE_SIGNUP وDEFAULT_USER_ROLE وDEFAULT_LOCALE وغيرها تقرأ عند أول تشغيل ثم تحفظ في قاعدة البيانات، لأن ENABLE_PERSISTENT_CONFIG مفعل افتراضياً بحسب صفحة متغيرات البيئة Environment Variables، فإذا غيرتها في الملف لاحقاً فلن يتغير شيء حتى تغيرها من لوحة الإدارة Admin Panel، وهذا من أكثر ما يربك عند التحديث.
  • الأسرار كلها في ملف .env، ومنها POSTGRES_PASSWORD الذي يستخدمه Compose في موضعين: كلمة مرور قاعدة المتجهات، وعنوان الاتصال Connection URL بها PGVECTOR_DB_URL.

والآن نشغل الخدمات ونقرأ سجل Open WebUI:

docker compose up -d
docker compose logs open-webui | grep -E "admin|v0.13"

والمخرج سوف يكون كما يلي:

open-webui-1  | v0.13.4 - building the best AI user interface.
open-webui-1  | 2026-11-18 20:47:18.042 | INFO     | open_webui.utils.auth:create_admin_user:651 - Creating admin account from environment variables: [email protected]
open-webui-1  | 2026-11-18 20:47:18.674 | INFO     | open_webui.utils.auth:create_admin_user:661 - Admin account created successfully: [email protected]

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

curl -sk https://ai.example.com/api/config
{"status":true,"name":"Open WebUI","version":"0.13.4","default_locale":"ar-SA","i18n":{},"oauth":{"providers":{},"auto_redirect":false},"features":{"slim":true,"auth_sessions":true,"tether":true,"auth":true,"auth_trusted_header":false,"enable_signup_password_confirmation":false,"enable_ldap":false,"enable_signup":false,"enable_login_form":true,"enable_websocket":true}}

في المخرج أعلاه لاحظ أن enable_signup قيمته false، وأن default_locale هو ar-SA، وأن slim قيمته true، وهذه الأخيرة سوف تعود إلينا في المشكلة الثانية.

ثلاث مشكلات حقيقية في الطريق

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

المشكلة الأولى: الشبكة الداخلية تمنع تحميل النماذج

في النسخة الأولى من الملف وضعنا Ollama على شبكة backend وحدها، وجعلناها داخلية internal: true حتى لا يخرج منها شيء، وهذه فكرة جيدة للأمان، ثم حاولنا تحميل نموذج التضمين:

docker compose exec ollama ollama pull qwen3-embedding:0.6b
pulling manifest
Error: pull model manifest: Get "https://registry.ollama.ai/v2/library/qwen3-embedding/manifests/0.6b": dial tcp: lookup registry.ollama.ai on 127.0.0.11:53: server misbehaving

والخطأ هنا ليس في Ollama، وإنما في الشبكة: العنوان 127.0.0.11 هو خادم DNS الداخلي الذي يضعه Docker في كل Container في كل Container، وعلى الشبكة الداخلية لا يستطيع أن يحل أي اسم خارجي، فيفشل التحميل قبل أن يبدأ. والحل الذي اخترناه أن نضيف لـ Ollama وحده شبكة ثالثة egress للخروج إلى الإنترنت، دون أن ننشر له أي منفذ، فيبقى غير مرئي من الخارج ويستطيع أن يحمل النماذج. وإذا كانت بيئتك معزولة تماماً عن الإنترنت، فالبديل أن تحمل النماذج على جهاز آخر ثم تنقل مجلد /root/.ollama/models إلى الـ Volume.

المشكلة الثانية: النسخة slim تحتاج قاعدة متجهات خارجية

بعد أن عمل كل شيء رفعنا أول مستند إلى قاعدة المعرفة، ففشلت المعالجة، وأرجعت الواجهة البرمجية API هذا الخطأ عند إضافة الملف:

{'detail': '400: 503: Configure PGVECTOR_DB_URL for remote vector storage.'}

وقرأنا السبب من كود Open WebUI نفسه داخل الـ Container، فملف config.py فيه هذا السطر:

478:VECTOR_DB = os.getenv('VECTOR_DB', 'pgvector' if USE_SLIM else 'chroma')

أي أن النسخة الكاملة تحفظ المتجهات في قاعدة Chroma داخل نفس الـ Volume، أما النسخة slim فلا تحمل Chroma أصلاً، وتفترض أن لديك قاعدة PostgreSQL فيها إضافة pgvector، ولا تبدأ أي بحث في المستندات حتى تعطيها عنوانها. وهذا غير مكتوب في جدول النسخ في صفحة التثبيت، الذي يكتفي بأن slim «للاستخدام مع مزودي نماذج خارجيين». والحل خدمة رابعة vectordb من Image pgvector/pgvector، والمتغيران VECTOR_DB وPGVECTOR_DB_URL، كما في الملف النهائي أعلاه. وإذا كنت لا تريد خدمة إضافية فاستخدم النسخة الكاملة v0.13.4 بحجمها الأكبر، وقد شرحنا قواعد المتجهات واختيارها في مقال RAG.

المشكلة الثالثة: النموذج المخصص لا يبحث في المستندات

هذه المشكلة سوف تراها بعد أن ننشئ قاعدة المعرفة والنموذج المخصص في الأقسام التالية، ولكننا نذكرها هنا لأنها الأصعب في الملاحظة: سألت سارة النموذج «مساعد الدعم» عن إعادة تعيين كلمة مرور المدير، والإجابة موجودة حرفياً في الدليل، فجاء الرد:

وفقاً للمستندات المرفقة، لا يوجد دليل على عملية إعادة تعيين كلمة مرور للمدير عبر أي من الخطوات أو الإرشادات المرفقة.

لذا، لا أستطيع مساعدتك في ذلك.

والدليل على السبب في حقل الاستخدام Usage من نفس الرد: "prompt_eval_count": 57، أي أن النموذج قرأ 57 توكناً فقط، وهي تعليمات النظام System Prompt والسؤال، ولم يصله أي مقطع من المستندات. وفي كود Open WebUI 0.13 تجد السبب في ملف middleware.py: المعرفة المربوطة بالنموذج لا تضاف إلى الرسالة تلقائياً إلا إذا كان وضع استدعاء الأدوات function_calling هو legacy، أما في الوضع الافتراضي الجديد native فالنموذج نفسه يجب أن يقرر استدعاء أداة البحث، وهذا ما يذكره توثيق النماذج في جملة قصيرة، والنموذج الصغير لم يستدعها. والحل أن تجعل وضع استدعاء الأدوات legacy في إعدادات النموذج المخصص من «المتقدم» Advanced Params، أو بالحقل "function_calling": "legacy" في الواجهة البرمجية، وبعدها أصبح الرد:

إذا نسي العميل كلمة مرور المدير، يجب عليه الدخول إلى السيرفر وإدخال الأمر التالي:
**`demo-invoices reset-admin`**، ثم سيرسل النظام رابطاً صالحاً لمدة **30 دقيقة** إلى بريد المدير المسجل.

وقرأ النموذج هذه المرة 980 توكناً بدل 57، أي أن المقاطع Chunks وصلت إليه، والإجابة صحيحة ومطابقة للدليل.

الحسابات والأدوار Roles والمجموعات Groups

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

ثلاث بطاقات للأدوار: المدير والمستخدم وبانتظار الموافقة، وتحتها مجموعة support التي ترى مساعد الدعم وقاعدة المعرفة والنموذج الأساسي، ومجموعة sales التي لا ترى أي نموذج، والنماذج الأساسية الخاصة افتراضياً
الدور يحدد ما يفعله الحساب، والمجموعة تحدد ما يراه

وتستطيع أن تنشئ الحسابات من لوحة الإدارة في قسم «المستخدمين»، أو من الواجهة البرمجية API إذا كان لديك عدد كبير منها. أنشأنا حسابين: سارة من فريق الدعم، وعمر من فريق المبيعات، ثم مجموعتين باسم support وsales وأضفنا كل حساب إلى مجموعته، والصورة التالية من لوحة الإدارة بعد ذلك:

صفحة المستخدمين في لوحة إدارة Open WebUI بالعربية: Admin بدور المسؤول، وسارة من الدعم وعمر من المبيعات بدور مستخدم
ثلاثة حسابات: المدير ومستخدمان

والمجموعات في نفس اللوحة، لكل منها عضو واحد:

صفحة المجموعات في Open WebUI: مجموعة sales بوصف فريق المبيعات ومجموعة support بوصف فريق الدعم الفني، وتحتها الأذونات الافتراضية لكل المستخدمين
مجموعتان، وأذونات افتراضية تنطبق على كل المستخدمين

الأذونات الافتراضية Default Permissions: ماذا يستطيع المستخدم العادي؟

في صفحة المجموعات رأيت سطراً باسم «الأذونات الافتراضية» ينطبق على كل من دوره user، وهذه الأذونات هي ما يملكه المستخدم قبل أن يدخل أي مجموعة، فقرأناها من الواجهة البرمجية بحساب المدير:

curl -sk https://ai.example.com/api/v1/users/default/permissions -H "Authorization: Bearer $TOKEN"
{"workspace": {"models": false, "knowledge": false, "prompts": false, "tools": false, ...},
 "sharing": {"models": false, "public_models": false, "knowledge": false, ... "public_chats": false, ...},
 "chat": {"controls": true, "system_prompt": true, "params": true, "file_upload": true, "web_upload": true,
          "delete": true, "edit": true, "share": true, "export": true, ...},
 "features": {"api_keys": false, "notes": true, "channels": true, "web_search": true,
              "image_generation": true, "code_interpreter": true, "memories": true, ...}}

في المخرج أعلاه لاحظ التالي:

  • المستخدم العادي لا يستطيع أن ينشئ نماذج ولا قواعد معرفة في مساحة العمل Workspace workspace، ولا أن يشارك شيئاً للعموم، وهذا مناسب لفريق تديره أنت.
  • ولكنه يستطيع أن يكتب تعليمات نظام System Prompt خاصة به system_prompt ويغير إعدادات التوليد params في محادثاته، وأن يرفع ملفات داخل المحادثة file_upload. والملف الذي يرفعه الموظف في محادثة يحفظ في مجلد uploads على سيرفرك، فاجعل ذلك جزءاً من سياسة الاستخدام Usage Policy التي شرحناها في قالب سياسة الذكاء الاصطناعي.
  • بعض الميزات مسموحة في الأذونات مثل البحث في الويب Web Search web_search وتوليد الصور Image Generation image_generation، ولكنها لا تعمل حتى يضبطها المدير بمزود في الإعدادات، فإذا ضبطت البحث في الويب يوماً فتذكر أن أسئلة الموظفين سوف تخرج إلى محرك البحث Search Engine.
  • مفاتيح API للمستخدمين api_keys مغلقة افتراضياً، فلا يستطيع موظف أن يربط برنامجاً خارجياً بالمساعد باسمه حتى تسمح بذلك لمجموعة بعينها.

وهناك إعداد لا يظهر في هذه القائمة ويهم الخصوصية Privacy: المدير يستطيع أن يقرأ محادثات المستخدمين، لأن المتغير ENABLE_ADMIN_CHAT_ACCESS قيمته الافتراضية True في كود Open WebUI. وهذا قد يكون مطلوباً للتدقيق، وقد يكون مخالفاً لسياسة شركتك، فقرره بوضوح وأخبر الموظفين به، وإذا لم تحتجه فاجعله False في ملف compose.

النماذج: نموذج للمحادثة ونموذج للتضمين

نحتاج نموذجين في Ollama: نموذج محادثة Chat Model يكتب الإجابات، ونموذج تضمين Embedding يحول المقاطع والأسئلة إلى متجهات للبحث. واخترنا للمحادثة ministral-3:3b لثلاثة أسباب: رخصته Apache-2.0، وبطاقته تذكر العربية صراحة، وكان الأفضل في الاختبار العربي من بين النماذج الصغيرة في مقال النماذج المفتوحة. واخترنا للتضمين qwen3-embedding:0.6b لأنه متعدد اللغات وصغير، بدلاً من نموذج التضمين الافتراضي الإنجليزي، وقد شرحنا في قسم نموذج التضمين في مقال RAG لماذا يفسد نموذج التضمين الإنجليزي البحث في النص العربي:

docker compose exec ollama ollama pull ministral-3:3b
docker compose exec ollama ollama pull qwen3-embedding:0.6b
docker compose exec ollama ollama list
NAME                    ID              SIZE      MODIFIED
ministral-3:3b          f04aa1c738f6    3.0 GB    9 seconds ago
qwen3-embedding:0.6b    ac6da0dfba84    639 MB    15 minutes ago

ولاحظ أن نموذج التضمين يحدد في متغيري البيئة RAG_EMBEDDING_ENGINE وRAG_EMBEDDING_MODEL، وإذا غيرته بعد أن رفعت مستندات، فيجب أن تعيد فهرستها كلها، لأن متجهات نموذجين مختلفين لا تقارن ببعضها.

قاعدة المعرفة Knowledge: مستندات فريق الدعم

أنشأنا قاعدة معرفة باسم «دليل المنتج والدعم» فيها ملفان بالعربية: دليل لنظام فواتير تجريبي، والأسئلة الشائعة لفريق الدعم، وتستطيع أن تفعل ذلك من «مساحة العمل» Workspace ثم «المعرفة»، أو من الواجهة البرمجية. وعند إنشائها جعلنا صلاحية القراءة لمجموعة support فقط، فلا يراها عمر من المبيعات، وتحققنا من ذلك بطلب القاعدة بحسابه:

(401, {'detail': 'You do not have permission to access this resource. Please contact your administrator for assistance.'})

ولكل ملف يرفع تمر نفس المراحل التي شرحناها في مقال RAG، والصورة التالية تبين ما يحدث داخل Open WebUI:

ثماني خطوات مرقمة: الملف ثم التقطيع ثم التضمين ثم الحفظ في pgvector، ثم السؤال يتحول إلى متجه ثم البحث عن أقرب المقاطع ثم إضافتها إلى التعليمات ثم الإجابة مع المصدر، وتحتها تنبيه بأن نموذج التضمين الافتراضي إنجليزي
مرحلة التجهيز مرة لكل ملف، ومرحلة السؤال مع كل رسالة

نموذج مخصص: «مساعد الدعم»

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

{"id": "support-assistant", "base_model_id": "ministral-3:3b", "name": "مساعد الدعم",
 "meta": {"description": "يجيب فريق الدعم من دليل المنتج والأسئلة الشائعة", "knowledge": [{"id": "...", "type": "collection"}]},
 "params": {"system": "أنت مساعد فريق الدعم الفني. أجب بالعربية الفصحى وباختصار، ومن المستندات المرفقة فقط، وإذا لم تجد الإجابة فيها فقل إنك لا تعرف.",
            "temperature": 0.1, "function_calling": "legacy"},
 "access_grants": [{"principal_type": "group", "principal_id": "<support>", "permission": "read"}]}

وبعد إنشائه سألت سارة عنه فجاء الرد:

{"detail": "Model not found"}

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

[email protected] 200 ['support-assistant']
[email protected] 200 []
admin ['ministral-3:3b', 'qwen3-embedding:0.6b', 'support-assistant']

فأعطينا مجموعة support صلاحية القراءة على ministral-3:3b من صفحة النموذج في لوحة الإدارة أو من الواجهة البرمجية، فأصبحت القوائم:

[email protected] ['ministral-3:3b', 'support-assistant']
[email protected] []

في المخرج أعلاه لاحظ التالي:

  • عمر لا يرى أي نموذج، لأن مجموعته لم تأخذ صلاحية على شيء بعد، فإذا أرسل طلباً إلى «مساعد الدعم» عبر الواجهة البرمجية جاءه Model not found، أي أن الصلاحية تطبق في الخادم وليس في الواجهة فقط.
  • سارة ترى الآن النموذج الأساسي أيضاً، وتستطيع أن تحادثه دون قاعدة المعرفة ودون تعليمات النظام. وهذا ثمن مشاركة النموذج الأساسي، فإذا أردت أن يبقى المساعد المخصص هو الطريق الوحيد، فلا تعط المجموعة إلا النماذج التي تحتاجها، واكتب التعليمات الأساسية في نموذج مخصص لكل استخدام.
  • المدير يرى كل النماذج بما فيها نموذج التضمين، لأن المدير يتجاوز صلاحيات النماذج افتراضياً بحسب التوثيق.

المحادثة من المتصفح بالعربية

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

صفحة دخول Open WebUI بالعربية: سجل الدخول إلى Open WebUI، وحقلا البريد والباسورد، وزر تسجيل الدخول، دون رابط لإنشاء حساب
صفحة الدخول بالعربية، ولا يوجد فيها رابط لإنشاء حساب

وعندما دخلت سارة وكتبت سؤالها لمساعد الدعم، ظهرت أولاً رسالة البحث في المعرفة قبل أن يبدأ النموذج بالكتابة، وهذه هي مرحلة السؤال التي رسمناها في صورة RAG أعلاه:

محادثة سارة مع مساعد الدعم بالعربية، وتحت سؤالها عن الترقية وعدد المستخدمين رسالة جار البحث في المعرفة
قبل أن يكتب النموذج: البحث في قاعدة المعرفة

ثم اكتملت الإجابة ومعها المصدر الذي أخذت منه:

إجابة مساعد الدعم: يرقي العميل من صفحة الاشتراك دون إعادة تثبيت مع إشارة إلى ملف support-faq.md، والنسخة المتقدمة تسمح بفواتير غير محدودة و25 مستخدماً مع إشارة إلى product-guide.md، وتحتها عدد المصادر 2 وأسئلة متابعة
الإجابة مع اسم الملف بجانب كل جملة

في الصورتين أعلاه لاحظ التالي:

  • الإجابة صحيحة ومن المستندين معاً: الترقية من صفحة الاشتراك دون إعادة تثبيت من ملف الأسئلة الشائعة، و25 مستخدماً من دليل المنتج، وبجانب كل جملة اسم الملف الذي أخذت منه.
  • عبارة «عدد المصادر: 2» تحت الإجابة تفتح المقاطع نفسها التي وصلت إلى النموذج، وهذا ما يجعل الموظف يتحقق بنفسه بدل أن يثق بالإجابة.
  • هذه الإجابة أخذت على جهازنا عدة دقائق، لأن النموذج يقرأ قرابة ألف توكن من المقاطع قبل أن يكتب، والمعالج مشغول بأعمال أخرى، وعلى بطاقة رسومية متوسطة تصبح ثوان.
  • الواجهة اقترحت أسئلة متابعة بالعربية تحت الإجابة، وولدت عنوان المحادثة «ترقية الحساب وكم مستخدم» بنفس النموذج، وهذه طلبات إضافية تأخذ من وقت المعالج، فإذا كان الخادم بطيئاً فأوقفها من إعدادات الواجهة.

ومن جهة المدير، هذه صفحة النموذج المخصص في مساحة العمل، وفيها النموذج الأساسي وتعليمات النظام وقاعدة المعرفة المربوطة وزر «الوصول» الذي يحدد من يراه:

صفحة تعديل النموذج مساعد الدعم في Open WebUI بالعربية: الوصف، والنموذج الأساسي ministral-3:3b، وتعليمات النظام، والمعلمات المتقدمة بتعديلين، والمعرفة دليل المنتج والدعم، وزر الوصول في الأعلى
النموذج المخصص: الأساس والتعليمات والمعرفة والصلاحية في صفحة واحدة

الواجهة العربية في الواقع

الترجمة العربية في Open WebUI يكتبها المجتمع، وهي تغطي أغلب ما يراه الموظف كل يوم: صفحة الدخول، والمحادثة، ورسائل البحث في المعرفة، ولوحة المستخدمين والمجموعات، كما رأيت في الصور. ولكنها ليست كاملة ولا موحدة، فقد رأينا في التجربة «الباسورد» عنواناً للحقل و«ادخل كلمة المرور» داخله، ونافذة «ما هو الجديد» بملاحظات الإصدار Release Notes بالإنجليزية كاملة، وعبارة Compare revision في صفحة تعديل النموذج. وإذا وجدت ترجمة Translation خاطئة فملفات الترجمة في مستودع المشروع Project Repository نفسه، ويمكنك أن تقترح التصحيح عليهم بدل أن تعدلها في نسختك وتفقدها مع كل تحديث. أما اتجاه النص Text Direction فيتبع لغة الواجهة، والإجابات العربية من النموذج تظهر من اليمين لليسار، والكود والأوامر داخلها من اليسار لليمين كما في صورة الإجابة.

كم أخذت كل خدمة من الذاكرة والقرص Disk؟

الخدمةحجم الـ Image على القرصالذاكرة دون نموذج محمل
Open WebUI 0.13.4 slim883 MB298 MiB
pgvector على PostgreSQL 18677 MB33 MiB
Ollama 0.40.138.47 GB47 MiB، وقرابة 8 GiB أثناء الإجابة بالنموذج ministral-3:3b مع طلبين متوازيين
Caddy 2.11.992 MB29 MiB

في الجدول أعلاه لاحظ أن رقم 197 MB في صفحة التثبيت هو حجم النسخة slim مضغوطة عند التحميل، أما على القرص بعد فكها فأخذت 883 MB، وأن Image الخاصة بـ Ollama كبيرة لأنها تحمل مكتبات البطاقات الرسومية معها حتى لو لم تستخدمها. وأكبر استهلاك للذاكرة هو النموذج نفسه أثناء العمل، وقد قسناه من docker stats وهو يجيب عن سؤال سارة.

لماذا pgvector وليس قاعدة متجهات أخرى؟

Open WebUI تدعم أكثر من قاعدة متجهات، فكودها يعرف ثلاث عشرة قاعدة، منها Chroma في النسخة الكاملة وQdrant وMilvus وElasticsearch وOpenSearch، واخترنا pgvector لسببين: الأول أنه الافتراضي الذي تبحث عنه النسخة slim كما رأيت في كودها، فلا نحتاج إلا عنوان الاتصال. والثاني أن PostgreSQL أداة يعرف أغلب الفرق كيف تنسخها وتراقبها وتحدثها، فالنسخة الاحتياطية بالأمر pg_dump واستعادتها بالأمر pg_restore كما في هذا المقال، دون أداة جديدة تتعلمها. وقد قارنا قواعد المتجهات نفسها في مقال RAG.

التحقق من النجاح

بعد التشغيل تأكد من أربعة أشياء بالترتيب، وكلها نفذناها في التجربة:

  1. أن Ollama لا يظهر من خارج Docker: الأمر docker compose ps لا يعرض أي منفذ لخدمة ollama، ولا لـ vectordb، والمنفذ الوحيد هو منفذ Caddy.
  2. أن Open WebUI ترى Ollama عبر OLLAMA_BASE_URL: قائمة النماذج عند المدير من /api/models فيها ministral-3:3b وqwen3-embedding:0.6b كما رأيت أعلاه، فإذا كانت فارغة فالاتصال لا يعمل.
  3. أن إعدادات RAG هي التي وضعتها: طلبنا /api/v1/retrieval/embedding بحساب المدير فرجع "RAG_EMBEDDING_ENGINE": "ollama" و"RAG_EMBEDDING_MODEL": "qwen3-embedding:0.6b"، أي أن المتغيرين وصلا.
  4. أن الصلاحيات تعمل في الخادم وليس في الواجهة فقط: طلب عمر لقاعدة المعرفة رجع 401، وطلبه للنموذج رجع Model not found.
  5. أن الشهادة تعمل: فحصنا الاتصال بالأمر openssl s_client، فكانت الجهة المصدرة CN=Caddy Local Authority - ECC Intermediate وهي جهة Caddy الداخلية، والبروتوكول TLSv1.3، ومدة الشهادة اثنتا عشرة ساعة فقط، لأن Caddy يجدد شهاداته الداخلية تلقائياً قبل انتهائها، فلا تتفاجأ بالمدة القصيرة إذا فحصتها.

الدخول الموحد SSO بدل كلمات المرور

إذا كان في شركتك أكثر من بضعة موظفين، فإنشاء حساب لكل منهم في Open WebUI يعني كلمة مرور أخرى ينساها الموظف، وحساباً يبقى بعد أن يغادر الشركة. والأنسب أن تربط الخدمة بمزود دخول موحد Single Sign-On عبر OpenID Connect، مثل Authentik الذي شرحناه في تثبيت Authentik للدخول الموحد، فيدخل الموظف بحساب الشركة، وإذا أغلقت حسابه هناك أغلق هنا أيضاً. وقد شرحنا فكرة OIDC نفسها في شرح OAuth وOpenID Connect، ولاحظ أن ربط المجموعات من المزود بمجموعات Open WebUI يحتاج ضبطاً إضافياً، فابدأ بتعيين المجموعات يدوياً كما فعلنا هنا.

كم مستخدماً يتحمل هذا السيرفر؟

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

  • كل سؤال مع قاعدة معرفة يكلف قراءة المقاطع أولاً، فسرعة قراءة النص Prompt Processing مهمة هنا أكثر من المحادثة العادية، وهي أعلى بكثير على البطاقة الرسومية GPU.
  • ارفع OLLAMA_NUM_PARALLEL على قدر المستخدمين المتزامنين، وقد رأيت في مقال Ollama أم llama.cpp أم vLLM أن الطلبات بالإعداد الافتراضي تنتظر بعضها، واحسب أن كل طلب متواز يحجز نافذة سياق كاملة.
  • نموذج التضمين يعمل عند رفع كل ملف ومع كل سؤال، فإذا رفع الفريق مئات الملفات مرة واحدة، فسوف تنشغل Ollama بها وقتاً قبل أن تعود للأسئلة.
  • Open WebUI يرسل بعد كل إجابة طلبات إضافية إلى النموذج لتوليد عنوان المحادثة وأسئلة المتابعة، كما رأيت في صورة الإجابة، وهذه الطلبات تنافس أسئلة الموظفين على نفس المعالج، فاجعل لها نموذجاً صغيراً من إعدادات «نموذج المهام» Task Model في لوحة الإدارة، أو أوقفها إذا كان الخادم مزدحماً.
  • ابدأ بقسم واحد، وقس زمن الإجابة الحقيقي على أسئلته، ثم قرر هل تحتاج بطاقة رسومية، واحسب ذاكرتها كما في قاعدة الذاكرة.

الأمان: ما الذي يحمي هذه الخدمة فعلاً؟

قد يتساءل البعض: إذا كانت الخدمة داخل الشبكة فقط، فلماذا كل هذا؟ والإجابة أن الشبكة الداخلية ليست مكاناً آمناً بطبيعتها، فجهاز موظف مصاب Infected Device، أو شبكة ضيوف Guest Network مربوطة بالخطأ، أو منفذ نسيته مفتوحاً، كلها طرق يصل منها شخص لا تعرفه إلى المساعد وإلى المستندات التي رفعتها فيه. وفيما يلي ما طبقناه في الإعداد أعلاه وسببه:

  • Ollama دون منفذ منشور: واجهة Ollama لا تطلب أي مصادقة، فمن يصل إليها يستطيع أن يسأل أي نموذج ويحمل نماذج ويحذفها، لذلك لا يصل إليها إلا Open WebUI عبر شبكة Docker الداخلية.
  • حساب المدير من متغيرات البيئة: أول حساب يسجل في Open WebUI يصبح مديراً، وهذه نافذة خطر بين التشغيل وإنشاء الحساب يذكرها توثيق Open WebUI في صفحة المخاطر المقبولة، ويوصي بأن تنهي الإعداد عبر شبكة خاصة، أو أن تضع WEBUI_ADMIN_EMAIL وWEBUI_ADMIN_PASSWORD قبل أول تشغيل فينشأ الحساب ويغلق التسجيل تلقائياً، وهذا ما فعلناه.
  • الحسابات الجديدة بانتظار الموافقة: الدور الافتراضي pending بحسب التوثيق، فلا يرى الحساب الجديد شيئاً حتى يرفعه المدير، والأفضل أن تنشئ الحسابات بنفسك أو تربط الخدمة بالدخول الموحد SSO.
  • مفتاح التوقيع WEBUI_SECRET_KEY: يوقع جلسات الدخول Sessions، فإذا تغير بعد نقل الخدمة أو استعادتها خرج كل المستخدمين من جلساتهم، وإذا تسرب استطاع من يملكه أن يصنع جلسة لأي حساب، لذلك ولدناه بأنفسنا في ملف .env واحفظه مع أسرار الخادم.
  • TLS عند الـ Reverse Proxy: كلمات المرور وأسئلة الموظفين ومستنداتهم تمر في الطلبات، فلا تقبل بها نصاً غير مشفر حتى داخل الشبكة.
  • لا تعرض الخدمة على الإنترنت دون طبقة دخول قبلها: إذا احتاج الموظفون الوصول من خارج المكتب فاستخدم VPN، أو ضع أمامها دخولاً موحداً مثل Authentik، ولا تنشر صفحة الدخول للعالم وحدها.

من يستطيع أن يصل إلى Ollama فعلاً؟

لا تكتف بقراءة ملف compose، وإنما جرب الوصول إلى Ollama من أربعة أماكن، كما فعلنا في التجربة. من السيرفر نفسه على المنفذ الافتراضي:

curl -s -m 5 -o /dev/null -w '%{http_code}\n' http://127.0.0.1:11434/api/tags; echo "exit=$?"
000
exit=7

ورمز الخروج 7 في curl يعني أن الاتصال رفض، لأن المنفذ غير منشور أصلاً. ثم من Container على شبكة Docker الافتراضية، ثم من Container على شبكة frontend التي عليها Caddy، ثم من Container على شبكة backend:

docker run --rm alpine:3.22 sh -c 'wget -q -T 5 -O- http://ad2-owui-ollama-1:11434/api/version; echo "exit=$?"'
docker run --rm --network ad2-owui_frontend alpine:3.22 sh -c 'wget -q -T 5 -O- http://ollama:11434/api/version; echo "exit=$?"'
docker run --rm --network ad2-owui_backend alpine:3.22 sh -c 'wget -q -T 5 -O- http://ollama:11434/api/version; echo; echo "exit=$?"'
wget: bad address 'ad2-owui-ollama-1:11434'
exit=1
wget: bad address 'ollama:11434'
exit=1
{"version":"0.40.13"}
exit=0

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

النسخ الاحتياطي والاستعادة

بيانات الخدمة في مكانين، وكلاهما ضروري للاستعادة: الـ Volume الخاص بـ Open WebUI، وفيه قاعدة البيانات webui.db بالحسابات والمجموعات والمحادثات Chats والإعدادات، ومجلد uploads بالملفات الأصلية التي رفعها المستخدمون، ثم قاعدة المتجهات في pgvector. أما نماذج Ollama فتحملها من جديد بالأمر ollama pull، فلا حاجة لنسخها إلا في بيئة معزولة. وهذا ما وجدناه داخل الـ Volume:

docker compose exec open-webui ls -la /app/backend/data
drwxr-xr-x 4 root root   4096 Nov 18 21:09 .
drwxr-xr-x 1 root root   4096 Nov 17 14:51 ..
drwxr-xr-x 4 root root   4096 Nov 18 20:46 cache
drwxr-xr-x 2 root root   4096 Nov 18 21:10 uploads
-rw-r--r-- 1 root root 884736 Nov 18 21:09 webui.db
-rw-r--r-- 1 root root  32768 Nov 18 21:26 webui.db-shm
-rw-r--r-- 1 root root 284312 Nov 18 21:26 webui.db-wal

ولاحظ الملفين webui.db-wal وwebui.db-shm: قاعدة SQLite تعمل بوضع WAL، أي أن آخر التغييرات تكتب أولاً في ملف جانبي ثم تنقل إلى الملف الأساسي، فإذا نسخت webui.db وحده والخدمة تعمل، فقد تفقد آخر ما كتب أو تحصل على نسخة غير متسقة. لذلك يوقف السكربت التالي Open WebUI لثوان أثناء النسخ، ثم يأخذ نسخة من قاعدة المتجهات بالأداة pg_dump التي تعمل والقاعدة تعمل، وقد شرحنا القاعدة العامة في النسخ الاحتياطي بقاعدة 3-2-1:

#!/bin/bash
# Backup of Open WebUI: the data volume (SQLite + uploads) while the app is stopped, and a pg_dump of the vector DB.
set -euo pipefail
cd "$(dirname "$0")"
ts=$(date +%Y%m%d-%H%M)
mkdir -p backups
docker compose stop open-webui
docker run --rm -v ad2-owui_webui:/data:ro -v "$PWD/backups:/backup" alpine:3.22 \
  tar czf /backup/webui-$ts.tar.gz -C /data .
docker compose start open-webui
docker compose exec -T vectordb pg_dump -U webui -Fc webui > backups/vectordb-$ts.dump
ls -lh backups/
 Container ad2-owui-open-webui-1 Stopping 
 Container ad2-owui-open-webui-1 Stopped 
 Container ad2-owui-vectordb-1 Waiting 
 Container ad2-owui-vectordb-1 Healthy 
 Container ad2-owui-open-webui-1 Starting 
 Container ad2-owui-open-webui-1 Started 
total 164K
-rw-r--r-- 1 wajdy 197609 77K Nov 19 00:59 vectordb-20261119-0058.dump
-rw-r--r-- 1 wajdy 197609 84K Nov 19 00:59 webui-20261119-0058.tar.gz

في المخرج أعلاه لاحظ أن Open WebUI توقف ثوان فقط ثم عاد، وأن النسختين صغيرتان لأن البيانات في التجربة قليلة، وعلى سيرفر فيه آلاف المحادثات ومئات الملفات تكبر النسخة كثيراً، فانقلها إلى مكان آخر غير السيرفر نفسه كما شرحنا في قاعدة 3-2-1.

والنسخة التي لم تجرب استعادتها لا تعتبر نسخة، لذلك أجرينا تمرين استعادة كاملاً: حذفنا الـ Volume كله، واستعدنا قاعدة المتجهات من النسخة، ثم شغلنا الخدمة من جديد:

#!/bin/bash
# Restore drill: delete the data volume and the vectors, then bring them back from the latest backup.
set -euo pipefail
cd "$(dirname "$0")"
web=$(ls -t backups/webui-*.tar.gz | head -1); vec=$(ls -t backups/vectordb-*.dump | head -1)
docker compose stop open-webui
docker compose rm -f open-webui
docker volume rm ad2-owui_webui
docker compose create open-webui
docker run --rm -v ad2-owui_webui:/data -v "$PWD/backups:/backup:ro" alpine:3.22 \
  tar xzf /backup/$(basename $web) -C /data
docker compose exec -T vectordb pg_restore -U webui -d webui --clean --if-exists < $vec
docker compose up -d open-webui

وفي المحاولة الأولى أنشأنا الـ Volume بالأمر docker volume create بدل docker compose create، فظهر هذا التحذير:

level=warning msg="volume \"ad2-owui_webui\" already exists but was not created by Docker Compose. Use `external: true` to use an existing volume"

والسبب أن Compose يضع على الـ Volumes التي ينشئها علامات Labels باسم المشروع، فإذا أنشأتها بنفسك لم يتعرف عليها، والحل أن تترك Compose ينشئها كما في السكربت أعلاه. وبعد الاستعادة دخلنا بحساب سارة، فوجدنا محادثاتها الثلاث وقاعدة المعرفة والنماذج كما كانت:

chats 200 ['مدة رد تذكرة عاجلة', 'ترقية الحساب وكم مستخدم', 'تسجيل المستخدمين ورفع المستوى']
models ['ministral-3:3b', 'support-assistant']
knowledge 200 دليل المنتج والدعم

وسألنا قاعدة المعرفة مباشرة عن النسخ الاحتياطي في الدليل، فرجع أقرب مقطع وهو الصحيح، أي أن المتجهات عادت أيضاً:

{"distances": [[0.7953027866827158, 0.6705143018416356]], "documents": [["## النسخ الاحتياطي\nيأخذ النظام نسخة احتياطية تلقائية كل يوم الساعة 3 فجراً، ويحتفظ بآخر 14 نسخة في المجلد `/var/backups/demo-invoices`.", ...

ولاحظ أن مفتاح التوقيع WEBUI_SECRET_KEY ثابت في ملف .env، فاحفظ هذا الملف مع النسخة في مكان آمن، لأن البيانات المستعادة بمفتاح مختلف تخرج كل المستخدمين من جلساتهم، وكلمة مرور قاعدة المتجهات فيه أيضاً.

التحديث إلى إصدار أحدث

Open WebUI يصدر إصدارات كثيرة، والقاعدة ثلاث خطوات: نسخة احتياطية بالسكربت أعلاه، ثم تغيير الوسم Tag في compose.yaml إلى الإصدار الجديد بالرقم وليس main، ثم docker compose pull وdocker compose up -d وقراءة السجل حتى تظهر رسالة البدء. واقرأ ملاحظات الإصدار قبل ذلك، فالإصدار 0.13 مثلاً يحفظ صلاحيات قواعد المعرفة والنماذج في جدول access_grants كما رأيت في هذا المقال، وأي تغيير من هذا النوع يعني ترحيلاً Migration لقاعدة البيانات لا رجوع عنه إلا من النسخة. والأمر نفسه في Ollama: ثبت الوسم، وحدثه بعد أن تقرأ ملاحظاته، وتأكد بعد التحديث بالأمر ollama list أن النماذج ما زالت موجودة.

مشكلات شائعة وحلولها

  • pull model manifest ... server misbehaving: Ollama على شبكة داخلية لا تصل إلى الإنترنت، فأضف له شبكة للخروج أو انقل النماذج يدوياً.
  • Configure PGVECTOR_DB_URL for remote vector storage: تستخدم النسخة slim دون قاعدة متجهات، فأضف pgvector أو استخدم النسخة الكاملة.
  • المساعد يقول إن المعلومة غير موجودة وهي في المستند: انظر إلى prompt_eval_count في الرد، فإذا كان صغيراً فالمقاطع لم تصل، وجرب function_calling: legacy في إعدادات النموذج.
  • Model not found لمستخدم مع أن النموذج المخصص مشارك معه: أعط مجموعته صلاحية القراءة على النموذج الأساسي أيضاً.
  • غيرت متغير بيئة ولم يتغير شيء: الإعداد محفوظ في قاعدة البيانات بسبب ENABLE_PERSISTENT_CONFIG، فغيره من لوحة الإدارة.
  • تحذير volume ... was not created by Docker Compose بعد الاستعادة: اترك Compose ينشئ الـ Volume بالأمر docker compose create.
  • الإجابة بطيئة جداً على المعالج: نموذج 3B مع قاعدة معرفة يقرأ قرابة ألف توكن قبل أن يكتب، وفي تجربتنا كانت سرعة الكتابة 0.43 توكن في الثانية والجهاز تحت ضغط أعمال أخرى، فاحسب العتاد كما في تشغيل نماذج اللغة على جهازك، أو استخدم نموذجاً أصغر للمهام البسيطة.

قائمة التحقق

  • هل Ollama دون أي منفذ منشور، وCaddy وحده على 443؟
  • هل أنشئ حساب المدير من WEBUI_ADMIN_EMAIL قبل أن يصل أحد إلى الخدمة، والتسجيل مغلق؟
  • هل نموذج التضمين متعدد اللغات، ومعه قاعدة متجهات إذا استخدمت slim؟
  • هل لكل مجموعة النماذج وقواعد المعرفة التي تحتاجها فقط، وجربت بحساب من خارجها أن يرى Model not found؟
  • هل النسخة الاحتياطية تشمل الـ Volume وقاعدة المتجهات وملف .env، وجربت استعادتها؟
  • هل الوسوم Tags مثبتة بالأرقام، وقرأت ملاحظات الإصدار قبل التحديث؟

تدريب عملي

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

الخلاصة

وصلنا لنهاية الموضوع، وأهم ما فيه:

  • Ollama لا يطلب أي مصادقة، فلا ينشر منفذه أبداً، وOpen WebUI أمامه تعطيك الحسابات والأدوار والمجموعات والصلاحيات على كل نموذج وكل قاعدة معرفة.
  • أنشئ حساب المدير من متغيرات البيئة قبل أول تشغيل، فيغلق التسجيل تلقائياً، والحسابات الجديدة بانتظار الموافقة افتراضياً.
  • النسخة slim تحتاج قاعدة متجهات مثل pgvector، ونموذج التضمين الافتراضي إنجليزي، فغيره إلى نموذج متعدد اللغات قبل رفع أي مستند عربي.
  • النموذج المخصص يحتاج صلاحية على النموذج الأساسي أيضاً، وفي الإصدار 0.13 لم تصل المعرفة إلى النموذج الصغير إلا بوضع legacy، فتحقق من عدد التوكنز التي قرأها.
  • انسخ الـ Volume والمتجهات وملف .env معاً، وجرب الاستعادة، فقد استعدنا كل شيء بعد حذفه في دقائق.

وفي المقالات القادمة من مرحلة الذكاء الاصطناعي على سيرفرك بإذن الله سوف نشغل DeepSeek على سيرفرك، ثم vLLM لفريق كامل على بطاقة رسومية.

دليلالنماذج المفتوحة Open Weights: الرخص والأحجام والعربيةما الذي تحمله عندما تحمل نموذجاً مفتوحاً، وماذا تسمح لك رخص Qwen وLlama وMistral وDeepSeek وGemma، وكم تخسر بالتكميم في العربية بقياس حقيقي.دليلOllama أم llama.cpp أم vLLM؟ قياس على نفس النموذجشغلنا نفس النموذج على الأدوات الثلاث وأرسلنا إليها طلبات متزامنة، لترى متى يكفيك Ollama ومتى تحتاج llama.cpp أو vLLM.دليلRAG للمبتدئين: نموذج لغة يجيب من مستنداتك على سيرفرككيف تجعل نموذج اللغة يجيب من مستندات مؤسستك ويذكر مصدره، دون أن يخرج أي مستند من سيرفرك.دليلتشغيل نماذج اللغة على جهازك: كم ذاكرة وأي GPU تحتاج؟كيف تحسب الذاكرة التي يحتاجها النموذج، وماذا تتوقع من جهازك الحالي قبل أن تشتري بطاقة رسومية GPU.دليلالذكاء الاصطناعي AI في العمل: ما لا ترسله لخدمة خارجيةما الذي يجوز أن ترسله إلى مساعد ذكي خارجي وما الذي يبقى داخل الشركة، بحسب وثائق سدايا ونظام حماية البيانات، ومتى تحتاج نموذجاً على سيرفرك.دليلتثبيت Caddy على خادمك: Reverse Proxy بشهادات HTTPS تلقائيةكيف تثبت Caddy على سيرفرك ليمنح كل موقع شهادة HTTPS تلقائياً، وتربط به تطبيقاتك بملف إعداد من بضعة أسطر.دليلتثبيت authentik للدخول الموحد SSO إلى تطبيقاتككيف تثبت authentik حتى يدخل كل موظف إلى تطبيقات الفريق بحساب واحد، مع فرض المصادقة الثنائية على الجميع.دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.

سجل التحديثات

  • 19 نوفمبر 2026: كتابة الدليل واختباره على Open WebUI 0.13.4 slim وOllama 0.40.13 وpgvector 0.8.7 على PostgreSQL 18 وCaddy 2.11.9، بالنموذجين ministral-3:3b وqwen3-embedding:0.6b، على معالج فقط مع Docker Desktop وWSL2.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.