← volver

Vaultwarden: tu propio gestor de contraseñas autoalojado con Docker

Por · · [Admin-Sistemas] · lectura estimada: ~5 min
$ í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.

Cómo se conectan tus dispositivos a tu Vaultwarden

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

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal