Sari la conținutul principal

Docker cu Ollama extern

Folosiți această configurație când Ollama rulează deja pe gazda dvs., pe alt server sau pe un computer Tailscale/LAN.

Disponibilitatea Work​

Această configurație Compose schimbă locul în care rulează Ollama; Work rămâne activat prin socketul Docker montat al gazdei. Aceasta oferă Libre WebUI control echivalent cu root asupra gazdei Docker, deci folosiți-o numai acolo unde administratorii Libre WebUI sunt și administratori de încredere ai gazdei. Pe Linux, setați DOCKER_GID în .env la grupul care deține socketul. Eliminați montarea dacă nu doriți Work. Consultați Work: Spații de lucru izolate.

Cerințe preliminare​

Confirmați că Ollama este accesibil:

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

Descărcați un model dacă instanța este nouă:

ollama pull gemma4:12b

Pornirea Libre WebUI​

Din rădăcina depozitului:

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

Deschideți http://localhost:8080.

Fișierul Compose setează implicit OLLAMA_BASE_URL la http://host.docker.internal:11434.

URL Ollama personalizat​

Pentru o altă gazdă:

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

Pentru gazdele Linux care nu rezolvă host.docker.internal, adăugați următoarele în serviciu:

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

Persistența datelor​

Fișierul Compose stochează datele Libre WebUI în volume Docker:

  • libre_webui_data
  • libre_webui_temp

Setați secrete stabile pentru producție:

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

Creați împreună copii de rezervă pentru volumul de date și cheia de criptare.

Acces în rețea​

Fișierul Compose din depozit setează în prezent CORS_ORIGIN direct. O valoare din shell sau fișierul .env nu înlocuiește această valoare literală. Editați intrarea libre-webui.environment sau adăugați o suprascriere Compose explicită, de exemplu 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

Aplicați ambele fișiere:

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

Pentru un domeniu public, folosiți originea HTTPS exactă pentru ambele valori și terminați traficul prin HTTPS.

Comenzi utile​

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

Depanare​

Libre WebUI nu poate accesa Ollama

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

Dacă operația eșuează, folosiți o adresă IP LAN/Tailscale explicită în OLLAMA_BASE_URL.

Modelele nu apar

Verificați gazda Ollama:

ollama list

Managerul de modele citește din instanța Ollama configurată.

Erori CORS

Asigurați-vă că CORS_ORIGIN corespunde exact originii browserului, inclusiv schema și portul.

Documentație conexă​