SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor · Actualizado 2026-10-30

Gestores de secretos autoalojados para un VPS, comparados

Compara OpenBao, Infisical, SOPS con age, credenciales de systemd y un archivo env protegido para elegir secretos en un solo VPS y conocer su coste.

Qué hace un gestor de secretos autoalojado que no hace un gestor de contraseñas

Un gestor de secretos autoalojado entrega credenciales a los procesos. Un gestor de contraseñas entrega credenciales a las personas. Todo lo demás se deriva de esa diferencia. Una persona presente y atenta desbloquea un gestor de contraseñas. Un gestor de secretos tiene que entregar la contraseña de una base de datos a una aplicación a las 03:00, cuando nadie está despierto.

Los modos de fallo son distintos, y eso importa. Un gestor de contraseñas bloqueado es una molestia: se vuelve a introducir la contraseña maestra. Un gestor de secretos sellado provoca una interrupción: todos los servicios que se reinicien mientras está sellado arrancan sin credenciales y permanecen detenidos. Ejecutar Vaultwarden como gestor de contraseñas propio resuelve bien el problema de las personas. No resuelve el problema de las máquinas, y nunca se diseñó para hacerlo. Si también ejecuta uno junto con esto, los elementos que conviene reforzar son su token de administración y su archivo de copia de seguridad, no el contenido de la bóveda, que el cliente ya cifra. Una revisión de seguridad de Vaultwarden cubre ambos aspectos.

Las opciones realistas para un solo servidor se dividen en dos grupos. OpenBao e Infisical son servicios: una API, una base de datos, TLS (seguridad de la capa de transporte), un paso de inicio de sesión y un proceso que ahora debe mantener activo. SOPS con age, las credenciales de systemd y los secretos de Docker son archivos: se cifran en reposo, algo que ya está en ejecución los descifra y no hay nada adicional que monitorizar.

Esta es la respuesta directa. Para un solo equipo con una o dos personas, las opciones basadas en archivos suelen ser las adecuadas. Un OpenBao que nadie desella correctamente y cuyas credenciales nadie rota es peor que un archivo de entorno con permisos mode 600, porque añade un componente más y una copia de seguridad que probablemente se configurará mal, sin proporcionar ninguna rotación que no se estuviera haciendo manualmente.

¿Es suficiente un archivo de entorno con permisos 600?

A menudo, sí. La amenaza que evita es que otro usuario del servidor lea la contraseña de la base de datos. Los permisos de archivos de Unix lo impiden, incluso antes de que la red esté activa.

sudo install -d -m 750 -o root -g myapp /etc/myapp
sudo install -m 640 -o root -g myapp /dev/null /etc/myapp/env
sudoedit /etc/myapp/env

Compruébelo desde ambos lados:

sudo -u myapp cat /etc/myapp/env
sudo -u nobody cat /etc/myapp/env

El primer comando muestra el archivo. El segundo muestra cat: /etc/myapp/env: Permission denied, porque nobody no pertenece al grupo myapp y el archivo no tiene permisos para otros usuarios. Ese es todo el modelo de seguridad, y es un modelo real.

La filtración ocurre después. Una unidad de systemd con EnvironmentFile= copia esos valores en el entorno del proceso, y el entorno del proceso se puede leer.

[Service]
User=myapp
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/local/bin/myapp
sudo cat /proc/$(pgrep -n myapp)/environ | tr '\0' '\n'

Ese comando muestra sus secretos en texto claro, porque /proc/<pid>/environ puede ser leído por root y por el usuario con el que se ejecuta el proceso. Un generador de informes de errores que adjunte el entorno a un informe verá lo mismo. También lo verá cualquier herramienta que se ejecute con la misma cuenta. Por eso mantener los secretos fuera de los agentes de IA empieza por sacarlos del entorno. Combine el archivo con un usuario de servicio dedicado con pocos privilegios para que «el usuario con el que se ejecuta el proceso» no sea root.

SOPS con age: secretos cifrados que puede confirmar en git

SOPS (secrets operations) cifra los valores de un archivo YAML o JSON y deja las claves en texto claro. age es una herramienta de cifrado pequeña que le proporciona un único par de claves y ningún servidor de claves. Juntos permiten confirmar secrets.enc.yaml junto al código, y git diff sigue mostrando qué configuración cambió sin revelar a un lector en qué se convirtió.

age está incluido en Ubuntu 24.04. SOPS no lo está, así que descargue el .deb desde la página de versiones. La versión 3.13.3 era la actual en octubre de 2026.

sudo apt update && sudo apt install -y age
curl -LO https://github.com/getsops/sops/releases/download/v3.13.3/sops_3.13.3_amd64.deb
sudo apt install -y ./sops_3.13.3_amd64.deb
sops --version

Genere un par de claves. age-keygen escribe la clave privada en el archivo e imprime la clave pública, por lo que verá una línea que comienza por Public key: age1....

mkdir -p ~/.config/sops/age
age-keygen -o ~/.config/sops/age/keys.txt
chmod 600 ~/.config/sops/age/keys.txt
age-keygen -y ~/.config/sops/age/keys.txt

Coloque la clave pública en .sops.yaml en la raíz del repositorio, para no tener que recordar el destinatario en la línea de comandos.

creation_rules:
  - age: age1s3cqcks5genc6ru8chl0hkkd04zmxvczsvdxq99ekffe4gmvjpzsedk23c
sops encrypt secrets.yaml > secrets.enc.yaml
sops decrypt secrets.enc.yaml

Una regla sin path_regex coincide con todo, que es lo que necesita al principio. Si añade una más adelante, escríbala para que coincida con el archivo que pasa a sops, porque las reglas se comprueban con la ruta de entrada y no con el archivo al que redirige la salida.

En tiempo de ejecución, entregue los valores a un solo proceso y a ningún otro:

sops exec-env secrets.enc.yaml './myapp'

sops exec-env descifra los valores en memoria y los establece en el entorno del proceso hijo, por lo que no se escribe texto claro en el disco. La limitación del entorno descrita en la sección anterior también se aplica a ese proceso hijo.

Aquí hay dos problemas frecuentes. El error Failed to get the data key required to decrypt the SOPS file con systemd casi siempre significa que SOPS buscó en el directorio de inicio incorrecto, porque una unidad no hereda su HOME. Establezca la ruta explícitamente mediante Environment=SOPS_AGE_KEY_FILE=/etc/sops/age.txt en la unidad. Por otra parte, editar .sops.yaml no vuelve a cifrar lo que ya existe: añadir la clave pública de un compañero sólo afecta a los archivos nuevos, así que ejecute sops updatekeys secrets.enc.yaml en cada archivo existente. Si su configuración ya se ejecuta mediante Ansible, cifrar los mismos valores con Ansible Vault permite obtener el mismo resultado sin una segunda herramienta.

credenciales de systemd: secretos que nunca llegan al entorno

Ubuntu 24.04 incluye systemd 255, por lo que no es necesario instalar nada. systemd-creds cifra un secreto en el host, y systemd lo descifra en un directorio privado que sólo puede leer ese servicio.

sudo systemd-creds setup
sudo install -d -m 700 /etc/myapp
echo -n 'hunter2' | sudo systemd-creds encrypt --name=db_password - /etc/myapp/db_password.cred
[Service]
User=myapp
LoadCredentialEncrypted=db_password:/etc/myapp/db_password.cred
ExecStart=/usr/local/bin/myapp

El servicio lee el valor desde un archivo llamado db_password dentro del directorio indicado por $CREDENTIALS_DIRECTORY. El valor no está en el entorno, por lo que /proc/<pid>/environ no muestra nada útil, y el texto sin cifrar nunca se escribe en el sistema de archivos raíz.

Verifique que el archivo se descifra antes de indicar a una unidad que lo use:

sudo systemd-creds decrypt /etc/myapp/db_password.cred -

Debe saber qué clave lo cifró, porque eso determina si la copia de seguridad sirve. El valor predeterminado --with-key=auto usa el chip TPM2 (módulo de plataforma segura, versión 2) si encuentra uno y no se ejecuta en un contenedor, y usa la clave del host si /var/lib/systemd/ está en un medio persistente. En una máquina en la que se cumplen ambas condiciones, la credencial queda vinculada a los dos elementos, y ambos deben estar presentes para descifrarla. La mayoría de las instancias VPS no tienen TPM2.

systemd-analyze has-tpm2

no significa que sólo se usó la clave del host. Esa clave se encuentra en /var/lib/systemd/credential.secret y sólo root puede leerla. Si restaura db_password.cred en un VPS nuevo sin ese archivo, nunca podrá descifrarlo. Copie credential.secret en la misma copia de seguridad o conserve el texto sin cifrar en un lugar al que todavía pueda acceder. Si muestra yes, la credencial también está vinculada al chip de esa máquina, por lo que no se descifrará en ningún otro lugar, ni siquiera con credential.secret; sólo servirá la copia en texto sin cifrar.

Secretos de Docker: archivos en /run/secrets

Compose lee un archivo del host y lo monta en el contenedor en /run/secrets/<name>.

services:
  app:
    image: myapp:latest
    environment:
      DB_PASSWORD_FILE: /run/secrets/db_password
    secrets:
      - db_password
secrets:
  db_password:
    file: ./db_password.txt
docker compose exec app cat /run/secrets/db_password
docker compose exec app env | grep -i password

El primero muestra el secreto. El segundo muestra sólo DB_PASSWORD_FILE=/run/secrets/db_password, que es el objetivo: el valor nunca está en el entorno del contenedor, por lo que no aparece en la salida de docker inspect. Muchas imágenes oficiales ya esperan esta estructura, y la imagen de Postgres lee POSTGRES_PASSWORD_FILE exactamente de esta forma.

Debe tener claro qué ofrece este mecanismo. Fuera del modo Swarm no hay cifrado en ninguna capa: ./db_password.txt es un archivo de texto plano en el host, y su única protección son sus permisos y su propietario. Configure ambos manualmente, porque Compose montará sin quejarse un archivo legible por todos. El conjunto más amplio de ventajas y limitaciones frente al atajo de env_file se explica en la guía sobre archivos env y secretos de Compose.

Qué cuesta realmente ejecutar OpenBao y Vault

OpenBao es el fork de HashiCorp Vault mantenido por Linux Foundation, iniciado después de que HashiCorp cambiara la licencia de Vault a Business Source License en 2023. OpenBao continúa bajo MPL 2.0 (Mozilla Public License). La versión 2.7.2, publicada el 26 October 2026, era la versión más reciente cuando lo comprobamos el 27 October 2026. Casi todo lo siguiente también se aplica a Vault, porque el fork conservó la misma interfaz de comandos.

docker pull docker.io/openbao/openbao

Los paquetes .deb para Debian y Ubuntu se adjuntan a cada versión en GitHub si prefiere que apt gestione la instalación. El servidor necesita un archivo de configuración que defina un listener y un backend de almacenamiento:

listener "tcp" {
  address       = "127.0.0.1:8200"
  tls_cert_file = "/path/to/full-chain.pem"
  tls_key_file  = "/path/to/private-key.pem"
}

storage "raft" {
  path = "/path/to/raft/data"
  node_id = "raft_node_1"
}

Después, inícielo una vez:

bao operator init

De forma predeterminada, esto divide la clave root en 5 partes y requiere 3 de ellas para quitar el sellado. Esas son las opciones -key-shares y -key-threshold. El comando muestra las partes y el token root inicial. Guarde ambos en ese momento, porque sin las partes nada puede descifrar el almacenamiento.

Ahora viene la parte que la mayoría de las comparativas omite. Un servidor reiniciado está sellado. OpenBao mantiene la clave root sólo en memoria, por lo que después de reiniciarse no puede descifrar su propio almacenamiento hasta que alguien proporcione el umbral de partes requerido. Por tanto, una actualización del kernel o una terminación por falta de memoria dejan un servidor sellado y aplicaciones que no pueden iniciar sesión.

En un VPS de una sola persona, la división de Shamir no protege nada, porque las 5 partes terminan en el mismo gestor de contraseñas de la misma persona. El desbloqueo automático traslada la clave a un dispositivo o servicio de confianza. En una nube grande, normalmente es un servicio de gestión de claves. En un VPS, suele ser un archivo de clave en el mismo disco que los datos que protege. Esto reduce realmente la seguridad a cambio de que el servidor vuelva a funcionar por sí solo después de un reinicio. Tome esta decisión de forma consciente y deje constancia de la opción elegida.

Infisical: una interfaz, una base de datos y una clave maestra que sigue estando bajo su control

Infisical es una plataforma de secretos con interfaz web, proyectos, entornos y control de acceso por usuario. Puede alojarlo con Compose usando pocos pasos:

curl -o docker-compose.prod.yml https://raw.githubusercontent.com/Infisical/infisical/main/docker-compose.prod.yml
curl -o .env https://raw.githubusercontent.com/Infisical/infisical/main/.env.example
docker compose -f docker-compose.prod.yml up -d

Edite .env antes de ejecutar ese último comando. Dos valores deben ser propios, y uno de ellos no debe modificarse manualmente después:

openssl rand -hex 16
openssl rand -base64 32

El primero es ENCRYPTION_KEY, una cadena hexadecimal de 16 bytes. Es la clave con la que se cifran los secretos dentro de PostgreSQL. Si la pierde, una copia de seguridad perfecta de la base de datos se convierte en un conjunto de datos cifrados. Si sustituye esta clave por otra en una instancia en ejecución, los secretos existentes dejarán de descifrarse. Para rotarla, siga el procedimiento documentado de Infisical. La consola del servidor genera la clave nueva, y la anterior sigue siendo válida hasta que todas las instancias hayan cambiado a la nueva y usted la elimine. Si nunca la elimina, Infisical lo hace durante la primera limpieza semanal posterior a un periodo de retención de 7 days de forma predeterminada. Por tanto, guarde la clave anterior antes de ese momento si todavía la necesita. El segundo es AUTH_SECRET, una cadena base64 de 32 bytes utilizada para las sesiones. SITE_URL debe ser la URL absoluta a la que realmente accederá, incluido el protocolo, o la redirección del inicio de sesión fallará.

Infisical encaja mejor que OpenBao cuando lo que realmente necesita son usuarios: una interfaz web para un equipo pequeño y separación entre entornos, en lugar de credenciales de base de datos que caduquen por sí solas. A cambio, debe ejecutar PostgreSQL y Redis, además de gestionar un certificado TLS. También tendrá que aplicar parches y crear copias de seguridad de todos esos componentes.

Qué ocurre cuando el servicio de secretos está caído y la aplicación se reinicia

Esta pregunta determina si un servicio de secretos debe ejecutarse en un único servidor. Los archivos se pueden leer antes de que se inicie la red. Un servicio no.

Reinicie el servidor y la aplicación y OpenBao se iniciarán al mismo tiempo. La aplicación solicita la contraseña de la base de datos, OpenBao todavía está sellado y la solicitud falla. Si la unidad define Restart=, systemd reinicia la aplicación hasta que alguien introduzca las partes necesarias para desellarla o hasta que el límite de frecuencia de inicio definido por StartLimitIntervalSec= y StartLimitBurst= detenga los intentos y la deje en estado fallido. Sin Restart=, cuyo valor predeterminado es no, simplemente permanece detenida. No hay ningún componente averiado. Pero tampoco hay ninguno activo.

Hay dos formas correctas de resolverlo. Ordene las unidades y permita que la aplicación vuelva a intentarlo: After= el servicio de secretos, además de Restart=on-failure, un RestartSec= suficientemente largo para no sobrecargar la API, y un límite de frecuencia de inicio que no abandone antes de que alguien pueda desellar el servicio. O bien obtenga el secreto durante el despliegue en lugar de hacerlo durante el arranque: escríbalo en un archivo con permisos 600 o en una credencial de systemd, de modo que el sistema en ejecución dependa de un archivo y no de una API.

La caducidad del token plantea el mismo problema, pero en una escala de tiempo más lenta. Los tokens y las concesiones de OpenBao tienen un tiempo de vida. Por tanto, un proceso de larga duración que nunca los renueva pierde el acceso en un momento que no tiene relación con ningún despliegue. Este fallo resulta confuso precisamente porque ese día no cambió nada.

Crear una copia de seguridad del almacén

Cada opción tiene una clave, y una copia de seguridad sin esa clave no sirve. Anote dónde se encuentra la suya.

En un archivo de entorno, el propio archivo es el secreto, por lo que la copia de seguridad debe estar cifrada. Con SOPS, el archivo cifrado puede estar en cualquier ubicación pública, y la clave privada de age en ~/.config/sops/age/keys.txt es lo que no debe perder. Para las credenciales de systemd, haga una copia de seguridad de /var/lib/systemd/credential.secret junto con los archivos .cred. Para Infisical, cree un volcado de PostgreSQL y almacene ENCRYPTION_KEY en una ubicación separada. Después de una rotación, conserve la clave antigua junto con cualquier volcado creado antes de la rotación, porque para restaurar ese volcado se necesita la clave antigua.

OpenBao con almacenamiento raft crea su propia instantánea:

bao operator raft snapshot save backup.snap
bao operator raft snapshot restore backup.snap

La instantánea contiene el almacenamiento cifrado, por lo que para restaurarla en un servidor nuevo siguen siendo necesarias las partes de desprecintado de bao operator init. Un trabajo nocturno que copie las instantáneas al almacenamiento de objetos mientras las partes se guardan en ningún sitio no constituye una copia de seguridad. Pruebe la restauración en un VPS desechable antes de depender de ella.

Registro de auditoría: quién leyó qué secreto

Los archivos no proporcionan un registro de auditoría. El modo y el propietario indican quién podría leer el secreto. Nunca indican quién lo hizo. auditd con una supervisión de la ruta es el sustituto más cercano, y registra que se abrió un archivo, no qué valor se utilizó.

OpenBao registra cada solicitud en un dispositivo de auditoría que se habilita explícitamente. Desde 2.3.2, la creación de un dispositivo mediante la API, que es lo que hace bao audit enable, sólo funciona cuando la configuración del servidor establece unsafe_allow_api_audit_creation = true, y esa opción está deshabilitada de forma predeterminada. Declare el dispositivo en la configuración del servidor, junto al listener. OpenBao lo habilita al reiniciar o mediante SIGHUP:

audit "file" "local" {
  description = "Local audit log"
  options {
    file_path = "/var/log/openbao_audit.log"
  }
}

Hay dos aspectos de este registro que cambian la forma de ejecutar el servidor. La mayoría de las cadenas de las solicitudes y respuestas se someten a un hash con HMAC-SHA256 y una sal, por lo que puede comparar un valor que ya conoce con el registro sin que este contenga el texto sin cifrar. Los enteros y los valores booleanos se escriben sin modificar, por lo que un secreto numérico no obtiene ninguna protección de ese hash.

A continuación, el problema operativo: OpenBao no responde a las solicitudes cuando ningún dispositivo de auditoría habilitado puede registrarlas, y un dispositivo que falla de forma bloqueante hace que las solicitudes queden bloqueadas hasta que alguien lo arregle. Un disco lleno en /var/log deja fuera de servicio la API de secretos por diseño. Asigne un espacio propio al registro de auditoría y configure una regla de logrotate desde el primer día, no después de la primera interrupción.

¿Qué gestor de secretos autoalojado debería ejecutar?

Cuente las máquinas y las personas, y después elija.

  1. Una máquina y una persona: un archivo de entorno propiedad de root que sólo pueda leer el grupo del servicio (modo 640, como se indicó anteriormente), o uno con modo 600 que systemd lea directamente para el servicio mediante EnvironmentFile=. Añada credenciales de systemd cuando quiera evitar que el valor aparezca en el entorno del proceso.
  2. Una máquina, entre dos y cinco personas y una configuración que ya está en git: SOPS con age. Cada persona obtiene un par de claves, y .sops.yaml enumera todas las claves públicas autorizadas para descifrar.
  3. Varias máquinas, un repositorio de configuración y sin necesidad de credenciales que caduquen: siga usando SOPS con age, con una clave destinataria por host, de modo que una clave de host robada sólo permita descifrar los archivos de ese host.
  4. Varias máquinas y varios equipos que realmente necesitan credenciales de base de datos con una duración limitada, además de un registro de auditoría que alguien revise: OpenBao. Reserve una hora mensual de trabajo del operador para las prácticas de desencriptado y restauración.

La regla subyacente es la misma en los cuatro casos. Ejecute la solución más pequeña que cumpla un requisito que pueda expresar claramente, porque un gestor de secretos que está caído no se puede distinguir de uno que está vacío.

FAQ

¿Merece la pena usar un gestor de secretos autogestionado para un único VPS?

Por lo general, no, si se refiere a un servicio como OpenBao o Infisical. En un único equipo con una o dos personas, un archivo de entorno con permisos 600 o una credencial cifrada de systemd ofrecen la misma protección frente a otro usuario local, sin un paso de desbloqueo ni otro servicio que mantener actualizado. Un servicio de secretos empieza a compensar cuando tiene varias máquinas y varias personas, o cuando necesita credenciales que caduquen sin que nadie tenga que rotarlas manualmente.

¿Cuál es la diferencia entre un gestor de contraseñas y un gestor de secretos?

Un gestor de contraseñas almacena credenciales que introduce una persona, y una persona lo desbloquea mientras está presente. Un gestor de secretos proporciona credenciales a los procesos, por lo que debe funcionar a las 03:00 sin supervisión. Esa es la diferencia fundamental: un gestor de contraseñas bloqueado le obliga a volver a escribir una contraseña maestra, mientras que un gestor de secretos sellado detiene todos los servicios que se reinicien mientras permanezca sellado.

¿Qué ocurre con mis aplicaciones si OpenBao queda sellado después de un reinicio?

No pueden obtener sus secretos, por lo que no se inician. Si sus unidades establecen Restart=, systemd vuelve a intentarlo hasta que alguien proporciona el umbral de desbloqueo, que de forma predeterminada es 3 de 5 fragmentos, o hasta que el límite de frecuencia de arranque de la unidad detiene los reintentos. OpenBao mantiene la clave raíz sólo en memoria, por lo que cada reinicio vuelve a sellarlo. Puede activar el desbloqueo automático, aceptando que en un único VPS la clave de desbloqueo termina en el mismo disco que los datos, o generar los secretos en un archivo durante el despliegue para que el arranque nunca dependa de la API.

¿Puedo confirmar archivos cifrados con SOPS en un repositorio público?

Los valores están cifrados, por lo que están protegidos frente a cualquiera que no tenga la clave privada de age. Las claves no están cifradas: un lector puede ver que conserva STRIPE_SECRET_KEY y SMTP_PASSWORD, así como con qué frecuencia cambia cada una. Esos metadatos son aceptables para la mayoría de los proyectos y no lo son para algunos. Mantenga la clave privada de age fuera del repositorio y ejecute sops updatekeys en cada archivo existente siempre que añada o elimine un destinatario.

¿Te resultó útil este artículo?