Деплой PWA на shared hosting
Не Vercel, не Netlify — обычный shared hosting с PHP. PWA-приложение здесь работает, есть нюансы.
Инструкции по деплою PWA обычно начинаются со слов «подключите репозиторий к Vercel». Но далеко не каждому проекту нужна такая платформа, а в России обычный хостинг с PHP и Apache по-прежнему очень распространён. Хорошая новость: PWA там работает. PWA — это по сути статические файлы, манифест и service worker. Плохая: несколько вещей придётся настроить руками, иначе приложение не установится или пользователи будут неделями видеть старую версию.
Что обязательно настроить
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.
Как выкатывать обновления
- Соберите проект с хэшами в именах файлов.
- Загрузите на хостинг новые файлы статики, не удаляя старые: у части пользователей ещё открыта прежняя версия.
- Последними загрузите
index.htmlиsw.jsс новой версией кэша. - Через несколько дней удалите старые файлы.
Загружать удобнее через 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, проверим, хватит ли его.