개요
Open WebUI는 완전히 오프라인에서 작동하도록 설계된 확장 가능하고 기능이 풍부하며 사용하기 쉬운 자체 호스팅 웹 인터페이스입니다. 원래 Ollama Web UI로 만들어졌으며, 이 프로젝트는 Ollama, OpenAI API, OpenAI 호환 엔드포인트를 포함한 여러 LLM 백엔드를 지원하는 종합 플랫폼으로 발전하여 유연성과 벤더 독립성을 제공합니다.
이 플랫폼은 직관적인 ChatGPT 스타일 인터페이스와 다른 자체 호스팅 솔루션에서는 보기 드문 강력한 기능을 결합하여 차별화됩니다. Open WebUI는 다중 사용자 지원, 대화 기록, RAG(검색 증강 생성)를 활용한 문서 업로드, 웹 검색 연동, 이미지 생성, 음성 입출력, 폭넓은 사용자 지정 옵션을 갖춘 완전한 대화형 AI 환경을 제공합니다.
개인정보 보호와 데이터 소유권을 핵심 원칙으로 삼아 구축된 Open WebUI는 모든 대화, 문서, 사용자 데이터를 외부 의존성 없이 VPS에 로컬로 저장합니다. 이 아키텍처는 원격 측정 데이터 전송이 전혀 없고, 완전한 오프라인 작동을 보장하며, AI 상호작용을 완전히 통제할 수 있게 합니다. 따라서 엄격한 데이터 거버넌스 요건이 있는 조직이나 AI 워크플로에서 개인정보 보호를 중시하는 개인에게 이상적입니다.
이 플랫폼은 단순한 채팅 상호작용을 넘어서는 정교한 워크플로를 지원합니다. 사용자는 사용자 지정 프롬프트를 만들고, 특정 매개변수가 설정된 모델 프리셋을 구성하며, 태그와 폴더로 대화를 정리하고, 워크스페이스 공유를 통해 협업하며, 플러그인 시스템으로 기능을 확장할 수 있습니다. 관리자 패널은 다중 사용자 배포를 위한 종합적인 사용자 관리, 사용량 분석, 시스템 구성을 제공합니다.
Open WebUI는 로컬 모델 실행을 위해 Ollama와 원활하게 통합되며, OpenAI, Azure OpenAI 또는 호환 가능한 모든 API 엔드포인트에도 연결되어 로컬 자원과 클라우드 자원을 모두 활용하는 하이브리드 배포를 가능하게 합니다. 이러한 유연성 덕분에 조직은 일상적인 작업에는 비용이 저렴한 로컬 추론을 사용하고, 특수한 요구에는 클라우드 API를 따로 두어 사용할 수 있습니다.
설치와 배포는 Docker 컨테이너를 통해 간소화되어 최소한의 구성만으로 시작할 수 있습니다. 이 플랫폼은 같은 시스템에 있는 Ollama 설치를 자동으로 찾아내어, VPS에서 두 서비스를 모두 실행하는 사용자의 설정을 단순하게 만듭니다. 프로덕션 배포의 경우 Open WebUI는 OpenID Connect를 통한 인증, LDAP 연동, 세분화된 권한 제어를 지원합니다.
주요 기능
다중 백엔드 유연성
Ollama, OpenAI, Azure OpenAI 또는 OpenAI 호환 API에 연결하세요. 단일 인터페이스에서 여러 제공업체의 모델을 전환하여 사용할 수 있습니다.
RAG 문서 처리
문서(PDF, DOCX, TXT)를 업로드하여 문맥을 인식하는 대화를 진행하세요. 클라우드 서비스 없이 로컬 임베딩과 벡터 검색으로 비공개 문서 질의응답을 수행합니다.
완전한 사용자 관리
인증, 역할 기반 접근 제어, 워크스페이스 분리, 관리자 대시보드를 포함한 다중 사용자 지원. 기업 인증을 위한 OIDC 및 LDAP 연동.
고급 채팅 기능
대화 분기, 재생성, 편집, 전체 기록 검색, 정리를 위한 태그와 폴더. 대화를 Markdown 또는 JSON으로 내보낼 수 있습니다.
이미지 및 음성 지원
DALL-E 또는 Stable Diffusion 연동으로 이미지를 생성합니다. Web Speech API를 통한 음성 입력과 텍스트 음성 변환을 통한 음성 출력을 지원합니다.
확장 가능한 플러그인 시스템
사용자 지정 함수, 도구, 연동으로 기능을 확장하세요. 웹 검색, 코드 실행, API 커넥터, 전문 워크플로를 위한 커뮤니티 플러그인을 이용할 수 있습니다.
사용 사례
- 팀 협업 플랫폼: 팀이 AI 모델과 상호작용하고, 대화를 공유하며, 공동 지식 기반을 구축할 수 있는 공유 워크스페이스
- 문서 리서치 도우미: 클라우드에 데이터를 노출하지 않고 AI 기반 질의응답과 분석을 위해 연구 논문, 계약서, 문서를 업로드
- 개발 도구: 여러 모델 지원, 대화 기록, 코드 스니펫 정리를 갖춘 코딩 도우미
- 고객 지원 인터페이스: 지원팀이 AI를 활용하여 응답 초안 작성과 정보 조회를 더 빠르게 수행하도록 돕는 내부 도구
- 교육 플랫폼: 학생과 교육자가 여러 AI 모델을 안전하게 실험할 수 있는 다중 사용자 환경
- 개인 지식 관리: 생각, 메모, 대화를 정리하며 데이터 소유권을 완전히 갖는 비공개 ChatGPT 대안
설치 가이드
가장 간단한 배포를 위해 Docker를 사용하여 Ubuntu VPS에 Open WebUI를 설치하세요. 공식 이미지를 내려받고 3000번 포트로 포트 매핑하여 실행합니다. 같은 호스트에 있는 Ollama와 연동하려면 호스트 네트워크 모드를 사용하거나 네트워크를 통해 Ollama API에 연결하세요.
기본 설치는 영구 데이터 저장을 위한 볼륨 마운트가 포함된 단일 docker run 명령으로 이루어집니다. 인증 방식, 기본 모델, 클라우드 백엔드를 사용하는 경우 외부 API 키에 대한 환경 변수를 구성하세요.
프로덕션 배포에는 Docker Compose를 사용하여 Open WebUI, Ollama, 세션 저장을 위한 Redis 또는 PostgreSQL 같은 선택적 서비스를 각각 별도 컨테이너로 실행하세요. SSL 종료와 사용자 지정 도메인 매핑을 위해 Nginx로 리버스 프록시를 설정하세요.
OpenID Connect 공급자(Google, Microsoft, GitHub)용 환경 변수를 설정하여 인증을 구성하거나, 이메일/비밀번호 기반의 기본 제공 사용자 관리를 활성화하세요. 첫 실행 시 환경 변수로 관리자 자격 증명을 설정하세요.
대화와 사용자 데이터를 위한 /app/backend/data를 포함하여 데이터 영속성을 위해 볼륨을 마운트하세요. RAG 기능을 사용하려면 문서 업로드와 벡터 임베딩을 위한 충분한 저장 공간을 확보하세요. 데이터베이스와 업로드된 문서에 대한 백업 전략을 구성하세요.
설정 팁
Open WebUI 구성은 환경 변수와 관리자 웹 인터페이스로 관리됩니다. Ollama 백엔드에 연결하려면 OLLAMA_BASE_URL을, OpenAI 접근에는 OPENAI_API_KEY를, 사용 가능한 모델을 지정하려면 DEFAULT_MODELS를 설정하세요.
임베딩 모델과 벡터 데이터베이스 설정을 구성하여 RAG를 활성화하십시오. 안전한 세션을 위해 WEBUI_SECRET_KEY를 설정하십시오. RAG_FILE_MAX_SIZE로 파일 업로드 제한을, DATA_DIR로 저장 경로를 구성합니다.
다중 사용자 배포의 경우 ENABLE_SIGNUP으로 가입을, ENABLE_LOGIN_FORM으로 인증 방식을, WEBHOOK_URL로 외부 연동을 구성하세요. LOG_LEVEL로 로그 수준을 설정하고 ENABLE_METRICS로 지표를 활성화하세요.
모범 사례는 SSL이 적용된 리버스 프록시 뒤에서 실행하기, 데이터 볼륨의 정기 백업 구현, 메모리 문제를 방지하도록 Docker에서 리소스 제한 구성, 다중 컨테이너 배포에서 세션 관리에 Redis 사용, 문서 업로드와 대화 기록의 저장 공간 사용량 모니터링 등입니다.
기술적 요구 사항
종속성
- ✓ Docker
- ✓ Ollama or OpenAI API key (for backend)
- ✓ Optional: Redis for session management