Despliegue sin Conexión de Windows

Este artículo le guiará a través del procedimiento para instalar y desplegar Bitwarden en su propio servidor de Windows en un entorno sin conexión o aislado. Por favor revise la documentación de soporte para la liberación de software de Bitwarden.

Antes de proceder con la instalación, asegúrese de que se cumplan los siguientes requisitos:

• Docker Engine y Docker Compose están instalados y listos para usar en su servidor. Durante esta configuración, debes deseleccionar la opción Usar WSL2 en lugar de Hyper-V (recomendado).

• Usando una máquina con acceso a internet, has descargado el último archivo docker-stub.zip de la página de lanzamientos del repositorio del Servidor Bitwarden y has transferido este archivo a tu servidor.

• Se ha configurado y activado un servidor SMTP sin conexión en su entorno.

• (Opcional) Los binarios de OpenSSL para Windows están instalados y listos para usar en tu servidor. Puede usar un certificado autofirmado en lugar de OpenSSL si lo desea.

Ejecutar Bitwarden en un servidor de Windows requiere el uso de virtualización anidada. Por favor, consulte la documentación de su Hipervisor para averiguar si la virtualización anidada (nido) es compatible y cómo habilitarla.

Por defecto, Bitwarden se servirá a través de los puertos 80 (http) y 443 (https) en la máquina anfitriona. Abre estos puertos para que Bitwarden pueda ser accedido desde dentro y/o fuera de la red. Puede optar por elegir diferentes puertos durante la instalación.

Recomendamos configurar un nombre de dominio con registros DNS que apunten a su máquina anfitriona (por ejemplo, bitwarden.example.com), especialmente si está sirviendo Bitwarden a través de internet.

Abre PowerShell y crea un usuario local de Bitwarden ejecutando el siguiente comando:

Bash
PS C:\> $Password = Read-Host -AsSecureString

Después de ejecutar el comando anterior, ingrese la contraseña deseada en el cuadro de diálogo de entrada de texto. Después de especificar una contraseña, ejecute el siguiente comando:

Bash
New-LocalUser "Bitwarden" -Password $Password -Description "Bitwarden Local Admin"

Como el nuevo usuario, crea una carpeta de Bitwarden en C:\:

Bash
PS C:\> mkdir Bitwarden

Una vez que instales Docker Desktop, navega a Ajustes → Recursos → Compartir Archivos y añade el directorio creado (C:\Bitwarden) a la lista de Recursos. Seleccione Aplicar y Reiniciar para aplicar sus cambios.

Recomendamos iniciar sesión como el nuevo usuario creado antes de completar todos los procedimientos subsiguientes en este documento.

Para configurar tu máquina con los recursos necesarios para tu servidor Bitwarden:

1. Crea un nuevo directorio en C:\Bitwarden llamado bwdata y extrae docker-stub.zip en él.
   
   Una vez descomprimido, el directorio bwdata coincidirá con lo que el archivo docker-compose.yml espera en su mapeo de volumen. Puede, si lo desea, cambiar la ubicación de estas asignaciones en la máquina anfitriona.

2. En bwdata\env\global.override.env, editar las siguientes variables de entorno:

   • globalSettings__baseServiceUri__vault=: Ingresa el dominio de tu instancia de Bitwarden.

   • globalSettings__sqlServer__ConnectionString=: Reemplace la CONTRASEÑA_ALEATORIA_DE_BASE_DE_DATOS con una contraseña segura para usar en un paso posterior.

   • globalSettings__identityServer__certificatePassword=: Establezca una contraseña de certificado segura para usar en un paso posterior.

   • globalSettings__internalIdentityKey=: Reemplace RANDOM_IDENTITY_KEY con una cadena de clave aleatoria.

   • globalSettings__oidcIdentityClientKey=: Reemplace RANDOM_IDENTITY_KEY con una cadena de clave aleatoria.

   • globalSettings__duo__aKey=: Reemplace RANDOM_DUO_AKEY con una cadena de clave aleatoria.

   • globalSettings__installation__id=: Ingresa una id de instalación obtenida de https://bitwarden.com/host.

   • globalSettings__installation__key=: Ingresa una clave de instalación obtenida de https://bitwarden.com/host.

   • globalSettings__pushRelayBaseUri=: Esta variable debería estar en blanco. Vea Configurar Relay de Notificaciones para más información.

     consejo

     En este momento, considere también establecer valores para todas las variables globalSettings__mail__smtp__ y para adminSettings__admins. Hacerlo configurará el servidor de correo SMTP utilizado para enviar invitaciones a nuevos miembros de la organización y proporcionar acceso al Portal del Administrador del Sistema.

     Obtenga más información sobre las variables de entorno .

3. Genere un certificado identidad.pfx para el contenedor de identidad. Puedes hacerlo usando OpenSSL o cualquier herramienta para generar un certificado autofirmado. Si estás utilizando OpenSSL, ejecuta los siguientes comandos:

   Bash
   openssl req -x509 -newkey rsa:4096 -sha256 -nodes -keyout identity.key -out identity.crt -subj "/CN=Bitwarden IdentityServer" -days 10950

   y

   Bash
   openssl pkcs12 -export -out ./identity/identity.pfx -inkey identity.key -in identity.crt -passout pass:IDENTITY_CERT_PASSWORD

   En el comando anterior, reemplace IDENTITY_CERT_PASSWORD con la contraseña del certificado creada y utilizada en Paso 2.

4. Mueva identidad.pfx al directorio de volumen mapeado (por defecto, .\bwdata\identidad).

5. Copia identity.pfx al directorio .\bwdata\ssl.

6. Crea un subdirectorio en .\bwdata\ssl con el nombre de tu dominio.

7. Proporcione un certificado SSL confiable y una clave privada en el subdirectorio recién creado .\bwdata\ssl\bitwarden.example.com.

   nota

   Este directorio está mapeado al contenedor NGINX en \etc\ssl. Si no puedes proporcionar un certificado SSL de confianza, adelanta la instalación con un proxy que proporciona un punto final HTTPS a las aplicaciones cliente de Bitwarden.

8. En .\bwdata\nginx\default.conf:

   1. Reemplace todas las instancias de bitwarden.example.com con su dominio, incluyendo en el encabezado de la Política-de-Seguridad-de-Contenido.

   2. Establezca las variables ssl_certificate y ssl_certificate_key a las rutas del certificado y la clave privada proporcionadas en el Paso 6.

   3. Realice una de las siguientes acciones, dependiendo de la configuración de su certificado:

      • Si utiliza un certificado SSL de confianza, establezca la variable ssl_trusted_certificate en la ruta a su certificado.

      • Si utiliza un certificado autofirmado, comente las variables ssl_trusted_certificate.

9. En .\bwdata\env\mssql.override.env, reemplace RANDOM_DATABASE_PASSWORD con la contraseña creada en Paso 2.

10. En .\bwdata\web\app-id.json, reemplace bitwarden.example.com con su dominio.

Para obtener imágenes de Docker para usar en su máquina sin conexión:

1. Desde una máquina conectada a internet, descarga todas las imágenes de docker bitwarden/xxx:latest, tal como se enumeran en el archivo docker-compose.yml en docker-stub.zip.

2. Guarda cada imagen en un archivo .img, por ejemplo:

   Bash
   docker image save -o mssql.img bitwarden/mssql:version

3. Transfiere todos los archivos .img a tu máquina sin conexión.

4. En su máquina sin conexión, cargue cada archivo .img para crear sus imágenes locales de Docker, por ejemplo:

   Bash
   docker image load -i mssql.img

Inicie su servidor Bitwarden con el siguiente comando:

Bash
docker-compose -f ./docker/docker-compose.yml up -d

Verifique que todos los contenedores estén funcionando correctamente.

Bash
docker ps

¡Felicidades! Bitwarden ahora está en funcionamiento en https://your.domain.com. Visita la caja fuerte web en tu navegador para confirmar que está funcionando.

Ahora puedes registrar una nueva cuenta e iniciar sesión. Necesitará haber configurado las variables de entorno SMTP (ver Variables de Entorno) para poder verificar el correo electrónico de su nueva cuenta.

• Si planeas autoalojar una organización Bitwarden, consulta autoalojar una organización para comenzar.

• Para obtener información adicional, consulte las preguntas frecuentes sobre autoalojamiento.

Actualizar un servidor autoalojado que ha sido instalado y desplegado manualmente es diferente del procedimiento estándar de actualización. Para actualizar tu servidor instalado manualmente:

1. Descarga el último archivo docker-stub.zip de las páginas de lanzamientos en GitHub.

2. Descomprime el nuevo archivo docker-stub.zip y compara su contenido con lo que actualmente está en tu directorio bwdata, copiando cualquier cosa nueva a los archivos preexistentes en bwdata.
   No sobrescriba su directorio bwdata preexistente con el contenido del archivo más reciente docker-stub.zip, ya que esto sobrescribiría cualquier trabajo de configuración personalizado que haya realizado.

3. Descargue las últimas imágenes de contenedores y transfiéralas a su máquina sin conexión como se documentó anteriormente.

4. Ejecuta el siguiente comando para reiniciar tu servidor con tu configuración actualizada y los contenedores más recientes:

   Bash
   docker-compose -f ./docker/docker-compose.yml down && docker-compose -f ./docker/docker-compose.yml up -d