Skip to main content

인스턴스에 대한 호스트 이름 구성하기

네트워크를 통해 액세스할 수 있는 호스트 이름을 할당하여 GitHub Enterprise Server 인스턴스에 대한 신뢰할 수 있는 액세스를 제공할 수 있습니다.

GitHub Enterprise Server에 대한 호스트 이름 알아보기

네트워크에서 알려진 이름을 통해 GitHub Enterprise Server 인스턴스에 대한 신뢰할 수 있는 액세스를 제공하기 위해 호스트 이름을 구성할 수 있습니다. 하드 코딩된 IP 주소를 사용하는 대신 호스트 이름을 구성하는 경우, 사용자 또는 클라이언트 소프트웨어에 영향을 주지 않고 GitHub Enterprise Server 인스턴스을(를) 실행하는 물리적 하드웨어를 변경할 수 있습니다.

관리 콘솔의 호스트 이름 설정은 인터넷 또는 내부 네트워크 내에서 확인할 수 있는 적절한 FQDN(정규화된 도메인 이름)으로 설정해야 합니다. 예를 들어 호스트 이름 설정은 github.companyname.com.일 수 있습니다. 웹 및 API 요청은 관리 콘솔에 구성된 호스트 이름으로 자동으로 리디렉션됩니다. localhost는 유효한 호스트 이름 설정이 아닙니다.

호스트 이름의 길이는 도메인 이름 사양 RFC의 섹션 2.3.4에 따라 63자 미만이어야 합니다.

호스트 이름을 구성한 후 하위 도메인 격리를 사용하도록 설정하여 GitHub Enterprise Server 인스턴스의 보안을 더욱 강화할 수 있습니다. 자세한 내용은 하위 도메인 격리 사용을(를) 참조하세요.

GitHub에서는 기존 GitHub Enterprise Server 인스턴스의 호스트 이름을 변경하지 않는 것이 좋습니다. 호스트 이름을 변경하면 인스턴스 중단을 포함하여 예기치 않은 동작이 발생합니다. 대신 원하는 호스트 이름으로 새 인스턴스를 구성한 다음 원래 인스턴스에서 새 인스턴스로 설정 및 데이터를 복원합니다.

지원되는 호스트 이름 형식에 대한 자세한 내용은 HTTP RFC 섹션 2.1을 참조하세요.

호스트 이름 구성하기

  1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

  3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

  4. 설정 사이드바의 호스트 이름을 클릭합니다.

  5. "Hostname"에서 GitHub Enterprise Server 인스턴스에 설정할 호스트 이름을 입력합니다.

  6. 새 호스트 이름에 대한 DNS 및 SSL 설정을 테스트하려면 도메인 설정 테스트를 클릭합니다.

  7. 모든 항목 옆에 녹색 확인 표시가 표시되지 않으면 실패한 설정에 대한 구성을 검토합니다. 자세한 내용은 "DNS 이름 서버 구성"을(를) 참조하세요.

  8. "설정" 사이드바에서 설정 저장을 클릭합니다.

    Note

    관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

  9. 구성 실행이 완료될 때까지 기다립니다.

다양한 교차 사이트 스크립팅 취약성을 완화하려면 호스트 이름을 구성한 후 GitHub Enterprise Server 인스턴스에 대한 하위 도메인 격리를 사용하도록 설정하는 것이 좋습니다. 자세한 내용은 하위 도메인 격리 사용을(를) 참조하세요.

호스트 이름 변경하기

GitHub Enterprise Server 인스턴스의 호스트 이름을 변경해야 하는 경우, 원하는 호스트 이름을 사용하여 기존 인스턴스의 백업을 새 인스턴스로 복원해야 합니다. 자세한 내용은 인스턴스의 호스트 이름 변경을(를) 참조하세요.

Warning

초기 설정 후 GitHub Enterprise Server의 호스트 이름을 변경하지 마세요. 호스트 이름을 변경하면 예기치 못한 동작이 발생합니다. 최악의 경우 인스턴스 중단 및 사용자 보안 키 무효화 등을 포함합니다. 인스턴스의 호스트 이름을 변경했고 문제가 발생한 경우, GitHub Enterprise 지원 또는 GitHub Premium 지원에 문의하십시오.