웹사이트 사용자 지정 도메인 설정

사용자 지정 도메인을 사용하는 능력은 브랜드 구축 및 웹사이트의 전문적인 온라인 입지를 만드는 데 매우 중요합니다. 각 정적 사이트 호스팅 플랫폼은 특정 구성 방법을 가지고 있습니다. 이 문서는 GitHub Pages를 예시로 사용하여 사용자 지정 도메인을 설정하는 방법에 대한 기본 개요를 제공합니다. 자세한 내용은 공식 GitHub Pages 문서를 참조하십시오: https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site.

개요

이 가이드에서는 다음 방법을 설명합니다:

• GitHub Pages를 사용하여 사용자 지정 도메인 구성
• 도메인 등록 기관에서 DNS 레코드 설정

구성 단계 (GitHub Pages 예시)

1단계: 도메인 제공자에서 DNS 레코드 구성

사용자 지정 도메인을 GitHub Pages로 연결하려면 도메인 제공자에서 다음 DNS 레코드를 구성해야 합니다:

1. A 레코드: 루트 도메인(예: yourdomain.org)을 GitHub Pages 서버의 IP 주소로 연결합니다. IP 주소는 다음과 같습니다:
   • 185.199.108.153
   • 185.199.109.153
   • 185.199.110.153
   • 185.199.111.153
2. CNAME 레코드: www 서브도메인(예: www.yourdomain.org)을 GitHub Pages 도메인(예: yourusername.github.io)으로 연결합니다.

2단계: GitHub Pages에서 사용자 지정 도메인 설정

1. 저장소 설정으로 이동: 웹사이트 코드가 호스팅된 GitHub 저장소로 이동합니다.
2. GitHub Pages 설정 열기: "Settings"를 클릭한 다음 사이드바에서 "Pages" 섹션으로 이동합니다.
3. 사용자 지정 도메인 입력: "Custom domain" 섹션에 원하는 사용자 지정 도메인 이름(예: www.yourdomain.org)을 입력합니다.
4. 저장 및 확인: "Save"를 클릭합니다. GitHub Pages가 사용자 지정 도메인 설정을 확인하려고 시도합니다.

3단계: HTTPS 활성화 (권장)

GitHub Pages 설정에서 "Enforce HTTPS" 옵션을 선택하여 웹사이트에서 암호화를 활성화합니다. 이는 보안 및 일부 기능의 원활한 작동에 필수적입니다.

4단계: BASE URL 변경

• 테마 구성: 테마에 따라 페이지 리소스가 올바르게 로드되지 않는 경우를 비롯하여 웹사이트가 사용자 지정 도메인에서 제대로 작동하도록 하려면 BASE URL 또는 유사한 설정을 구성해야 할 수 있습니다.
• 설정 찾기: 이 설정의 정확한 위치는 테마 또는 SSG 프레임워크에 따라 다릅니다.
  • vitepress 테마를 사용하는 경우, 구성은 일반적으로 config.mts 파일에 있으며, base: '/'와 같은 설정을 찾습니다.
  • hugo 테마를 사용하는 경우, 구성은 일반적으로 config.toml 파일에 있으며, baseURL = "your-domain.org"와 같은 설정을 찾습니다.
  • jekyll 테마를 사용하는 경우, 구성은 일반적으로 _config.yml 파일에 있으며, baseurl: ""와 같은 설정을 찾습니다.
• 기본 Base URL 설정: 테마에 BASE URL 또는 유사한 설정에 대한 전용 설정이 없는 경우, 충돌을 피하기 위해 BASE_URL = '/', baseurl: "" 또는 base: '/'와 같은 형식으로 변경해야 합니다.
• VitePress 예시

  import { defineConfig } from 'vitepress';
  
  export default defineConfig({
    base: '/'
  })

중요 고려 사항

• 전파 시간: DNS 변경 사항이 인터넷 전체에 전파되는 데 시간이 걸릴 수 있습니다. 변경 사항이 적용되는 데 몇 분 또는 몇 시간이 걸릴 수 있습니다.
• 특정 요구 사항: 플랫폼마다 요구 사항과 UI 레이아웃이 다르므로 항상 해당 특정 문서를 확인하십시오.
• 도메인 제공자: 이러한 레코드를 생성하거나 변경하려면 도메인 제공자의 DNS 설정에 액세스해야 합니다.
• VpAdmin 설정: 도메인 등록 기관에서 DNS 설정을 구성한 후에는 VpAdmin의 "사이트 구성"에서 동일한 도메인을 설정해야 합니다.

결론

이러한 단계를 따르면 GitHub Pages에서 호스팅되는 웹사이트에 대한 사용자 지정 도메인을 성공적으로 구성할 수 있습니다. 특히 다른 플랫폼을 사용하는 경우 더 자세한 지침은 호스팅 플랫폼의 공식 문서를 참조하십시오.