정적 구현 guide
원본 간 Canonical URL 관리
게이트웨이와 원본에서 같은 응답이 제공될 때 메타데이터, 내부 링크, sitemap이 하나의 안정적인 공개 URL을 가리키게 합니다.
최종 수정일 2026-08-22
하나의 공개 정체성 선택하기
Rewrite된 페이지는 public gateway와 production origin 양쪽에서 접근될 수 있습니다. 내용은 같아도 hostname은 다릅니다. Canonical link는 검색 시스템에 어떤 주소가 지속적인 공개 정체성인지 알려줍니다. 이 구조에서는 origin HTML을 직접 열더라도 항상 gateway domain을 canonical로 사용합니다.
Canonical은 absolute URL이어야 하고 production에서는 HTTPS를 사용하며 정확한 guide slug를 포함해야 합니다. Preview deployment hostname이나 local 주소를 상속하면 안 됩니다. Site URL을 필수 build 설정으로 취급하면 잘못된 metadata를 조용히 배포하는 대신 명확하게 build를 실패시킬 수 있습니다.
Discovery signal 동기화
Canonical tag는 나머지 site 정보가 동의할 때 가장 잘 작동합니다. Gateway home은 같은 guide path에 링크해야 하고 sitemap도 동일한 URL 집합을 포함해야 합니다. Origin에서 rendering된 관련 guide 링크 역시 public prefix를 사용하여 rewrite 후에도 gateway에 머물러야 합니다.
콘텐츠 변경 후 전체 집합을 자동으로 검증합니다. Slug를 삭제하면 sitemap 항목과 모든 related reference도 함께 삭제해야 합니다. Domain을 변경하면 robots, sitemap, Open Graph URL과 canonical이 함께 이동하도록 두 프로젝트를 다시 build합니다.