본문으로 건너뛰기

외부 Ollama를 사용하는 Docker

Ollama가 이미 호스트, 다른 서버 또는 Tailscale/LAN 컴퓨터에서 실행 중일 때 이 구성을 사용하세요.

Work 사용 가능 여부​

이 Compose 구성은 Ollama가 실행되는 위치를 바꾸지만, Work는 마운트된 호스트 Docker 소켓을 통해 계속 활성화됩니다. Libre WebUI에 Docker 호스트의 root와 동등한 제어권을 주므로 Libre WebUI 관리자도 신뢰할 수 있는 호스트 관리자인 환경에서만 사용하세요. Linux에서는 .env의 DOCKER_GID를 소켓 소유 그룹으로 설정합니다. 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 URL​

다른 호스트를 사용하려면:

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

host.docker.internal을 해석하지 못하는 Linux 호스트에서는 서비스에 다음을 추가합니다.

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.origin.yml 같은 명시적 Compose 재정의를 추가하세요.

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

실패하면 OLLAMA_BASE_URL에 명시적인 LAN/Tailscale IP를 사용하세요.

모델이 표시되지 않음

Ollama 호스트를 확인합니다.

ollama list

모델 관리자는 설정된 Ollama 인스턴스에서 정보를 읽습니다.

CORS 오류

CORS_ORIGIN이 스킴과 포트를 포함한 정확한 브라우저 출처와 일치하는지 확인하세요.

관련 문서​