DevOps и инфраструктура 15 мин чтения 2026-11-11

Платформа опросов и сбора отзывов клиентов Formbricks на VDS: развертывание открытой альтернативы Typeform в Docker Compose с защитой персональных данных по 152-ФЗ

Практическое руководство по развертыванию микросервисного стека платформы опросов Formbricks v6 на VDS в Docker Compose: Hub, Cube, SpiceDB, встраивание виджетов, валидация Standard Webhooks в Telegram и 152-ФЗ.

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

Сбор обратной связи, проведение NPS-опросов (Net Promoter Score), квалификация лидов и анкетирование пользователей — ключевые инструменты любого растущего интернет-магазина, продуктового сервиса или B2B-компании. Годами стандартом в этой сфере оставались зарубежные облачные сервисы вроде Typeform, SurveyMonkey и Qualtrics. Однако в современных реалиях их использование сопряжено с серьезными барьерами: оплата российскими картами заблокирована, подписки достигают десятков и сотен долларов в месяц за каждого оператора, а хранение персональных данных клиентов (ФИО, телефоны, email, отзывы) на зарубежных серверах прямо противоречит требованиям Федерального закона № 152-ФЗ «О персональных данных».

Formbricks — это ведущая open-source платформа опросов и управления клиентским опытом (Experience Management), созданная как открытая, приватная и полнофункциональная альтернатива Typeform. Актуальная архитектура Formbricks v6 (XM Suite) представляет собой зрелую распределенную систему: конструктор форм на Next.js, высокопроизводительный движок обработки ответов Hub на Go, гранулярную систему авторизации SpiceDB (ReBAC), аналитический движок Cube.js, базу данных PostgreSQL 18 и кэширующий слой Valkey (Redis). Платформа позволяет создавать любые формы: от компактных всплывающих виджетов на сайте до автономных многостраничных анкет с ветвлением логики, скрытыми полями и мгновенной криптографически подписанной доставкой ответов в Telegram и CRM. В этом подробном руководстве мы разберем развертывание полного стека Formbricks v6 на собственном VDS в Docker Compose, настройку обратного прокси Nginx с защитой от DoS и SSL, интеграцию виджета на сайт и организацию автоматических бэкапов.

1. Архитектура Formbricks v6: почему открытый стек побеждает проприетарные SaaS

В отличие от устаревших CMS-плагинов или примитивных монолитов, современный Formbricks v6 спроектирован по модульному микросервисному принципу, обеспечивающему высокую надежность, аналитическую мощь и защиту персональных данных.

Критерий Облачные SaaS (Typeform, SurveyMonkey) Google Forms / Яндекс Формы Formbricks v6 (Self-Hosted на VDS)
Стоимость и лицензия От $30–$80/мес за место, заблокирована оплата из РФ Бесплатно (с жесткими ограничениями дизайна и логики) 0 ₽ (Open Source AGPLv3), оплата только VDS от 1 000 ₽/мес
Локализация данных (152-ФЗ) Серверы в США и ЕС (прямое нарушение 152-ФЗ) Зависимость от политик сторонней корпорации 100% контроль: базы в дата-центрах РФ (Tier III)
Лимиты на ответы и формы От 100 до 1 000 ответов в месяц на базовых тарифах Базовые квоты аккаунта Безлимитно: любое количество форм, вопросов и ответов
Встраивание виджетов на сайт Iframe с чужим копирайтом на дешевых тарифах Только примитивный внешний фрейм Нативный JS SDK: модалки, слайдеры, полный White-Label
Интеграции и вебхуки Zapier / Make (требуют платных подписок) Таблицы, базовые триггеры Standard Webhooks (HMAC-SHA256), REST API, n8n, Telegram

Ключевые компоненты микросервисной архитектуры Formbricks v6:

  • Веб-интерфейс Formbricks Web (Next.js / TypeScript): Визуальный Drag-and-Drop конструктор опросов, публичные формы респондентов, аутентификация Better Auth и личный кабинет администратора.
  • Сервисы Formbricks Hub и Hub-Worker (Go): Высокопроизводительный движок на Go для асинхронного приема ответов и фоновый воркер (на очередях River), обеспечивающий диспетчеризацию вебхуков и внешних интеграций без блокировки HTTP-потока.
  • Авторизационный движок SpiceDB (AuthZed ReBAC): Гранулярное управление доступом на основе отношений (Relation-Based Access Control) по протоколу gRPC, изолирующее права команд, проектов и организаций.
  • Аналитический слой Cube.js (Semantic Layer): Специализированный сервер агрегации метрик, мгновенно рассчитывающий распределение оценок NPS, показатели конверсии и динамику завершения форм.
  • База данных PostgreSQL 18 (образ pgvector/pgvector:pg18): Штатный образ официального репозитория Formbricks. Гарантирует строгую ACID-сохранность транзакций и предоставляет векторные индексы для модуля расширенного семантического анализа и AI-таксономии отзывов.
  • Кэш и брокер Valkey / Redis: Управление сессиями пользователей, распределенные блокировки и кэширование метаданных форм.

💡 Совет инженера

При использовании Formbricks на собственном сервере вы получаете полноценный White-Label без чужих логотипов. Вы можете разместить систему на собственном поддомене (например, surveys.example.com) и полностью кастомизировать цветовую гамму, шрифты и CSS-стили форм под брендбук вашей компании.

2. Системные требования и подготовка инфраструктуры на VDS

Ввиду развитой микросервисной структуры (одновременная работа веб-интерфейса Next.js, аналитики Cube.js, демонов Hub и базы данных) требования к оперативной памяти Formbricks v6 выше, чем у старых монолитных версий v4. Для комфортной и бессбойной эксплуатации требуется от 4 ГБ RAM.

Ресурс Минимальные требования (v6) Рекомендуемая конфигурация (Production)
Процессор (vCPU) 2 vCPU (от 2.4 ГГц) 4 vCPU (от 3.3 ГГц)
Оперативная память (RAM) 4 ГБ RAM (+ 2 ГБ Swap) 6–8 ГБ RAM
Дисковое пространство 40 ГБ NVMe 60–80 ГБ NVMe (при хранении вложенных файлов)
Операционная система Ubuntu 22.04 LTS / Debian 12 Ubuntu 24.04 LTS x86_64

Подключимся к серверу по SSH, обновим репозитории, настроим базовые правила межсетевого экрана UFW и установим Docker с плагином Compose:

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

# Установка базовых утилит и клиента S3 для бэкапов
sudo apt install -y curl wget git ufw ca-certificates gnupg awscli

# Настройка межсетевого экрана UFW: закрываем все входящие порты, кроме SSH, HTTP и HTTPS
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp comment 'SSH'
sudo ufw allow 80/tcp comment 'HTTP Certbot'
sudo ufw allow 443/tcp comment 'HTTPS Nginx'
sudo ufw --force enable
sudo ufw status

# Установка Docker через официальный скрипт разработчиков
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Добавление текущего пользователя в группу docker
# Внимание: добавление в группу docker предоставляет права, эквивалентные root
sudo usermod -aG docker $USER

# Создание изолированной структуры каталогов проекта Formbricks
sudo mkdir -p /opt/formbricks/{data,uploads,backup,logs,cube/schema}
sudo chown -R $USER:$USER /opt/formbricks
cd /opt/formbricks

# Загрузка официальных вспомогательных файлов архитектуры v6:
# 1. Скрипт инициализации роли и базы данных SpiceDB в PostgreSQL
curl -fsSL -o authzed-postgres-bootstrap.sh https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/authzed-postgres-bootstrap.sh
chmod 700 authzed-postgres-bootstrap.sh

# 2. Модели и скрипты аналитического движка Cube.js
curl -fsSL -o cube/cube.js https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/cube/cube.js
curl -fsSL -o cube/schema/FeedbackRecords.js https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/cube/schema/FeedbackRecords.js

# Ограничение прав на служебный каталог резервных копий
chmod 750 /opt/formbricks/backup

Для применения прав группы docker перелогиньтесь в терминале (exit и повторный вход по SSH). Направьте DNS A-запись вашего поддомена (например, surveys.example.com) на публичный IP-адрес вашего VDS. Проверить распространение DNS-записей по серверам мира можно с помощью инструмента DNS Lookup на SysKit.

3. Манифест Docker Compose: запуск полного стека Formbricks v6 (Hub, Cube, SpiceDB, Postgres, Valkey)

Актуальный стек Formbricks v6 (XM Suite) — это микросервисная платформа. Чтобы система функционировала штатно, в манифесте запускаются не только веб-приложение и база данных, но и все ключевые сервисы: движок фоновых задач и вебхуков Hub, аналитический слой Cube.js и сервер авторизации SpiceDB.

Сгенерируем криптографически стойкие ключи для всех сервисов экосистемы. Для этого выполним консольные команды в терминале или воспользуемся онлайн-инструментом генератора надежных паролей на SysKit:

# Пароль базы данных PostgreSQL
DB_SECRET=$(openssl rand -hex 16)

# Секреты аутентификации Better Auth и шифрования AES-256 (ровно 64 hex-символа)
BETTER_AUTH_SECRET=$(openssl rand -hex 32)
ENCRYPTION_KEY=$(openssl rand -hex 32)
CRON_SECRET=$(openssl rand -hex 32)

# Межсервисные токены Hub, Cube и SpiceDB
HUB_API_KEY=$(openssl rand -hex 32)
CUBEJS_API_SECRET=$(openssl rand -hex 32)
AUTHZED_TOKEN=$(openssl rand -hex 32)
AUTHZED_DATABASE_PASSWORD=$(openssl rand -hex 32)

# Секрет подписи Standard Webhooks (HMAC-SHA256)
WEBHOOK_SECRET="whsec_$(openssl rand -hex 24)"

# Создание конфигурационного файла переменных окружения
cat <<EOF > /opt/formbricks/.env
# Сетевой адрес платформы (строго с протоколом https)
WEBAPP_URL=https://surveys.example.com
BETTER_AUTH_URL=https://surveys.example.com
NEXTAUTH_URL=https://surveys.example.com

# База данных PostgreSQL 18
POSTGRES_USER=postgres
POSTGRES_PASSWORD=${DB_SECRET}
POSTGRES_PASSWORD_URL_ENCODED=${DB_SECRET}
POSTGRES_DB=formbricks
DATABASE_URL=postgresql://postgres:${DB_SECRET}@postgres:5432/formbricks?schema=public

# Секретные ключи приложения
BETTER_AUTH_SECRET=${BETTER_AUTH_SECRET}
NEXTAUTH_SECRET=${BETTER_AUTH_SECRET}
ENCRYPTION_KEY=${ENCRYPTION_KEY}
CRON_SECRET=${CRON_SECRET}

# Кэш и очереди Valkey
REDIS_URL=redis://redis:6379

# Formbricks Hub (API и Worker вебхуков)
HUB_API_KEY=${HUB_API_KEY}
HUB_API_URL=http://hub:8080
HUB_INTERNAL_API_TOKEN=${HUB_API_KEY}

# Аналитический движок Cube.js
CUBEJS_API_URL=http://cube:4000
CUBEJS_API_SECRET=${CUBEJS_API_SECRET}
CUBEJS_JWT_ISSUER=formbricks-web
CUBEJS_JWT_AUDIENCE=formbricks-cube

# Авторизационный сервис SpiceDB (AuthZed ReBAC)
AUTHZED_ENABLED=true
AUTHZED_ENDPOINT=spicedb:50051
AUTHZED_TOKEN=${AUTHZED_TOKEN}
AUTHZED_SYSTEM_KEY=formbricks
AUTHZED_DATABASE_PASSWORD=${AUTHZED_DATABASE_PASSWORD}
AUTHZED_INSECURE=true
AUTHZED_CONSISTENCY=fully_consistent

# Секрет подписи Standard Webhooks
WEBHOOK_SECRET=${WEBHOOK_SECRET}

# Каталог для загрузок файлов в опросах
UPLOADS_DIR=/home/nextjs/apps/web/uploads

# Настройки отправки почты (SMTP)
MAIL_FROM=surveys@example.com
SMTP_HOST=smtp.yandex.ru
SMTP_PORT=465
SMTP_SECURE_ENABLED=1
SMTP_USER=surveys@example.com
SMTP_PASSWORD=your_smtp_app_password
EOF

# Защита файла переменных окружения (доступ только владельцу)
chmod 600 /opt/formbricks/.env

Создадим файл /opt/formbricks/docker-compose.yml. В манифесте задействована вся официальная микросервисная связка с разделением ролей и изоляцией портов: наружу опубликован только порт веб-интерфейса 127.0.0.1:3000, а директива extra_hosts обеспечивает доставку вебхуков локальным службам на хосте:

services:
  # 1. Реляционная база данных с поддержкой pgvector
  postgres:
    image: pgvector/pgvector:pg18
    container_name: formbricks-db
    restart: unless-stopped
    shm_size: 512mb
    mem_limit: 768m
    cpus: 1.0
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: formbricks
    volumes:
      - ./data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres || exit 1"]
      interval: 5s
      timeout: 3s
      retries: 30
      start_period: 15s
    networks:
      - fb_net

  # 2. Быстрый брокер кэша и сессий Valkey (Redis)
  redis:
    image: valkey/valkey:8-alpine
    container_name: formbricks-cache
    restart: unless-stopped
    mem_limit: 256m
    cpus: 0.5
    command: valkey-server --appendonly yes --maxmemory-policy noeviction
    volumes:
      - ./valkey-data:/data
    healthcheck:
      test: ["CMD", "valkey-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 30
      start_period: 10s
    networks:
      - fb_net

  # 3. Инициализация роли и БД SpiceDB в PostgreSQL
  authzed-db-bootstrap:
    image: pgvector/pgvector:pg18
    container_name: formbricks-authzed-bootstrap
    restart: "no"
    entrypoint: ["/bin/sh", "-ec", "exec /usr/local/bin/authzed-postgres-bootstrap.sh"]
    environment:
      POSTGRES_ADMIN_URL: postgresql://postgres:${POSTGRES_PASSWORD}@postgres:5432/postgres?sslmode=disable
      AUTHZED_DATABASE_NAME: spicedb
      AUTHZED_DATABASE_USERNAME: spicedb
      AUTHZED_DATABASE_PASSWORD: ${AUTHZED_DATABASE_PASSWORD}
    volumes:
      - ./authzed-postgres-bootstrap.sh:/usr/local/bin/authzed-postgres-bootstrap.sh:ro
    depends_on:
      postgres:
        condition: service_healthy
    networks:
      - fb_net

  # 4. Применение схемы данных SpiceDB
  spicedb-migrate:
    image: authzed/spicedb:v1.57.0
    container_name: formbricks-spicedb-migrate
    restart: "no"
    command: datastore migrate head
    environment:
      SPICEDB_DATASTORE_ENGINE: postgres
      SPICEDB_DATASTORE_CONN_URI: postgresql://spicedb:${AUTHZED_DATABASE_PASSWORD}@postgres:5432/spicedb?sslmode=disable
    depends_on:
      authzed-db-bootstrap:
        condition: service_completed_successfully
    networks:
      - fb_net

  # 5. Движок авторизации SpiceDB (AuthZed ReBAC)
  spicedb:
    image: authzed/spicedb:v1.57.0
    container_name: formbricks-spicedb
    restart: unless-stopped
    mem_limit: 384m
    cpus: 0.5
    command: serve
    environment:
      SPICEDB_DATASTORE_ENGINE: postgres
      SPICEDB_DATASTORE_CONN_URI: postgresql://spicedb:${AUTHZED_DATABASE_PASSWORD}@postgres:5432/spicedb?sslmode=disable
      SPICEDB_GRPC_PRESHARED_KEY: ${AUTHZED_TOKEN}
      SPICEDB_LOG_FORMAT: json
      SPICEDB_LOG_LEVEL: info
      SPICEDB_TELEMETRY_ENDPOINT: ""
    depends_on:
      spicedb-migrate:
        condition: service_completed_successfully
    healthcheck:
      test: ["CMD", "/usr/local/bin/grpc_health_probe", "-addr=localhost:50051"]
      interval: 5s
      timeout: 5s
      retries: 15
      start_period: 10s
    networks:
      - fb_net

  # 6. Миграции основной схемы Prisma для Formbricks
  formbricks-migrate:
    image: ghcr.io/formbricks/formbricks:v6.1.4
    container_name: formbricks-migrate
    restart: "no"
    env_file: .env
    entrypoint: ["sh", "-c"]
    command: ["node /home/nextjs/validate-env.mjs && node packages/database/dist/scripts/apply-migrations.js"]
    depends_on:
      postgres:
        condition: service_healthy
    networks:
      - fb_net

  # 7. Инициализация пространств прав в SpiceDB
  authzed-initialize:
    image: ghcr.io/formbricks/formbricks:v6.1.4
    container_name: formbricks-authzed-init
    restart: "no"
    env_file: .env
    entrypoint: ["formbricks-authzed"]
    command: ["upgrade", "prepare"]
    depends_on:
      formbricks-migrate:
        condition: service_completed_successfully
      spicedb:
        condition: service_healthy
    networks:
      - fb_net

  # 8. Миграции схемы Hub (Goose + River)
  hub-migrate:
    image: ghcr.io/formbricks/hub:latest
    container_name: formbricks-hub-migrate
    restart: "no"
    entrypoint: ["sh", "-c"]
    command: ["/usr/local/bin/goose -dir /app/migrations postgres \"$$DATABASE_URL\" up && /usr/local/bin/river migrate-up --database-url \"$$DATABASE_URL\""]
    environment:
      DATABASE_URL: postgresql://postgres:${POSTGRES_PASSWORD}@postgres:5432/formbricks?sslmode=disable
    depends_on:
      formbricks-migrate:
        condition: service_completed_successfully
    networks:
      - fb_net

  # 9. Formbricks Hub API
  hub:
    image: ghcr.io/formbricks/hub:latest
    container_name: formbricks-hub
    restart: unless-stopped
    mem_limit: 384m
    cpus: 0.5
    environment:
      DATABASE_URL: postgresql://postgres:${POSTGRES_PASSWORD}@postgres:5432/formbricks?sslmode=disable
      API_KEY: ${HUB_API_KEY}
    depends_on:
      hub-migrate:
        condition: service_completed_successfully
      postgres:
        condition: service_healthy
    networks:
      - fb_net

  # 10. Hub Worker (диспетчеризация очередей и вебхуков)
  hub-worker:
    image: ghcr.io/formbricks/hub:latest
    container_name: formbricks-hub-worker
    restart: unless-stopped
    mem_limit: 384m
    cpus: 0.5
    entrypoint: ["/app/hub-worker"]
    environment:
      DATABASE_URL: postgresql://postgres:${POSTGRES_PASSWORD}@postgres:5432/formbricks?sslmode=disable
    depends_on:
      hub-migrate:
        condition: service_completed_successfully
      postgres:
        condition: service_healthy
    networks:
      - fb_net

  # 11. Аналитический сервер Cube.js
  cube:
    image: ghcr.io/formbricks/cube:1.8.17-1
    container_name: formbricks-cube
    restart: unless-stopped
    mem_limit: 512m
    cpus: 0.75
    environment:
      CUBEJS_DB_TYPE: postgres
      CUBEJS_DB_HOST: postgres
      CUBEJS_DB_NAME: formbricks
      CUBEJS_DB_USER: postgres
      CUBEJS_DB_PASS: ${POSTGRES_PASSWORD}
      CUBEJS_API_SECRET: ${CUBEJS_API_SECRET}
      CUBEJS_JWT_ISSUER: formbricks-web
      CUBEJS_JWT_AUDIENCE: formbricks-cube
      CUBEJS_DEFAULT_API_SCOPES: meta,data
      CUBEJS_CACHE_AND_QUEUE_DRIVER: memory
      CUBEJS_DB_QUERY_TIMEOUT: 60s
    volumes:
      - ./cube/cube.js:/cube/conf/cube.js:ro
      - ./cube/schema:/cube/conf/model:ro
    healthcheck:
      test: ["CMD", "node", "-e", "require('http').get('http://127.0.0.1:4000/readyz', (res) => { res.resume(); process.exit(res.statusCode === 200 ? 0 : 1); }).on('error', () => process.exit(1));"]
      interval: 10s
      timeout: 5s
      retries: 15
      start_period: 30s
    depends_on:
      hub-migrate:
        condition: service_completed_successfully
      postgres:
        condition: service_healthy
    networks:
      - fb_net

  # 12. Основное веб-приложение Formbricks Web
  formbricks:
    image: ghcr.io/formbricks/formbricks:v6.1.4
    container_name: formbricks-web
    restart: unless-stopped
    mem_limit: 1024m
    cpus: 1.5
    ports:
      # Публикация строго на 127.0.0.1: защита от прямого обхода UFW
      - "127.0.0.1:3000:3000"
    extra_hosts:
      # Маршрутизация к хостовым вебхукам и сервисам
      - "host.docker.internal:host-gateway"
    env_file: .env
    environment:
      SKIP_STARTUP_MIGRATION: "true"
    volumes:
      - ./uploads:/home/nextjs/apps/web/uploads
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
      cube:
        condition: service_healthy
      hub:
        condition: service_started
    healthcheck:
      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3000/health').then((r) => { if (!r.ok) process.exit(1) }).catch(() => process.exit(1))"]
      interval: 15s
      timeout: 5s
      retries: 5
      start_period: 40s
    networks:
      - fb_net

networks:
  fb_net:
    driver: bridge

💡 Совет инженера

Почему в v6 нельзя убрать Hub и Cube: В Formbricks v6 асинхронный воркер Hub Worker отвечает за обработку событий responseCreated и доставку вебхуков. Если в манифесте отсутствует Hub, формы смогут собирать ответы в базу, но вебхуки в Telegram/CRM и аналитические дашборды Cube.js работать не будут. Фиксация стабильного тега v6.1.4 защищает продакшен от неконтролируемых breaking changes при будущих релизах.

4. Настройка обратного прокси Nginx, Rate Limiting и выпуск SSL Let's Encrypt

Для приема внешнего трафика, эффективной отдачи статических ассетов виджета, терминации SSL-шифрования и защиты от спам-ботов настроим хостовый Nginx с ограничением частоты запросов (Rate Limiting). Ограничение на уровне reverse-proxy — штатное требование для публичных опросников.

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

# Установка веб-сервера Nginx и плагина Certbot
sudo apt install -y nginx certbot python3-certbot-nginx

Создадим конфигурационный файл виртуального хоста /etc/nginx/sites-available/surveys.conf с зонами ограничения частоты обращений:

# Зоны ограничения частоты запросов (защита от спама и DoS)
limit_req_zone $binary_remote_addr zone=fb_general:10m rate=30r/s;
limit_req_zone $binary_remote_addr zone=fb_api:10m rate=15r/s;

server {
    listen 80;
    server_name surveys.example.com;

    # Максимальный размер загружаемых файлов в формах (резюме, фото чеков)
    client_max_body_size 25M;

    # Публичные API-эндпоинты и прием ответов на опросы
    location /api/ {
        limit_req zone=fb_api burst=25 nodelay;

        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        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_read_timeout 90s;
    }

    # Основной интерфейс и статические ассеты виджета
    location / {
        limit_req zone=fb_general burst=50 nodelay;

        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        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_read_timeout 90s;
    }
}

Активируем конфигурацию, проверим синтаксис Nginx и выпустим бесплатный SSL-сертификат Let's Encrypt:

# Активация виртуального хоста
sudo ln -sf /etc/nginx/sites-available/surveys.conf /etc/nginx/sites-enabled/

# Проверка синтаксиса конфигурации Nginx
sudo nginx -t

# Перезапуск веб-сервера
sudo systemctl reload nginx

# Автоматический выпуск доверенного SSL-сертификата Let's Encrypt с автоматическим редиректом
sudo certbot --nginx -d surveys.example.com --non-interactive --agree-tos -m admin@example.com --redirect

Certbot автоматически добавит в конфигурационный файл защищенные TLS-директивы и настроит 301-редирект с HTTP на HTTPS. Для проверки корректности цепочки перенаправлений и валидности сертификата воспользуйтесь сетевыми утилитами Проверка редиректов и Проверка SSL-сертификата на SysKit.

5. Выбор надежного VDS под опросы и сбор клиентских данных

Сервер платформы опросов работает в режиме ожидания неравномерных всплесков посещаемости. Если ваша форма встроена в корзину интернет-магазина, прикреплена к email-рассылке на 50 000 подписчиков или опубликована в популярном Telegram-канале, на узел в течение нескольких минут обрушатся тысячи параллельных запросов. При выборе виртуального сервера под Formbricks v6 важно учитывать три ключевых инженерных параметра:

  • Быстрые NVMe-накопители с высокой скоростью произвольной записи: Фиксация ответов респондентов в PostgreSQL, обновление сессий в Valkey и сохранение прикрепленных файлов требуют минимальных задержек ввода-вывода (I/O). Высокоскоростные диски исключают очереди дисковых операций и зависание форм у клиентов.
  • Широкий сетевой канал и безлимитный трафик: Постоянная раздача скриптов виджета и прием ответов создают устойчивый входящий и исходящий трафик. Выбирайте провайдеров с честной пропускной способностью от 200 Мбит/с до 1 Гбит/с без скрытых ограничений по объему переданных гигабайт.
  • Соответствие требованиям 152-ФЗ и российская юрисдикция: Формы заявок, лид-магниты, анкеты кандидатов и опросы NPS практически всегда содержат имена, телефоны, email-адреса и комментарии клиентов. В соответствии с ч. 5 ст. 18 152-ФЗ базы данных с персональными данными граждан РФ обязаны первично размещаться на территории России. Размещение VDS в отечественных дата-центрах уровня Tier III гарантирует полное соответствие законодательству и защищает бизнес от крупных штрафов Роскомнадзора.

💡 Совет инженера

Для стабильной работы полного микросервисного стека Formbricks v6 (с аналитикой Cube.js, ReBAC-авторизацией SpiceDB и очередями Hub) минимально требуется VDS с 2 vCPU и 4 ГБ RAM (с добавлением 2 ГБ Swap). Для высоконагруженных проектов, масштабных email-рассылок и генерации тяжелых аналитических срезов рекомендуем конфигурацию с 4 vCPU, 8 ГБ RAM и автоматическим резервным копированием в российское S3-хранилище.

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

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

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

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

Высокоскоростные накопители NVMe и безлимитный трафик в дата-центрах РФ (Tier III) для мгновенной отдачи виджетов и соответствия 152-ФЗ.

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

Selectel — Корпоративная инфраструктура

Отказоустойчивые серверы в Москве и Санкт-Петербурге с гарантированной защитой персональных данных и мгновенной фиксацией транзакций PostgreSQL.

Конфигурация
4 vCPU 3.4 ГГц • 8 ГБ RAM • 80 ГБ NVMe • Канал до 1 Гбит/с
Легкий старт
🟠

Beget — Простота и стабильность

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

Конфигурация
2 vCPU 3.0 ГГц • 4 ГБ RAM • 50 ГБ NVMe • Посуточная оплата

6. Создание первого опроса: NPS, формы лидогенерации и интеграция с Tilda / WordPress

Запустим контейнеры стека через Docker Compose и проверим статус инициализации служб:

# Запуск всех компонентов платформы в фоновом режиме
docker compose up -d

# Проверка статуса работы всех микросервисов стека v6
docker compose ps

# Проверка готовности API и здоровья основного веб-сервиса
curl -fsS http://127.0.0.1:3000/health || echo "Ожидание запуска..."

# Просмотр журналов инициализации Formbricks Web и Hub
docker compose logs -f formbricks hub-worker

После старта контейнеров перейдите в браузере по адресу https://surveys.example.com. При первом посещении система предложит создать аккаунт суперадминистратора и задать название первой организации. В интерфейсе Formbricks доступно два фундаментальных формата взаимодействия с респондентами:

  • Автономные опросы по ссылке (Link Surveys): Каждая форма получает постоянный URL вида https://surveys.example.com/s/clx123.... Такие ссылки идеально подходят для отправки в Telegram-каналах, WhatsApp-рассылках или в письмах с подтверждением заказа через сервер рассылок Listmonk.
  • Встроенные виджеты для сайта (In-App / On-Site Surveys): Всплывающие модальные окна, аккуратные боковые слайдеры или опросные плашки, появляющиеся при определенных действиях пользователя (например, при попытке закрыть вкладку или после оформления покупки).

Для подключения Formbricks к любому сайту на Tilda, WordPress, 1C-Битрикс или кастомному SPA-приложению достаточно вставить в секцию <head> или перед закрывающим тегом </body> официальный пакет JS SDK:

<!-- Подключение официального виджета Formbricks на сайт -->
<script type="text/javascript">
  !function(){var t=document.createElement("script");t.type="text/javascript",t.async=!0,t.src="https://surveys.example.com/api/packages/website";var e=document.getElementsByTagName("script")[0];e.parentNode.insertBefore(t,e)}();
</script>
<script type="text/javascript">
  window.formbricks = window.formbricks || [];
  window.formbricks.init({
    environmentId: "clx_ваш_environment_id",
    apiHost: "https://surveys.example.com"
  });
</script>

Параметр environmentId берется во вкладке Configuration → Setup Checklist либо в настройках окружения проекта (Project Settings → Environments) в панели управления Formbricks. После внедрения кода вам больше не потребуется привлекать программистов для изменения опросов: все правила показа (задержка в секундах, глубина прокрутки страницы, показ только на определенных URL) настраиваются мышью в визуальном редакторе.

7. Настройка вебхуков: криптографическая проверка Standard Webhooks (HMAC-SHA256) и Telegram

Одной из ключевых болей при использовании опросников является запоздалая реакция на жалобы клиентов или горячие лиды. В Formbricks v6 асинхронный воркер Hub Worker при получении каждого ответа (событие responseCreated) генерирует защищенный вебхук по спецификации Standard Webhooks. Тело запроса подписывается секретным ключом с использованием криптографического алгоритма HMAC-SHA256.

Прием вебхуков на открытом сетевом порту без верификации подписи категорически недопустим: любой злоумышленник может направить поддельный POST-запрос и засорить ваш Telegram-чат фиктивными лидами. Создадим надежный микросервис-обработчик /opt/formbricks/telegram_webhook.py на стандартной библиотеке Python 3. Он валидирует заголовки webhook-id, webhook-timestamp и webhook-signature, защищает от replay-атак (проверяет свежесть метки времени) и форматирует ответы респондентов для Telegram:

# /opt/formbricks/telegram_webhook.py
from http.server import HTTPServer, BaseHTTPRequestHandler
import json
import urllib.request
import urllib.parse
import hmac
import hashlib
import base64
import time
import os

TELEGRAM_BOT_TOKEN = os.getenv("TELEGRAM_BOT_TOKEN", "YOUR_BOT_TOKEN")
TELEGRAM_CHAT_ID = os.getenv("TELEGRAM_CHAT_ID", "YOUR_CHAT_ID")
WEBHOOK_SECRET = os.getenv("WEBHOOK_SECRET", "whsec_your_secret_from_env")

def verify_standard_webhook(secret: str, msg_id: str, timestamp: str, body: bytes, signature_header: str) -> bool:
    """Верификация подписи Standard Webhooks (HMAC-SHA256) и защита от replay-атак."""
    if not secret or not msg_id or not timestamp or not signature_header:
        return False
    
    # 1. Защита от replay-атак: отклоняем запросы старше 5 минут (300 секунд)
    try:
        req_time = float(timestamp)
        if abs(time.time() - req_time) > 300:
            return False
    except ValueError:
        return False

    # 2. Подготовка секрета (отсекаем опциональный префикс whsec_ и декодируем base64 при наличии)
    raw_secret = secret.replace("whsec_", "")
    try:
        secret_bytes = base64.b64decode(raw_secret)
    except Exception:
        secret_bytes = secret.encode("utf-8")

    # 3. Вычисление ожидаемой подписи HMAC-SHA256: id.timestamp.body
    to_sign = f"{msg_id}.{timestamp}.".encode("utf-8") + body
    expected_digest = hmac.new(secret_bytes, to_sign, hashlib.sha256).digest()
    expected_b64 = base64.b64encode(expected_digest).decode("utf-8")

    # 4. Сверка с сигнатурами из заголовка (формат: "v1,signature" или набор пробельных записей)
    signatures = []
    for part in signature_header.split():
        if "," in part:
            scheme, sig = part.split(",", 1)
            if scheme == "v1":
                signatures.append(sig)
        else:
            signatures.append(part)

    return any(hmac.compare_digest(expected_b64, s) for s in signatures)

class WebhookHandler(BaseHTTPRequestHandler):
    def do_POST(self):
        content_length = int(self.headers.get('Content-Length', 0))
        body = self.rfile.read(content_length)

        msg_id = self.headers.get("webhook-id", "")
        timestamp = self.headers.get("webhook-timestamp", "")
        signature = self.headers.get("webhook-signature", "")

        # Проверка криптографической подписи Standard Webhooks
        if not verify_standard_webhook(WEBHOOK_SECRET, msg_id, timestamp, body, signature):
            self.send_response(401)
            self.send_header("Content-Type", "application/json")
            self.end_headers()
            self.wfile.write(b'{"error": "Invalid webhook signature"}')
            print(f"[SECURITY] Отклонен запрос с невалидной подписью (ID: {msg_id})")
            return

        try:
            data = json.loads(body.decode('utf-8'))
        except Exception:
            self.send_response(400)
            self.end_headers()
            return

        # Извлечение названия опроса и ответов респондента
        survey_name = data.get("data", {}).get("survey", {}).get("name", "Опрос")
        response_data = data.get("data", {}).get("data", {})
        
        # Формирование читаемого отчета для Telegram
        text_lines = [f"📋 *Новый ответ в опросе: {survey_name}*"]
        for key, answer in response_data.items():
            label = key.replace("_", " ").capitalize()
            text_lines.append(f"• *{label}:* {answer}")
        
        message = "\n".join(text_lines)
        
        # Отправка в Telegram Bot API
        telegram_url = f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage"
        payload = urllib.parse.urlencode({
            "chat_id": TELEGRAM_CHAT_ID,
            "text": message,
            "parse_mode": "Markdown"
        }).encode('utf-8')
        
        req = urllib.request.Request(telegram_url, data=payload, method="POST")
        try:
            urllib.request.urlopen(req, timeout=5)
        except Exception as e:
            print(f"Ошибка отправки в Telegram: {e}")

        self.send_response(200)
        self.end_headers()
        self.wfile.write(b'{"status": "ok"}')

if __name__ == "__main__":
    # Слушаем все сетевые интерфейсы на порту 9005
    server = HTTPServer(('0.0.0.0', 9005), WebhookHandler)
    print("Telegram Webhook Receiver запущен на порту 9005 с проверкой HMAC-SHA256...")
    server.serve_forever()

В веб-панели Formbricks перейдите в Configuration → Webhooks → Add Webhook. Поскольку сервис Hub Worker изолирован во внутренней мостовой сети Docker, для обращения к локальному сервису на хосте укажите адрес http://host.docker.internal:9005 (это имя маршрутизируется директивой extra_hosts из нашего docker-compose.yml). В поле секретного ключа укажите значение WEBHOOK_SECRET из вашего файла .env и выберите событие Response Created.

💡 Совет инженера

При настройке NPS-опросов (шкала от 0 до 10) используйте логическое ветвление: если клиент ставит оценку от 0 до 6 (критики), Formbricks может автоматически открыть вопрос «Что нам нужно исправить, чтобы стать лучше?» и отправить тревожный алерт в Telegram. Если оценка 9 или 10 (промоутеры) — предложить оставить публичный отзыв на картах или подарить промокод на следующий заказ.

8. Автоматическое резервное копирование баз данных PostgreSQL, SpiceDB и медиафайлов в S3

В архитектуре Formbricks v6 данные разделены между двумя базами: основная база formbricks хранит формы и ответы, а база spicedb — граф прав и ролей доступа. Загруженные респондентами файлы (фотографии чеков, резюме, сканы) сохраняются в томе /opt/formbricks/uploads. Для создания надежного и консистентного резервного копирования без прерывания обслуживания пользователей используем горячий дамп pg_dump в сжатом бинарном формате -Fc.

Создадим производственный Bash-скрипт /opt/formbricks/backup/backup.sh:

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

# Загрузка чувствительных переменных окружения проекта
if [[ -f /opt/formbricks/.env ]]; then
    set -a
    source /opt/formbricks/.env
    set +a
fi

BACKUP_DIR="/opt/formbricks/backup"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
DB_BACKUP_FILE="${BACKUP_DIR}/formbricks_db_${TIMESTAMP}.dump"
SPICEDB_BACKUP_FILE="${BACKUP_DIR}/spicedb_${TIMESTAMP}.dump"
UPLOADS_BACKUP_FILE="${BACKUP_DIR}/formbricks_uploads_${TIMESTAMP}.tar.gz"

# Параметры оповещений в Telegram (опционально)
TELEGRAM_BOT_TOKEN="${TELEGRAM_BOT_TOKEN:-}"
TELEGRAM_CHAT_ID="${TELEGRAM_CHAT_ID:-}"

# Параметры совместимого российского S3-хранилища (Timeweb Cloud, Selectel)
S3_ENDPOINT="${S3_ENDPOINT:-https://s3.timeweb.cloud}"
S3_BUCKET="${S3_BUCKET:-my-formbricks-backups}"

send_telegram() {
    local message="$1"
    if [[ -n "${TELEGRAM_BOT_TOKEN}" && -n "${TELEGRAM_CHAT_ID}" ]]; then
        curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
            --data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
            --data-urlencode "text=${message}" > /dev/null || true
    fi
}

echo "=== Запуск резервного копирования Formbricks: ${TIMESTAMP} ==="

# 1. Создание горячих консистентных дампов баз Formbricks и SpiceDB
echo "Создание дампа базы данных Formbricks..."
docker exec formbricks-db pg_dump -U postgres -d formbricks -Fc > "${DB_BACKUP_FILE}"

echo "Создание дампа базы данных SpiceDB..."
docker exec formbricks-db pg_dump -U postgres -d spicedb -Fc > "${SPICEDB_BACKUP_FILE}"

# 2. Создание архива пользовательских загрузок
echo "Архивация пользовательских загрузок..."
tar -czf "${UPLOADS_BACKUP_FILE}" -C "/opt/formbricks" uploads

chmod 600 "${DB_BACKUP_FILE}" "${SPICEDB_BACKUP_FILE}" "${UPLOADS_BACKUP_FILE}"

DB_SIZE=$(du -sh "${DB_BACKUP_FILE}" | cut -f1)
SPICE_SIZE=$(du -sh "${SPICEDB_BACKUP_FILE}" | cut -f1)
UPLOADS_SIZE=$(du -sh "${UPLOADS_BACKUP_FILE}" | cut -f1)

# 3. Выгрузка резервных копий в холодное S3-хранилище (при наличии awscli)
if command -v aws &> /dev/null && [[ -n "${S3_BUCKET}" ]]; then
    echo "Отправка архивов в S3: ${S3_BUCKET}..."
    aws --endpoint-url="${S3_ENDPOINT}" s3 cp "${DB_BACKUP_FILE}" "s3://${S3_BUCKET}/formbricks/db/$(basename "${DB_BACKUP_FILE}")"
    aws --endpoint-url="${S3_ENDPOINT}" s3 cp "${SPICEDB_BACKUP_FILE}" "s3://${S3_BUCKET}/formbricks/db/$(basename "${SPICEDB_BACKUP_FILE}")"
    aws --endpoint-url="${S3_ENDPOINT}" s3 cp "${UPLOADS_BACKUP_FILE}" "s3://${S3_BUCKET}/formbricks/uploads/$(basename "${UPLOADS_BACKUP_FILE}")"
fi

# 4. Локальная ротация архивов (хранение дампов за последние 7 дней)
find "${BACKUP_DIR}" -type f -name "formbricks_db_*.dump" -mtime +7 -delete
find "${BACKUP_DIR}" -type f -name "spicedb_*.dump" -mtime +7 -delete
find "${BACKUP_DIR}" -type f -name "formbricks_uploads_*.tar.gz" -mtime +7 -delete

echo "Резервное копирование завершено успешно."

# 5. Отправка отчета в Telegram
MESSAGE="✅ Formbricks Backup Успешно
Сервер: surveys.example.com
Дамп Formbricks: $(basename "${DB_BACKUP_FILE}") (${DB_SIZE})
Дамп SpiceDB: $(basename "${SPICEDB_BACKUP_FILE}") (${SPICE_SIZE})
Файлы: $(basename "${UPLOADS_BACKUP_FILE}") (${UPLOADS_SIZE})
Хранилище: S3 (${S3_BUCKET})
Дата: $(date '+%Y-%m-%d %H:%M:%S')"

send_telegram "${MESSAGE}"

Назначим безопасные права на скрипт и настроим его регулярный запуск по расписанию в crontab:

# Назначение прав на исполнение скрипта
chmod 750 /opt/formbricks/backup/backup.sh

# Добавление задачи в планировщик cron (запуск каждую ночь в 03:30)
(crontab -l 2>/dev/null; echo "30 3 * * * /opt/formbricks/backup/backup.sh >> /opt/formbricks/logs/backup.log 2>&1") | crontab -

Для создания гибких расписаний воспользуйтесь утилитой генератора выражений Crontab на SysKit, а также шаблоном резервного копирования томов Docker.

9. Инженерный чек-лист проверки и ввод в эксплуатацию

Перед запуском масштабного сбора ответов и интеграцией опросов на боевой сайт убедитесь в готовности критических узлов инфраструктуры:

📋 Чек-лист готовности Formbricks к production

  • Статус микросервисов: Все службы стека v6 (Web, Hub, Hub-Worker, Cube, SpiceDB, PostgreSQL, Valkey) находятся в статусе Up (healthy) по команде docker compose ps.
  • Проверка здоровья: Запрос к официальному эндпоинту curl -fsS http://127.0.0.1:3000/health возвращает положительный статус.
  • Сетевая безопасность и Rate Limiting: Порт 3000 слушает строго 127.0.0.1, в Nginx настроены зоны ограничения частоты запросов для защиты от спам-ботов, а порты БД 5432 и 6379 закрыты в UFW.
  • Защита шифрования: Переменная ENCRYPTION_KEY содержит ровно 64 hex-символа, права на файл .env ограничены до 600.
  • Корректность SSL: Проверьте отсутствие предупреждений безопасности и актуальность сертификата через SSL Checker.
  • Безопасность вебхуков: Обработчик Telegram валидирует подпись Standard Webhooks (HMAC-SHA256) и отсекает запросы с устаревшим timestamp.
  • Тестовый Link Survey: Создайте тестовый опрос, перейдите по прямой ссылке, отправьте пробный ответ и убедитесь в его фиксации в дашборде.
  • Тест встраивания виджета: Проверьте корректное открытие формы на тестовой странице без ошибок в консоли браузера (отсутствие блокировок CORS).
  • Проверка бэкапа: Запустите backup.sh вручную и удостоверьтесь в создании дампов баз formbricks, spicedb и архива файлов.

Запустите независимую платформу опросов на надежном VDS

Собирайте отзывы клиентов, проводите NPS-опросы и привлекайте лидов с соблюдением требований 152-ФЗ на проверенных виртуальных серверах с быстрыми накопителями NVMe и каналом связи до 1 Гбит/с в дата-центрах РФ.

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

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

Как Formbricks помогает соблюдать требования Федерального закона № 152-ФЗ?
Formbricks разворачивается на вашем собственном VDS, размещенном в российском дата-центре (Timeweb Cloud, Selectel или Beget). Все собираемые персональные данные (ФИО, номера телефонов, адреса почты, комментарии и NPS) хранятся исключительно в вашей базе данных PostgreSQL на территории РФ с шифрованием AES-256, без трансграничной передачи на серверы в США или ЕС, что полностью исключает риски штрафов Роскомнадзора.
Можно ли встроить опрос Formbricks на сайт без перезагрузки страниц и с сохранением дизайна?
Да, Formbricks предоставляет легковесный нативный JS SDK (менее 15 КБ). Виджет подключается одной строчкой кода и может отображаться как всплывающее модальное окно, ненавязчивый боковой слайдер или встроенный блок прямо в разметке страницы. Вы можете полностью отключить любые логотипы Formbricks и кастомизировать фирменные цвета, шрифты и скругления под дизайн вашего сайта.
Зачем в Formbricks v6 нужны Hub, Cube и SpiceDB и можно ли их отключить?
В архитектуре Formbricks v6 задачи строго распределены между микросервисами: сервис Hub и воркер Hub-Worker обрабатывают входящие события и асинхронную доставку вебхуков, аналитический движок Cube.js рассчитывает агрегированные метрики NPS и конверсий, а SpiceDB обеспечивает гранулярное разграничение доступа (ReBAC). Без них платформа не сможет формировать аналитику и доставлять вебхуки интеграций. Для одновременного запуска всех служб требуется от 4 ГБ RAM.
Что делать, если при первом запуске контейнер Formbricks падает с ошибкой шифрования или переменных окружения?
Ключевая причина сбоя — неверная длина переменной ENCRYPTION_KEY в файле .env. Для алгоритма AES-256 ключ обязан содержать ровно 64 hex-символа (32 байта, генерируется командой openssl rand -hex 32). Также проверьте наличие всех сгенерированных секретов (BETTER_AUTH_SECRET, HUB_API_KEY, CUBEJS_API_SECRET, AUTHZED_TOKEN, AUTHZED_DATABASE_PASSWORD) и корректность загрузки конфигураций Cube и скрипта bootstrap SpiceDB.

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

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