Docker مع Ollama خارجي

استخدم هذه التهيئة عندما يكون Ollama مشغّلًا بالفعل على مضيفك أو خادم آخر أو جهاز في شبكة Tailscale/LAN.

توفر Work

تغير تهيئة Compose هذه مكان تشغيل Ollama، لكن Work يظل مفعّلًا عبر تركيب مقبس Docker للمضيف. ويمنح ذلك Libre WebUI تحكمًا في مضيف Docker يعادل صلاحية المستخدم الجذر، لذا لا تستخدمه إلا عندما يكون مسؤولو Libre WebUI أنفسهم مسؤولين موثوقين للمضيف. على Linux، اضبط DOCKER_GID في .env على المجموعة المالكة للمقبس. أزل التركيب إذا لم تكن تريد Work. راجع Work: مساحات العمل المعزولة.

المتطلبات المسبقة

تحقق من إمكانية الوصول إلى Ollama:

curl http://localhost:11434/api/version

نزّل نموذجًا إذا كان المثيل جديدًا:

ollama pull gemma4:12b

بدء Libre WebUI

من جذر المستودع:

docker compose -f docker-compose.external-ollama.yml up -d

افتح http://localhost:8080.

يشير ملف Compose افتراضيًا بقيمة OLLAMA_BASE_URL إلى http://host.docker.internal:11434.

عنوان Ollama مخصص

لاستخدام مضيف مختلف:

OLLAMA_BASE_URL=http://192.168.1.100:11434 docker compose -f docker-compose.external-ollama.yml up -d

على مضيفات Linux التي لا تحل host.docker.internal، أضف ما يلي إلى الخدمة:

extra_hosts:
  - 'host.docker.internal:host-gateway'

استمرارية البيانات

يخزن ملف Compose بيانات Libre WebUI في وحدات تخزين Docker:

• libre_webui_data
• libre_webui_temp

اضبط أسرارًا ثابتة للإنتاج:

JWT_SECRET=replace-with-a-long-random-secret
ENCRYPTION_KEY=replace-with-64-hex-characters

انسخ احتياطيًا وحدة البيانات ومفتاح التشفير معًا.

الوصول عبر الشبكة

يضبط ملف Compose في المستودع CORS_ORIGIN مباشرة حاليًا. ولا تستبدل قيمة في بيئة الأوامر أو ملف .env تلك القيمة الحرفية. عدّل إدخال libre-webui.environment أو أضف تجاوز Compose صريحًا، مثل compose.origin.yml:

services:
  libre-webui:
    environment:
      CORS_ORIGIN: http://localhost:8080,http://192.168.1.50:8080
      BASE_URL: http://192.168.1.50:8080

طبّق الملفين:

docker compose \
  -f docker-compose.external-ollama.yml \
  -f compose.origin.yml \
  up -d

لنطاق عام، استخدم أصل HTTPS الدقيق للقيمتين وأنهِ حركة البيانات باستخدام HTTPS.

أوامر مفيدة

docker compose -f docker-compose.external-ollama.yml ps
docker compose -f docker-compose.external-ollama.yml logs -f libre-webui
docker compose -f docker-compose.external-ollama.yml restart
docker compose -f docker-compose.external-ollama.yml pull
docker compose -f docker-compose.external-ollama.yml up -d

استكشاف الأخطاء وإصلاحها

لا يستطيع Libre WebUI الوصول إلى Ollama

docker compose -f docker-compose.external-ollama.yml exec libre-webui \
  wget -O- http://host.docker.internal:11434/api/version

إذا فشل ذلك، فاستخدم عنوان IP صريحًا لشبكة LAN/Tailscale في OLLAMA_BASE_URL.

لا تظهر النماذج

تحقق من مضيف Ollama:

ollama list

يقرأ مدير النماذج من مثيل Ollama المهيأ.

أخطاء CORS

تأكد من تطابق CORS_ORIGIN مع أصل المتصفح الدقيق، بما في ذلك البروتوكول والمنفذ.

وثائق ذات صلة

• Work: مساحات العمل المعزولة
• Docker
• استخدام النماذج
• استكشاف الأخطاء وإصلاحها