Перейти до основного вмісту

Docker із зовнішнім Ollama

Використовуйте цю конфігурацію, коли Ollama вже працює на хості, іншому сервері або машині в Tailscale/LAN.

Доступність Work​

Ця конфігурація Compose змінює місце роботи Ollama; Work залишається ввімкненим через підключений socket Docker хоста. Це надає Libre WebUI контроль над хостом на рівні root, тому використовуйте лише там, де адміністратори Libre WebUI також є довіреними адміністраторами хоста. У 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​

Для іншого хоста:

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 в томах:

  • 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.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

Якщо команда не працює, задайте явну адресу LAN/Tailscale в OLLAMA_BASE_URL.

Моделі не відображаються

Перевірте хост Ollama:

ollama list

Менеджер моделей читає налаштовану інстанцію Ollama.

Помилки CORS

Переконайтеся, що CORS_ORIGIN точно збігається з походженням браузера, включно зі схемою й портом.

Пов’язана документація​