WordPress는 안녕: Hugo Static Site Generator로 마이그레이션한 이유와 방법

우리는 WordPress에서 최신 정적 사이트 생성기(SSG)인 Hugo로 netguide.jp의 전환을 공식적으로 완료했습니다.

WordPress와 같은 동적 CMS를 운영하면 페이지 로드 지연, 보안 업데이트, 호스팅 비용으로 인해 병목 현상이 점점 더 심해졌습니다. 정적 워크플로로 마이그레이션하면 이러한 문제가 모두 해결되었습니다. 이 사례 연구에서는 동기 부여, 마이그레이션 전략 및 마이그레이션 후 성능 향상을 공유합니다.

1. 우리가 WordPress를 떠난 세 가지 이유

WordPress는 매우 다재다능한 CMS로 남아 있지만, 동적 데이터베이스 기반 아키텍처는 콘텐츠가 성장함에 따라 중요한 과제를 안겨주었습니다.

페이지 속도 제한(핵심 웹 바이탈) 누적된 데이터베이스 쿼리와 과도한 플러그인으로 인해 모바일 성능이 심각하게 저하되어 핵심 웹 바이탈(특히 LCP 및 INP)에 부정적인 영향을 미치고 검색 순위가 하락했습니다.
유지 관리 오버헤드 및 보안 위험 WordPress 코어, 테마 및 플러그인은 취약점의 지속적인 표적입니다. 지속적인 테스트 및 업데이트 주기에는 해킹 시도를 방지하기 위해 너무 많은 수동 시간이 필요했습니다.
호스팅 오버헤드 동적 PHP 페이지를 규모에 맞게 빠르게 실행하려면 프리미엄 VPS 호스팅이 필요했기 때문에 월간 운영 비용이 높아졌습니다.

2. 마이그레이션 설계: Hugo + 스택 테마

우리는 고도로 세련된 스택 테마(hugo-theme-stack)와 짝을 이루는 가장 빠른 Go 기반 정적 사이트 생성기인 Hugo를 선택했습니다.

🌐 다국어 아키텍처(ja / en)

우리는 /ja/에 따라 일본어 콘텐츠를 제공하고 /en/에 따라 영어 콘텐츠를 제공하도록 시스템을 구성했습니다. 적절한 HTML 대체 태그와 함께 다국어 SEO를 완벽하게 정렬하기 위해 xhtml:link(hreflang 주석)가 포함된 Google 호환 XML 사이트맵을 생성했습니다.

🖼️ AVIF를 통한 이미지 최적화

전송 속도를 극대화하기 위해 원시 PNG 및 JPEG 썸네일을 고도로 압축된 차세대 AVIF 이미지로 자동 변환하는 자산 파이프라인을 만들었습니다.

🔗 완전한 리디렉션 전략

URL 형식을 중첩된 날짜 경로에서 클린 슬러그(예: /ja/software/...)로 변경하면서 _redirects 파일에 104 리디렉션을 구성하여 들어오는 검색 엔진 링크 주스나 사용자 북마크가 깨지지 않도록 했습니다.

3. 단계별 전환

우리는 다음과 같은 4가지 주요 단계로 마이그레이션을 실행했습니다.

워드프레스 데이터 내보내기 우리는 내보내기 플러그인을 사용하여 모든 원시 HTML 콘텐츠, 메타데이터, 게시 날짜, 슬러그 및 주요 이미지 연결을 구조화된 XML 형식으로 다운로드했습니다.
마크다운으로 변환 사용자 정의 구문 분석 스크립트를 사용하여 XML 데이터베이스 레코드를 머리말이 포함된 Markdown 파일(.ja.md 및 .en.md)로 변환했습니다.
테마 및 재정의 적용 우리는 디렉토리 내부에 hugo-theme-stack을 구조화하여 지역화된 검색, 태그 클라우드 및 TOC를 설정했습니다.
이미지 자산 최적화 우리는 이미지 자동화 스크립트를 실행하여 최적화된 AVIF 자산과 뚜렷한 밝은 모드 및 어두운 모드 썸네일 디자인을 재생성했습니다.

4. 📈 마이그레이션 후 결과

새로 생성된 정적 HTML 출력을 Cloudflare 페이지에 호스팅함으로써 즉각적인 개선이 이루어졌습니다.

PageSpeed Insights 최대치 모바일 성능 점수 100/100에 도달했습니다. LCP(가장 콘텐츠가 풍부한 페인트)가 0.6초 미만으로 단축되어 전환이 즉각적으로 느껴집니다.
호스팅 비용 없음 Cloudflare의 글로벌 에지 네트워크를 활용함으로써 우리는 무료 계층에서 수백만 건의 요청을 처리할 수 있었고 월별 VPS 호스팅 비용이 완전히 제거되었습니다.
절대적인 보안 데이터베이스나 동적 PHP 계층이 없으면 SQL 주입이나 무차별 관리 공격과 같은 일반적인 취약점은 구조적으로 불가능합니다.