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

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

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

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub’s plans."

All GitHub Pages builds will use GitHub Actions from June 30, 2024. No other changes are required but GitHub Actions must be enabled in your repository for builds to continue. For more information on enabling GitHub Actions, see "Managing GitHub Actions settings for a repository."

이 문서의 내용

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 및 다른 직속 하위 도메인도 인수되지 않도록 방지됩니다.

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

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

이미 사용 중인 도메인 확인

현재 다른 사용자 또는 조직에서 사용 중인 귀하 소유의 도메인을 확인하여 GitHub Pages 웹 사이트에 사용할 수 있도록 하는 경우, 현재 위치에서 도메인을 릴리스하는 프로세스를 완료하는 데 7일이 걸립니다. 이미 확인된 도메인(다른 사용자 또는 조직에서 확인)을 확인하려는 경우, 릴리스 프로세스가 성공하지 않습니다.

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

  1. 페이지의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 설정 클릭합니다.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

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

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

  4. "어떤 도메인을 추가하시겠습니까?"에서 확인할 도메인을 입력하고 도메인 추가를 선택합니다. 텍스트 상자에 입력된 "example.com"을 GitHub Pages에 확인된 도메인으로 추가하는

    스크린샷 텍스트 아래에는 "도메인 추가"라는 녹색 단추가 있습니다.

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

    확인된 도메인을 보여 주는 GitHub Pages 설정의 스크린샷. 오른쪽의 가로 케밥 아이콘 아래에 "계속 확인" 드롭다운 옵션이 진한 주황색으로 표시됩니다.

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

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

조직 사이트의 도메인 확인

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

  1. GitHub.com의 오른쪽 위에서 프로필 사진을 선택한 다음 내 조직을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "조직"이 진한 주황색으로 표시됩니다.

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

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

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

  5. "어떤 도메인을 추가하시겠습니까?"에서 확인할 도메인을 입력하고 도메인 추가를 선택합니다. 텍스트 상자에 입력된 "example.com"을 GitHub Pages에 확인된 도메인으로 추가하는

    스크린샷 텍스트 아래에는 "도메인 추가"라는 녹색 단추가 있습니다.

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

    확인된 도메인을 보여 주는 GitHub Pages 설정의 스크린샷. 오른쪽의 가로 케밥 아이콘 아래에 "계속 확인" 드롭다운 옵션이 진한 주황색으로 표시됩니다.

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

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