.kr 도메인 Cloudflare Pages에 완벽 연결 가이드 (가비아 예시)

Cloudflare Pages는 정적 웹사이트를 무료로, 그리고 매우 빠르게 호스팅할 수 있는 훌륭한 서비스입니다. 하지만 가비아(Gabia)와 같은 국내 업체에서 구매한 .kr 도메인을 연결하는 과정은 처음 해보는 분들께 다소 헷갈릴 수 있습니다.

오늘은 그 전체 과정을 누구나 따라 할 수 있도록 A부터 Z까지 상세하게 안내해 드리겠습니다.

전체 프로세스 요약

1. Cloudflare 가입 및 사이트 추가: 내 .kr 도메인을 Cloudflare에 등록합니다.
2. 네임서버 변경 (가비아 -> Cloudflare): 내 도메인의 관리 주체를 가비아에서 Cloudflare로 위임합니다.
3. Cloudflare Pages 프로젝트 생성 및 도메인 연결: Cloudflare Pages에 내 웹사이트 프로젝트를 만들고, 2단계에서 추가한 .kr 도메인을 연결(CNAME 레코드 설정)합니다.

1단계: Cloudflare에 내 도메인 등록하기

가장 먼저 할 일은 Cloudflare에 여러분의 .kr 도메인을 알려주는 것입니다.

1. Cloudflare에 로그인한 후, 메인 대시보드에서 ‘Add a Site’ 버튼을 클릭합니다.
2. 여러분의 .kr 도메인 주소(예: example.co.kr)를 입력합니다.
3. 요금제는 ‘Free’ 플랜을 선택하고 계속 진행합니다.
4. Cloudflare가 기존 DNS 레코드를 스캔할 텐데, 일단 무시하고 **‘Continue’**를 누릅니다.

이 단계를 마치면, Cloudflare는 여러분에게 2개의 ‘Cloudflare Nameservers’ 주소를 알려줄 것입니다. (예: dina.ns.cloudflare.com, pablo.ns.cloudflare.com) 이 주소들을 잘 복사해두세요. 다음 단계에서 사용됩니다.

2단계: 가비아에서 네임서버 변경하기

이제 도메인을 구매한 가비아로 이동하여, “이 도메인의 실질적인 관리는 이제부터 Cloudflare가 할 것입니다”라고 알려주는 작업을 해야 합니다.

1. 가비아에 로그인 후 **‘My 가비아’**로 들어갑니다.
2. 관리할 도메인 우측의 ‘관리’ 버튼을 클릭합니다.
3. ‘네임서버 설정’ 메뉴로 이동합니다.
4. 기존에 설정된 가비아 네임서버 정보를 삭제하고, 1단계에서 Cloudflare가 알려준 2개의 네임서버 주소를 1차, 2차에 각각 입력하고 저장합니다.

주의: 네임서버 변경 사항이 전 세계 인터넷에 전파되기까지는 몇 분에서 최대 48시간까지 소요될 수 있습니다. 보통은 1시간 내외로 완료됩니다. Cloudflare 대시보드에서 ‘Re-check nameservers’ 버튼을 눌러 상태를 확인할 수 있습니다.

3단계: Cloudflare Pages에 프로젝트 연결하기

네임서버가 성공적으로 변경되었다면, 이제 실질적인 웹사이트 연결 작업입니다.

1. Cloudflare 대시보드 좌측 메뉴에서 **‘Workers & Pages’**를 선택합니다.
2. ‘Create application’ > ‘Pages’ 탭 > **‘Connect to Git’**을 선택하여 여러분의 웹사이트 코드가 있는 GitHub (또는 GitLab) 레포지토리를 연결합니다.
3. 빌드 설정을 진행합니다. (Astro, Next.js 등 사용하는 프레임워크를 선택하면 기본 설정이 자동으로 채워집니다.)
4. **‘Save and Deploy’**를 눌러 첫 배포를 시작합니다.

첫 배포가 완료되면 xxxx.pages.dev 형태의 임시 도메인이 생성됩니다. 이제 이 프로젝트에 우리가 구매한 .kr 도메인을 연결할 차례입니다.

5. 방금 만든 Pages 프로젝트로 들어가 ‘Custom domains’ 탭을 클릭합니다.
6. ‘Set up a domain’ 버튼을 누르고, 연결할 .kr 도메인 주소를 입력합니다.

이 과정을 마치면, Cloudflare Pages는 자동으로 해당 도메인에 대한 CNAME 레코드를 여러분의 Cloudflare DNS 설정에 추가해줍니다. (예: example.co.kr은 xxxx.pages.dev를 가리킴)

흔히 겪는 문제와 해결 (Troubleshooting)

• “Error 1014: CNAME Cross-User Banned”: 이 오류는 해당 도메인이 다른 Cloudflare 계정에 이미 등록되어 있을 때 발생합니다. 예전에 다른 계정으로 해당 도메인을 추가한 적이 없는지 확인하고, 있다면 해당 계정에서 도메인을 먼저 삭제해야 합니다.
• SSL/TLS 인증서 문제 (SSL_ERROR_NO_CYPHER_OVERLAP): 네임서버 변경 직후에 자주 발생할 수 있습니다. Cloudflare의 SSL/TLS 설정이 완전히 활성화될 때까지 시간이 필요하기 때문입니다. SSL/TLS 암호화 모드가 ‘Full’ 또는 ‘Full (Strict)‘로 설정되어 있는지 확인하고, 잠시 기다리면 대부분 해결됩니다.
• 변경 사항이 반영되지 않아요: 브라우저 캐시나 로컬 DNS 캐시 문제일 수 있습니다. 시크릿 모드로 접속해보거나, ipconfig /flushdns (Windows) 명령어로 DNS 캐시를 초기화해보세요.

마치며

.kr 도메인을 Cloudflare Pages에 연결하는 과정은 네임서버와 DNS 레코드의 개념만 명확히 이해하면 결코 어렵지 않습니다. 이 가이드를 통해 여러분의 소중한 도메인으로 더 빠르고 안정적인 웹사이트를 운영하실 수 있기를 바랍니다.

#Cloudflare #도메인연결 #웹호스팅 #kr도메인 #개발가이드