Безопасность и Защита 18 мин чтения 2026-11-06

Централизованное управление секретами и .env с Infisical: развертывание в Docker Compose на VDS с шифрованием AES-GCM и защитой от утечек API-ключей

Практическое инженерное руководство по установке платформы управления секретами Infisical v0.167.6 в Docker Compose на VDS. Надежное шифрование в покое (AES-256-GCM), защита от случайного коммита токенов в Git, изоляция окружений dev/staging/prod, настройка Nginx с SSL и безопасная инъекция переменных в контейнеры через Infisical CLI без хранения .env на диске.

Инженерная редакция SysKit Проверено инженерами SysKit.ru

В процессе разработки и эксплуатации любого современного сервиса накапливаются десятки критических учетных данных: токены Telegram-ботов, API-ключи платежных систем, приватные ключи нейросетей, секреты JWT-авторизации и пароли боевых баз данных. В подавляющем большинстве проектов эти секреты хранятся в открытых файлах .env, которые разработчики копируют через незащищенные чаты, размножают по локальным ноутбукам и случайно коммитят в репозитории Git. Одно ошибочное действие приводит к компрометации боевой инфраструктуры и многомиллионным штрафам за утечку персональных данных. Открытая платформа Infisical (более 30 300 звёзд на GitHub, ядро под свободной лицензией MIT) предлагает элегантную инженерную замену хаосу в файлах конфигурации: централизованный сейф с шифрованием AES-256-GCM в покое, версионированием, разграничением доступа по средам (dev/staging/prod) и динамической инъекцией переменных в память процессов через официальный CLI без сохранения открытых файлов на диск хоста.

1. Архитектура Infisical и почему открытые .env-файлы несут угрозу

Классический подход с текстовыми файлами .env обладает фундаментальными уязвимостями, которые невозможно устранить стандартными средствами Linux:

  • Отсутствие версионирования и аудита: когда разработчик меняет пароль к тестовой базе в локальном файле, невозможно отследить, кто, когда и зачем внес изменения, а также откатиться к стабильной версии.
  • Утечки через систему контроля версий: даже если файл .env добавлен в .gitignore, в спешке его регулярно коммитят в Git, после чего секреты навсегда оседают в истории коммитов репозитория.
  • Компрометация при доступе к серверу: если злоумышленник получает доступ на чтение файловой системы VDS (например, через уязвимость Local File Inclusion в веб-приложении), незашифрованный файл .env мгновенно раскрывает все пароли к сопутствующим сервисам.
  • Дрейф конфигураций (Config Drift): переменные окружения на боевом сервере, staging-стенде и машинах программистов со временем рассинхронизируются, приводя к трудноуловимым багам в продакшене.

Платформа Infisical решает эти проблемы на уровне криптографической архитектуры. В режиме автономного развертывания (Self-Hosted) сервис обеспечивает надежное шифрование в покое (Encryption at Rest): все секреты шифруются симметричным алгоритмом AES-256-GCM с уникальным вектором инициализации (IV). Внутреннее хранилище PostgreSQL содержит исключительно нечитаемые шифротексты, что защищает от утечки учетных данных при компрометации дампов базы данных или резервных копий. Системный мастер-ключ ENCRYPTION_KEY хранится в файле конфигурации хоста, поэтому надежная изоляция прав доступа (chmod 600) и закрытие внешних портов через UFW выступают ключевым периметром защиты.

Критерий Infisical (Self-Hosted) HashiCorp Vault Doppler (SaaS) Текстовые .env файлы
Лицензия и контроль Open Source (MIT Core) BSL 1.1 (несвободная) Закрытый проприетарный SaaS Без контроля
Порог входа / Удобство (DX) Минимальный (Web UI + CLI) Высокий (HCL, Unseal, токены) Высокое удобство Примитивный
Шифрование секретов AES-256-GCM (Encryption at Rest) Шифрование на сервере (Shamir) Шифрование в облаке США Открытый текст (Plaintext)
Инъекция в процессы В память (infisical run) Через Vault Agent / Consul В память (doppler run) Чтение с диска
Локализация (152-ФЗ РФ) 100% (ваш VDS в РФ) 100% (при своем сервере) Риск санкционной блокировки Локально

Для небольших команд и быстрорастущих проектов Infisical предлагает идеальный баланс: в ней нет чудовищной сложности настройки HashiCorp Vault, но есть все возможности коммерческого Doppler, развернутого на вашем собственном российском сервере без риска блокировки зарубежных аккаунтов.

2. Подготовка операционной системы VDS и изоляция сетевых портов

Для развертывания Infisical рекомендуется использовать чистый сервер под управлением Ubuntu 24.04 LTS или Debian 12. Стек платформы базируется на современных версиях Node.js, PostgreSQL 16 и Redis 7. Подготовка хоста включает настройку файрвола UFW, активацию файла подкачки (Swap) и установку официального Docker Engine.

Подключаемся к серверу по SSH и выполняем базовую оптимизацию системных пакетов:

# Обновление списка пакетов и системы
sudo apt update && sudo apt upgrade -y

# Создание и активация файла подкачки (Swap) на 2 ГБ
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Автоматическое подключение Swap при перезагрузке
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Настройка виртуальной памяти (swappiness = 10)
sudo sysctl vm.swappiness=10
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf

Устанавливаем официальный стек Docker Engine и плагин Docker Compose v2:

# Установка вспомогательных утилит
sudo apt install -y ca-certificates curl gnupg lsb-release jq

# Добавление официального репозитория Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Проверка работоспособности Docker
sudo docker --version && sudo docker compose version

Настраиваем межсетевой экран ufw. Наружу должны быть открыты исключительно стандартные порты SSH (22), HTTP (80) и HTTPS (443). Внутренний порт веб-интерфейса Infisical (8080), а также служебные порты PostgreSQL (5432) и Redis (6379) должны быть изолированы внутри виртуальной сети Docker и привязаны к локальной петле 127.0.0.1. Проверить доступность портов сервера после запуска всегда можно с помощью бесплатного инструмента проверки открытых портов SysKit:

# Запрет входящих соединений по умолчанию
sudo ufw default deny incoming
sudo ufw default allow outgoing

# Разрешение только необходимых портов
sudo ufw allow 22/tcp comment 'SSH'
sudo ufw allow 80/tcp comment 'Nginx HTTP'
sudo ufw allow 443/tcp comment 'Nginx HTTPS'

# Активация файрвола
sudo ufw enable
sudo ufw status verbose

3. Боевой Docker Compose манифест с PostgreSQL 16 и Redis 7

Для изоляции платформы создаем выделенный системный каталог /opt/infisical, в котором разместим переменные окружения, криптографические ключи и манифест контейнеров:

sudo mkdir -p /opt/infisical
sudo chmod 750 /opt/infisical
cd /opt/infisical

Создаем защищенный файл переменных окружения .env. Для генерации мастер-ключа шифрования ENCRYPTION_KEY, секрета сессий AUTH_SECRET и пароля базы данных используем криптографически стойкие генераторы OpenSSL или встроенный генератор паролей SysKit:

# Генерация 16-байтного hex-ключа шифрования данных (32 символа hex)
ENC_KEY=$(openssl rand -hex 16)

# Генерация 32-байтного base64-секрета для JWT-авторизации
AUTH_SEC=$(openssl rand -base64 32)

# Генерация пароля для PostgreSQL
PG_PASS=$(openssl rand -base64 24 | tr -d "=+/" | cut -c1-20)

cat <<EOF | sudo tee /opt/infisical/.env
# Основные параметры Infisical
NODE_ENV=production
SITE_URL=https://vault.yourdomain.ru
ENCRYPTION_KEY=${ENC_KEY}
AUTH_SECRET=${AUTH_SEC}

# Параметры внутренней базы данных PostgreSQL 16
POSTGRES_USER=infisical
POSTGRES_PASSWORD=${PG_PASS}
POSTGRES_DB=infisicaldb
DB_CONNECTION_URI=postgres://infisical:${PG_PASS}@db:5432/infisicaldb

# Параметры кэширования и очередей Redis 7
REDIS_URL=redis://redis:6379

# Почтовый шлюз SMTP для приглашения коллег и восстановления паролей (опционально)
SMTP_HOST=smtp.yandex.ru
SMTP_PORT=465
SMTP_SECURE=true
SMTP_USER=vault-noreply@yourdomain.ru
SMTP_PASSWORD=ваш_пароль_приложения_smtp
SMTP_FROM_ADDRESS=vault-noreply@yourdomain.ru
SMTP_FROM_NAME="Infisical Vault"
EOF

sudo chmod 600 /opt/infisical/.env

Внимание: обязательно сохраните значения ENCRYPTION_KEY и AUTH_SECRET в надежном корпоративном менеджере паролей (например, в Vaultwarden). Если вы потеряете или измените ENCRYPTION_KEY после добавления секретов в систему, расшифровать их в базе данных будет невозможно. Блок параметров SMTP опционален, но крайне рекомендуется: без почтового сервера вы сможете зарегистрировать первого администратора, однако автоматическая рассылка приглашений коллегам и сброс паролей требуют валидного почтового шлюза.

Теперь создаем файл /opt/infisical/docker-compose.yml. Обратите внимание: порт 8080 привязан строго к петлевому адресу 127.0.0.1, контейнеры СУБД снабжены проверкой работоспособности healthcheck, а лимиты ресурсов зафиксированы директивами mem_limit и cpus. Если вам понадобятся другие типовые конфигурации, используйте наш генератор Docker Compose:

services:
  backend:
    image: infisical/infisical:v0.167.6
    container_name: infisical_backend
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - NODE_ENV=production
      - ENCRYPTION_KEY=${ENCRYPTION_KEY}
      - AUTH_SECRET=${AUTH_SECRET}
      - SITE_URL=${SITE_URL}
      - DB_CONNECTION_URI=${DB_CONNECTION_URI}
      - REDIS_URL=${REDIS_URL}
      - SMTP_HOST=${SMTP_HOST}
      - SMTP_PORT=${SMTP_PORT}
      - SMTP_SECURE=${SMTP_SECURE}
      - SMTP_USER=${SMTP_USER}
      - SMTP_PASSWORD=${SMTP_PASSWORD}
      - SMTP_FROM_ADDRESS=${SMTP_FROM_ADDRESS}
      - SMTP_FROM_NAME=${SMTP_FROM_NAME}
    mem_limit: 1024m
    cpus: 1.0
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started
    networks:
      - infisical_net

  db:
    image: postgres:16-alpine
    container_name: infisical_db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - db_data:/var/lib/postgresql/data
    mem_limit: 512m
    cpus: 1.0
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - infisical_net

  redis:
    image: redis:7-alpine
    container_name: infisical_redis
    restart: unless-stopped
    volumes:
      - redis_data:/data
    mem_limit: 256m
    cpus: 0.5
    networks:
      - infisical_net

networks:
  infisical_net:
    driver: bridge

volumes:
  db_data:
    driver: local
  redis_data:
    driver: local

Запускаем контейнеры в фоновом режиме и контролируем прохождение автоматических миграций схемы данных:

cd /opt/infisical
sudo docker compose up -d

# Просмотр логов запуска сервиса
sudo docker compose logs -f backend

Когда в журнале появится сообщение о готовности HTTP-сервера к приему входящих запросов, платформа готова к подключению обратного прокси.

4. Конфигурация Nginx Reverse Proxy, Let's Encrypt SSL и заголовков

Для безопасной передачи секретов по зашифрованному каналу TLS настраиваем обратный прокси-сервер Nginx с автоматическим получением сертификата Let's Encrypt. Настройка выполняется в два последовательных шага, что полностью исключает ошибку chicken-and-egg (когда тест конфигурации nginx -t аварийно завершается из-за еще не сгенерированных файлов ключей).

Устанавливаем Nginx и клиент Certbot:

sudo apt install -y nginx certbot python3-certbot-nginx

Шаг 1: Создаем начальный конфигурационный файл /etc/nginx/sites-available/infisical.conf с базовым проксированием по HTTP для успешного подтверждения доменного имени ACME-челленжем:

upstream infisical_upstream {
    server 127.0.0.1:8080;
    keepalive 32;
}

server {
    listen 80;
    listen [::]:80;
    server_name vault.yourdomain.ru;

    location / {
        proxy_pass http://infisical_upstream;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Активируем виртуальный хост, проверяем синтаксис и выпускаем сертификат Let's Encrypt с автоматической настройкой перенаправления на HTTPS:

# Активация виртуального хоста
sudo ln -s /etc/nginx/sites-available/infisical.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

# Получение SSL-сертификата с автоматическим редиректом
sudo certbot --nginx -d vault.yourdomain.ru --non-interactive --agree-tos --redirect -m admin@yourdomain.ru

Шаг 2: После успешного выпуска сертификата дополняем /etc/nginx/sites-available/infisical.conf строгими параметрами безопасности, поддержкой WebSockets (необходимы для живого обновления статусов в веб-интерфейсе) и сжатием Gzip. Сгенерировать готовые сниппеты директив всегда можно в нашем генераторе конфигураций Nginx:

upstream infisical_upstream {
    server 127.0.0.1:8080;
    keepalive 32;
}

server {
    listen 80;
    listen [::]:80;
    server_name vault.yourdomain.ru;

    # Автоматический редирект HTTP на HTTPS
    return 301 https://$host$request_uri;
}

server {
    # В дистрибутивах Ubuntu 24.04 (nginx 1.24) и Debian 12 (nginx 1.22) директива http2 указывается в listen:
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    # (Для сборок nginx.org 1.26+ используется раздельный синтаксис: listen 443 ssl; http2 on;)
    server_name vault.yourdomain.ru;

    # Сертификаты Let's Encrypt
    ssl_certificate /etc/letsencrypt/live/vault.yourdomain.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/vault.yourdomain.ru/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    # Ограничение размера тела запроса
    client_max_body_size 25M;

    # Заголовки безопасности
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    # Сжатие Gzip для ускорения передачи дашбордов и JSON
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_types text/plain text/css application/json application/javascript image/svg+xml;

    location / {
        proxy_pass http://infisical_upstream;
        proxy_http_version 1.1;

        # Поддержка WebSockets для живого взаимодействия с интерфейсом
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # Передача реальных заголовков клиента
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
}

Применяем обновленный боевой конфигурационный файл:

sudo nginx -t && sudo systemctl reload nginx

Проверьте корректность цепочки сертификатов онлайн-утилитой проверки SSL и подтвердите отсутствие циклических редиректов через проверку редиректов SysKit.

5. Системные требования и подбор оптимального тарифа VDS

Поскольку архитектура Infisical спроектирована на легковесном стеке Node.js с эффективным пулом соединений к PostgreSQL и асинхронным кэшем Redis, платформа предъявляет весьма скромные требования к серверному оборудованию. В отличие от тяжелых JVM-решений, здесь нет потребности в резервировании гигабайтов памяти под сборщик мусора.

Ниже приведена таблица конфигурационных профилей для выбора оптимального тарифа VDS:

Профиль использования Разработчики и CI/CD Рекомендуемые ресурсы VDS Ожидаемое потребление RAM
Стартовый (Малая команда) 1 – 10 инженеров, до 15 проектов 2 vCPU • 2 ГБ RAM • 25 ГБ NVMe 600 – 900 МБ RAM
Стандартный (Растущий проект) 10 – 40 инженеров, активный CI/CD 2 vCPU • 4 ГБ RAM • 40 ГБ NVMe 1.2 – 1.8 ГБ RAM
Enterprise / High-Load 40 – 150+ сотрудников, авторотация 4 vCPU • 8 ГБ RAM • 80 ГБ NVMe 2.5 – 3.5 ГБ RAM

Для надежного размещения хранилища секретов критически важна стабильность сетевого соединения и высокая скорость дисковой подсистемы NVMe, гарантирующая мгновенное выполнение транзакций при шифровании ключей.

Рекомендуемые VDS-провайдеры

Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с

Выбор редакции
⚡

Timeweb Cloud — Быстрые NVMe VDS

Высокая производительность процессоров и скоростные NVMe-диски для мгновенного отклика API управления секретами и шифрования на лету.

Конфигурация
2 vCPU 3.3 ГГц • 2 ГБ RAM • 30 ГБ NVMe • Трафик без лимита
Премиум Tier III
🔷

Selectel — Надежная Enterprise-инфраструктура

Аппаратная изоляция ресурсов в сертифицированных ЦОД Tier III с гарантированной защитой от сетевых атак и быстрым S3 для дампов базы.

Конфигурация
2 vCPU • 2 ГБ RAM • 40 ГБ NVMe • Канал 100 Мбит/с
Быстрый старт
🟠

Beget — Простота управления и надежность

Удобный интерфейс управления, автоматические ежедневные бэкапы хоста и мгновенная установка Docker в один клик при развертывании сервера.

Конфигурация
2 vCPU • 2 ГБ RAM • 25 ГБ NVMe • Безлимитный трафик

6. Первый запуск: инициализация администратора, проекты и окружения

После завершения настройки Nginx и перезапуска веб-сервера перейдите в браузере по адресу https://vault.yourdomain.ru. Система встретит вас экраном первичной регистрации корневого администратора:

  1. Создание суперпользователя: введите имя, фамилию, рабочий корпоративный email и сгенерируйте стойкий мастер-пароль длиной не менее 18 символов с помощью генератора паролей SysKit. Мастер-пароль используется для генерации локального клиентского ключа шифрования, поэтому его утеря означает потерю доступа к аккаунту.
  2. Создание организации и первого проекта: укажите название вашей компании (например, «MyCompany») и имя первого проекта (например, «ecommerce-platform»).
  3. Настройка окружений (Environments): по умолчанию Infisical автоматически создает три изолированных контура: Development (для локальной разработки), Staging (для тестовых стендов) и Production (для боевых серверов). При необходимости в настройках проекта можно добавить кастомные среды (например, Testing или Demo).
  4. Обязательная двухфакторная аутентификация (2FA): сразу после входа откройте профиль (Personal Settings → Security) и активируйте TOTP-аутентификацию через Яндекс Ключ или Google Authenticator.

Для добавления коллег перейдите в раздел Project Settings → Access Control → Members. В Infisical реализована гранулярная ролевая модель доступа (RBAC):

  • Admin — полный доступ к проекту, управлению участниками и интеграциям.
  • Member — стандартный доступ на просмотр и изменение секретов в разрешенных средах (например, только в Development и Staging).
  • Viewer — доступ только на чтение без возможности редактирования или просмотра истории версий.
  • Custom Roles — возможность тонко разрешить доступ только к определенным папкам с секретами (например, запретить джуниор-разработчикам просмотр боевых ключей платежного шлюза).

7. Управление секретами: шифрование AES-256-GCM, версионирование и RBAC-права

Инженерный нюанс архитектуры: в облачном SaaS Infisical шифрование секретов происходит в браузере клиента (Zero-Knowledge E2EE), однако при автономном развертывании (Self-Hosted) на собственном сервере мастер-ключ ENCRYPTION_KEY хранится в файле .env бэкенда. Поэтому в сценарии собственного VDS модель защиты представляет собой надежное шифрование в покое (Encryption at Rest): база данных PostgreSQL хранит исключительно шифротексты и защищена от утечек бэкапов, а строгое разграничение прав доступа к хосту (chmod 600) защищает мастер-ключ.

В веб-интерфейсе Infisical работа с секретами организована максимально наглядно. Выберите проект, перейдите в нужное окружение (например, Production) и нажмите «Add Secret»:

  • Форматы значений: платформа поддерживает стандартные пары Ключ-Значение, многострочные сертификаты и приватные RSA-ключи (Multiline Secrets), а также комментирование назначения каждого токена.
  • Интерполяция переменных (Secret Referencing): Infisical позволяет ссылаться на другие переменные, исключая дублирование данных. Например, можно задать строку подключения через конструкцию:
    DATABASE_URL=postgres://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:5432/${DB_NAME}
    При инъекции система автоматически подставит актуальные значения связанных переменных.
  • Версионирование и откат изменений (Point-in-Time Recovery): каждый раз, когда сотрудник редактирует или удаляет переменную, создается новая версия секрета (v1, v2, v3). В журнале наглядно видно автора, время и точное diff-изменение. Если новый токен сломал сборку, откат к предыдущей версии выполняется одним кликом мыши.
  • Журнал аудита (Audit Logs): раздел Organization Settings → Audit Logs фиксирует каждое действие: кто запрашивал расшифровку секретов, кто экспортировал переменные и с какого IP-адреса выполнялся вход. Это полностью закрывает требования служб информационной безопасности и стандартов 152-ФЗ.

8. Автоматическая инъекция переменных через Infisical CLI без сохранения на диск

Главная инженерная ценность Infisical заключается в полном отказе от хранения открытых .env файлов на жестких дисках боевых VDS. Вместо небезопасного текстового файла на сервере используется официальная консольная утилита Infisical CLI, которая запрашивает зашифрованные секреты по защищенному API и пробрасывает их напрямую в оперативную память запускаемого процесса.

Устанавливаем Infisical CLI на боевой сервер:

# Добавление официального репозитория Infisical CLI (artifacts-cli.infisical.com)
curl -1sLf 'https://artifacts-cli.infisical.com/setup.deb.sh' | sudo -E bash

# Установка утилиты
sudo apt-get update && sudo apt-get install -y infisical

# Проверка версии CLI
infisical --version

Аутентификация через Machine Identity (Universal Auth):

Для автоматических серверов и CI/CD пайплайнов категорически нельзя использовать персональные логины и пароли разработчиков. В Infisical настраивается машинная аутентификация:

  1. В веб-интерфейсе откройте Project Settings → Access Control → Machine Identities.
  2. Нажмите «Create Identity», укажите имя (например, «production-vds-runner») и назначьте роль с доступом строго на чтение (Read-Only) окружения Production.
  3. Сгенерируйте пару учетных данных: Client ID и Client Secret.

На боевом сервере создаем изолированный файл конфигурации /etc/infisical-auth.env с правами 600:

cat <<EOF | sudo tee /etc/infisical-auth.env
INFISICAL_API_URL="https://vault.yourdomain.ru/api"
INFISICAL_UNIVERSAL_AUTH_CLIENT_ID="ваш-client-id"
INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET="ваш-client-secret"
EOF

sudo chmod 600 /etc/infisical-auth.env

Безопасный запуск сервисов в Docker Compose:

Теперь для старта любого вашего боевого проекта (например, интернет-магазина или Telegram-бота) не нужно копировать файл .env на сервер. Достаточно выполнить команду infisical run, указав целевое окружение и идентификатор проекта:

# Загрузка учетных данных сервиса
source /etc/infisical-auth.env

# Запуск контейнеров с пробросом секретов прямо в оперативную память Docker:
infisical run --env=prod --projectId="ваш-project-id" -- docker compose up -d

Как это работает под капотом: утилита Infisical CLI обращается к вашему серверу vault.yourdomain.ru, проходит аутентификацию по протоколу Universal Auth, расшифровывает переменные локально в памяти процесса и запускает дочернюю команду docker compose up -d, передав переменные окружения через стандартный Linux-механизм environ. На диске хоста не остается ни единого байта открытых секретов: даже если злоумышленник получит физический доступ к диску VDS или украдет снапшот, секреты останутся надежно защищены.

9. Регламент резервного копирования СУБД, ротация ключей и чек-лист

Вся база данных учетных записей, шифротекстов секретов и настроек прав хранится в PostgreSQL. Для создания регулярного дампа базы данных настраиваем резервное копирование с прямой передачей бинарного потока на хост и последующей отправкой в независимое S3-хранилище (например, по схеме с Kopia и дедупликацией):

#!/usr/bin/env bash
set -euo pipefail

BACKUP_DIR="/var/backups/infisical"
DATE_TAG=$(date +%Y%m%d_%H%M%S)
DUMP_FILE="${BACKUP_DIR}/infisical_${DATE_TAG}.dump"

sudo mkdir -p "${BACKUP_DIR}"

# Создание дампа PostgreSQL с прямой записью потока данных на хост (без сохранения внутри контейнера)
sudo docker exec infisical_db pg_dump -U infisical -d infisicaldb -F c -b > "${DUMP_FILE}"
sudo chmod 600 "${DUMP_FILE}"

# Ротация локальных архивов старше 30 дней
find "${BACKUP_DIR}" -name "infisical_*.dump" -mtime +30 -delete

Регламент плановой ротации ключей шифрования:

  • API-токены внешних сервисов: ротируются раз в 90 дней через интерфейс Infisical с бесшовной передачей в контейнеры при следующем перезапуске сервисов.
  • Client Secret для Machine Identity: при ротации создается новый секрет в веб-панели, обновляется файл /etc/infisical-auth.env на боевом сервере, после чего старый секрет отзывается без простоя сервиса.
  • Мастер-ключ ENCRYPTION_KEY: является неизменяемым (immutable) на протяжении всего жизненного цикла инстанса базы данных. Любая ручная замена ключа в файле .env приведет к необратимой потере доступа к шифротекстам. Плановая регулярная ротация выполняется на уровне самих прикладных секретов внутри сейфа и сервисных ключей Machine Identity, а не системного ключа СУБД.

Чек-лист системного администратора для запуска Infisical в Production:

  1. Значения ENCRYPTION_KEY (16 байт hex) и AUTH_SECRET (32 байта base64) сгенерированы криптографически стойким генератором и сохранены в надежном менеджере паролей.
  2. Файл /opt/infisical/.env защищен правами доступа chmod 600 и доступен только суперпользователю.
  3. Порт 8080 привязан строго к 127.0.0.1 и закрыт от внешнего мира правилами файрвола UFW.
  4. В Nginx настроен защищенный виртуальный хост с TLSv1.2/1.3, поддержкой WebSockets, HSTS и заголовками безопасности.
  5. Для учетной записи администратора включена обязательная двухфакторная аутентификация TOTP.
  6. Боевые серверы и CI/CD пайплайны подключены исключительно через Machine Identity (Universal Auth) с правами Read-Only на конкретные окружения.
  7. На рабочих станциях и серверах прекращено сохранение незашифрованных файлов .env — запуск сервисов переведен на infisical run.
  8. В проекте настроены изолированные окружения (Development, Staging, Production) с разграничением прав разработчиков.
  9. Настроен регулярный автоматический дамп базы данных PostgreSQL с ротацией и репликацией в объектное хранилище S3.
  10. Периодически проверяется журнал аудита (Audit Logs) на предмет аномальных всплесков чтения секретов.

Вопросы и ответы (FAQ)

Популярные вопросы вебмастеров и сисадминов по данной теме

Чем Infisical отличается от классического HashiCorp Vault?
HashiCorp Vault — мощный enterprise-инструмент, обладающий крайне высоким порогом входа: сложный синтаксис HCL-политик, необходимость ручного распечатывания хранилища (Unseal Keys) при каждом перезапуске и сменившаяся лицензия (BSL 1.1). Infisical изначально спроектирован с упором на Developer Experience (DX): ядро распространяется под открытой лицензией MIT, разворачивается за 10 минут в Docker Compose, имеет интуитивный веб-интерфейс в стиле Doppler и мощный CLI (infisical run), который подставляет переменные напрямую в окружение процессов без необходимости переписывать код приложений.
Что произойдет, если я потеряю переменную ENCRYPTION_KEY?
Переменная ENCRYPTION_KEY задает 16-байтный шестнадцатеричный ключ (openssl rand -hex 16), с помощью которого Infisical шифрует мастер-ключи проектов и значения переменных в PostgreSQL. Если этот ключ утерян или изменен, расшифровать существующие секреты в базе данных будет математически невозможно. Поэтому ключ ENCRYPTION_KEY и секрет AUTH_SECRET необходимо обязательно сохранить в надежном менеджере паролей еще до первого запуска контейнера.
Как безопасно передавать секреты в контейнеры на боевом сервере (Production)?
Золотой стандарт Infisical — использование Machine Identity (Universal Auth) и утилиты Infisical CLI. На боевом сервере создается сервисная учетная запись с правами Read-Only на окружение Production. При старте контейнеров команда 'infisical run --env=prod -- docker compose up -d' получает секреты по защищенному TLS-соединению и передает их дочернему процессу в оперативную память. На диске VDS не создается открытый файл .env, что исключает утечку учетных данных при компрометации файловой системы или чтении логов.
Поддерживает ли Infisical авторотацию секретов и интеграцию с внешними сервисами?
Да, Infisical умеет синхронизировать секреты в реальном времени с внешними провайдерами (Native Integrations): GitHub Actions, GitLab CI, AWS Secrets Manager, Kubernetes Secrets и внешними вебхуками. При изменении пароля в интерфейсе Infisical он может автоматически обновиться в секретах репозитория CI/CD или вызвать перезапуск связанного сервиса через вебхук.
Сколько ресурсов VDS потребляет стек Infisical?
Стек Infisical состоит из трех контейнеров: приложение на Node.js (Infisical Core), СУБД PostgreSQL 16 и кэш Redis 7. В состоянии покоя весь стек потребляет около 500–700 МБ оперативной памяти. При активной работе с CLI и веб-интерфейсом комфортный объем RAM составляет 1.5–2 ГБ. Таким образом, даже базового VDS с 2 vCPU и 2 ГБ RAM достаточно для стабильного обслуживания команды из 10–20 разработчиков.

Читайте также в блоге SysKit

Смежные руководства и полезные технические статьи