Вимоги та підготовка

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). Інсталятор запитає ключ насамперед і без активної ліцензії нічого не встановить - див. «Встановлення».

Готові?

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