Ubuntu 24.04에 Bitwarden 비밀번호 관리 볼트 배포

출처: Dev.to

사전 요구 사항

• Ubuntu 24.04 (최소 2 GB RAM, 권장 4 GB)
• Docker 및 Docker Compose 설치
• 서버를 가리키는 도메인 이름
• bitwarden.com/host 에서 제공되는 설치 ID와 키

설치

1. 현재 사용자를 Docker 그룹에 추가

sudo usermod -aG docker $USER
newgrp docker

2. 설치 디렉터리를 생성하고 소유권을 부여

sudo mkdir -p /opt/bitwarden
sudo chown -R $USER:$USER /opt/bitwarden
cd /opt/bitwarden

3. 설치 스크립트를 가져오기

curl -Lso bitwarden.sh https://go.btwrdn.co/bw-sh
chmod 700 bitwarden.sh

4. 설치 프로그램 실행

./bitwarden.sh install

다음 항목을 입력하라는 프롬프트가 표시됩니다:

• 도메인 이름 – 예: bitwarden.example.com
• Let’s Encrypt 사용 – y (권장) 및 연락 이메일 입력
• 데이터베이스 이름 – 기본값 vault 사용해도 됨
• 설치 ID와 키 – 위 링크에서 확인
• 지역 – 설치 ID를 받은 지역에 맞게 US 또는 EU

5. 스택을 시작

./bitwarden.sh start

6. 컨테이너 실행 확인

docker container ls

첫 시작 시 이미지가 다운로드되고 설정이 구축됩니다. 몇 분 정도 소요될 수 있습니다.

최초 접근

1. 브라우저에서 https://bitwarden.example.com을 엽니다.
2. Create Account(계정 만들기)를 클릭하고 가입 양식을 작성합니다.
3. 이메일 주소를 인증합니다. (SMTP가 아직 설정되지 않았다면 /opt/bitwarden/bwdata/env/global.override.env 파일을 편집하세요.)
4. 로그인하여 첫 조직을 만들고 금고 항목을 추가합니다.

경고: Bitwarden은 제로 지식 암호화를 사용합니다. 마스터 비밀번호를 분실하면 금고를 복구할 수 없습니다. 마스터 비밀번호는 오프라인에서 안전하게 보관하세요.

설치 후 작업

• SMTP 설정 – 사용자가 초대 및 비밀번호 재설정 이메일을 받을 수 있도록 합니다.
• /opt/bitwarden/bwdata의 정기 백업 설정

유지 보수

• 새 릴리스 업데이트: ./bitwarden.sh update
• 업데이트 후 스택 재시작: ./bitwarden.sh restart

추가 자료

추가 팁이 포함된 전체 가이드는 Vultr Docs의 원본 글을 참고하세요.