
Cómo alojar tu gestor de contraseñas tipo BitWarden
Tus contraseñas son tu propiedad digital más importante, y mantenerlas seguras significa tenerlas en tus propias manos.
Tus contraseñas son tu propiedad digital más importante, y mantenerlas seguras significa tenerlas en tus propias manos. Al autoalojar (self-hosting) tu propio gestor de contraseñas, tomas el control de tu propia seguridad.
BitWarden es ampliamente considerado como uno de los más confiables en el ámbito de la gestión de contraseñas y su código fuente está disponible bajo la licencia AGPL-3.0. NodeWarden es un servidor no oficial compatible con BitWarden, escrito en Typescript, que se puede desplegar de forma gratuita en Cloudflare.
Comparación de características con el servidor oficial de BitWarden
| Capacidad | BitWarden | NodeWarden | Notas |
|---|---|---|---|
| Bóveda Web (Web Vault) | ✅ | ✅ | Interfaz original de la Bóveda Web |
Sincronización completa /api/sync | ✅ | ✅ | Compatibilidad optimizada para clientes oficiales |
| Subir / descargar archivos adjuntos | ✅ | ✅ | Cloudflare R2 o KV |
| Send (Enviar) | ✅ | ✅ | Soporta envíos de texto y de archivos |
| Importar / Exportar | ✅ | ✅ | Soporta importación de BitWarden JSON / CSV / ZIP con adjuntos |
| Centro de copias de seguridad en la nube | ❌ | ✅ | Copias de seguridad programadas a WebDAV / S3 |
| Pista de contraseña (web) | ⚠️ Limitado | ✅ | No requiere correo electrónico |
| TOTP / Steam TOTP | ✅ | ✅ | Incluye soporte para steam:// |
| Multiusuario | ✅ | ✅ | Registro mediante invitación |
| Organizaciones / Colecciones / Roles | ✅ | ❌ | No implementado |
| Inicio de sesión con 2FA | ✅ | ⚠️ Parcial | Actualmente solo TOTP a nivel de usuario |
| SSO / SCIM / Directorio corporativo | ✅ | ❌ | No implementado |
Lo que necesitamos:
- Una cuenta de GitHub
- Una cuenta de Cloudflare (Gratuita) con el almacenamiento R2 activado.
- _Opcional:_Un nombre de dominio personalizado gestionado en Cloudflare.
Fase 1: Preparar el código
- Haz un _fork_del repositorio de NodeWarden desde https://github.com/Tech-Voyage-Dev/nodewarden del repositorio original https://github.com/shuaiplus/nodewarden GitHub.

- Habilita el workflow"Sync Upstream".

Fase 2: Desplegar en Cloudflare
- Crea una aplicación Worker en Cloudflare.

- Selecciona 'Continue with GitHub' para desplegar la aplicación.


- Espera unos momentos a que Cloudflare construya y despliegue tu app. Te dará una URL por defecto tipo
worker.dev.
(Opcional) Añadir un dominio personalizado:
- En la configuración de tu Cloudflare Worker, ve a la pestaña Settings.
- Haz clic en + Add.
- Escribe el dominio que prefieras y sigue las instrucciones.


Fase 3: Proteger tu servidor (El secreto JWT)
- Ve al navegador web e ingresa tu dominio personalizado o el dominio 'worker.dev' generado.
- Te aparecerá el mensaje 'JWT_SECRET is missing'.

- Copia la clave secreta generada y vuelve a la pestaña de Settings (Configuración) de tu Worker de NodeWarden, luego haz clic en el botón '+ Add' en la sección 'Variables and Secrets'.


- Pega el secreto generado y haz clic en el botón 'Deploy / Save'.
Fase 4: Crear tu cuenta de administrador
- Vuelve al navegador web y actualiza la página; verás la siguiente página de inicio de sesión.

- Haz clic en 'Create Account' para crear la cuenta de administrador.

- Inicia sesión con la cuenta de administrador que acabas de crear para acceder al panel de control (Dashboard).

- Ahora ya tenemos el servidor desplegado y en funcionamiento. Empezaremos a configurar los clientes de BitWarden.
Fase 5: Conectar tus dispositivos
Puedes usar las aplicaciones oficiales de BitWarden en todos tus dispositivos.
Extensión para Chrome
- Instala la extensión de Bitwarden para Chrome.
- Abre la extensión.
- Haz clic en el enlace junto a 'Accessing:' (Accediendo a:) en la parte inferior del menú emergente.

- Ingresa el nombre de dominio de tu servidor NodeWarden.

- Guarda la configuración e inicia sesión con tu cuenta.
App para iOS
- Instala la app de BitWarden desde la App Store.
- Abre la app y haz clic en '' junto a 'Logging in on:' (Iniciando sesión en:).

- Ingresa el nombre de dominio del servidor NodeWarden y haz clic en el botón '✓'.

Otros Clientes
NodeWarden ha sido probado y se ha confirmado que es compatible con estos clientes oficiales de BitWarden:
- ✅ Windows de escritorio
- ✅ Apps móviles Android/iOS
- ✅ Extensiones de navegador
- ✅ Linux de escritorio
- ⚠️ macOS de escritorio (no verificado completamente)
Copia de seguridad de la bóveda
NodeWarden te permite hacer copias de seguridad de tu bóveda en una computadora local o en almacenamiento remoto (almacenamiento compatible con S3 o WebDAV).
Para automatizar las copias de seguridad remotas:
- Configura los detalles del almacenamiento remoto dentro del panel de control de NodeWarden.
- Asegúrate de que la tarea Cron esté configurada en los ajustes de Cloudflare Worker para la copia de seguridad remota automática.

Consideraciones finales de seguridad
- Protege el acceso a tu cuenta de Cloudflare, de lo contrario los datos podrían verse comprometidos. Habilita la autenticación de dos factores (2FA) o una Passkey(Clave de acceso) en tu cuenta de Cloudflare de inmediato.
- Aloja NodeWarden en una cuenta de Cloudflare dedicada. No compartas recursos con otras aplicaciones web para minimizar los riesgos de seguridad.
- Protege NodeWarden con Cloudflare
Referencias
- Guía de inicio oficial de NodeWarden