Пользователь заходит на международный сайт, и первая же секунда решает многое. Увидит ли он свой язык сразу или будет искать переключатель вручную. Делать это на клиенте — значит сначала отдать общую версию страницы. А потом переключить её через JavaScript, с заметным миганием интерфейса. Geoip nextjs middleware решает эту задачу иначе. Редирект происходит до того, как страница вообще дойдёт до браузера.
В прошлой статье мы разбирали GeoIP в GovTech. Сегодня вернёмся к инженерной части и разберём конкретный технический паттерн — middleware в Next.js.
Что такое middleware в Next.js
Связующее программное обеспечение — общий термин для слоя, который обрабатывает запрос между его получением и передачей дальше по цепочке. В Next.js middleware — это код, который выполняется до рендеринга страницы, на edge-рантайме, максимально близко к пользователю.
Middleware идеально подходит для geoip-логики именно потому, что выполняется раньше основного рендеринга. Решение о редиректе или подстановке региона принимается до того, как приложение начнёт собирать саму страницу.
Геолокационные редиректы без лишней задержки
Классический сценарий — редирект на локализованную версию сайта по региону пользователя. Middleware получает IP-адрес из заголовков входящего запроса, обращается к geoip-сервису. И на основе ответа решает, куда направить пользователя. Например, на региональный поддомен или на нужную языковую версию пути.
Поскольку это происходит на edge-уровне, до полноценного серверного рендеринга, задержка минимальна. Пользователь не видит промежуточного состояния — сразу получает нужную версию страницы.
Реализация i18n-роутинга
Next.js поддерживает встроенный роутинг для мультиязычных сайтов. Но по умолчанию он не решает вопрос, какой язык выбрать для нового посетителя. Middleware закрывает именно этот пробел. Определяет регион по geoip и сразу перенаправляет на соответствующий языковой путь. Вместо показа страницы выбора языка при каждом первом визите.
Такой подход снижает трение для пользователя. Но стоит оставлять и ручной переключатель языка — geoip определяет вероятный язык, а не подтверждённое предпочтение человека.
Работа с cookies для повторных визитов
Хорошая практика — не запрашивать geoip на каждый запрос повторно, а сохранять решение в cookie после первого визита. Middleware сначала проверяет наличие такой cookie, и только при её отсутствии обращается к geoip-сервису. Это снижает количество вызовов API и ускоряет обработку последующих визитов того же пользователя.
Если пользователь вручную сменил язык или регион через интерфейс, это решение тоже стоит сохранить в cookie с более высоким приоритетом, чем автоматическое определение по IP.
Ограничения edge-рантайма
У edge-рантайма Next.js есть ограничения по сравнению с обычным Node.js окружением — доступен не весь стандартный набор библиотек, а размер middleware ограничен по объёму кода. Поэтому вызов geoip API из middleware стоит делать через простой fetch-запрос без тяжёлых зависимостей, а не пытаться встроить полноценную локальную базу данных прямо в middleware-код.
Как подключить geoip к middleware
Вызов из middleware ничем принципиально не отличается от обычного серверного запроса — тот же fetch к API с секретным ключом на стороне сервера. Модуль GeoIP от WildX отдаёт страну и регион в лёгком JSON-ответе, что хорошо ложится на ограничения edge-окружения по объёму зависимостей.
Итог
Geoip nextjs middleware даёт быстрый и незаметный для пользователя способ локализации: редирект и определение языка происходят до рендеринга страницы, без визуального мигания интерфейса. Комбинация с cookie для повторных визитов и уважение ручного выбора пользователя делают такую схему устойчивой в реальном проекте.
Проверить интеграцию с вашим Next.js проектом можно бесплатно. Подключите модуль GeoIP от WildX — сразу после регистрации активируется тестовый период на 14 дней. Во время теста доступен весь функционал сервиса с минимальными ограничениями, поэтому вы успеете протестировать middleware на реальном трафике.
