관리자 비밀번호 재설정 🗝️

관리자 비밀번호를 잊으셨더라도 걱정하지 마세요! 아래에서 Docker 🐳 배포 및 Open WebUI의 로컬 설치를 위한 관리자 비밀번호 재설정 단계별 가이드를 찾을 수 있습니다.

Docker 배포를 위한 가이드 🐳

Docker를 사용하여 배포된 Open WebUI의 관리자 비밀번호를 재설정하려면 다음 단계를 따르세요.

단계 1: 새로운 비밀번호 해시 생성 🔐

먼저 새로운 비밀번호의 bcrypt 해시를 생성해야 합니다. 로컬 컴퓨터에서 다음 명령을 실행하여 your-new-password를 사용하려는 비밀번호로 바꾸세요:

htpasswd -bnBC 10 "" your-new-password | tr -d :\n

참고: 출력에는 신중히 처리해야 하는 특수 문자가 포함된 bcrypt 해시가 포함됩니다. 해시의 $ 문자는 다음 단계에서 올바르게 사용하려면 트리플 이스케이프( \\\ 로 변경)되어야 합니다.

단계 2: Docker에서 비밀번호 업데이트 🔄

이제 Docker 배포에서 비밀번호를 업데이트합니다. 아래 명령에서 HASH를 1단계에서 생성된 bcrypt 해시로 바꾸고 $ 문자를 트리플 이스케이프하여 사용하세요. 또한, [email protected]을 관리자 계정과 연결된 이메일 주소로 교체하세요.

중요: 아래 명령이 모든 경우에서 작동하지 않을 수 있습니다. 작동하지 않는 경우, 아래 제시된 대체 명령을 시도하세요.

docker run --rm -v open-webui:/data alpine/socat EXEC:"bash -c apk add sqlite && echo UPDATE auth SET password=\HASH\ WHERE email=\[email protected]\; | sqlite3 /data/webui.db", STDIO

로컬 설치를 위한 가이드 💻

Open WebUI의 로컬 설치를 사용하는 경우에도 시스템에서 직접 관리자 비밀번호를 재설정할 수 있습니다.

단계 1: 새로운 비밀번호 해시 생성 🔐

Docker 방법과 마찬가지로, 다음 명령을 사용하여 새로운 비밀번호의 bcrypt 해시를 생성하세요. your-new-password를 새 비밀번호로 바꾸는 것을 잊지 마세요:

htpasswd -bnBC 10 "" your-new-password | tr -d :\n

단계 2: 로컬 비밀번호 업데이트 🔄

이제 로컬 컴퓨터에서 open-webui 디렉토리로 이동하여 1단계에서 생성한 bcrypt 해시를 HASH로, 관리자 계정 이메일을 [email protected]로 바꾼 후 다음을 실행하세요:

sqlite3 backend/data/webui.db "UPDATE auth SET password=HASH WHERE [email protected];"

대체 Docker 방법

위의 방법에 문제가 발생하면. alpine/socat에서 bash 명령을 연결하는 데 문제가 발생할 수 있습니다. bash가 없기 때문입니다.

1. open-webui 볼륨에 연결된 alpine Linux를 실행합니다.

   docker run -it --rm -v open-webui:/path/to/data alpine

   /path/to/data는 당신의 볼륨 설정에 따라 달라집니다.

   1. apache2-utils와 sqlite를 설치합니다:

      apk add apache2-utils sqlite

   2. bcrypt 해시를 생성합니다:

      htpasswd -bnBC 10 "" your-new-password | tr -d :

   3. 비밀번호를 업데이트합니다:

      sqlite3 /path/to/data/webui.db

      UPDATE auth SET password=HASH WHERE email=admin@example.com;
      -- sqlite 종료: [Ctrl + d]

모든 데이터 초기화

Open WebUI를 완전히 초기화하고 사용자 데이터, 설정, 비밀번호를 포함하여 모든 데이터를 삭제하려면 webui.db 파일을 제거하는 단계를 따르세요.

단계 1: Python 환경에서 webui.db 찾기

특히 가상 환경을 사용하는 경우 webui.db가 어디에 저장되어 있는지 잘 모를 경우, 다음 단계를 따라 찾을 수 있습니다:

1. 가상 환경을 활성화합니다(적용되는 경우).

2. Python 셸을 엽니다: python

3. Python 셸 내부에서 다음 코드를 실행합니다:

   import os
   import open_webui

   # Open WebUI 패키지가 설치된 위치를 표시
   print("Open WebUI가 설치된 위치:", open_webui.__file__)

   # `webui.db`의 잠재적 경로 구성(`data/webui.db`에 일반적으로 위치함)
   db_path = os.path.join(os.path.dirname(open_webui.__file__), "data", "webui.db")
   print("webui.db의 잠재적 경로:", db_path)

   # 해당 경로에 `webui.db`가 있는지 확인
   if os.path.exists(db_path):
       print("webui.db 발견됨:", db_path)
   else:
       print("webui.db 발견되지 않음:", db_path)

4. 출력 확인:
   • 파일이 발견되면 정확한 경로를 확인할 수 있습니다.
   • 발견되지 않으면, Linux에서 find를 사용하거나 Windows/Mac에서 전역 파일 검색을 수행해야 할 수 있습니다.

단계 2: webui.db 삭제

파일을 찾은 후, 다음과 유사한 명령을 사용하여 삭제합니다:

   rm -rf /path/to/your/python/environment/lib/pythonX.X/site-packages/open_webui/data/webui.db

경고: webui.db를 삭제하면 사용자 계정, 설정 및 비밀번호를 포함한 저장된 데이터가 모두 제거됩니다. 새로 시작하려는 경우에만 이 작업을 수행하세요!