가벼운 자택 서버로 비밀번호를 직접 관리하는 방법
집 서버나 작은 클라우드에 비밀번호 저장소를 올려놓고, 공식 클라이언트 그대로 접속해 데이터를 직접 통제하는 장면을 상상해 보세요. 이 프로젝트는 Bitwarden 공식 서버가 요구하는 높은 사양을 피하면서, 기존 Bitwarden 앱과 호환되는 대안 서버를 제공합니다. Rust로 작성되어 자원을 적게 쓰면서도 개인 및 소규모 조직의 보안 요구를 충족시킵니다.
Bitwarden 앱 그대로 쓰는 이유
이 서버는 Bitwarden 클라이언트 API를 거의 완벽하게 구현합니다. 사용자가 이미 사용 중인 모바일, 데스크톱, 브라우저 확장 프로그램 등 공식 Bitwarden 클라이언트를 그대로 연결할 수 있습니다. 개인 금고, Send 기능, 첨부 파일, 웹사이트 아이콘, 개인 API 키 등 핵심 기능이 모두 지원됩니다. 조직용 기능으로는 컬렉션, 비밀번호 공유, 멤버 역할, 그룹, 이벤트 로그, 관리자 비밀번호 재설정, 디렉터리 커넥터, 정책 관리가 포함되어 있습니다. 또한 인증기, 이메일, FIDO2 WebAuthn, YubiKey, Duo 등 다양한 2단계 인증 방식과 긴급 액세스 기능도 지원합니다.
설치와 실행 환경
권장 설치 방법은 컨테이너 이미지를 사용하는 것입니다. ghcr.io, docker.io, quay.io에서 이미지를 가져와 Docker 또는 Podman으로 실행할 수 있습니다. 데이터 영구 저장을 위해 호스트 볼륨을 마운트해야 하며, 예시에서는 /vw-data/ 경로를 사용합니다. 웹 볼트 사용 시 Web Crypto API를 위해 HTTPS와 안전한 컨텍스트가 필수이므로, 반드시 HTTPS를 활성화해야 합니다. Rocket 웹 프레임워크 기반이지만, TLS 설정을 위해 리버스 프록시 사용을 권장합니다. 커뮤니티 패키지도 존재하지만 최신 버전이 아니거나 설정 방식이 다를 수 있으니 주의가 필요합니다.
데이터 손실과 책임 범위
이 프로젝트는 Bitwarden Inc.와 공식적으로 연관되어 있지 않습니다. 다만 유지보수자 중 한 명이 Bitwarden에 고용되어 있으나, 개인 시간과 독립적으로 기여하며 다른 유지보수자들이 검토합니다. 프로젝트 방향은 자택 호스팅 커뮤니티, 즉 개인, 가족, 소규모 조직을 중심으로 지속 가능성을 확보하는 데 맞춰져 있습니다. 중요한 점은 데이터 손실에 대해 개발진이 책임을 지지 않는다는 것입니다. 비밀번호, 첨부 파일 등 모든 정보의 정기적인 백업은 사용자의 몫이며, 데이터 유실 시 즉시 개발진에게 연락해야 합니다.
사용 전 확인 사항
공식 Bitwarden 지원 채널을 사용하지 말고, 버그나 제안은 이 프로젝트의 이슈 트래커나 커뮤니티 포럼에 직접 보고해야 합니다. 최신 버전을 사용하고 있는지, 유사한 문제가 이미 보고되었는지 먼저 확인하는 것이 좋습니다. 자원을 많이 쓰는 공식 서버가 부담스러운 환경이라면 이 대안 서버가 적합하지만, 데이터 백업 전략을 반드시 수립해야 합니다.
