Vaultwarden: tu propio gestor de contraseñas autoalojado con Docker
$ índice
Si tus contraseñas viven en un Excel, en notas del móvil o repetidas en veinte servicios, tienes un problema que un gestor de contraseñas resuelve de raíz. Y si además no quieres que esas contraseñas vivan en los servidores de nadie, la respuesta es Vaultwarden: una reimplementación en Rust del servidor de Bitwarden, ligera y autoalojada, compatible con todas las aplicaciones oficiales de Bitwarden. Un solo contenedor Docker, una base de datos SQLite y tus credenciales bajo tu control.
Por qué Vaultwarden y no el Bitwarden oficial
El Bitwarden autoalojado oficial es un despliegue pesado: varios contenedores, SQL Server y al menos 2 GB de RAM. Vaultwarden hace lo mismo con un binario estático de unos 50 MB y una única base de datos. Además, desbloquea sin pagar las funciones que en bitwarden.com son de pago: TOTP integrado, organizaciones para compartir con la familia o el equipo, adjuntos, acceso de emergencia e informes de seguridad.
La contrapartida es honesta: tú eres el operador, y las copias, los parches y el HTTPS son tu responsabilidad.
El cifrado es de extremo a extremo: la bóveda se cifra en tu dispositivo con tu contraseña maestra y el servidor solo guarda blobs cifrados. Por eso el HTTPS no es opcional: sin él, los clientes oficiales de Bitwarden se niegan a conectar, porque el cifrado del lado del cliente depende de la API Web Crypto, que solo funciona en contextos seguros.

Despliegue con Docker Compose
Necesitas un VPS o un servidor en casa con Docker y un dominio apuntando a él, por ejemplo vault.tudominio.com. Crea el proyecto:
mkdir -p /opt/vaultwarden && cd /opt/vaultwarden
openssl rand -hex 32 # anota el valor: será tu ADMIN_TOKEN
Escribe el compose.yml:
services:
vaultwarden:
image: vaultwarden/server:1.37.5
container_name: vaultwarden
restart: unless-stopped
environment:
DOMAIN: "https://vault.tudominio.com"
SIGNUPS_ALLOWED: "true"
INVITATIONS_ALLOWED: "true"
ADMIN_TOKEN: "pega-aqui-el-token-generado"
ENABLE_WEBSOCKET: "true"
volumes:
- ./vw-data:/data
ports:
- "127.0.0.1:8080:80"
Fíjate en tres detalles. El puerto solo escucha en 127.0.0.1: nadie llega a Vaultwarden directamente, solo el proxy inverso. SIGNUPS_ALLOWED empieza en true para que puedas crear tu cuenta, pero es temporal. Y la imagen va con versión fijada (1.37.5, la vigente al escribir esto), no latest, para que las actualizaciones sean una decisión consciente.
Arranca el servicio:
docker compose up -d
docker compose logs -f vaultwarden
HTTPS con Caddy y primer acceso
Delante de Vaultwarden pon un proxy inverso que emita el certificado. Con Caddy, el proxy inverso con HTTPS automático, basta con este Caddyfile (Caddy obtiene y renueva el certificado de Let’s Encrypt solo):
vault.tudominio.com {
reverse_proxy 127.0.0.1:8080
}
Comprueba que https://vault.tudominio.com responde y crea tu cuenta desde la web. En ese momento, cierra el registro para siempre:
sed -i 's/SIGNUPS_ALLOWED: "true"/SIGNUPS_ALLOWED: "false"/' compose.yml
docker compose up -d
A partir de ahí, las cuentas nuevas solo entran por invitación desde el panel de administración (https://vault.tudominio.com/admin, protegido por tu ADMIN_TOKEN). Si algún día quieres endurecerlo aún más, el panel permite sustituir el token en claro por su hash Argon2.
Instala después las aplicaciones oficiales de Bitwarden (escritorio, móvil y extensión del navegador) y, en cada una, cambia la URL del servidor a https://vault.tudominio.com antes de iniciar sesión. Activa el segundo factor en tu cuenta: Vaultwarden admite TOTP y llaves de seguridad FIDO2/WebAuthn.
Copias de seguridad: lo único que no puede fallar
Toda tu bóveda vive en un solo directorio: ./vw-data, con la base de datos db.sqlite3, las claves RSA y los adjuntos. Si ese directorio se pierde sin copia, no hay forma de recuperar nada: ni Vaultwarden ni Bitwarden guardan una copia de tu contraseña maestra.
La copia es tan simple como parar el contenedor, copiar el directorio y volver a arrancar:
docker compose stop
tar -czf /root/backups/vaultwarden-$(date +%F).tar.gz vw-data
docker compose start
Hazlo a diario con un temporizador y guarda una copia fuera del servidor, por ejemplo con copias cifradas y verificables con Restic. Y una vez al mes, prueba la restauración en una máquina de pruebas: una copia que nunca se ha restaurado es solo una esperanza. Guarda además, fuera del servidor y en papel, tu contraseña maestra y los códigos de recuperación del 2FA; sin ellos, ni la mejor copia sirve.
Actualizaciones y mantenimiento
Actualizar es un solo comando, pero léete antes las notas de la versión: Vaultwarden va por detrás de los clientes oficiales y algunas versiones exigen una versión mínima del servidor, o retiran funciones antiguas.
docker compose pull
docker compose up -d
docker compose logs --tail 50 vaultwarden
Si el log arranca sin errores y la web responde, listo. Si algo falla, vuelve al tag anterior y restaura la copia del día anterior.
Checklist final
| Paso | Estado |
|---|---|
| HTTPS activo antes del primer inicio de sesión | ☐ |
Registro público cerrado (SIGNUPS_ALLOWED=false) |
☐ |
Panel /admin protegido con un token largo |
☐ |
| 2FA activado en la cuenta principal | ☐ |
| Clientes oficiales apuntando a tu dominio | ☐ |
Copia diaria de vw-data fuera del servidor |
☐ |
| Restauración probada al menos una vez | ☐ |
| Contraseña maestra y códigos 2FA guardados fuera del servidor | ☐ |
Vaultwarden no es el servicio más vistoso de tu homelab, pero guarda las llaves de todos los demás. Móntalo con calma, cierra el registro, haz la copia y pruébala: el día que un servicio filtre credenciales, la diferencia entre cambiar veinte contraseñas en una tarde o no poder cambiar ninguna estará en haber hecho bien este trabajo. Y ya que estás endureciendo el servidor, revisa también el acceso SSH con SSH a prueba de bots.
comentarios(0)
$ dejar comentario