Open WebUI 핵심 개요

올인원 AI 플랫폼

Open WebUI는 Ollama와 OpenAI 호환 API 등 다양한 LLM 실행 환경을 지원하는 오프라인 운영이 가능한 AI 챗 플랫폼입니다. 자체 문서 검색(RAG), 손쉬운 설치, 다양한 확장 기능으로 차별화됩니다.

간편한 설치와 다양한 배포 옵션

Docker, Kubernetes, Python pip 등 다양한 방법으로 쉽게 설치할 수 있습니다. 커스텀 컨테이너 이미지(:cuda, :ollama)와 GPU 지원까지 제공해 사용 환경에 맞춘 구축이 가능합니다.

Ollama 및 OpenAI API 통합

Ollama 모델과 OpenAI 호환 API를 모두 연결해 대화 기능을 확장할 수 있습니다. LMStudio, GroqCloud, Mistral, OpenRouter 등 다양한 모델도 연동이 가능합니다.

고급 사용자 및 권한 관리

관리자가 세부적인 사용자 역할과 권한을 부여하는 기능을 지원합니다. 보안을 강화하고, 각 사용자에 맞는 환경을 제공할 수 있습니다.

기업 환경에 특화된 SCIM 지원

SCIM 2.0 프로토콜을 통해 Okta, Azure AD, Google Workspace 등과 연동하여 사용자와 그룹 관리를 자동화합니다.

다양한 인터페이스와 접근성

PC, 노트북, 모바일 등 다양한 기기에서 최적화된 화면을 제공합니다. 모바일에서는 PWA 기능을 통해 네이티브 앱과 동일한 경험 및 오프라인 접근성도 지원됩니다.

문서 검색과 웹 연동

문서 라이브러리 또는 직접 문서 업로드로 챗봇의 RAG(검색 기반 응답) 기능을 사용할 수 있습니다. 또한 다양한 검색엔진(SearXNG, Google, DuckDuckGo 등)과 웹사이트 내용을 대화에 바로 활용할 수 있습니다.

이미지 생성 및 멀티모델 통합

AUTOMATIC1111, ComfyUI, OpenAI DALL-E 등 다양한 이미지 생성 엔진을 연결할 수 있습니다. 여러 LLM 모델을 동시에 활용해서 더욱 다양한 답변을 받을 수 있습니다.

라이트코드 및 파이프라인 확장 기능

순수 파이썬 함수 연동, 로컬 코드 에디터, 플러그인을 통한 기능 추가(예: 실시간 번역, 유저 관리, 메시지 필터링 등) 등 개발자 친화적인 확장성을 제공합니다.

꾸준한 업데이트와 커뮤니티

정기적인 기능 추가와 수정이 이루어지고, 다양한 설치/업데이트 가이드와 Discord 커뮤니티를 통해 도움을 받을 수 있습니다.

오픈 라이선스와 브랜드 정책

BSD-3-Clause 기반의 라이선스를 채택, 자유로운 사용/배포/상업적 활용이 가능하며 단, "Open WebUI" 브랜드를 유지해야 합니다.

주요 설치 명령어 예시

# pip 설치
pip install open-webui

# 실행
open-webui serve

# Docker Ollama가 같은 서버일 때
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

# Docker Ollama가 다른 서버일 때
docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

# OpenAI API만 사용할 때
docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

# Ollama 포함, GPU 지원
docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

# 업데이트(Watchtower 사용)
docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once open-webui

기술적 문제 해결 팁

Docker 네트워크 연결 문제 시, --network=host 옵션과 OLLAMA_BASE_URL 환경변수 설정이 필요할 수 있습니다. 자세한 방법과 FAQ는 공식 문서와 Discord 커뮤니티에서 확인할 수 있습니다.

출처 및 참고 : open-webui/open-webui: User-friendly AI Interface (Supports Ollama, OpenAI API, ...)