GitHub Pages에 대한 사용자 지정 도메인 확인

도메인을 확인하여 사용자 지정 도메인의 보안을 강화하고 인수 공격을 방지할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

GitHub Pages은(는) 조직의 GitHub Free 및 GitHub Free이(가) 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud 및 GitHub Enterprise Server의 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다. 자세한 내용은 GitHub의 플랜을(를) 참조하세요.

GitHub Pages은(는) 이제 GitHub Actions을(를) 사용하여 Jekyll 빌드를 실행합니다. 빌드의 원본으로 분기를 사용하는 경우 기본 제공 Jekyll 워크플로를 사용하려면 리포지토리에서 GitHub Actions을(를) 사용하도록 설정해야 합니다. 또는 GitHub Actions을(를) 사용할 수 없거나 사용하지 않도록 설정한 경우 원본 분기의 루트에 .nojekyll 파일을 추가하면 Jekyll 빌드 프로세스를 무시하고 콘텐츠를 직접 배포합니다. GitHub Actions 사용에 대한 자세한 내용은 리포지토리에 대한 GitHub Actions 설정 관리을(를) 참조하세요.

이 문서의 내용

GitHub Pages에 대한 도메인 확인 정보

개인 계정의 Custom Domain을 확인하는 경우에는 확인된 Custom Domain 또는 도메인의 직접 하위 도메인에 GitHub Pages 사이트를 게시하는 데 개인 계정이 소유한 리포지토리만 사용할 수 있습니다. 조직의 Custom Domain을 확인하는 경우에는 확인된 Custom Domain 또는 도메인의 직접 하위 도메인에 GitHub Pages 사이트를 게시하는 데 조직이 소유한 리포지토리만 사용할 수 있습니다.

도메인을 확인하면 다른 GitHub 사용자가 여러분의 사용자 지정 도메인을 인수하여 자체 GitHub Pages 사이트를 게시하는 데 사용할 수 없습니다. 리포지토리를 삭제하는 경우, 청구 플랜이 다운그레이드된 경우 또는 도메인이 GitHub Pages에 대해 구성된 상태로 유지되고 확인되지 않은 상태일 때 사용자 지정 도메인의 연결을 해제하거나 GitHub Pages를 사용하지 않도록 설정하는 기타 모든 변경이 발생한 후 도메인 인수가 발생할 수 있습니다.

도메인을 확인하면 직속 하위 도메인도 확인에 포함됩니다. 예를 들어 github.com 사용자 지정 도메인이 확인되면 docs.github.com, support.github.com 및 다른 직속 하위 도메인도 인수되지 않도록 방지됩니다.

Warning

*.example.com과 같은 와일드카드 DNS 레코드를 사용하지 않는 것이 좋습니다. 이러한 레코드는 도메인을 확인하더라도 즉각적인 도메인 인수 위험에 처하게 됩니다. 예를 들어 example.com을 확인하면 다른 사용자는 a.example.com를 사용할 수 없지만 여전히 b.a.example.com을 인수할 수 있습니다(와일드카드 DNS 레코드가 적용됨). 자세한 내용은 GitHub Pages에 대한 사용자 지정 도메인 확인을(를) 참조하세요.

조직에 대한 도메인을 확인할 수도 있는데, 그러면 조직 프로필. 자세한 내용은 조직의 도메인 확인 또는 승인.

이미 사용 중인 도메인 확인

현재 다른 사용자 또는 조직에서 사용 중인 소유 도메인을 GitHub Pages 웹사이트에 사용할 수 있도록 하기 위해 확인 중일 수 있습니다. 이 경우 도메인은 다른 사용자 또는 조직이 소유한 GitHub Pages 웹 사이트에서 즉시 해제됩니다. 이미 확인된 도메인(다른 사용자 또는 조직에서 확인)을 확인하려는 경우, 릴리스 프로세스가 성공하지 않습니다.

사용자 사이트에 대한 도메인 확인

Note

아래에 설명된 옵션이 표시되지 않으면 리포지토리 설정이 아닌 프로필 설정에 있는지 확인합니다. 도메인 확인은 프로필 수준에서 수행됩니다.

  1. GitHub의 페이지 오른쪽 상단에서 프로필 사진을 선택한 다음, 설정을 선택합니다.

  2. 사이드바의 “코드, 계획 및 자동화” 섹션에서 페이지를 클릭합니다.

  3. 오른쪽에서 도메인 추가를 클릭합니다.

  4. "어떤 도메인을 추가하시겠습니까?"에서 확인할 도메인을 입력하고 도메인 추가를 선택합니다.

    GitHub Pages 사이트에 대해 확인된 도메인을 추가하는 필드의 스크린샷 녹색 "Add domain" 단추가 필드 아래에 표시됩니다.

  5. "DNS TXT 레코드 추가"의 지침에 따라 도메인 호스팅 서비스와 관련된 TXT 레코드를 만듭니다. example.com DNS 구성에 TXT 레코드를 추가하는 GitHub Pages 지침의

    스크린샷.

  6. DNS 구성이 변경될 때까지 기다리세요. 즉시 변경되거나 최대 24시간이 걸릴 수 있습니다. 명령줄에서 dig 명령을 실행하여 DNS 구성의 변경 내용을 확인할 수 있습니다. 아래 명령에서 USERNAME은 사용자 이름으로, example.com은 확인 중인 도메인으로 바꿉니다. DNS 구성이 업데이트된 경우 출력에 새 TXT 레코드가 표시됩니다.

    dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT

  7. DNS 구성이 업데이트되었는지 확인한 후 도메인을 확인할 수 있습니다. 변경이 즉시 실행되지 않고 이전 페이지에서 벗어난 경우 처음 몇 단계를 수행하여 페이지 설정으로 돌아간 후 도메인 오른쪽에 있는 을 클릭한 다음, 확인 계속을 클릭합니다.

    "확인된 도메인" 설정의 스크린샷 오른쪽의 가로 Kebab 아이콘 아래에 "Continue verifying" 옵션이 주황색 윤곽선으로 표시됩니다.

  8. 도메인을 확인하려면 확인을 클릭합니다.

  9. 사용자 지정 도메인이 확인된 상태로 유지하려면 도메인의 DNS 구성에 TXT 레코드를 유지합니다.

조직 사이트의 도메인 확인

조직 소유자는 조직의 사용자 지정 도메인을 확인할 수 있습니다.

Note

아래에 설명된 옵션이 표시되지 않으면 조직 설정에 있는지 확인합니다. 도메인 확인은 리포지토리 설정에서 수행되지 않습니다.

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택한 다음, Your organizations를 클릭합니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 사이드바의 “코드, 계획 및 자동화” 섹션에서 페이지를 클릭합니다.

  4. 오른쪽에서 도메인 추가를 클릭합니다.

  5. "어떤 도메인을 추가하시겠습니까?"에서 확인할 도메인을 입력하고 도메인 추가를 선택합니다.

    GitHub Pages 사이트에 대해 확인된 도메인을 추가하는 필드의 스크린샷 녹색 "Add domain" 단추가 필드 아래에 표시됩니다.

  6. "DNS TXT 레코드 추가"의 지침에 따라 도메인 호스팅 서비스와 관련된 TXT 레코드를 만듭니다. example.com DNS 구성에 TXT 레코드를 추가하는 GitHub Pages 지침의

    스크린샷.

  7. DNS 구성이 변경될 때까지 기다립니다. 즉시 변경되거나 최대 24시간이 걸릴 수 있습니다. 명령줄에서 dig 명령을 실행하여 DNS 구성의 변경 내용을 확인할 수 있습니다. 아래 명령에서 ORGANIZATION은 조직의 이름으로, example.com은 확인 중인 도메인으로 바꿉니다. DNS 구성이 업데이트된 경우 출력에 새 TXT 레코드가 표시됩니다.

    dig _github-pages-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT

  8. DNS 구성이 업데이트되었는지 확인한 후 도메인을 확인할 수 있습니다. 변경이 즉시 실행되지 않고 이전 페이지에서 벗어난 경우 처음 몇 단계를 수행하여 페이지 설정으로 돌아간 후 도메인 오른쪽에 있는 을 클릭한 다음, 확인 계속을 클릭합니다.

    "확인된 도메인" 설정의 스크린샷 오른쪽의 가로 Kebab 아이콘 아래에 "Continue verifying" 옵션이 주황색 윤곽선으로 표시됩니다.

  9. 도메인을 확인하려면 확인을 클릭합니다.

  10. 사용자 지정 도메인이 확인된 상태로 유지하려면 도메인의 DNS 구성에 TXT 레코드를 유지합니다.