WordPress에서 Astro로 마이그레이션: 헤드리스든 완전 이전이든 검색 순위를 지키며 옮기는 방법

짧은 답변

W3Techs에 따르면 2026년 10월 13일 기준으로 전체 웹사이트의 40.1%가 WordPress로 운영되고 있습니다. 그래서 대부분의 사이트 마이그레이션은 WordPress에서 출발합니다. Astro 공식 마이그레이션 가이드는 두 가지 경로를 제시합니다. WordPress를 헤드리스 CMS로 남겨 두고 프런트엔드는 Astro로 빌드하는 방법, 그리고 콘텐츠를 WordPress 밖으로 완전히 옮기는 방법입니다.

어느 쪽이든 트래픽을 지키는 작업은 같습니다. 방문자를 모으는 모든 URL을 유지하고, SEO 플러그인이 생성하던 제목과 설명을 옮기고, 업로드 폴더를 복사하고, 프런트엔드 기능을 맡던 플러그인을 대체하고, 바뀌는 모든 URL에 영구 리디렉션을 걸어야 합니다. 이 순서대로 진행하면 새 사이트는 검색 순위를 처음부터 다시 쌓지 않고도 더 빨리 로드되고 운영 비용도 줄일 수 있습니다.

헤드리스 WordPress로 갈까, 완전히 옮길까?

Astro는 두 방식을 모두 문서로 안내합니다. WordPress를 헤드리스 CMS로 사용하기와 WordPress에서 이전하기이며, 후자에서는 콘텐츠 이전에 wordpress-export-to-markdown 도구를 추천합니다.

실제 WordPress 사이트 8곳에서 확인한 것

2026년 10월 13일, 저희는 WordPress.org의 뉴스 블로그부터 대형 미디어까지 WordPress로 만든 사이트 8곳을 살펴보며, 마이그레이션에서 무엇을 믿고 쓸 수 있는지 확인했습니다.

• 8곳 중 7곳이 REST API로 글을 공개하고 있었습니다. 경로는 /wp-json/wp/v2/posts입니다. 나머지 한 곳은 401을 반환했습니다. 일부 호스팅 업체와 보안 플러그인은 API를 막아 두므로, API를 전제로 계획을 세우기 전에 내 사이트부터 확인하세요.
• 8곳 중 3곳은 글마다 Yoast SEO 데이터도 함께 반환했습니다. Yoast는 표준 REST API 응답에 yoastheadjson 필드를 추가하며, 여기에는 해당 페이지에 출력하는 제목, 설명, canonical URL, Open Graph 태그, 스키마가 담겨 있습니다(Yoast 개발자 문서). 필요한 SEO 메타데이터가 바로 재사용할 수 있는 형태로 준비되어 있는 셈입니다.
• 반환된 글 URL은 모두 끝에 슬래시가 붙어 있었고, 7곳 중 5곳은 URL에 연도가 들어 있었습니다. /2026/10/post-name/ 같은 형태입니다. Astro가 이 구조를 정확히 재현하지 못하면 모든 글에 리디렉션이 필요해집니다.
• 8곳 중 6곳이 여전히 jQuery를 불러오고 있었습니다. WordPress 테마가 얼마나 많은 프런트엔드 코드를 싣고 다니는지, 그리고 Astro로 다시 만들면 그 코드를 덜어 낼 수 있다는 점을 보여 줍니다.

WordPress에서 Astro로, 단계별 진행

1. 모든 URL 목록 만들기. WordPress는 5.5 버전부터 /wp-sitemap.xml에 사이트맵을 게시합니다. 단, SEO 플러그인이 자체 사이트맵으로 대체한 경우는 예외입니다(Make WordPress Core). 여기에 Google Search Console에서 가능한 가장 긴 기간으로 페이지 보고서를 더하고, 설정 > 고유주소에서 고유주소(퍼머링크) 구조를 기록해 두고, 리디렉션 플러그인을 쓰고 있다면 그 규칙을 내보내세요.
2. 헤드리스와 완전 이전 중 선택하기. 위의 표를 기준으로 정하세요. 나머지 단계는 두 방식 모두에 해당합니다. 헤드리스라면 '내보내기'는 같은 데이터를 빌드 시점에 API에서 읽어 오는 것을 뜻합니다.
3. 콘텐츠 내보내기. 도구 > 내보내기를 실행하면 WXR 파일이 만들어집니다. 글, 페이지, 커스텀 포스트 타입, 댓글, 사용자 정의 필드, 카테고리, 태그, 커스텀 택소노미, 사용자를 담은 XML 내보내기 파일입니다(WordPress 문서). 스크립트로 내보낸다면 REST API가 페이지당 최대 100개의 글을 각 글의 렌더링된 HTML과 함께 반환합니다.
4. 업로드 파일 복사하기. 이미지는 XML 파일 안에 들어 있지 않습니다. WordPress가 이미지마다 만든 크기별 사본과 함께 wp-content/uploads에 저장되어 있습니다. 원본은 남겨 두고, 크기별 이미지는 astro:assets가 생성하게 하고, 기존 이미지 URL을 그대로 유지할지 리디렉션이 필요한지 정하세요.
5. SEO 메타데이터 옮기기. 사이트가 Yoast SEO를 사용한다면 모든 글과 페이지에 대해 REST API에서 yoastheadjson을 읽어 오세요. 플러그인이 저장해 둔 템플릿이 아니라 최종 제목과 설명을 얻을 수 있습니다. Yoast를 쓰지 않는다면 내보낸 파일에 있는 플러그인의 사용자 정의 필드에서 가져오세요.
6. 템플릿을 Astro 컴포넌트로 다시 만들기. 완전히 옮긴다면 글과 페이지를 콘텐츠 컬렉션이나 새 CMS로 바꾸고, 헤드리스 WordPress라면 API에서 가져오세요. 글 몇 개의 HTML을 열어 숏코드, 임베드, 페이지 빌더 마크업이 있는지 확인하세요. 기존 테마 밖에서 제대로 보이게 하려면 정리가 필요한 경우가 많습니다.
7. 프런트엔드 기능을 맡던 플러그인 대체하기. 폼에는 별도의 엔드포인트(Cloudflare Worker, 폼 서비스 또는 CRM)가 필요하고, 검색은 Pagefind 같은 정적 인덱스로 바꿀 수 있으며, 댓글은 유지할지, 외부 서비스로 옮길지, 닫을지 결정해야 합니다. 페이지를 미리 빌드하면 캐시 플러그인은 더 이상 할 일이 없습니다.
8. URL 구조 맞추기. WordPress의 고유주소는 보통 슬래시로 끝나며, 이는 Astro의 기본 디렉터리 출력과 일치합니다. 날짜 기반 고유주소는 /[year]/[month]/[slug]/ 같은 동적 라우트로 만듭니다(Astro 라우팅). 카테고리와 태그 아카이브에는 별도의 페이지나 리디렉션이 필요합니다.
9. WordPress가 남기는 URL까지 포함해 서버에서 리디렉션하기. 어댑터 없는 정적 Astro 빌드는 설정한 리디렉션을 meta refresh 페이지로 바꿉니다(Astro 설정 레퍼런스). 따라서 사이트를 호스팅하는 곳에서 1:1 301 리디렉션을 설정하세요. 바뀐 글뿐 아니라 WordPress가 스스로 만드는 URL도 챙겨야 합니다. /feed/, ?p= 단축 링크, 첨부 파일 페이지, 작성자 아카이브, 그리고 옮긴 /wp-content/uploads/ 파일입니다.
10. 런칭한 뒤 지켜보기. DNS를 전환하고, 새 사이트 검증이 끝날 때까지 기존 WordPress 설치는 나만 접근할 수 있게 남겨 두고, 이후 몇 주 동안 Search Console의 색인 생성 보고서를 확인하세요. 웹사이트 이전 SEO 체크리스트에서 런칭 당일과 이후 90일 동안 할 일을 다룹니다.

이전 후 달라지는 점

SEO 지키기

URL이 변경되는 사이트 이전에 관한 Google 가이드가 여기에도 그대로 적용됩니다. 모든 기존 URL을 가장 가까운 새 URL에 매핑하고, 서버 측 영구 리디렉션을 사용하고, 최소 1년 동안 유지하세요. WordPress는 끝에 슬래시가 붙는 고유주소가 Astro의 기본값과 일치하기 때문에, 대부분의 플랫폼보다 같은 URL을 유지하기 쉽습니다. 손이 가는 부분은 날짜 경로, 아카이브, 그리고 플러그인이 생성한 모든 URL을 재현하는 일입니다.

다음으로 기존 테마와 플러그인이 모든 페이지에 추가하던 것을 확인하세요. canonical 태그, Open Graph 이미지, 구조화된 데이터, 다국어 플러그인의 hreflang 태그, robots 규칙입니다. 새 사이트에서 빠진 것은 전환하는 날 Google이 잃는 신호가 됩니다.

Dardo의 WordPress 마이그레이션 진행 방식

WordPress 이전은 웹사이트 마이그레이션 서비스의 일부로 진행합니다. URL과 콘텐츠 목록 작성, 헤드리스와 완전 이전 중 결정을 거쳐 대표 페이지 하나를 먼저 다시 만들어 합의한 화면 너비에서 검토한 뒤, 나머지 템플릿, 폼, 리디렉션을 진행합니다. 구축 자체는 Astro 기반 웹 개발입니다. 아직 WordPress를 떠날지 고민 중이라면 WordPress와 맞춤형 웹사이트 비교에서 각각 언제 투자 가치가 있는지 다루고, Framer와 Webflow 마이그레이션 가이드에서는 그 밖의 흔한 출발점을 다룹니다.

이전을 고민하고 있다면 사이트와 바꾸고 싶은 점을 보내 주세요. 견적을 드리기 전에 헤드리스와 완전 이전 중 어느 쪽이 맞는지 먼저 말씀드리겠습니다.