WordPressEscape

Trang chủ / Hướng dẫn

Workbench

Di chuyển 528.854 trang WordPress sang Hugo: Ghi chú kỹ thuật

Đây là những ghi chú thực tế trong quá trình chuyển Unlimited Charters, website chị em nội bộ của chúng tôi, từ WordPress sang Hugo vào tháng 5 năm 2026. Phần tổng quan về hoạt động kinh doanh đã có trong bài case study; nội dung này dành cho người trực tiếp thực hiện: điều gì đã hỏng khi xử lý nửa triệu trang, những lệnh nào gây rắc rối và các bước kiểm tra hiện được chạy trên mọi website, dù lớn hay nhỏ.

Đọc trong 12 phút 9 mục Tối ưu để lên hạng
Trong trang này
  1. Bối cảnh
  2. Kiểm kê template trước khi xử lý nội dung
  3. Build được chia nhỏ và các vấn đề với hệ thống tệp
  4. Cải thiện hiệu năng: chỉnh template rồi chạy script trên toàn bộ dữ liệu
  5. Các thiết lập Cloudflare có ảnh hưởng đáng kể
  6. Các chi tiết về Schema và SEO
  7. Thu thập khách hàng tiềm năng là phần không thể để mất
  8. Những điều chúng tôi sẽ làm khác đi
  9. Nguồn và tài liệu đọc thêm
  10. Câu hỏi thường gặp
Câu trả lời nhanh

Ở quy mô này, vấn đề chủ yếu nằm ở hệ thống tệp và quy trình hơn là ở Hugo: chia nhỏ quá trình build, giữ nội dung tạm bên ngoài thư mục content mà Hugo mount, tuyệt đối không chạy hai tiến trình di chuyển trên cùng một thư mục và xử lý mỗi thay đổi theo hai bước: chỉnh template rồi chạy script trên toàn bộ dữ liệu. Những cải thiện hiệu năng lớn nhất đến từ việc đặt đúng kích thước ảnh, đưa CSS quan trọng vào stylesheet đồng bộ, không lazy-load ảnh LCP, trì hoãn widget báo giá nhưng chừa sẵn không gian và tắt Cloudflare Email Obfuscation.

01

Bối cảnh

Unlimited Charters thuộc cùng một tập đoàn với WordPressEscape; đây là lần di chuyển thử nghiệm của chính chúng tôi, được thực hiện với toàn quyền truy cập máy chủ. Website có hơn nửa triệu URL, chủ yếu là các trang địa điểm dùng template, cùng với các trang hub, trang đội tàu và blog. Mục tiêu là tạo website Hugo dưới dạng các tệp tĩnh, phân phối qua Cloudflare, đồng thời giữ nguyên mọi đường dẫn hiện có.

02

Kiểm kê template trước khi xử lý nội dung

Chúng tôi bắt đầu bằng cách nhóm URL theo template WordPress đã dùng để hiển thị chúng, thay vì nhóm theo mẫu URL. Mỗi nhóm được đưa ra một quyết định: xây dựng lại dưới dạng layout Hugo hoặc tạm thời phân phối bản chụp tĩnh từ đầu ra của WordPress. Ưu tiên xây dựng lại các nhóm có lưu lượng cao và dùng bản chụp cho các trường hợp đặc biệt giúp dự án tiến triển mà không bị chặn bởi hàng loạt trang tùy chỉnh ít phổ biến.

Một điểm dễ gây nhầm lẫn: trên WordPress, đường dẫn URL không phải lúc nào cũng là slug post_name. Các trang cha, quy tắc rewrite tùy chỉnh và dữ liệu import cũ tạo ra những đường dẫn không khớp với slug, vì vậy đường dẫn phải được lấy từ quá trình crawl, không phải từ cơ sở dữ liệu.

03

Build được chia nhỏ và các vấn đề với hệ thống tệp

Render toàn bộ trang trong một lần chạy vừa chậm vừa khiến mọi thay đổi nhỏ trở nên tốn kém. Chúng tôi chia nhỏ quy trình: chuyển các tệp nguồn chưa cần build vào một thư mục tạm, build một phần, deploy rồi khôi phục. Bốn vấn đề sau đã khiến chúng tôi mất thời gian:

  1. Thư mục tạm phải nằm bên ngoài thư mục content mà Hugo mount. Nếu đặt ở bất kỳ vị trí nào bên trong thư mục content đã mount, Hugo vẫn quét mọi tệp và việc chia nhỏ gần như không đem lại lợi ích.
  2. rsync --exclude=index.html loại trừ mọi tệp index.html ở tất cả cấp thư mục, chứ không chỉ tệp ở thư mục gốc. Hãy neo mẫu bằng --exclude=/index.html.
  3. Hai tiến trình di chuyển đồng thời trên cùng một thư mục sẽ lồng thư mục vào nhau. Hai tiến trình khôi phục chạy đua đã tạo ra khoảng 367.000 thư mục bị lồng sâu thêm một cấp. Môi trường production vẫn hoạt động bình thường vì chỉ phân phối đầu ra đã build; một script di chuyển duy nhất đã đưa chúng về đúng vị trí. Chỉ một tiến trình được phép quản lý thư mục, và điều này được đảm bảo bằng lock.
  4. mv dir/* target/ sẽ thất bại ở quy mô này vì danh sách đối số quá dài. Hãy dùng find ... -exec mv -t target {} +.
# render một nhóm nhỏ các trang mà không cần build lại toàn bộ
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # lưu tạm BÊN NGOÀI thư mục content đã mount
  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

Cải thiện hiệu năng: chỉnh template rồi chạy script trên toàn bộ dữ liệu

Mỗi cải thiện đều gồm hai phần: sửa template Hugo để các lần build sau cho ra kết quả đúng và cập nhật HTML đã build để có thể triển khai ngay mà không cần build lại toàn bộ. Những thay đổi tạo ra tác động lớn nhất gồm:

  • Kích thước ảnh. Một template đặt cố định width="1600" height="700" trong khi CSS sử dụng tỷ lệ khung hình khác. Đã sửa trên 527.815 trang. Giá trị width/height phải khớp với tỷ lệ khung hình khi render, nếu không trình duyệt sẽ chừa sai khoảng trống (tối ưu CLS).
  • Các quy tắc aspect-ratio xung đột trên cùng một selector trong hai stylesheet; đã hợp nhất thành một quy tắc.
  • CSS quan trọng nằm trong tệp bất đồng bộ. Các quy tắc dành cho thiết bị di động cần thiết ở lần hiển thị đầu tiên lại nằm trong stylesheet được trì hoãn, gây ra việc dàn trang lại muộn. Đã chuyển chúng vào stylesheet đồng bộ.
  • Ảnh hero được lazy-load. loading="lazy" trên ảnh nằm trong vùng hiển thị đầu tiên đã làm chậm LCP; được thay bằng fetchpriority="high" (tối ưu LCP).
  • Ảnh LCP quá lớn được thay bằng các phiên bản nhỏ hơn, tiết kiệm từ 50 đến 440 KB mỗi trang.
  • Widget báo giá chỉ tải khi người dùng tương tác lần đầu (có cơ chế dự phòng bằng timeout), còn container chừa sẵn chiều cao 480px (560px trên thiết bị di động). Trước đó, khi widget được mount, trang bị dịch chuyển với CLS khoảng 0,54.
05

Các thiết lập Cloudflare có ảnh hưởng đáng kể

  • Tắt Email Obfuscation. Bộ giải mã của tính năng này quét DOM sau khi tải trang rồi viết lại các liên kết email, gây ra hiện tượng dịch chuyển bố cục. Đây là nguồn CLS dai dẳng nhất mà chúng tôi phát hiện.
  • Tắt Rocket Loader. Tính năng này sắp xếp lại thứ tự script và gây ảnh hưởng đến cơ chế tải trì hoãn.
  • Purge sau mỗi lần deploy. Cache ở edge vẫn giữ HTML cũ; purge theo đường dẫn sau mỗi lần deploy giúp tránh phân phối các trang lỗi thời (tài liệu purge của Cloudflare).
  • Đo lường trên production, không phải staging. Môi trường staging không áp dụng cùng thiết lập Cloudflare cho ra điểm số phòng lab không phản ánh production.
06

Các chi tiết về Schema và SEO

  • Search Console báo lỗi dữ liệu có cấu trúc vì entity Service chứa aggregateRating và review. Chúng tôi đã xóa các thuộc tính này thay vì cố làm cho chúng vượt qua kiểm tra; markup phải phản ánh nội dung mà người dùng có thể nhìn thấy (hướng dẫn về dữ liệu có cấu trúc).
  • Các bài blog ban đầu được render bằng template địa điểm và kế thừa sai loại schema. Giờ đây mỗi template tự khai báo entity của mình.
  • 35 đường dẫn không nhất quán của đội tàu và dịch vụ được chuyển hướng vĩnh viễn đến các trang lồng đúng (chuyển hướng).
  • Media được chuyển từ /wp-content/uploads/ sang /uploads/ bằng một quy tắc 301 duy nhất; một lượt chạy sed song song đã viết lại 528.852 trên tổng số 528.854 tệp chỉ trong vài phút.
  • Yoast được gỡ bỏ sau khi Hugo đảm nhiệm việc xuất sitemap, schema, thẻ meta và robots.txt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Thu thập khách hàng tiềm năng là phần không thể để mất

Biểu mẫu báo giá là nguồn tạo doanh thu của website, vì vậy nó có bộ kiểm tra riêng: vị trí mount của widget phải tồn tại trong HTML đã build của mọi trang có widget, tên trường phải khớp với yêu cầu của endpoint tiếp nhận và một lần deploy thay thế cả thư mục không được xóa trang báo giá độc lập. Một lần chuyển đổi làm mất chức năng thu thập khách hàng tiềm năng có thể vẫn trông thành công trên mọi chỉ số SEO, trong khi doanh nghiệp âm thầm mất đi các yêu cầu tư vấn.

08

Những điều chúng tôi sẽ làm khác đi

  1. Tắt Email Obfuscation trước lần đo CLS đầu tiên.
  2. Chia nhỏ quá trình build ngay từ ngày đầu tiên.
  3. Khóa thư mục content ngay từ ngày đầu tiên.
  4. Ghi lại quy trình chỉnh template rồi chạy trên toàn bộ dữ liệu trước lần sửa đầu tiên, không phải sau lần sửa thứ năm.
  5. Đưa bước kiểm tra dữ liệu người dùng thực tế (CrUX) vào checklist ra mắt, vì điểm số phòng lab trên staging không phản ánh production.

Góc nhìn kinh doanh về cùng dự án này, bao gồm cả những phần chúng tôi vẫn giữ trên WordPress, có trong case study.

09

Nguồn và tài liệu đọc thêm

Câu hỏi thường gặp

Đây có phải là dự án di chuyển của khách hàng không?

Không. Unlimited Charters là website chị em nội bộ thuộc cùng một tập đoàn với WordPressEscape. Đây là trường hợp thử nghiệm của chính chúng tôi.

Hugo có xử lý được nửa triệu trang không?

Có, nhưng build lại toàn bộ đủ chậm để việc chia nhỏ build và xử lý tệp cẩn thận trở nên rất quan trọng. Phần lớn vấn đề chúng tôi gặp phải nằm ở hệ thống tệp và quy trình, không phải lỗi của Hugo.

Điều gì gây ra hiện tượng dịch chuyển bố cục nghiêm trọng nhất?

Widget báo giá được mount mà không chừa sẵn không gian (CLS khoảng 0,54 trên các trang hub) và Cloudflare Email Obfuscation viết lại trang sau khi tải xong.

Những bài học này có áp dụng cho website nhỏ không?

Có. Các bước kiểm tra tương tự - đối chiếu URL, kích thước ảnh, CSS quan trọng, ảnh hero không lazy-load và widget được trì hoãn - đều áp dụng cho website 40 trang; chỉ khác là chúng hoàn tất trong vài phút thay vì vài giờ.

Quét website của tôi miễn phí

Xem website của bạn có phù hợp với giải pháp tương tự không

Bản audit miễn phí trong 60 giây cho bạn biết điểm PageSpeed thực tế, số lượng trang chính xác, các khoảng trống SEO và những tính năng WordPress cần được thay thế. Sau đó, WordPressEscape sẽ xây dựng lại website trên Hugo, giữ nguyên mọi URL và bàn giao mã nguồn ngay từ ngày đầu tiên - đúng như cách UC đã được xây dựng lại.

Quét website của tôi miễn phí
Đọc tiếp
Tất cả hướng dẫn33
Tìm kiếm liên quandi chuyển wordpress sang hugo528.854 trang (thử nghiệm nội bộ)build hugo được chia nhỏkhắc phục cls trên cloudflaredọn dẹp schemađối chiếu url