본문으로 건너뛰기

데모 모드

데모 모드를 사용하면 공개 미리보기 배포에서 실제 백엔드 계정이나 제공자 자격 증명 없이 Libre WebUI를 보여 줄 수 있습니다.

데모 모드가 켜지는 조건

다음 조건에서 데모 모드가 활성화됩니다.

  • VITE_DEMO_MODE=true이거나
  • 프런트엔드가 Vercel, Netlify, GitHub Pages 같은 알려진 미리보기 호스트 또는 demo./preview. 하위 도메인에서 실행 중인 경우.

VITE_DEMO_MODE=true을 설정하지 않으면 로컬 개발 환경은 데모 모드가 아닙니다.

로그인 동작

데모 모드에서는 로그인 양식에 데모 자격 증명이 미리 입력되고 입력란이 비활성화됩니다. 사용자는 로그인만 누르면 됩니다. 가입 및 OAuth 버튼은 숨겨집니다.

데모 모드가 제공하는 기능

데모 모드는 주요 제품 흐름에 모의 API 응답을 사용합니다.

  • 채팅 세션과 메시지
  • 모델
  • 페르소나
  • 아티팩트
  • 환경 설정
  • 플러그인 목록

실제 사용자 데이터를 쓰지 않으면서 데모를 직접 조작할 수 있습니다.

데모 모드가 제공하지 않는 기능

데모 모드는 프로덕션 인증 전략이 아닙니다. 실제 영속성, 실제 제공자 호출, 실제 계정 관리, 실제 Work 작업 컨테이너 및 명령 실행을 제공하지 않습니다.

실제 배포에서는 정상 인증으로 백엔드를 실행하고 공개할 제공자를 설정하세요.

데모 모드 설정

프런트엔드 .env:

VITE_DEMO_MODE=true

평소처럼 프런트엔드를 빌드하고 실행합니다. 백엔드도 실행 중이더라도 지원되는 UI 흐름에서는 데모 모드 API 모의 응답이 우선합니다.

관련 문서