Требования и подготовка

PWA Hub разворачивается на вашем собственном сервере. Перед запуском установщика подготовьте несколько вещей - чистый сервер и пару аккаунтов у внешних сервисов. Это займёт 15-30 минут, зато сама установка пройдёт гладко и без сюрпризов.

Что понадобится - чек-лист

• ✅ Чистый VPS (Ubuntu или Debian) - совершенно пустой сервер.
• ✅ Домен - например, зарегистрированный в Namecheap.
• ✅ Аккаунт Cloudflare - для DNS и SSL.
• ✅ Аккаунт Namecheap - для регистрации и управления доменами.
• ✅ Аккаунт фильтра (Adspect, TrafficArmor или FraudFilter) - антибот-защита трафика.
• ✅ Лицензионный ключ PWA Hub - от вендора.

Разберём каждый пункт.

1. Сервер (VPS)

Только чистый сервер

PWA Hub нужен совершенно пустой сервер - без других сайтов, панелей и запущенных сервисов. Порты 80 и 443 должны быть полностью свободны. На сервере, где уже что-то работает, установка будет конфликтовать. Берите свежую, только что созданную машину.

Обязательные требования (их проверяет установщик - при несоответствии он остановится):

• ОС: Ubuntu 20.04 или новее, либо Debian 12, 13.
• Архитектура: x86_64 или aarch64.
• Процессор: от 2 vCPU.
• RAM: от 4 ГБ.
• Диск: от 20 ГБ свободного места.
• Доступ: root (запуск через sudo).
• Порты: свободные 80 и 443 (веб-сервер).

Рекомендуемые ресурсы по тарифу. PWA Hub - это полноценный стек (база данных, аналитика, очередь событий, кэш, вебсокеты, рендеринг витрин и антибот-фильтр), поэтому даже на младшем тарифе берите VPS с запасом. Ориентир под тарифы PWA Hub:

Тариф	Мест	Домены	vCPU	RAM	Диск (NVMe SSD)
Free	1	1	2	4 ГБ	20 ГБ
Solo	1	5	4	8 ГБ	40 ГБ
Team	5	50	6	16 ГБ	80 ГБ
Agency	10	200	8	32 ГБ	160 ГБ

Трафик безлимитный на всех тарифах

Тариф ограничивает места и домены, но не трафик - визиты не лимитируются нигде. Поэтому цифры выше - стартовый ориентир, а не потолок. Реальную потребность задаёт пиковый трафик (визиты в секунду) и объём аналитики: льёте много - поднимайте в первую очередь vCPU и диск, независимо от тарифа.

Что на что влияет:

• RAM - база и аналитика держат данные и индексы в памяти; её нехватка бьёт по скорости сильнее всего. Меньше 8 ГБ не берите даже на Solo.
• CPU - рендеринг витрин и антибот-проверка каждого захода; добавляйте vCPU, когда загрузка стабильно выше 70-80%.
• Диск - только NVMe/SSD - визиты и конверсии хранятся целиком, поэтому он растёт со временем. История хорошо сжимается, так что гигабайты копятся не быстро, но держите свободным хотя бы 30% и расширяйте по мере роста.

Расширяться просто

Начните со стартового ориентира и добавляйте ресурсы, когда CPU/RAM стабильно в потолке или растёт задержка. Вертикальное расширение (добавить vCPU/RAM/диск у провайдера) обычно занимает пару минут и один перезапуск.

Где взять VPS

Подойдёт любой провайдер VPS (Hetzner, DigitalOcean, Vultr и т. п.). При создании выбирайте чистый образ Ubuntu или Debian - без предустановленных панелей и веб-серверов.

2. Домен

Нужен домен, на котором будет работать система. Панель управления живёт на хосте, который вы выберете при активации лицензии: поддомен вроде admin.<ваш-домен> или отдельный домен. Домен можно зарегистрировать в Namecheap (см. ниже) или у любого другого регистратора - главное, чтобы вы могли управлять его DNS через Cloudflare.

3. Аккаунт Cloudflare

Cloudflare отвечает за DNS ваших доменов и за шифрование трафика. Достаточно бесплатного тарифа.

• Зарегистрируйтесь на cloudflare.com.
• Позже создадите API Token с правами на зоны и DNS - его вы введёте в панели, и система будет сама управлять записями доменов.
• Режим шифрования нужно будет выставить SSL/TLS = Full.

Подробный порядок настройки - в разделе «Домены и Cloudflare».

4. Аккаунт Namecheap

Namecheap используется для регистрации и управления доменами прямо из панели. Понадобится аккаунт с включённым API-доступом:

• API Key и API User - в разделе API вашего профиля Namecheap.
• Whitelist IP - в настройках API нужно добавить IP вашего сервера (без этого запросы не пройдут).

TIP

API-доступ в Namecheap включается по запросу и при выполнении их условий (например, минимальный баланс/количество доменов). Оформите его заранее, чтобы не ждать на этапе настройки.

5. Аккаунт фильтра (антибот)

PWA Hub прогоняет каждого посетителя через антибот-фильтр: реальный человек видит ваше приложение (PWA), а бот - «белую» страницу. Для этого нужен аккаунт у сервиса фильтрации.

• Подходит Adspect, TrafficArmor или FraudFilter. Заведите аккаунт в одном из них и возьмите ключ доступа - его вы введёте в панели в разделе фильтр-аккаунтов. Какой ключ нужен каждому сервису - в разделе «Аккаунты фильтрации».

Без фильтра трафик блокируется

Пока фильтр не настроен, система по умолчанию считает всех посетителей ботами (fail-closed) и показывает «белую» страницу. Это защита: так «сырой» трафик случайно не попадёт на ваше предложение.

6. Лицензионный ключ

Для работы PWA Hub нужен лицензионный ключ. Получите его у вендора (сервис лицензий - pwahub.org). Установщик спросит ключ первым делом и без активной лицензии ничего не поставит - см. «Установка».

Готовы?

Когда чистый сервер поднят, а аккаунты созданы - переходите к разделу «Установка». Всё разворачивается одной командой.