WordPressEscape

Strona główna / Poradnik

Workbench

Migracja 528 854 stron WordPress do Hugo: notatki inżynieryjne

To robocze notatki z przeniesienia Unlimited Charters, naszej siostrzanej witryny wewnętrznej, z WordPress do Hugo w maju 2026 roku. Podsumowanie biznesowe znajdziesz w studium przypadku; tutaj skupiamy się na części dla osoby, która musi wykonać tę pracę: co przestało działać przy pół milionie stron, które polecenia sprawiły nam problemy oraz jakie kontrole uruchamiamy teraz w każdej witrynie, niezależnie od jej rozmiaru.

6 min czytania 9 sekcji Stworzony, by zajmować wysokie pozycje
Na tej stronie
  1. Kontekst
  2. Inwentaryzacja szablonów przed migracją treści
  3. Kompilacje partycjonowane i pułapki systemu plików
  4. Optymalizacje wydajności wdrażane jako zmiana szablonu i aktualizacja całego korpusu
  5. Ustawienia Cloudflare, które miały znaczenie
  6. Szczegóły dotyczące danych strukturalnych i SEO
  7. Pozyskiwanie leadów to element, którego nie można utracić
  8. Co zrobilibyśmy inaczej
  9. Źródła i dalsza lektura
  10. Najczęściej zadawane pytania
Szybka odpowiedź

Przy tej skali problemy dotyczą bardziej systemu plików i organizacji pracy niż samego Hugo: podziału kompilacji, przechowywania odłożonej zawartości poza punktem montowania treści Hugo, bezwzględnego unikania uruchamiania dwóch procesów przenoszenia w tym samym katalogu oraz traktowania każdej poprawki jako zmiany w szablonie połączonej ze skryptową aktualizacją całego zbioru treści. Największą poprawę wydajności przyniosło określenie wymiarów obrazów, synchroniczne ładowanie krytycznego CSS, wyłączenie leniwego ładowania obrazu LCP, odroczone ładowanie widżetu z ofertami przy zarezerwowanym miejscu oraz wyłączenie funkcji Cloudflare Email Obfuscation.

01

Kontekst

Unlimited Charters należy do tej samej grupy co WordPressEscape; była to nasza własna migracja testowa, przeprowadzona z pełnym dostępem do serwera. Witryna miała nieco ponad pół miliona adresów URL - głównie szablonowych stron lokalizacyjnych, a także hubów, stron floty i bloga. Celem była witryna zbudowana w Hugo i serwowana jako pliki statyczne za pośrednictwem Cloudflare, z zachowaniem wszystkich dotychczasowych ścieżek.

02

Inwentaryzacja szablonów przed migracją treści

Zaczęliśmy od pogrupowania adresów URL według szablonu WordPress, który je renderował, a nie według wzorca adresu. Dla każdej grupy podjęliśmy jedną decyzję: odtworzyć ją jako layout Hugo albo tymczasowo serwować statyczny zrzut wygenerowany przez WordPress. Odtworzenie w pierwszej kolejności grup o największym ruchu i zapisanie wyjątków w postaci zrzutów pozwoliło kontynuować projekt bez blokowania prac przez długi ogon niestandardowych stron.

Warto pamiętać o jednej pułapce: w WordPress ścieżka URL nie zawsze odpowiada slugowi post_name. Strony nadrzędne, niestandardowe reguły przepisywania adresów i stare importy generowały ścieżki niezgodne ze slugiem, dlatego ścieżkę trzeba było pobierać z crawlowania, a nie z bazy danych.

03

Kompilacje partycjonowane i pułapki systemu plików

Renderowanie wszystkich stron w jednym przebiegu trwało długo i sprawiało, że każda drobna zmiana była kosztowna. Podzieliliśmy proces na części: przenosiliśmy pliki źródłowe, których akurat nie budowaliśmy, do katalogu tymczasowego, budowaliśmy wybrany podzbiór, wdrażaliśmy go, a następnie przywracaliśmy pliki. Cztery pułapki kosztowały nas czas:

  1. Katalog tymczasowy musi znajdować się poza zamontowanym katalogiem content Hugo. Jeśli znajduje się gdziekolwiek w zamontowanym katalogu treści, Hugo nadal skanuje każdy plik i partycjonowanie nic nie daje.
  2. rsync --exclude=index.html wyklucza każdy plik index.html na każdej głębokości, a nie tylko ten z katalogu głównego. Zakotwicz wzorzec (--exclude=/index.html).
  3. Przenoszenie tego samego katalogu przez dwa równoległe procesy powoduje jego zagnieżdżenie. Dwa procesy przywracające dane jednocześnie utworzyły około 367 000 katalogów zagnieżdżonych o jeden poziom za głęboko. Produkcja działała poprawnie, ponieważ serwowała gotowy output; pojedyncze skryptowane przeniesienie spłaszczyło strukturę. Jeden proces zarządza katalogiem - wymuszamy to za pomocą blokady.
  4. mv dir/* target/ nie działa przy tej skali (lista argumentów jest zbyt długa). Użyj find ... -exec mv -t target {} +.
# renderowanie kilku stron bez przebudowy całości
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # katalog tymczasowy POZA zamontowanym katalogiem content
  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

Optymalizacje wydajności wdrażane jako zmiana szablonu i aktualizacja całego korpusu

Każda poprawka miała dwa elementy: korygowaliśmy szablon Hugo, aby kolejne kompilacje były prawidłowe, oraz poprawialiśmy już wygenerowany HTML, żeby wdrożyć zmianę bez pełnej przebudowy. Największe znaczenie miały:

  • Wymiary obrazów. Szablon na sztywno ustawiał width="1600" height="700", podczas gdy CSS wykorzystywał inne proporcje. Poprawiliśmy to na 527 815 stronach. Wartości width/height muszą odpowiadać proporcjom renderowanego obrazu, w przeciwnym razie przeglądarka rezerwuje niewłaściwą przestrzeń (optymalizacja CLS).
  • Sprzeczne reguły aspect-ratio dla tego samego selektora w dwóch arkuszach stylów; połączyliśmy je w jedną regułę.
  • Krytyczny CSS w pliku ładowanym asynchronicznie. Reguły mobilne potrzebne do pierwszego renderowania znajdowały się w odroczonym arkuszu stylów, co powodowało późniejszy ponowny układ strony. Przenieśliśmy je do arkusza ładowanego synchronicznie.
  • Lazy loading hero. loading="lazy" dla obrazu widocznego nad linią załamania opóźniało LCP; zastąpiliśmy je przez fetchpriority="high" (optymalizacja LCP).
  • Zbyt duże obrazy LCP zastąpiliśmy mniejszymi wariantami, oszczędzając od 50 do 440 KB na stronie.
  • Widget wyceny ładuje się przy pierwszej interakcji (z mechanizmem awaryjnym po upływie limitu czasu), a jego kontener rezerwuje 480 px (560 px na urządzeniach mobilnych). Wcześniej jego zamontowanie przesuwało stronę, powodując CLS na poziomie około 0,54.
05

Ustawienia Cloudflare, które miały znaczenie

  • Wyłączone ukrywanie adresów e-mail. Dekoder tej funkcji skanuje DOM po załadowaniu strony i przepisuje odnośniki e-mail, co powodowało przesunięcie układu. Było to najbardziej uporczywe źródło CLS, jakie znaleźliśmy.
  • Wyłączony Rocket Loader. Zmieniał kolejność skryptów i zakłócał odroczone ładowanie.
  • Czyszczenie cache po wdrożeniu. Cache na brzegu sieci przechowywał stary HTML; czyszczenie go według ścieżki po każdym wdrożeniu zapobiegało serwowaniu nieaktualnych stron (dokumentacja czyszczenia cache Cloudflare).
  • Pomiar produkcji, nie środowiska staging. Staging bez tych samych ustawień Cloudflare generował wyniki laboratoryjne, które nie odpowiadały produkcji.
06

Szczegóły dotyczące danych strukturalnych i SEO

  • Search Console zgłaszało błędy danych strukturalnych, ponieważ encja Service zawierała aggregateRating i review. Usunęliśmy je, zamiast próbować doprowadzić je do poprawnej walidacji; oznaczenia muszą odzwierciedlać treści widoczne dla użytkowników (wytyczne dotyczące danych strukturalnych).
  • Wpisy blogowe były początkowo renderowane za pomocą szablonu lokalizacji i dziedziczyły niewłaściwy typ danych strukturalnych. Każdy szablon deklaruje teraz własną encję.
  • 35 niespójnych ścieżek floty i usług otrzymało stałe przekierowania do prawidłowych stron zagnieżdżonych (przekierowania).
  • Pliki multimedialne przenieśliśmy z /wp-content/uploads/ do /uploads/ za pomocą jednej reguły 301; równoległy przebieg sed przepisał 528 852 z 528 854 plików w kilka minut.
  • Usunęliśmy Yoast, gdy Hugo zaczęło generować mapę witryny, dane strukturalne, tagi meta i robots.txt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Pozyskiwanie leadów to element, którego nie można utracić

Formularz wyceny generuje przychody witryny, dlatego objęliśmy go osobnymi kontrolami: element widgetu musi znajdować się w wygenerowanym kodzie HTML każdej strony, na której był obecny, nazwy pól muszą odpowiadać wymaganiom endpointu obsługującego zgłoszenia, a wdrożenie zastępujące katalog nie może usuwać samodzielnej strony z formularzem wyceny. Migracja, która po cichu wyłącza pozyskiwanie leadów, może wyglądać na udaną we wszystkich metrykach SEO, podczas gdy firma traci zapytania.

08

Co zrobilibyśmy inaczej

  1. Wyłączyć Email Obfuscation przed pierwszym pomiarem CLS.
  2. Od pierwszego dnia rozdzielić proces budowania.
  3. Od pierwszego dnia zablokować katalog z treścią.
  4. Opisać schemat „szablon plus przetwarzanie całego korpusu” przed pierwszą poprawką, a nie dopiero po piątej.
  5. Dodać kontrolę danych rzeczywistych (CrUX) do checklisty uruchomieniowej, ponieważ wyniki testów laboratoryjnych na środowisku stagingowym nie odzwierciedlają produkcji.

Biznesowe podsumowanie tego samego projektu, w tym informacje o tym, co pozostawiliśmy w WordPress, znajduje się w studium przypadku.

09

Źródła i dalsza lektura

Najczęściej zadawane pytania

Czy to migracja strony klienta?

Nie. Unlimited Charters to wewnętrzna siostrzana strona należąca do tej samej grupy co WordPressEscape. To nasz własny przypadek testowy.

Czy Hugo obsługuje pół miliona stron?

Tak, ale pełne przebudowy trwają na tyle długo, że znaczenie mają kompilacje partycjonowane i staranne zarządzanie plikami. Większość problemów wynikała z systemu plików i procesów, a nie z błędów Hugo.

Co spowodowało największe przesunięcie układu?

Największe problemy powodowały widżet z wyceną, który był ładowany bez zarezerwowania miejsca (około 0,54 CLS na stronach hubów), oraz funkcja Cloudflare Email Obfuscation, która modyfikowała stronę po jej załadowaniu.

Czy te wnioski dotyczą również małych stron?

Tak. Te same kontrole (zgodność adresów URL, wymiary obrazów, krytyczny CSS, obraz hero ładowany bez opóźnienia i odroczone widżety) mają zastosowanie do strony liczącej 40 podstron - po prostu wykonują się w kilka minut zamiast w kilka godzin.

Przeskanuj moją stronę bezpłatnie

Sprawdź, czy Twoja witryna kwalifikuje się do takiej samej optymalizacji

Bezpłatny 60-sekundowy audyt pokaże Twój rzeczywisty wynik PageSpeed, dokładną liczbę stron, braki w SEO oraz funkcje WordPress, które trzeba zastąpić. Następnie WordPressEscape odtworzy Twoją witrynę w Hugo, zachowa wszystkie adresy URL i przekaże Ci kod źródłowy już pierwszego dnia - dokładnie tak, jak odbudowaliśmy UC.

Przeskanuj moją stronę bezpłatnie
Czytaj dalej
Wszystkie poradniki33
Powiązane wyszukiwaniamigracja z wordpress do hugo528 854 strony (test wewnętrzny)podzielona kompilacja hugopoprawka cls w cloudflareuporządkowanie danych strukturalnychzgodność adresów URL