Ubuntu 24.04에 OpenWebUI 로컬 AI 인터페이스 배포하기

Open WebUI는 로컬 및 원격 AI 모델을 위한 셀프 호스팅(self-hosted) 방식의 ChatGPT 스타일 인터페이스로, Ollama, OpenAI 호환 엔드포인트(endpoints), 그리고 사용자별 인증을 지원합니다. 이 가이드는 Traefik을 사용하여 자동 HTTPS를 처리하며 Docker Compose를 통해 Open WebUI를 배포합니다. 이 과정을 마치면 여러분의 도메인에서 모델 백엔드(backend)를 연결할 준비가 된 Open WebUI 인스턴스가 보안 환경에서 실행됩니다.

디렉토리 구조 설정

1. 프로젝트 디렉토리 생성:

$ mkdir -p ~/openwebui/data
$ cd ~/openwebui

2. 환경 변수 파일(.env) 생성:

$ nano .env

DOMAIN=openwebui.example.com
LETSENCRYPT_EMAIL=admin@example.com

Docker Compose로 배포하기

1. Docker Compose 매니페스트(manifest) 생성:

$ nano docker-compose.yaml

services:
  traefik:
    image: traefik:v3.6
...

2. 서비스 시작:

$ docker compose up -d

3. 서비스 실행 여부 확인:

$ docker compose ps

4. 로그 확인:

$ docker compose logs

Open WebUI 접속하기

브라우저에서 https://openwebui.example.com을 엽니다. 처음으로 등록하는 사용자가 관리자(administrator)가 됩니다. 추가 사용자는 동일한 절차를 통해 가입할 수 있으며, **Admin Panel(관리자 패널) → Users(사용자)**에서 관리할 수 있습니다.

다음 단계

Open WebUI가 실행 중이며 HTTPS를 통해 보안 연결이 제공됩니다. 이제 다음과 같은 작업을 수행할 수 있습니다:

• 로컬 Ollama 인스턴스 또는 모든 OpenAI 호환 엔드포인트를 모델 백엔드로 연결
• 지식 베이스(knowledge base)에 문서를 업로드하여 RAG(검색 증강 생성) 활성화
• 관리자 패널에서 사용자별 모델 권한 및 속도 제한(rate limits) 구성

추가적인 팁이 포함된 전체 가이드를 확인하려면 **Vultr Docs**의 원문 기사를 방문하세요.