Skip to main content

사용자 지정 도메인 및 GitHub 페이지 정보

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

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

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

지원되는 사용자 지정 도메인

사용자 지정 도메인을 리포지토리에 추가하기 전에 확인하는 것이 좋습니다. 이렇게 해야 보안을 개선하고 탈취 공격을 피할 수 있습니다. 자세한 내용은 GitHub Pages에 대한 사용자 지정 도메인 확인을(를) 참조하세요.

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

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

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

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

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

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

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

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

참고 항목

프라이빗으로 게시된 프로젝트 사이트의 URL은 사용자 또는 조직 사이트에 대한 사용자 지정 도메인의 영향을 받지 않습니다. 비공개로 게시된 사이트에 대한 자세한 내용은 AUTOTITLE을(를) 참고하세요.

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

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

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

하위 도메인은 DNS 공급자를 통해 레코드로 구성됩니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.

하위 도메인

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

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

사용자 지정 하위 도메인

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

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

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

apex 도메인은 DNS 공급자를 통해 , , 또는 레코드로 구성됩니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.

apex 도메인을 사용자 지정 도메인으로 사용하는 경우 www 하위 도메인도 설정하는 것이 좋습니다. DNS 공급자를 통해 각 도메인 유형에 대해 올바른 레코드를 구성하는 경우 GitHub Pages는 도메인 간에 리디렉션을 자동으로 만듭니다. 예를 들어 www.example.com을 사이트의 사용자 지정 도메인으로 구성하고 apex 및 www 도메인에 대해 설정된 GitHub Pages DNS 레코드가 있는 경우 example.comwww.example.com으로 리디렉션됩니다. 대신 example.com을 사용자 지정 도메인으로 구성하면 www.example.comexample.com으로 리디렉션됩니다. 자동 리디렉션은 다른 하위 도메인에도 적용됩니다. 예를 들어 www.blog.example.comblog.example.com으로 리디렉션되고 그 반대의 경우도 마찬가지입니다. www.www.로 시작하는 도메인을 구성할 수 없습니다. 자세한 내용은 AUTOTITLE을 참조하세요.

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

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

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

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

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

추가 참고 자료

  • AUTOTITLE