Μετάβαση στο κύριο περιεχόμενο

Docker με εξωτερικό Ollama

Χρησιμοποιήστε αυτή τη ρύθμιση όταν το Ollama εκτελείται ήδη στον host σας, σε άλλον διακομιστή ή σε υπολογιστή Tailscale/LAN.

Διαθεσιμότητα Work

Αυτή η ρύθμιση Compose αλλάζει το σημείο όπου εκτελείται το Ollama· το Work παραμένει ενεργό μέσω του προσαρτημένου socket Docker του host. Παρέχει στο Libre WebUI έλεγχο του host Docker ισοδύναμο με root, γι' αυτό χρησιμοποιήστε την μόνο όπου οι διαχειριστές Libre WebUI είναι και έμπιστοι διαχειριστές του host. Στο Linux, ορίστε στο .env το DOCKER_GID στην ομάδα που κατέχει το socket. Αφαιρέστε την προσάρτηση αν δεν χρειάζεστε το 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.

Προσαρμοσμένη URL Ollama

Για διαφορετικό host:

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

Για host 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. Μια τιμή στο shell σας ή στο αρχείο .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

Για δημόσιο domain, χρησιμοποιήστε την ακριβή προέλευση 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.

Τα μοντέλα δεν εμφανίζονται

Ελέγξτε τον host Ollama:

ollama list

Η Διαχείριση μοντέλων διαβάζει από τη ρυθμισμένη εγκατάσταση Ollama.

Σφάλματα CORS

Βεβαιωθείτε ότι το CORS_ORIGIN αντιστοιχεί ακριβώς στην προέλευση του προγράμματος περιήγησης, συμπεριλαμβανομένων του σχήματος και της θύρας.

Σχετική τεκμηρίωση