Skip to main content

사용자 지정 도메인 및 GitHub Pages 정보

GitHub Pages는 사용자 지정 도메인을 사용하거나 사이트 URL의 루트를 기본값(예: octocat.github.io)에서 사용자가 소유한 도메인으로 변경할 수 있도록 지원합니다.

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

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에 대한 사용자 지정 도메인 확인"을(를) 참조하세요.

GitHub Pages는 하위 도메인과 apex 도메인이라는 두 가지 유형의 도메인에서 작동합니다. 지원되지 않는 사용자 지정 도메인 목록은 "사용자 지정 도메인 및 GitHub Pages 문제 해결"을(를) 참조하세요.

지원되는 사용자 지정 도메인 유형예시
www 하위 도메인www.example.com
사용자 지정 하위 도메인blog.example.com
Apex 도메인example.com

사이트에 대한 apex 및 www 하위 도메인 구성 중 하나 또는 둘 다를 설정할 수 있습니다. apex 도메인에 대한 자세한 내용은 “GitHub Pages 사이트에 apex 도메인 사용”을 참조하세요.

apex 도메인을 사용하는 경우에도 항상 www 하위 도메인을 사용하는 것이 좋습니다. apex 도메인을 사용하여 새 사이트를 만드는 동안 사이트의 콘텐츠를 제공할 때 사용할 www 하위 도메인의 보안을 자동으로 시도하지만 www 하위 도메인을 사용하려면 DNS를 변경해야 합니다. www 하위 도메인을 구성하는 경우 연결된 apex 도메인의 보안을 자동으로 시도합니다. 자세한 내용은 "GitHub Pages 사이트의 사용자 지정 도메인 관리"을(를) 참조하세요.

여러 리포지토리에서 사용자 지정 도메인 사용

사용자 또는 조직 사이트에 대해 사용자 지정 도메인을 설정하면 기본적으로 동일한 계정이 소유한 모든 프로젝트 사이트에 동일한 사용자 지정 도메인이 사용됩니다. 사이트 유형에 대한 자세한 내용은 GitHub Pages 정보 항목을 참조하세요.

예를 들어 사용자 사이트에 대한 사용자 지정 도메인이 www.octocat.com이고 octo-project라는 리포지토리에서 게시된 사용자 지정 도메인이 구성되지 않은 프로젝트가 있는 경우 www.octocat.com/octo-project에서 해당 리포지토리에 대한 GitHub Pages 사이트를 사용할 수 있습니다.

개별 리포지토리에 사용자 지정 도메인 추가하여 기본 사용자 지정 도메인을 재정의할 수 있습니다.

참고: 비공개로 게시된 프로젝트 사이트의 URL은 사용자 또는 조직 사이트에 대한 사용자 지정 도메인의 영향을 받지 않습니다. 비공개로 게시된 사이트에 대한 자세한 내용은 GitHub Enterprise Cloud 설명서의 "GitHub Pages 사이트의 표시 여부 변경"을(를) 참고하세요.

기본 사용자 지정 도메인 제거하려면 사용자 또는 조직 사이트에서 사용자 지정 도메인을 제거해야 합니다.

GitHub Pages 사이트에 하위 도메인 사용

하위 도메인은 URL에서 루트 도메인 이전 부분입니다. 하위 도메인을 www 또는 blog.example.com와 같이 사이트의 고유한 섹션으로 구성할 수 있습니다.

하위 도메인은 DNS 공급자를 통해 CNAME 레코드로 구성됩니다. 자세한 내용은 "GitHub Pages 사이트의 사용자 지정 도메인 관리"을(를) 참조하세요.

www 하위 도메인

www 하위 도메인은 가장 일반적으로 사용되는 하위 도메인 유형입니다. 예를 들어 www.example.com에는 www 하위 도메인이 포함됩니다.

www 하위 도메인은 GitHub의 서버 IP 주소 변경의 영향을 받지 않으므로 www 하위 도메인은 가장 안정적인 유형의 사용자 지정 도메인입니다.

사용자 지정 하위 도메인

사용자 지정 하위 도메인은 표준 www 변형을 사용하지 않는 하위 도메인 유형입니다. 사용자 지정 하위 도메인은 사이트에서 두 개의 개별 섹션을 원하는 경우에 주로 사용됩니다. 예를 들어 호출된 blog.example.com 사이트를 만들고 해당 섹션을 www.example.com과 별도로 사용자 지정할 수 있습니다.

GitHub Pages 사이트에 apex 도메인 사용

apex 도메인은 example.com과 같은 하위 도메인을 포함하지 않는 사용자 지정 도메인입니다. apex 도메인은 베이스, bare, naked, 루트 apex 또는 영역 apex 도메인이라고도 합니다.

apex 도메인은 DNS 공급자를 통해 A, ALIAS, 또는 ANAME 레코드로 구성됩니다. 자세한 내용은 "GitHub Pages 사이트의 사용자 지정 도메인 관리"을(를) 참조하세요.

apex 도메인을 사용자 지정 도메인으로 사용하는 경우 www 하위 도메인도 설정하는 것이 좋습니다. DNS 공급자를 통해 각 도메인 유형에 대해 올바른 레코드를 구성하는 경우 GitHub Pages는 도메인 간에 리디렉션을 자동으로 만듭니다. 예를 들어 www.example.com을 사이트의 사용자 지정 도메인으로 구성하고 apex 및 www 도메인에 대해 설정된 GitHub Pages DNS 레코드가 있는 경우 example.comwww.example.com으로 리디렉션됩니다. 자동 리디렉션은 www 하위 도메인에만 적용됩니다. 자동 리디렉션은 다른 하위 도메인(예: blog)에 적용되지 않습니다. 자세한 내용은 "GitHub Pages 사이트의 사용자 지정 도메인 관리"을(를) 참조하세요.

GitHub Pages 사이트의 사용자 지정 도메인 보호

GitHub Pages 사이트가 비활성화되었지만 사용자 지정 도메인이 설정된 경우 도메인이 인수될 위험이 있습니다. 사이트가 비활성화된 동안 DNS 공급자를 사용하여 사용자 지정 도메인을 구성하면 다른 사용자가 하위 도메인 중 하나에서 사이트를 호스팅할 수 있습니다.

사용자 지정 도메인을 확인하면 다른 GitHub 사용자가 해당 리포지토리와 함께 도메인을 사용할 수 없습니다. 도메인이 확인되지 않고 GitHub Pages 사이트가 비활성화된 경우 DNS 공급자를 사용하여 DNS 레코드를 즉시 업데이트하거나 제거해야 합니다. 자세한 내용은 "GitHub Pages에 대한 사용자 지정 도메인 확인" 및 "GitHub Pages 사이트의 사용자 지정 도메인 관리"을(를) 참조하세요.

사이트가 자동으로 비활성화될 수 있는 몇 가지 이유가 있습니다.

  • GitHub Pro에서 GitHub Free로 다운그레이드하는 경우 현재 계정의 프라이빗 리포지토리에서 게시된 GitHub Pages 사이트는 게시되지 않습니다. 자세한 내용은 "계정 플랜 다운그레이드"을(를) 참조하세요.
  • 프라이빗 리포지토리를 GitHub Free를 사용하는 개인 계정으로 전송하는 경우 리포지토리는 GitHub Pages 기능에 대한 액세스 권한을 잃게 되며 현재 게시된 GitHub Pages 사이트는 게시되지 않습니다. 자세한 정보는 "리포지토리 전송" 항목을 참조하세요.

추가 참고 자료