Open WebUI

Open WebUI를 배포하고 관리자로 서버 게이트웨이 연결을 관리합니다.

설치 및 준비

Docker를 설치한 뒤 Open WebUI 빠른 시작을 따르거나 아래 명령을 실행합니다. 계정과 설정이 유지되도록 명명된 볼륨을 보존하세요. http://localhost:3000을 열고 첫 관리자 계정을 만듭니다. routerra.ai 키에서 연결 키를 만들고 게이트웨이 목록에서 허용 ID를 확인합니다.

연결 구성

관리자로 Settings → Admin → Connections → Manage OpenAI API Connections → Add Connection을 엽니다. URL은 https://routerra.ai/v1, API Key는 YOUR_API_KEY로 지정하고 기본 OpenAI 호환 유형을 활성화하여 저장합니다. 모델은 보통 이 연결의 /models에서 가져옵니다. 검색이 불가능하면 Model IDs 허용 목록에 YOUR_MODEL_ID를 넣습니다. 인스턴스 권한에 따라 공유되는 서버 연결이며 개인 브라우저 Direct Connection이 아닙니다.

docker run -d --name open-webui -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --restart always ghcr.io/open-webui/open-webui:main

모델 선택 및 오류 해결

새 채팅에서 YOUR_MODEL_ID를 선택해 짧은 메시지를 보냅니다. 모델이 없으면 연결 스위치와 허용 목록을 확인한 뒤 저장해 갱신합니다. 재시작 시 DB 설정이 OPENAI_API_BASE_URL과 OPENAI_API_KEY보다 우선할 수 있으므로 관리자 연결을 직접 편집하세요. ENABLE_PERSISTENT_CONFIG=False는 환경 변수를 강제하지만 관리자 변경이 유지되지 않습니다. 네트워크 오류는 docker logs open-webui와 컨테이너의 외부 HTTPS를 확인합니다.