Vaultwarden 보안 수준과 자가 호스팅 하드닝 가이드
Vaultwarden은 클라이언트 측 암호화를 지원하지만 관리자 토큰과 백업 파일 관리가 보안의 핵심입니다. 평문으로 저장되는 계정 메타데이터의 위험성을 이해하고 서버 설정을 강화하는 구체적인 방법을 확인하십시오.
Vaultwarden은 안전한가요? 짧은 답변
Vaultwarden은 가장 중요한 부분에서 보안을 유지합니다. 모든 볼트 항목은 서버에 도달하기 전에 사용자의 기기에서 암호화되기 때문입니다. 서버는 암호화된 볼트 콘텐츠와 일반 텍스트로 된 계정 메타데이터를 함께 저장합니다. 데이터베이스 전체를 복사하더라도 볼트의 암호화 키가 없으면 내용을 읽을 수 없지만, 계정 이메일 주소와 비밀번호 힌트는 즉시 노출됩니다.
이 답변은 많은 전제를 내포하고 있으며, 보안이 취약해지는 지점은 사용자가 설정하는 부분입니다. 추측 가능한 토큰 뒤에 숨겨진 관리자 패널, 인터넷 전체에 공개된 컨테이너 포트, 일반 텍스트로 된 config.json, 같은 서버의 홈 디렉터리에 방치된 백업 tarball 등이 그 예입니다. 이러한 문제들은 암호화 기술의 결함이 아닙니다. 이 모든 것이 자가 호스팅 볼트가 탈취되는 원인입니다.
아래의 모든 내용은 정상적으로 설치된 환경을 가정합니다. 아직 설치하지 않았다면 VPS용 Vaultwarden 설치 가이드를 통해 먼저 설치를 완료한 뒤, 이 목록을 순서대로 확인하십시오.
서버가 실제로 저장하는 데이터
Vaultwarden은 Bitwarden의 데이터 모델을 구현합니다. 볼트 항목의 이름, 사용자 이름, 비밀번호, 메모, URI는 요청이 전송되기 전에 클라이언트에서 무작위로 생성된 항목 키로 암호화됩니다. 해당 키는 사용자 또는 조직의 대칭 키로 보호되며, 비밀번호에서 파생된 키가 사용자의 대칭 키를 보호합니다. 첨부 파일 내용은 항목 키로 보호되는 별도의 첨부 파일 키를 사용합니다. 서버는 UUID(universally unique identifier)가 첨부된 불투명한 데이터를 수신합니다.
암호문이 아닌 데이터도 존재하며, 정확히 무엇인지 알아야 합니다.
- 계정 이메일 주소와 마스터 비밀번호 힌트는 평문으로 저장됩니다.
- KDF(key derivation function) 설정과 salt는 클라이언트가 다음 로그인 시 키를 재구성해야 하므로 평문으로 저장됩니다.
- 클라이언트가 전송한 마스터 비밀번호 해시의 서버 측 해시는 로그인 인증 자체에 사용됩니다.
- 메타데이터: 조직 멤버십, 기기 이름, 마지막 로그인 시간.
- 인증기 기반 2단계 로그인을 위한 TOTP 시크릿. 이 값은 서버가 사용자의 코드와 비교할 예상 코드를 계산해야 하므로
twofactor테이블에 암호화되지 않은 상태로 저장됩니다. 이는 볼트 항목 내부에 저장하는 TOTP(time-based one-time password) 시크릿과는 다르며, 후자는 다른 필드와 마찬가지로 암호화됩니다.
데이터 폴더의 크기는 작습니다. Docker 설치 환경에서는 /data에 마운트한 경로가 곧 데이터 폴더입니다.
sudo ls -l /vw-data/db.sqlite3은 거의 모든 상태 정보를 담고 있습니다. attachments/은 데이터베이스 테이블 외부의 UUID 디렉터리 하위에 업로드된 파일을 보관합니다. sends/는 Send 첨부 파일을 보관하며 임시 용도로 사용됩니다. icon_cache/은 일회성 데이터입니다. rsa_key.pem 및 관련 파일은 로그인한 사용자의 JWT(JSON web tokens)에 서명하므로, 해당 개인 키의 복사본을 탈취하면 볼트 로그인 세션을 위조할 수 있습니다. config.json는 관리자 페이지를 통해 저장된 설정을 보관하며, 여기에는 평문으로 된 SMTP 자격 증명과 설정된 관리자 토큰 값이 포함됩니다. 아래의 Argon2 지침을 따르면 평문 비밀번호 대신 관리자 토큰 해시가 저장됩니다.
따라서 실질적인 위협 모델은 네트워크 암호화가 아닌 파일 시스템 접근 권한입니다. 해당 디렉터리에 대한 읽기 권한이 있으면 모든 사용자의 이메일 주소, 로그인 2FA 시크릿, 세션 위조가 가능한 키, 그리고 오프라인에서 마음껏 공격할 수 있는 모든 볼트의 복사본을 탈취당하게 됩니다. 아래의 모든 단계는 해당 디렉터리에 대한 외부 접근을 차단하기 위해 존재합니다.
관리자 토큰을 먼저 수정하십시오
/admin은 사용자 목록, 초대, 삭제, 모든 런타임 설정을 포함하는 전체 제어 패널입니다. 이 패널은 단 하나의 공유 비밀값으로만 보호되며, 사용자 이름이나 사용자별 2단계 인증은 지원하지 않습니다.
이전 가이드에서는 openssl rand -base64 48을 사용하여 ADMIN_TOKEN을 생성하라고 안내합니다. 이 방법도 작동하지만, 설정하는 곳마다 비밀값이 평문으로 노출됩니다. Vaultwarden은 Argon2 PHC(Password Hashing Competition) 문자열도 허용하므로, 저장되는 값을 해시 형태로 바꿀 수 있습니다. 실행 중인 컨테이너에서 생성하려면 다음 명령을 사용하십시오.
docker exec -it vaultwarden /vaultwarden hash또는 컨테이너를 건드리지 않고 생성할 수도 있습니다.
docker run --rm -it vaultwarden/server /vaultwarden hash비밀번호를 두 번 입력하면 $argon2id$로 시작하는 줄이 출력됩니다. 베어메탈 환경이라면 ./vaultwarden hash을 실행하십시오. argon2 CLI를 직접 사용하려면 프로젝트 문서에 명시된 OWASP 최소 권장 매개변수를 따르십시오.
echo -n 'MySecretPassword' | argon2 "$(openssl rand -base64 32)" -e -id -k 19456 -t 2 -p 1이제 많은 사용자가 한 시간씩 허비하는 함정을 설명하겠습니다. PHC 문자열에는 $ 문자가 포함되어 있는데, Docker Compose는 $을 변수 치환 기호로 처리합니다. 이를 이스케이프 처리하지 않고 environment: 블록에 붙여넣으면 컨테이너에 전달되는 값이 훼손되어, 올바른 토큰을 입력해도 /admin가 거부하게 됩니다. 두 가지 안전한 방법이 있습니다. docker-compose.yml에서는 $을 두 번씩 입력하십시오.
environment:
ADMIN_TOKEN: $$argon2id$$v=19$$m=19456,t=2,p=1$$UUZxK1FZMkZoRHFQRlVrTXZvS0E3bHpNQW55c2dBN2NORzdsa0Nxd1JhND0$$cUoId+JBUsJutlG4rfDZayExfjq4TCt48aBc9qsc3UI.env 파일에서는 이스케이프가 필요 없지만, 작은따옴표를 사용해야 합니다.
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$MmeKRnGK5RW5mJS7h3TOL89GrpLPXJPAtTK8FTqj9HM$DqsstvoSAETl9YhnsXbf43WeaUwJC6JhViIvuPoig78'그다음 패널에 속도 제한을 걸고 세션 시간을 단축하십시오.
ADMIN_RATELIMIT_SECONDS=300
ADMIN_RATELIMIT_MAX_BURST=3
ADMIN_SESSION_LIFETIME=20이 설정은 클라이언트 IP당 3회의 관리자 로그인 요청을 허용하며, 이후 5분마다 1회씩 허용량을 보충합니다. 제한 장치가 비밀번호 확인보다 먼저 작동하므로 올바른 비밀번호와 틀린 비밀번호 모두 제한 횟수에 포함됩니다. 제한을 초과한 요청은 Too many requests, try again later.와 함께 HTTP 429 응답을 받습니다. 관리자 세션은 활동 여부와 관계없이 로그인 후 20분이 지나면 만료됩니다.
이보다 더 좋은 방법은 페이지 자체를 끄는 것입니다. 대부분의 인스턴스는 SMTP 설정과 초기 사용자 초대를 위해 한 번만 사용하면 다시는 필요하지 않습니다. 페이지를 비활성화하려면 ADMIN_TOKEN과 DISABLE_ADMIN_TOKEN을 모두 설정하지 말고, config.json에서 "admin_token" 키를 제거한 뒤 컨테이너를 다시 생성하십시오. 파일에서 키를 삭제하는 것이 중요한 이유는 관리자 페이지가 설정을 해당 파일에 기록하며, config.json에 있는 값이 환경 변수보다 우선하기 때문입니다. 환경 변수만 제거하면 페이지는 여전히 열려 있게 됩니다.
도메인이 노출되기 전에 가입 기능을 닫으십시오
SIGNUPS_ALLOWED=false
SIGNUPS_VERIFY=true
SHOW_PASSWORD_HINT=falseSIGNUPS_ALLOWED의 기본값은 true입니다. 이 설정을 그대로 두면 도메인에 접속하는 누구나 계정을 생성할 수 있으며, 해당 사용자의 데이터는 귀하의 데이터와 동일한 db.sqlite3에 저장됩니다. 이 값을 false로 설정하고 관리자 페이지에서 초대장을 통해 사용자를 추가하십시오. SMTP가 설정되어 있으면 초대 이메일이 발송되며, 설정되지 않은 경우 서버는 해당 주소에 대한 초대 기록만 남깁니다. INVITATIONS_ALLOWED 역시 기본적으로 true으로 설정되어 있어 조직 관리자가 다른 사용자를 초대할 수 있습니다. 사용자를 신뢰할 수 있는 환경이라면 괜찮지만, 단일 사용자 인스턴스라면 false로 설정해야 합니다. 특정 도메인만 가입을 허용해야 한다면 SIGNUPS_DOMAINS_WHITELIST=example.com를 사용할 수 있으나, 이는 자유 가입보다 범위가 좁을 뿐 초대 방식보다는 보안이 훨씬 취약합니다.
SHOW_PASSWORD_HINT은 기본적으로 false로 설정되어 있으며 이 상태를 유지해야 합니다. SMTP가 설정되지 않은 상태에서 이 기능이 켜져 있으면, 로그인 폼에 유효한 이메일 주소를 입력할 때 해당 계정의 마스터 비밀번호 힌트가 반환됩니다. 이는 힌트 유출뿐만 아니라 해당 이메일 주소의 존재 여부까지 확인해 주는 결과를 초래합니다.
인스턴스의 가입 기능을 잠시라도 열어두었다면, 관리자 페이지에 접속하여 사용자 목록을 확인하십시오. 본인 외에 다른 계정이 없는지 먼저 검토해야 합니다.
의도치 않게 공개된 포트
Docker 이미지는 컨테이너 내부의 80번 포트에서 대기합니다. 베어메탈 설치 시 기본값은 ROCKET_PORT=8000입니다. 문서화된 실행 명령은 다음과 같이 포트를 게시합니다.
--publish 127.0.0.1:8000:80127.0.0.1: 접두사는 이 설정의 핵심입니다. 대신 -p 8000:80을 작성하면 Docker는 0.0.0.0에 바인딩하며, 이는 nat 테이블에 DNAT(대상 네트워크 주소 변환) 규칙을 작성하는 방식으로 이루어집니다. 이 규칙들은 ufw가 관리하는 filter 체인보다 먼저 평가되므로, ufw status는 포트가 거부되었다고 보고하지만 실제로는 인터넷을 향해 포트가 활짝 열려 있게 됩니다. 전체 메커니즘에 대해서는 ufw를 우회하는 Docker 포트 가이드를 읽어보는 것이 좋습니다.
실제로 무엇이 대기 중인지 확인하십시오.
sudo ss -tlnp | grep 8000정상적인 결과는 127.0.0.1:8000에 바인딩된 단일 행입니다. 0.0.0.0:8000에 바인딩된 행이 있다면 Vault가 직접 노출된 상태입니다. 매핑을 수정하고 컨테이너를 다시 생성하십시오. 포트 바인딩은 컨테이너 생성 시점에 고정되며 docker compose restart로는 변경되지 않기 때문입니다.
docker compose up -d --force-recreate오래된 가이드에는 3012번 포트가 하나 더 남아 있습니다. 이는 별도의 WebSocket 포트입니다. 알림 트래픽이 메인 HTTP 포트로 통합됨에 따라 Vaultwarden 1.31.0에서 해당 포트에 대한 지원이 제거되었습니다. WEBSOCKET_ENABLED 및 WEBSOCKET_PORT는 1.29.0 버전부터 더 이상 사용되지 않으며 무시됩니다. 현재 스위치는 ENABLE_WEBSOCKET이며 기본값은 true입니다. 방화벽이나 compose 파일에서 여전히 3012번 포트를 열어두었다면 닫으십시오.
리버스 프록시에서 TLS 종료하기 (Rocket이 아닌 경우)
Vaultwarden은 웹 프레임워크인 Rocket을 통해 자체적으로 TLS(전송 계층 보안)를 제공할 수 있으나, 프로젝트 측에서는 운영 환경에서 이를 사용하지 말 것을 권장합니다. Rocket의 내장 TLS는 엄격한 SNI(서버 이름 표시) 지원이 부족합니다. 이것이 바로 보안 강화 권고 사항에서 인스턴스에 접근할 때 IP 주소가 아닌 호스트 이름을 사용하라고 하는 이유입니다. 공인 IP 대역은 지속적으로 스캔되며, IP 주소로 응답하는 볼트는 곧바로 발견됩니다.
nginx 서버 블록에서 중요한 부분은 다음과 같습니다.
client_max_body_size 525M;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}nginx의 기본값은 client_max_body_size에서 1m으로 설정되어 있으므로, 이 제한보다 큰 요청 본문은 실패합니다. nginx는 클라이언트에 HTTP 413을 반환하고 client intended to send too large body: ... bytes을 기록합니다. 거부된 업로드는 Vaultwarden에 도달하지 않습니다. Upgrade 및 Connection 헤더는 WebSocket 핸드셰이크를 /notifications/hub으로 전달합니다. 이 헤더를 제거해도 볼트는 작동하지만, 브라우저 및 데스크톱 클라이언트로 전달되는 WebSocket 알림은 중단됩니다. 모바일 클라이언트는 별도로 구성된 푸시 알림을 사용합니다.
Caddy는 설정이 더 간결하며 인증서를 자동으로 획득합니다.
vw.example.com {
reverse_proxy 127.0.0.1:8000 {
header_up X-Real-IP {remote_host}
}
}그런 다음 Vaultwarden에 이를 알립니다.
DOMAIN=https://vw.example.com
IP_HEADER=X-Real-IPIP_HEADER은 이미 기본값이 X-Real-IP로 설정되어 있으므로, 프록시가 실제로 해당 헤더를 설정하는지 확인하는 것이 중요합니다. Vaultwarden은 IP_HEADER_TRUSTED_PROXIES에 나열된 주소에서만 해당 헤더를 허용하며, 기본값은 local입니다. 이는 동일한 호스트나 동일한 컨테이너 네트워크에 있는 프록시를 포함하는 모든 비공용 주소를 의미합니다. 공용 주소에서 연결되는 프록시는 여기에 추가해야 합니다. 헤더가 누락되었거나 신뢰할 수 없는 주소에서 온 경우, 모든 로그 라인과 로그인 속도 제한은 프록시의 주소를 기준으로 기록됩니다. 즉, 공격자 한 명의 실패가 인스턴스의 모든 사용자에게 영향을 미치게 됩니다. 대신 IP_HEADER=X-Forwarded-For를 사용하는 경우, 1.37.4 버전은 신뢰할 수 있는 프록시가 아닌 가장 오른쪽 주소를 가져오므로 nginx 앞단의 CDN을 포함하여 체인에 있는 모든 프록시를 나열해야 합니다. 또한 DOMAIN을 실제 https URL로 설정하십시오. Vaultwarden은 이를 기반으로 초대 및 계정 복구 링크를 생성하며, WebAuthn 보안 키도 해당 오리진에 바인딩되기 때문입니다.
사용자가 자주 놓치는 세부 사항이 하나 있습니다. WebSocket 연결은 세션 토큰을 쿼리 문자열인 /notifications/hub?access_token=[JWT]로 전달합니다. 이 정보는 프록시 접근 로그에 평문으로 기록됩니다. 로그 형식에서 access_token 매개변수를 마스킹하거나, 해당 로그가 제어할 수 없는 곳으로 전송되지 않도록 하십시오.
로그인 엔드포인트에서 무차별 대입 공격 차단하기
속도 제한(rate limit)은 기본적으로 활성화되어 있습니다(LOGIN_RATELIMIT_SECONDS=60, LOGIN_RATELIMIT_MAX_BURST=10). 이는 공격자의 속도를 늦추지만, 완전히 막지는 못합니다. fail2ban은 공격을 차단할 수 있지만, Vaultwarden의 로그인 실패 기록을 읽을 수 있어야 합니다. Docker 환경에서 가장 간단한 방법은 로그 파일을 사용하는 것이며, Vaultwarden은 기본적으로 로그 파일을 생성하지 않습니다.
LOG_FILE=/data/vaultwarden.log
LOG_LEVEL=info
EXTENDED_LOGGING=true비밀번호 로그인 실패 시 다음과 같은 형식의 줄이 생성되며, 필터는 이 문자열을 일치시켜야 합니다.
[2026-08-07 09:14:22.000][vaultwarden::api::identity][ERROR] Username or password is incorrect. Try again. IP: 203.0.113.10. Username: user@example.com./etc/fail2ban/filter.d/vaultwarden.local에 필터를 작성합니다.
[INCLUDES]
before = common.conf
[Definition]
failregex = ^.*?Username or password is incorrect\. Try again\. IP: <ADDR>\. Username:.*$
ignoreregex =그리고 /etc/fail2ban/jail.d/vaultwarden.local에 jail을 작성합니다.
[vaultwarden]
enabled = true
backend = pyinotify
port = 80,443
filter = vaultwarden
banaction = %(banaction_allports)s
logpath = /vw-data/vaultwarden.log
maxretry = 3
bantime = 14400
findtime = 14400Vaultwarden을 컨테이너가 아닌 systemd 서비스로 실행 중이라면 LOG_FILE 단계는 건너뛸 수 있습니다. 프로젝트의 fail2ban 위키에서는 logpath 대신 backend = systemd와 Vaultwarden 유닛에 대한 journalmatch를 사용하여 저널을 읽는 방식을 권장합니다.
관리자 페이지를 유지하고 있다면 failregex이 ^.*Invalid admin token\. IP: <ADDR>.*$인 두 번째 jail을 추가하십시오. 관리자 로그인 실패는 다른 메시지로 기록되므로 기존 로그인 필터가 이를 감지할 수 없기 때문입니다. 설정이 완료되면 다음 명령으로 확인합니다.
sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwarden정상적으로 작동하는 jail은 File list 항목에 로그 파일 경로를 표시하고 Currently failed: 0 상태를 보고합니다. 다른 네트워크에서 비밀번호를 3회 틀리면 카운터가 올라가고, 해당 IP 주소가 Banned IP list 항목에 나타납니다. 카운터가 전혀 변하지 않는다면, 흔한 원인은 logpath입니다. 이는 컨테이너 내부의 /data/... 경로가 아니라 호스트 시스템의 실제 파일 경로여야 합니다. 두 번째 흔한 원인은 X-Real-IP가 누락되었거나 신뢰할 수 없는 경우이며, 이로 인해 모든 차단 대상이 프록시 서버 자신으로 지정될 수 있습니다. 이미 실행 중이어야 할 SSH jail을 포함한 나머지 설정은 Ubuntu 24.04용 fail2ban 가이드에서 확인할 수 있습니다.
마스터 비밀번호가 여전히 시스템 전체를 보호합니다
클라이언트 측 암호화란 마스터 비밀번호가 사용자의 대칭 키를 보호한다는 의미입니다. 공격자가 데이터베이스를 복사해 간 인스턴스에서 마스터 비밀번호가 짧다면, 이 글의 어떤 설정으로도 보호받을 수 없습니다. 공격자는 자신의 하드웨어가 허용하는 속도로 오프라인에서 해당 복사본을 공격하기 때문입니다. 서버 설정은 공격자의 개인 장비에 영향을 미치지 않습니다.
PASSWORD_ITERATIONS=600000는 오해하기 쉽습니다. 이 설정은 클라이언트가 전송하는 로그인 해시를 서버 측에서 해싱할 때의 반복 횟수를 결정하며, 프로젝트 구성 템플릿에 따르면 변경된 값은 기존 사용자가 다음번에 로그인할 때 적용됩니다. 이 설정은 클라이언트 측 KDF에는 영향을 주지 않으며, 클라이언트 측 KDF야말로 볼트에 대한 오프라인 공격의 난이도를 결정하는 설정입니다. 해당 설정은 각 계정에 귀속되며, 웹 볼트의 Settings, Security, Keys 메뉴에서 변경해야 키가 다시 암호화됩니다. Bitwarden 문서에 따르면 2026.2.1 버전 이후의 클라이언트는 사용자가 마스터 비밀번호로 로그인하거나 잠금을 해제할 때 600,000회 미만인 PBKDF2 설정을 자동으로 상향 조정합니다. 2026년 10월 10일 기준으로 이 동작이 Vaultwarden 서버에서도 동일하게 작동하는지는 확인되지 않았으며, Argon2id 설정은 절대 변경하지 않습니다. 따라서 몇 년 전에 가입한 사용자는 여전히 낮은 KDF 설정 상태일 수 있습니다. 서버가 대신 수행할 수 없는 작업이므로, 직접 확인하고 사용자에게 안내해야 합니다.
그다음 각 계정별로 2단계 인증을 활성화하십시오. 2단계 인증은 볼트 암호화 과정에 관여하지 않으므로 암호문 자체를 보호하지는 않습니다. 하지만 비밀번호가 탈취되었을 때 로그인하여 볼트 사본을 동기화하는 것을 방지할 수는 있습니다. 이메일 설정이 완료된 상태에서 REQUIRE_DEVICE_EMAIL=true을 활성화하면 새 장치 로그인 시 이메일 발송이 필수가 됩니다. 즉, 이메일 발송에 실패하면 로그인도 실패합니다. 메일 서비스가 완전히 비활성화된 경우, 이 설정은 새 장치 로그인을 차단하지 않습니다.
백업은 셀프 호스팅 볼트가 실패하는 지점입니다
동일한 VPS의 홈 디렉터리에 남겨둔 데이터 폴더의 tar czf은 앞서 수행한 모든 보안 조치를 무효화합니다. 해당 아카이브에는 모든 사용자의 암호문이 담긴 db.sqlite3, 로그인 세션을 위조할 수 있는 rsa_key.pem, 그리고 설정된 관리자 토큰 값과 SMTP 비밀번호가 포함된 config.json이 들어 있습니다. Argon2 지침을 따르면 관리자 비밀번호의 해시가 저장되지만, SMTP 비밀번호는 평문으로 남습니다. 이 파일에 대한 읽기 권한이 있으면 계정 메타데이터, 서버 보안 정보, 암호화된 볼트 데이터가 모두 노출됩니다.
이를 방지하는 두 가지 규칙이 있습니다. 아카이브를 서버 외부로 반출하십시오. 그리고 반출하기 전에 암호화하십시오.
데이터의 무결성 문제도 존재합니다. 서비스가 실행 중인 상태에서 cp를 사용하여 db.sqlite3을 복사하면 쓰기 작업이 진행 중인 파일이 생성되어 열리지 않을 수 있으며, 이는 복구 시점에야 확인하게 됩니다. 대신 SQLite 자체의 스냅샷 기능을 사용하십시오.
sqlite3 /vw-data/db.sqlite3 ".backup '/tmp/vw-db-backup.sqlite3'"아무도 테스트하지 않는 절반의 과정인 복구 작업은 Vaultwarden 백업 및 복구 가이드에서 다룹니다.
호스팅된 Bitwarden 대신 직접 운영할 때 포기해야 하는 것
솔직한 평가가 필요합니다. Bitwarden의 호스팅 서비스는 이를 전담하는 인력이 운영하며, 제3자 보안 감사를 거쳐 결과를 공개합니다. 직접 호스팅을 선택한다는 것은 이 과정을 스스로의 패치 주기로 대체한다는 의미입니다.
Vaultwarden은 보안 수정 사항을 일반적인 릴리스 형태로 자주 배포합니다. 2026년 11월 2일 프로젝트 릴리스 피드를 확인한 결과, 최신 버전은 2026년 11월 1일에 배포된 1.37.5입니다. 해당 릴리스 노트에는 두 건의 중간(Medium) 위험도 보안 권고가 포함되어 있으며, 즉시 업데이트할 것을 강력히 권장합니다. 또한 웹 볼트 2026.7.1 이상 버전에서 2단계 로그인 방식을 설정하거나 해제하기 위해, 그리고 2026.9.0 이상 버전에서 긴급 접근을 통해 계정 권한을 인수하기 위해 이 업데이트가 필수적입니다. 이전 버전인 1.37.4는 2026년 10월 5일에 배포되었으며, 가장 높은 위험도가 '높음(High)'인 7건의 보안 권고를 다루었습니다. 이는 2026년 7월 24일 1.37.0 릴리스 이후 네 번째 업데이트였습니다. 7월 29일에 1.37.1, 8월 22일에 1.37.2(클라이언트 버전 2026.8.0 이상에서 필수), 9월 13일에 1.37.3이 뒤를 이었습니다. 1.37.3 버전은 자격 증명이나 2FA가 변경될 때 2FA 기억 토큰을 무효화하고 사전 로그인 및 인증 요청 엔드포인트에 속도 제한(rate limit)을 적용했습니다. 완전히 신뢰할 수 없는 관리자가 포함된 조직을 운영 중이라면, 1.37.4 릴리스 노트는 업데이트 후 각 조직의 API 키를 교체할 것을 권장합니다. 또한 1.37.4는 X-Forwarded-For에서 읽어오는 주소를 변경하며, 이는 앞선 리버스 프록시 섹션에서 다루었습니다. 1년 전에 설정하고 잊어버린 인스턴스는 1년 전 코드로 실행되고 있는 셈입니다. latest 태그만으로는 충분하지 않습니다. 실행 중인 컨테이너는 docker compose pull를 실행하여 다시 생성하기 전까지는 처음 시작할 때의 이미지를 그대로 유지하기 때문입니다. 호스트 패키지를 위해 Ubuntu의 자동 업데이트를 설정하고, 컨테이너 업데이트는 반드시 확인할 수 있는 일정 알림으로 등록해 두어야 합니다.
솔직한 독자라면 다음과 같은 결론을 내려야 합니다. 이곳의 암호화 기술은 Bitwarden의 설계를 따르므로 안전하지만, 운영상의 위험은 전적으로 사용자에게 넘어옵니다. 패치를 꾸준히 수행하고 다른 곳에 백업을 유지한다면, 직접 제어하는 VPS에서 Vaultwarden 인스턴스를 운영하는 것은 비밀번호를 보관하기에 합리적인 선택입니다. 만약 이러한 습관을 유지할 자신이 없다면, 비용을 지불하고 호스팅 서비스를 이용하며 다른 곳에 주의를 기울이는 것이 좋습니다. 기능별 상세 비교는 Vaultwarden과 직접 호스팅하는 Bitwarden 비교에서 확인할 수 있습니다.
컨테이너 하위 호스트 보안 강화
Vaultwarden은 Linux 시스템에서 실행되는 하나의 프로세스일 뿐이며, 해당 시스템의 root 권한을 가진 사용자는 애플리케이션 설정과 관계없이 /vw-data을 읽을 수 있습니다. 컨테이너를 권한이 없는 사용자로 실행하려면 compose 파일에 user: "1000:1000"을 설정하고, 데이터 폴더의 소유권을 해당 사용자와 일치시키십시오. 또한 컨테이너가 쓰기 작업을 수행하지 않는 모든 항목은 :ro을 사용하여 읽기 전용으로 마운트하십시오. 마지막으로 외부 접근 경로를 차단하십시오. VPS의 SSH 보안 강화 문서에서는 키 기반 로그인 설정 및 비밀번호 인증 비활성화 방법을 다루고 있으며, 이는 앞서 언급한 모든 보안 조치를 우회하는 일반적인 공격을 방어하는 핵심 수단입니다.
FAQ
Vaultwarden 데이터베이스를 탈취하면 비밀번호를 읽을 수 있습니까?
직접적으로는 불가능합니다. 모든 볼트 항목은 클라이언트 측에서 무작위로 생성된 키로 암호화되며, 사용자 또는 조직의 대칭 키로 보호됩니다. 비밀번호에서 파생된 키는 사용자의 대칭 키를 보호하는 역할을 합니다. db.sqlite3에는 암호화된 볼트 내용과 함께 일반 텍스트 형태의 계정 메타데이터가 포함되어 있습니다. 공격자가 즉시 얻을 수 있는 정보는 각 계정의 이메일 주소, 비밀번호 힌트, KDF 설정, 로그인 및 기기 메타데이터입니다. twofactor 테이블에 저장된 로그인 TOTP 시크릿은 서버가 예상 코드를 계산해야 하므로 암호화되지 않은 상태로 저장됩니다. 공격자는 볼트 암호문을 오프라인에서 원하는 만큼 공격할 수 있으므로, 마스터 비밀번호의 길이가 보안의 핵심이 됩니다.
ADMIN_TOKEN을 사용해야 합니까, 아니면 관리자 페이지를 완전히 비활성화해야 합니까?
가능하다면 비활성화하십시오. 대부분의 인스턴스는 SMTP 설정과 사용자 초대를 위해 관리자 페이지를 한 번 사용한 뒤에는 다시 사용할 일이 거의 없습니다. 비활성화하려면 ADMIN_TOKEN과 DISABLE_ADMIN_TOKEN를 모두 설정하지 말고, config.json에서 "admin_token" 키를 제거한 뒤 컨테이너를 다시 생성하십시오. 환경 변수만 제거하는 것으로는 충분하지 않습니다. 관리자 페이지를 통해 작성된 설정은 config.json에 저장되며 우선순위를 갖기 때문입니다. 페이지를 유지해야 한다면 토큰을 일반 텍스트 문자열 대신 vaultwarden hash으로 생성한 Argon2 해시로 저장하고 ADMIN_RATELIMIT_MAX_BURST=3를 설정하십시오.
ADMIN_TOKEN이 올바른데도 /admin 페이지에서 거부됩니다. 무엇이 문제입니까?
거의 항상 $ 보간 문제입니다. Argon2 PHC 문자열에는 여러 개의 $ 문자가 포함되어 있는데, Docker Compose는 이를 docker-compose.yml environment: 블록 내의 변수로 확장합니다. 이로 인해 파일상으로는 올바르게 보여도 컨테이너는 손상된 값을 전달받게 됩니다. compose 파일에서 모든 $를 $$으로 두 번 입력하거나, 값을 작은따옴표로 감싼 .env 파일로 옮기십시오. 이 경우 이스케이프 처리가 필요하지 않습니다. 환경 변수 변경 사항은 재시작만으로는 적용되지 않으므로 이후 컨테이너를 다시 생성해야 합니다.
알림을 위해 여전히 3012 포트를 열어야 합니까?
아닙니다. Vaultwarden 1.31.0부터 3012 포트를 통한 WebSocket 트래픽 지원이 제거되었습니다. 알림 기능이 메인 HTTP 포트로 통합되었으며, WEBSOCKET_ENABLED와 WEBSOCKET_PORT은 1.29.0부터 폐기되어 무시됩니다. 현재 설정은 ENABLE_WEBSOCKET이며 기본값은 true입니다. 방화벽에서 3012 포트를 닫고 compose 파일에서 삭제하십시오. 브라우저 및 데스크톱 WebSocket 알림은 Upgrade 및 Connection 헤더에 의존하므로, 리버스 프록시가 이 헤더들을 전달하도록 설정되어 있는지 확인하십시오. 모바일 클라이언트는 별도로 설정된 푸시 알림을 사용합니다.