Налаштування Prerendering для SPA-сайтів (Prerender.io)

Налаштування Prerendering для SPA-сайтів (Prerender.io)

Prerender.io — SaaS-сервіс для попередньо рендерингу SPA-сторінок. Автоматично обнаруживає пошукових ботів і відправляє їм повністю відрендерений HTML замість пустого index.html.

Як це працює

1. Бот запитує /products/42
2. nginx перехоплює запит та проксирує на prerender.io
3. Prerender.io рендерить сторінку в headless Chrome
4. Повертає готовий HTML боту

Користувачі отримують звичайний SPA без змін.

Налаштування Nginx

map $http_user_agent $prerender_ua {
    ~*(Googlebot|AdsBot-Google|Googlebot-Image|Bingbot|Slurp|
       DuckDuckBot|Baiduspider|YandexBot|LinkedInBot|
       facebookexternalhit|Twitterbot|WhatsApp|TelegramBot)  "1";
    default "0";
}

server {
    listen 443 ssl;
    server_name company.com;

    location / {
        if ($prerender_ua = "1") {
            rewrite .* /$scheme://$host$request_uri? break;
            proxy_pass https://service.prerender.io;
            proxy_set_header X-Prerender-Token "YOUR_API_TOKEN";
            proxy_set_header X-Prerender-Host $host;
            proxy_connect_timeout 5s;
            proxy_read_timeout 60s;
        }

        try_files $uri /index.html;
    }
}

Налаштування Middleware (Express/Node.js)

const prerender = require('prerender-node')

prerender.set('prerenderToken', process.env.PRERENDER_TOKEN)
prerender.set('prerenderServiceUrl', 'https://service.prerender.io/')

// Опціональні налаштування
prerender.crawlerUserAgents.push('TelegramBot', 'WhatsApp')
prerender.set('blacklistPaths', ['/admin', '/dashboard', '/api'])

app.use(prerender)

Кешування через Prerender.io

Сервіс кешує сторінки автоматично. Керування через дашборд або API:

# Очистити конкретний URL
curl -X POST https://api.prerender.io/recache \
  -H "Content-Type: application/json" \
  -d '{"prerenderToken": "YOUR_TOKEN", "url": "https://company.com/product/42"}'

# Рекешувати при деплої (список змінених URL)
CHANGED_URLS=$(git diff HEAD~1 --name-only | grep "pages/" | ...)
for url in $CHANGED_URLS; do
  curl -X POST https://api.prerender.io/recache \
    -d "{\"prerenderToken\": \"$TOKEN\", \"url\": \"https://company.com/$url\"}"
done

Sitemap-based Precache

import requests
import xml.etree.ElementTree as ET

def precache_sitemap(sitemap_url, prerender_token):
    response = requests.get(sitemap_url)
    root = ET.fromstring(response.content)
    ns = {'sm': 'http://www.sitemaps.org/schemas/sitemap/0.9'}

    urls = [loc.text for loc in root.findall('.//sm:loc', ns)]
    print(f"Precaching {len(urls)} URLs...")

    for url in urls:
        requests.post('https://api.prerender.io/recache',
                     json={'prerenderToken': prerender_token, 'url': url})

precache_sitemap('https://company.com/sitemap.xml', os.environ['PRERENDER_TOKEN'])

Перевірка

# Запит як Googlebot
curl -A "Googlebot/2.1 (+http://www.google.com/bot.html)" \
  https://company.com/products/iphone-15 | \
  grep -o '<title>[^<]*</title>'

# Повинен повернути реальний title, не "React App" або пусту строку

Chrome DevTools → Network → Disable JS → перезагрузити — якщо контент видимий без JS, prerendering коректно працює для ботів.

Обмеження Prerender.io

• Платний від $9/мес, ліміти на кількість рендерів
• Затримка першого рендера (холодний старт)
• Не підходить для персоналізованих сторінок (контент залежить від користувача)
• Рендеринг без cookies користувача

Тривалість

Налаштування Prerender.io з nginx middleware та precache — 0,5–1 робочий день.