WordPressEscape

Главная / Руководство

Workbench

Перенос 528 854 страниц WordPress на Hugo: инженерные заметки

Это рабочие заметки по переносу Unlimited Charters - нашего внутреннего дочернего сайта - с WordPress на Hugo в мае 2026 года. Обзор для бизнеса опубликован в кейсе; здесь - информация для тех, кому предстоит выполнить такую работу: что пошло не так на полумиллионе страниц, какие команды подвели нас и какие проверки мы теперь запускаем для каждого сайта - большого или маленького.

Чтение: 14 мин. Разделов: 9 Создано для высоких позиций
На этой странице
  1. Контекст
  2. Инвентаризация шаблонов до переноса контента
  3. Разбиение сборки и ловушки файловой системы
  4. Исправления производительности: изменение шаблона плюс обработка всего корпуса страниц
  5. Настройки Cloudflare, которые имели значение
  6. Schema-разметка и детали SEO
  7. Лиды - это то, что нельзя потерять
  8. Что мы сделали бы иначе
  9. Источники и дополнительная информация
  10. Часто задаваемые вопросы
Краткий ответ

На таком масштабе проблемы связаны скорее с файловой системой и процессами, чем с Hugo: нужно разбивать сборку на части, хранить отложенный контент за пределами точки монтирования контента Hugo, никогда не запускать два процесса переноса для одной директории и рассматривать каждое исправление как изменение шаблона плюс скриптовую обработку всего корпуса страниц. Наибольший прирост производительности дали размеры изображений, синхронная загрузка критического CSS, отключение lazy-загрузки изображения LCP, отложенная загрузка виджета расчёта стоимости с зарезервированным местом и отключение Cloudflare Email Obfuscation.

01

Контекст

Unlimited Charters принадлежит той же группе, что и WordPressEscape; это была наша собственная тестовая миграция, выполненная с полным доступом к серверу. На сайте было чуть больше полумиллиона URL - преимущественно шаблонные страницы локаций, а также хабы, страницы флота и блог. Целью была сборка Hugo со статическими файлами за Cloudflare, при этом все существующие пути должны были сохраниться.

02

Инвентаризация шаблонов до переноса контента

Сначала мы сгруппировали URL по шаблону WordPress, который их формировал, а не по структуре URL. Для каждого семейства принималось одно решение: пересобрать его как layout Hugo или пока отдавать статический снимок результата работы WordPress. Пересборка самых посещаемых семейств в первую очередь и создание снимков для нестандартных страниц позволили двигаться вперёд, не блокируя проект из-за длинного хвоста пользовательских страниц.

Важная особенность: в WordPress путь URL не всегда совпадает со slug post_name. Родительские страницы, собственные правила rewrite и старые импорты создавали пути, не совпадающие со slug, поэтому путь нужно было получать из результатов обхода сайта, а не из базы данных.

03

Разбиение сборки и ловушки файловой системы

Рендеринг всех страниц за один запуск занимал много времени, а любое небольшое изменение становилось дорогим. Мы разбили процесс на части: переносили исходные файлы, которые не собирались в текущем запуске, во временное хранилище, собирали подмножество, разворачивали его, а затем возвращали файлы обратно. Четыре ловушки стоили нам времени:

  1. Хранилище должно находиться за пределами точки монтирования контента Hugo. Если оно расположено внутри каталога с примонтированным контентом, Hugo всё равно обходит каждый файл, и разбиение сборки теряет смысл.
  2. rsync --exclude=index.html исключает все index.html на любой глубине, а не только файл в корне. Зафиксируйте шаблон относительно корня: --exclude=/index.html.
  3. Два параллельных процесса переноса для одной директории вкладывают её саму в себя. Два процесса восстановления, работавшие одновременно, создали около 367 000 директорий на один уровень глубже. В продакшене всё работало нормально, поскольку сайт отдавал уже собранные файлы; одна скриптовая операция переноса исправила структуру. Директорией должен управлять только один процесс - это обеспечивается блокировкой.
  4. mv dir/* target/ не работает при таком размере (слишком длинный список аргументов). Используйте find ... -exec mv -t target {} +.
# отрендерить несколько страниц без полной пересборки
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # хранилище находится ВНЕ точки монтирования контента
  for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
  hugo --minify -d ../staged
  find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'
04

Исправления производительности: изменение шаблона плюс обработка всего корпуса страниц

Каждое исправление состояло из двух частей: нужно было правильно изменить шаблон Hugo, чтобы будущие сборки были корректными, и обработать уже собранный HTML, чтобы выпустить исправление без полной пересборки. Наибольшее значение имели следующие изменения:

  • Размеры изображений. В шаблоне были жёстко заданы width="1600" height="700", хотя CSS использовал другое соотношение сторон. Мы исправили это на 527 815 страницах. Значения width/height должны соответствовать отображаемому соотношению сторон, иначе браузер резервирует неправильное пространство (оптимизация CLS).
  • Конфликтующие правила aspect-ratio для одного и того же селектора в двух таблицах стилей; мы объединили их в одно правило.
  • Критический CSS в асинхронном файле. Правила для мобильных устройств, необходимые для первой отрисовки, находились в отложенной таблице стилей и вызывали позднюю перестройку макета. Мы перенесли их в синхронно загружаемую таблицу стилей.
  • Ленивая загрузка главного изображения. Атрибут loading="lazy" у изображения в первом экране задерживал LCP; мы заменили его на fetchpriority="high" (оптимизация LCP).
  • Слишком большие изображения LCP были заменены уменьшенными вариантами, что экономило от 50 до 440 КБ на страницу.
  • Виджет расчёта стоимости теперь загружается при первом взаимодействии пользователя с резервным тайм-аутом, а его контейнер резервирует 480 пикселей (560 пикселей на мобильных устройствах). Раньше его появление сдвигало страницу, создавая CLS около 0,54.
05

Настройки Cloudflare, которые имели значение

  • Email Obfuscation отключён. Его декодер после загрузки обходит DOM и переписывает ссылки на электронную почту, что приводило к сдвигу макета. Это был самый устойчивый источник CLS из всех обнаруженных.
  • Rocket Loader отключён. Он менял порядок загрузки скриптов и мешал отложенной загрузке.
  • Очистка кэша после деплоя. Кэши на периферийных узлах сохраняли старый HTML; очистка по путям после каждого деплоя не позволяла отдавать устаревшие страницы (документация Cloudflare по очистке кэша).
  • Измеряйте продакшен, а не staging. На staging без тех же настроек Cloudflare лабораторные оценки не совпадали с результатами в продакшене.
06

Schema-разметка и детали SEO

  • Search Console сообщала об ошибках структурированных данных, поскольку сущность Service содержала aggregateRating и review. Мы удалили их, а не пытались добиться прохождения проверки: разметка должна отражать контент, который видят пользователи (рекомендации по структурированным данным).
  • Изначально записи блога рендерились шаблоном локаций и наследовали неправильный тип schema-разметки. Теперь каждый шаблон объявляет собственную сущность.
  • Для 35 непоследовательных путей флота и услуг настроены постоянные редиректы на правильные вложенные страницы (редиректы).
  • Медиафайлы были перенесены из /wp-content/uploads/ в /uploads/ с одним правилом 301; параллельный проход sed за несколько минут переписал ссылки в 528 852 из 528 854 файлов.
  • Yoast удалён после того, как Hugo начал формировать sitemap, schema-разметку, метатеги и robots.txt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Лиды - это то, что нельзя потерять

Форма расчёта стоимости приносит сайту деньги, поэтому для неё мы создали отдельные проверки: точка монтирования виджета должна присутствовать в собранном HTML каждой страницы, где он был размещён; названия полей должны соответствовать требованиям endpoint приёма заявок; а деплой, заменяющий директорию, не должен удалять отдельную страницу расчёта стоимости. Переключение сайта, после которого незаметно перестаёт работать сбор лидов, может выглядеть успешным по всем SEO-метрикам, пока бизнес теряет заявки.

08

Что мы сделали бы иначе

  1. Отключили бы Email Obfuscation до первого измерения CLS.
  2. Разбили бы сборку на части с самого первого дня.
  3. Заблокировали бы директорию контента с самого первого дня.
  4. Зафиксировали бы подход «изменение шаблона плюс обработка всего корпуса» до первого исправления, а не после пятого.
  5. Добавили бы проверку данных реальных пользователей (CrUX) в чек-лист запуска, поскольку лабораторные показатели на staging не отражают продакшен.

Бизнес-версия этого же проекта, включая то, что мы оставили на WordPress, представлена в кейсе.

09

Источники и дополнительная информация

Часто задаваемые вопросы

Это миграция клиентского сайта?

Нет. Unlimited Charters - внутренний дочерний сайт, принадлежащий той же группе, что и WordPressEscape. Это наш собственный тестовый проект.

Справляется ли Hugo с полумиллионом страниц?

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

Что вызвало самый сильный сдвиг макета?

Виджет расчёта стоимости, который монтировался без резервирования места (около 0,54 CLS на страницах хабов), и Cloudflare Email Obfuscation, переписывавший страницу после загрузки.

Применимы ли эти выводы к небольшим сайтам?

Да. Те же проверки - соответствие URL, размеры изображений, критический CSS, главное изображение без lazy-загрузки и отложенные виджеты - применимы к сайту на 40 страницах; просто выполняются за минуты, а не за часы.

Бесплатно просканировать мой сайт

Проверьте, подходит ли вашему сайту такой же подход

Бесплатный аудит за 60 секунд покажет реальную оценку PageSpeed, точное количество страниц, пробелы в SEO и функции WordPress, которым нужна замена. Затем WordPressEscape пересоберёт сайт на Hugo, сохранит все URL и передаст вам исходный код в первый же день - именно так был пересобран UC.

Бесплатно просканировать мой сайт
Продолжить чтение
Все руководства33
Похожие запросымиграция с wordpress на hugo528 854 страницы (внутренний тест)разбиение сборки hugoисправление cls в cloudflareочистка schema-разметкисоответствие url