Сбор обратной связи, проведение 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-ФЗ.
Selectel — Корпоративная инфраструктура
Отказоустойчивые серверы в Москве и Санкт-Петербурге с гарантированной защитой персональных данных и мгновенной фиксацией транзакций PostgreSQL.
Beget — Простота и стабильность
Удобная панель управления, автоматическая настройка фаервола и быстрая установка Docker в 1 клик для малого бизнеса и интернет-магазинов.
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 Гбит/с в дата-центрах РФ.