Деплой PWA на shared hosting

Не Vercel, не Netlify — обычный shared hosting с PHP. PWA-приложение здесь работает, есть нюансы.

Деплой PWA на shared hosting

Инструкции по деплою PWA обычно начинаются со слов «подключите репозиторий к Vercel». Но далеко не каждому проекту нужна такая платформа, а в России обычный хостинг с PHP и Apache по-прежнему очень распространён. Хорошая новость: PWA там работает. PWA — это по сути статические файлы, манифест и service worker. Плохая: несколько вещей придётся настроить руками, иначе приложение не установится или пользователи будут неделями видеть старую версию.

Деплой PWA на shared hosting
Что нужно настроить на обычном shared hosting для PWA.

Что обязательно настроить

HTTPS. Service worker регистрируется только на защищённом соединении (исключение — localhost при разработке). Большинство хостингов выпускают бесплатный сертификат Let's Encrypt из панели. Проверьте, что включён редирект с http на https и сертификат продлевается автоматически.

MIME-типы. Старые конфигурации Apache могут не знать новых расширений. Добавьте в .htaccess:

AddType application/manifest+json .webmanifest
AddType font/woff2 .woff2
AddType application/wasm .wasm

Кэш-заголовки. Это самое важное для PWA. Статика с хэшем в имени файла (app.3f9a1c.js) кэшируется надолго, на год, с immutable. А вот index.html, манифест и сам sw.js должны отдаваться с Cache-Control: no-cache, чтобы браузер каждый раз проверял, не появилась ли новая версия:

<FilesMatch "\.(js|css|woff2|png|webp|svg)$">
  Header set Cache-Control "public, max-age=31536000, immutable"
</FilesMatch>
<FilesMatch "(index\.html|sw\.js|\.webmanifest)$">
  Header set Cache-Control "no-cache"
</FilesMatch>

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

Область действия service worker. По умолчанию SW управляет только той папкой, где лежит, и вложенными. Положите sw.js в корень сайта, если приложение должно работать на всех адресах. Расширить область из подпапки можно заголовком Service-Worker-Allowed, но проще не усложнять.

Манифест и иконки. В манифесте нужны name, short_name, start_url, display и иконки хотя бы 192 и 512 пикселей. Для iOS дополнительно добавьте apple-touch-icon в <head>.

Маршрутизация SPA. Если приложение одностраничное, все адреса, кроме реальных файлов, должны отдавать index.html. В Apache это одна строка FallbackResource /index.html или правило mod_rewrite. Без этого обновление страницы на внутреннем адресе даст 404.

Как выкатывать обновления

  1. Соберите проект с хэшами в именах файлов.
  2. Загрузите на хостинг новые файлы статики, не удаляя старые: у части пользователей ещё открыта прежняя версия.
  3. Последними загрузите index.html и sw.js с новой версией кэша.
  4. Через несколько дней удалите старые файлы.

Загружать удобнее через SFTP и rsync, а не перетаскиванием в файловом менеджере: так не забудете файл и не оставите сайт наполовину обновлённым. В самом приложении стоит показывать пользователю «Доступна новая версия — обновить», когда новый SW установлен. Какие стратегии кэширования выбрать для разных ресурсов, подробно разбирали в статье про стратегии service worker.

Что работает с оговорками

Push-уведомления. Нужен сервер, который хранит подписки и отправляет уведомления по протоколу Web Push с ключами VAPID. На PHP это делается готовой библиотекой, но проверьте, что хостинг даёт нужные расширения PHP для шифрования и позволяет запускать задачи по cron для рассылки. На iOS web push работает только для PWA, установленного на главный экран.

Background Sync. Это возможность браузера, а не сервера: отложенная отправка данных, когда появится сеть. Поддерживается не во всех браузерах, в Safari и Firefox её нет. Поэтому рассчитывайте на неё как на улучшение и держите запасной вариант: очередь в IndexedDB и повторную отправку при следующем открытии.

Тяжёлые фоновые задачи на сервере. На shared-хостинге обычно ограничены время выполнения скриптов, количество процессов и частота cron. Для WebSocket и долгих соединений он не подходит — тут нужен VPS.

Когда shared hosting уже мало

Например, PWA-каталог небольшого магазина с несколькими тысячами посетителей в день спокойно живёт на недорогом хостинге: основная нагрузка — статика, которую после первого визита отдаёт кэш service worker. Переезжать на VPS стоит, если нужны real-time-функции, очереди, свои фоновые процессы или сервер начинает упираться в лимиты тарифа.

Чек-лист перед запуском

  • HTTPS и редирект с http настроены.
  • Манифест отдаётся с правильным MIME-типом, иконки на месте.
  • Lighthouse не показывает ошибок в разделе установки PWA.
  • sw.js и index.html не кэшируются надолго.
  • Обновление проверено: выкатили новую версию — открытое приложение её подхватило.
  • Офлайн-режим проверен в DevTools с отключённой сетью.

Делаем такие приложения в рамках услуги PWA-приложение, а для уже работающих проектов есть поддержка веб-приложений.

Хотите запустить PWA на своём хостинге — напишите в Telegram или MAX, проверим, хватит ли его.

PWA-приложение
Услуга по теме — обсудим ваш проект.
Бесплатный инструмент
DNS-записи домена
Все записи с пояснениями, кто обслуживает DNS и почту, есть ли SPF и DMARC.

Есть задача по теме? Напишите — вернёмся с оценкой и сроками.

Написать в Telegram → Написать в MAX