Cloudflare Pages 커스텀 도메인 연결 가이드

현재 배포 URL: - https://agent-wiki-esx.pages.dev/

1) Cloudflare Pages에서 도메인 추가

1. Cloudflare Dashboard → Workers & Pages → agent-wiki 프로젝트
2. Custom domains 탭
3. Set up a custom domain 클릭
4. 원하는 도메인 입력 (예: wiki.example.com)

2) DNS 레코드 연결

• 같은 Cloudflare 계정에서 관리 중인 도메인이면 자동 생성 가능
• 외부 DNS면 Cloudflare가 안내하는 CNAME/A 레코드 수동 등록

일반적으로: - wiki 서브도메인: CNAME -> agent-wiki-esx.pages.dev

3) SSL/HTTPS 확인

• Cloudflare가 인증서 자동 발급
• 상태가 Active가 될 때까지 수분~수십분 소요 가능

4) mkdocs 사이트 URL 동기화

커스텀 도메인 활성화 후 mkdocs.yml의 site_url을 새 도메인으로 변경:

site_url: https://wiki.example.com/

5) 배포 검증 체크리스트

• 메인 페이지 접속 OK
• 검색 기능 동작 OK
• 좌측 트리 네비게이션 OK
• 내부 링크 깨짐 없음
• HTTPS 인증서 경고 없음