Выбор self-hosted менеджера секретов для одного VPS
Сравнение OpenBao, Infisical, SOPS с age и systemd credentials для одного сервера. Узнайте, какой инструмент лучше подходит для автоматизации и сколько это стоит.
Чем self-hosted менеджер секретов отличается от менеджера паролей
Self-hosted менеджер секретов передает учетные данные процессам. Менеджер паролей передает их людям. Все остальные различия вытекают из этого факта. Менеджер паролей разблокируется человеком, который присутствует и выполняет действие. Менеджер секретов должен предоставить приложению пароль от базы данных в 03:00, когда никого нет на месте.
Режимы сбоев различаются критическим образом. Заблокированный менеджер паролей — это неудобство: вы просто вводите мастер-пароль еще раз. Заблокированный (sealed) менеджер секретов — это простой: каждый сервис, который перезапускается в этот момент, не получает учетные данные и остается нерабочим. Запуск Vaultwarden в качестве собственного менеджера паролей хорошо решает задачу для человека. Он не решает задачу для машины, и он изначально не был для этого предназначен. Если вы используете его параллельно, стоит уделить внимание защите административного токена и файла резервной копии, а не содержимого хранилища, которое клиент и так шифрует. Укрепление безопасности Vaultwarden охватывает оба этих аспекта.
Реалистичные варианты для одного сервера делятся на две группы. OpenBao и Infisical — это полноценные сервисы: API, база данных, TLS (transport layer security), этап авторизации и процесс, который теперь нужно поддерживать в рабочем состоянии. SOPS с использованием age, systemd credentials и Docker secrets — это файлы: они зашифрованы в состоянии покоя, расшифровываются уже запущенным процессом и не требуют дополнительного мониторинга.
Честный ответ сразу: для одного сервера, на котором работают один или два человека, файловые решения обычно являются правильным выбором. OpenBao, который никто не разблокирует должным образом и в котором никто не меняет ключи, хуже, чем файл окружения с правами 600. Он добавляет лишний движущийся компонент и необходимость резервного копирования, с которой вы можете ошибиться, при этом не давая никакой автоматической ротации, которую вы не делали бы вручную.
Достаточно ли прав доступа 600 для файла с переменными окружения?
Зачастую да. Это защищает от ситуации, когда другой пользователь на сервере пытается прочитать ваш пароль от базы данных. Права доступа в Unix справляются с этой задачей, причем еще до того, как поднимется сеть.
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Проверьте это с обеих сторон:
sudo -u myapp cat /etc/myapp/env
sudo -u nobody cat /etc/myapp/envПервая команда выводит содержимое файла. Вторая выводит cat: /etc/myapp/env: Permission denied, так как nobody не входит в группу myapp, а у файла отсутствуют права для остальных пользователей. Это и есть вся модель безопасности, и она вполне реальна.
Утечка происходит на следующем этапе. Юнит systemd с параметром EnvironmentFile= копирует эти значения в переменные окружения процесса, а переменные окружения процесса доступны для чтения.
[Service]
User=myapp
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/local/bin/myappsudo cat /proc/$(pgrep -n myapp)/environ | tr '\0' '\n'Эта команда выводит ваши секреты в открытом виде, так как файл /proc/<pid>/environ доступен для чтения пользователю root и пользователю, от имени которого запущен процесс. Система сбора отчетов об ошибках, которая прикрепляет окружение к отчету, увидит то же самое. Как и любая утилита, запущенная под той же учетной записью. Именно поэтому исключение секретов из AI-агентов начинается с их удаления из переменных окружения. Используйте этот файл в связке с выделенным сервисным пользователем с низкими привилегиями, чтобы «пользователь, от имени которого запущен процесс» не был root.
SOPS и age: зашифрованные секреты для коммита в git
SOPS (secrets operations) шифрует значения в файлах YAML или JSON, оставляя ключи в открытом виде. age — это компактный инструмент шифрования, который использует одну пару ключей и не требует сервера ключей. Вместе они позволяют хранить secrets.enc.yaml рядом с кодом, а git diff по-прежнему показывает, какая настройка изменилась, не раскрывая её нового значения.
age входит в состав Ubuntu 24.04. SOPS в репозиториях отсутствует, поэтому скачайте .deb со страницы релизов. Версия 3.13.3 была актуальна на октябрь 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Создайте пару ключей. age-keygen записывает закрытый ключ в файл и выводит открытый ключ, поэтому вы увидите строку, начинающуюся с 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Поместите открытый ключ в .sops.yaml в корне репозитория, чтобы не указывать получателя в командной строке каждый раз.
creation_rules:
- age: age1s3cqcks5genc6ru8chl0hkkd04zmxvczsvdxq99ekffe4gmvjpzsedk23csops encrypt secrets.yaml > secrets.enc.yaml
sops decrypt secrets.enc.yamlПравило без path_regex применяется ко всему, что и требуется на начальном этапе. Если позже вы добавите правило, настройте его так, чтобы оно соответствовало файлу, который вы передаете в sops, так как правила проверяются по пути входного файла, а не по файлу, в который вы перенаправляете вывод.
Во время выполнения передавайте значения только одному процессу:
sops exec-env secrets.enc.yaml './myapp'sops exec-env выполняет расшифровку в оперативной памяти и устанавливает значения в окружении дочернего процесса, поэтому открытый текст не записывается на диск. Ограничение окружения из предыдущего раздела по-прежнему применимо к этому дочернему процессу.
Две проблемы часто вызывают затруднения. Ошибка Failed to get the data key required to decrypt the SOPS file при работе под systemd почти всегда означает, что SOPS искал не в том домашнем каталоге, так как юнит не наследует вашу переменную HOME. Явно укажите путь с помощью Environment=SOPS_AGE_KEY_FILE=/etc/sops/age.txt в юните. Кроме того, редактирование .sops.yaml не перешифровывает уже существующие данные: добавление открытого ключа коллеги влияет только на новые файлы, поэтому для каждого существующего файла выполните sops updatekeys secrets.enc.yaml. Если ваша конфигурация уже работает через Ansible, шифрование тех же значений с помощью Ansible Vault позволяет достичь того же результата без использования дополнительного инструмента.
Учетные данные systemd: секреты, которые не попадают в переменные окружения
В Ubuntu 24.04 поставляется systemd 255, поэтому дополнительная установка не требуется. systemd-creds шифрует секрет на хосте, а systemd расшифровывает его в приватный каталог, доступный для чтения только конкретному сервису.
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Сервис считывает значение из файла с именем db_password внутри каталога, указанного в $CREDENTIALS_DIRECTORY. Значение не попадает в переменные окружения, поэтому /proc/<pid>/environ не показывает ничего полезного, а открытый текст никогда не записывается на корневую файловую систему.
Перед тем как указывать путь к файлу в юните, убедитесь, что он расшифровывается:
sudo systemd-creds decrypt /etc/myapp/db_password.cred -Знайте, какой ключ использовался для шифрования, так как от этого зависит пригодность вашей резервной копии. По умолчанию --with-key=auto использует чип TPM2 (trusted platform module version 2), если он обнаружен и система не запущена в контейнере, либо ключ хоста, если /var/lib/systemd/ находится на постоянном носителе. На машине, где применимы оба варианта, учетные данные привязываются к обоим компонентам, и для расшифровки должны присутствовать оба. У большинства VPS-инстансов нет TPM2.
systemd-analyze has-tpm2no означает, что использовался только ключ хоста. Этот ключ находится в /var/lib/systemd/credential.secret и доступен для чтения только пользователю root. Если восстановить db_password.cred на новый VPS без этого файла, расшифровка будет невозможна. Скопируйте credential.secret в ту же резервную копию или сохраните открытый текст в доступном месте. Если выводится yes, значит, учетные данные также привязаны к чипу этой машины, поэтому они не расшифруются нигде больше, даже при наличии credential.secret, и помочь сможет только копия в открытом виде.
Docker secrets: файлы в /run/secrets
Compose считывает файл с хоста и монтирует его в контейнер по пути /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.txtcat /run/secrets/db_password
docker compose exec app cat /run/secrets/db_password
docker compose exec app env | grep -i passwordenv | grep DB_PASSWORD_FILE=/run/secrets/db_password
Первая команда выводит секрет. Вторая выводит только DB_PASSWORD_FILE=/run/secrets/db_password, в этом и заключается смысл: значение переменной никогда не попадает в окружение контейнера, поэтому оно не отображается в выводе docker inspect. Многие официальные образы уже рассчитаны на такой подход, и образ Postgres считывает POSTGRES_PASSWORD_FILE именно таким образом.
Важно понимать, что это такое. Вне режима Swarm шифрование на каком-либо уровне отсутствует: ./db_password.txt — это обычный текстовый файл на хосте, и единственная его защита — это права доступа и владелец. Устанавливайте их самостоятельно, так как Compose без предупреждений смонтирует файл, доступный для чтения всем пользователям. Подробное сравнение преимуществ и недостатков этого метода по сравнению с простым использованием env_file приведено в руководстве по файлам окружения и секретам в Compose.
Реальная стоимость эксплуатации OpenBao и Vault
OpenBao — это форк HashiCorp Vault от Linux Foundation, созданный после того, как HashiCorp изменила лицензию Vault на Business Source License в 2023 году. OpenBao распространяется под лицензией MPL 2.0 (Mozilla Public License). Версия 2.7.2, выпущенная 26 октября 2026 года, была актуальной на момент нашей проверки 27 октября 2026 года. Почти всё, сказанное ниже, применимо и к Vault, так как форк сохранил тот же набор команд.
docker pull docker.io/openbao/openbaoПакеты .deb для Debian и Ubuntu прикреплены к каждому релизу на GitHub, если вы предпочитаете управлять установкой через apt. Серверу требуется конфигурационный файл, содержащий настройки listener и storage backend:
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"
}Затем запустите его один раз:
bao operator initПо умолчанию система разделяет root key на 5 частей и требует 3 из них для снятия блокировки (unseal), что определяется флагами -key-shares и -key-threshold. Система выводит части ключа и начальный root token. Запишите их сразу, так как без этих частей расшифровать хранилище будет невозможно.
Теперь часть, которую пропускают большинство сравнений. Перезагруженный сервер — это заблокированный сервер. OpenBao хранит root key только в оперативной памяти, поэтому после перезагрузки он не может расшифровать собственное хранилище, пока кто-то не предоставит пороговое количество частей ключа. Обновление ядра или завершение процесса из-за нехватки памяти (OOM kill) приведет к тому, что сервер окажется заблокирован, а приложения не смогут авторизоваться.
На VPS, обслуживаемом одним человеком, разделение по методу Шамира ничего не защищает, так как все пять частей ключа оказываются в одном менеджере паролей у одного и того же владельца. Функция auto unseal переносит ключ на доверенное устройство или сервис. В крупном облаке это означает использование управляемого сервиса ключей, а на вашем VPS — обычно файл ключа, лежащий на том же диске, что и защищаемые данные. Это реальное снижение уровня безопасности, на которое идут ради того, чтобы сервер автоматически восстанавливал работу после перезагрузки. Делайте этот выбор осознанно и задокументируйте, какой вариант вы выбрали.
Infisical: интерфейс, база данных и мастер-ключ, который остается у вас
Infisical — это платформа для управления секретами с веб-интерфейсом, поддержкой проектов, окружений и разграничением прав доступа пользователей. Самостоятельное развертывание через Compose выполняется быстро:
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Отредактируйте .env перед выполнением последней команды. Два значения должны быть вашими, и одно из них нельзя изменять вручную после запуска:
openssl rand -hex 16
openssl rand -base64 32Первое — ENCRYPTION_KEY, шестнадцатеричная строка длиной 16 байт. Это ключ, которым шифруются ваши секреты внутри PostgreSQL. Его потеря превратит идеальную резервную копию базы данных в набор зашифрованных данных, а подмена значения на работающем экземпляре сделает невозможной расшифровку существующих секретов. Для ротации ключа используйте документированную процедуру Infisical: консоль сервера генерирует новый ключ, а старый остается валидным, пока все экземпляры не переключатся на новый, после чего старый можно удалить. Если вы его не удалите, Infisical сам удалит его во время первой еженедельной очистки по истечении периода хранения (по умолчанию 7 дней), поэтому сохраните старый ключ до этого момента, если он вам еще нужен. Второе значение — AUTH_SECRET, строка base64 длиной 32 байта, используемая для сессий. SITE_URL должен быть абсолютным URL, по которому вы будете обращаться к сервису (включая протокол), иначе редирект при входе в систему перестанет работать.
Infisical подходит лучше, чем OpenBao, если вам нужны люди: веб-интерфейс для небольшой команды и разделение окружений, а не учетные данные базы данных с автоматическим истечением срока действия. Это потребует от вас поддержки PostgreSQL, Redis и TLS-сертификата, которые теперь нужно обновлять и резервировать самостоятельно.
Что происходит, когда сервис секретов недоступен, а ваше приложение перезапускается
Этот вопрос определяет, стоит ли размещать сервис секретов на одном узле с приложением. Файлы доступны для чтения еще до запуска сети, а сервис — нет.
При перезагрузке сервера ваше приложение и OpenBao запускаются одновременно. Приложение запрашивает пароль от базы данных, но OpenBao еще заблокирован (sealed), и запрос завершается ошибкой. Если в юните задан параметр Restart=, systemd будет перезапускать приложение до тех пор, пока администратор не введет ключи разблокировки или пока не сработает ограничение частоты запуска, заданное параметрами StartLimitIntervalSec= и StartLimitBurst=, после чего сервис останется в состоянии сбоя. Без параметра Restart=, значение по умолчанию для которого no, приложение просто останется выключенным. Ничего не сломано, но ничего и не работает.
Существует два надежных способа решения этой проблемы. Первый — настроить порядок запуска юнитов и предусмотреть повторные попытки в приложении: используйте After= для сервиса секретов, а также Restart=on-failure и RestartSec= с интервалом, достаточным для того, чтобы не перегружать API, и установите ограничение частоты запуска, которое не приведет к остановке до того, как кто-то успеет разблокировать сервис. Второй способ — получать секреты во время развертывания, а не при загрузке: запишите секрет в файл с правами доступа 600 или используйте systemd credentials, чтобы работающая система зависела от файла, а не от API.
Истечение срока действия токена — это та же проблема, но с более медленным таймером. Токены и лизинги OpenBao имеют время жизни (TTL), поэтому долго работающий процесс, который не обновляет токен, теряет доступ в момент, не связанный с развертыванием. Такой сбой сбивает с толку именно потому, что в этот день никаких изменений не вносилось.
Резервное копирование самого хранилища
У каждого варианта есть ключ, и резервная копия без этого ключа бесполезна. Запишите, где хранится ваш ключ.
Для файла env сам файл является секретом, поэтому резервная копия должна быть зашифрована. В случае с SOPS зашифрованный файл можно разместить в любом публичном месте, но закрытый ключ age в ~/.config/sops/age/keys.txt — это то, что нельзя терять. Для учетных данных systemd создавайте резервную копию /var/lib/systemd/credential.secret вместе с файлами .cred. Для Infisical сделайте дамп PostgreSQL и храните ENCRYPTION_KEY отдельно от него. После ротации ключей сохраняйте старый ключ вместе с любым дампом, сделанным до ротации, так как для восстановления этого дампа потребуется старый ключ.
OpenBao с хранилищем raft создает собственные снимки состояния:
bao operator raft snapshot save backup.snap
bao operator raft snapshot restore backup.snapСнимок содержит ваше зашифрованное хранилище, поэтому для восстановления на новом сервере по-прежнему потребуются ключи для снятия защиты (unseal shares) из bao operator init. Ежедневное задание, которое копирует снимки в объектное хранилище, в то время как ключи нигде не сохранены — это резервная копия, которая ничего не стоит. Протестируйте восстановление на временном VPS, прежде чем полагаться на него.
Аудит логов: кто читал секреты
Файлы не предоставляют журнала аудита. Права доступа и владелец файла показывают лишь то, кто мог прочитать секрет, но не кто это сделал на самом деле. auditd с отслеживанием пути — ближайшая альтернатива, но этот инструмент сообщает лишь о факте открытия файла, а не о том, какое значение было использовано.
OpenBao регистрирует каждый запрос в устройстве аудита, которое вы активируете явным образом. Начиная с версии 2.3.2, создание устройства через API, что и делает bao audit enable, работает только если в конфигурации сервера задан параметр unsafe_allow_api_audit_creation = true, который по умолчанию отключен. Объявляйте устройство в конфигурации сервера рядом с настройками listener. OpenBao активирует его после перезапуска или при выполнении SIGHUP:
audit "file" "local" {
description = "Local audit log"
options {
file_path = "/var/log/openbao_audit.log"
}
}Два факта об этом логе меняют подход к эксплуатации сервера. Большинство строк в запросах и ответах хешируются с помощью HMAC-SHA256 и соли, поэтому вы можете сопоставить известное вам значение с записью в логе, не имея в самом логе открытого текста. Целые числа и логические значения записываются в открытом виде, поэтому числовой секрет не защищен таким хешированием.
И еще один эксплуатационный нюанс: OpenBao перестает отвечать на запросы, если ни одно из включенных устройств аудита не может их записать, а устройство, которое блокируется при сбое, приводит к зависанию запросов до тех пор, пока проблема не будет устранена. Переполнение диска по пути /var/log по замыслу разработчиков приводит к остановке API секретов. Выделите для логов аудита отдельный раздел и настройте правило logrotate в первый же день, а не после первого сбоя.
Какой self-hosted менеджер секретов выбрать?
Оцените количество машин и пользователей, затем сделайте выбор.
- Одна машина, один пользователь: файл env, принадлежащий root, который может читать только группа сервиса (права 640, как указано выше), или файл с правами 600, который systemd считывает для сервиса через
EnvironmentFile=. Используйте systemd credentials, если нужно передать значение через переменные окружения процесса. - Одна машина, от двух до пяти пользователей, конфигурация уже в git: SOPS с использованием age. У каждого пользователя есть пара ключей, а в
.sops.yamlперечислены все публичные ключи, которым разрешена расшифровка. - Несколько машин, один репозиторий конфигурации, нет необходимости в динамических учетных данных с истекающим сроком действия: по-прежнему SOPS с age, с одним ключом получателя на каждый хост. В этом случае скомпрометированный ключ хоста позволит расшифровать только файлы этого конкретного хоста.
- Несколько машин и несколько команд, которым действительно нужны учетные данные базы данных с ограниченным сроком действия, а также аудит действий: OpenBao. Заложите в бюджет один час в месяц на работу оператора по разблокировке (unsealing) и тренировки по восстановлению.
Правило для всех четырех случаев одинаково. Используйте самое простое решение, которое соответствует четко сформулированному требованию. Неработающий менеджер секретов ничем не отличается от пустого менеджера секретов.
FAQ
Стоит ли использовать self-hosted менеджер секретов для одного VPS?
Обычно нет, если речь идет о таких сервисах, как OpenBao или Infisical. На одном сервере с одним или двумя пользователями файл с правами 600 или зашифрованные учетные данные systemd обеспечивают ту же защиту от других локальных пользователей, не требуя процедуры распечатывания (unseal) и обслуживания дополнительного сервиса. Сервис управления секретами становится оправданным, когда у вас появляется несколько машин, несколько пользователей или реальная потребность в учетных данных, которые должны истекать без ручного обновления.
В чем разница между менеджером паролей и менеджером секретов?
Менеджер паролей хранит учетные данные, которые вводит человек, и разблокируется пользователем в его присутствии. Менеджер секретов предоставляет учетные данные процессам, поэтому он должен работать в 03:00, когда никого нет рядом. Из этого вытекает главное различие: заблокированный менеджер паролей требует ввода мастер-пароля, а запечатанный (sealed) менеджер секретов останавливает работу всех сервисов, которые пытаются перезапуститься в этот момент.
Что произойдет с моими приложениями, если OpenBao окажется запечатан после перезагрузки?
Они не смогут получить свои секреты и не запустятся. Если в их юнитах настроен Restart=, systemd будет повторять попытки запуска, пока кто-нибудь не предоставит порог распечатывания (по умолчанию 3 из 5 ключей) или пока не сработает ограничение на частоту запуска юнита. OpenBao хранит корневой ключ только в оперативной памяти, поэтому каждая перезагрузка снова запечатывает его. Либо включите автоматическое распечатывание (auto unseal), приняв тот факт, что на одном VPS ключ распечатывания окажется на том же диске, что и данные, либо записывайте секреты в файл во время развертывания, чтобы загрузка системы не зависела от API.
Можно ли коммитить зашифрованные через SOPS файлы в публичный репозиторий?
Значения зашифрованы, поэтому они защищены от любого, у кого нет приватного ключа age. Сами ключи не зашифрованы: читатель может увидеть, что у вас есть STRIPE_SECRET_KEY и SMTP_PASSWORD, а также как часто каждый из них меняется. Эти метаданные приемлемы для большинства проектов, но неприемлемы для некоторых. Храните приватный ключ age вне репозитория и запускайте sops updatekeys для каждого существующего файла при добавлении или удалении получателя.