# 도메인을 웹사이트로 연결하기

Source: https://support.kapsulehost.com/ko-kr/custom-domain-for-website

KapsuleHost 웹사이트는 기본적으로 임시 서브도메인에서 접근할 수 있습니다. 자신의 도메인(예: `www.yourdomain.com`)에서 사용 가능하게 하려면 KPanel에 도메인을 추가하고 DNS 레코드를 업데이트해야 합니다.

### 시작하기 전에

- 지정하려는 도메인을 소유하고 있어야 합니다
- 도메인이 다른 곳에 등록되어 있으면 등록기관의 DNS 설정에 접근할 수 있어야 합니다
- 도메인이 KapsuleHost에 등록되어 있으면 DNS가 자동으로 관리됩니다

### KPanel에서 사용자 정의 도메인 추가

1. [kpanel.kapsulehost.com](https://kpanel.kapsulehost.com)에서 KPanel에 로그인합니다
2. **Websites**로 이동하고 구성할 사이트를 선택합니다
3. **Domains** 탭을 엽니다([사이트 도메인 탭](https://support.kapsulehost.com/ko-kr/site-domains-tab) 참조)
4. **Add an external domain** 섹션에서 도메인 이름을 입력합니다(예: `yourdomain.com` 또는 `www.yourdomain.com`)
5. **Add**를 클릭합니다

KPanel에 도메인이 지정해야 하는 IP 주소가 표시됩니다.

### DNS 레코드 업데이트

KPanel에 도메인을 추가한 후 DNS 설정에서 [**A 레코드**](https://support.kapsulehost.com/ko-kr/dns-basics)를 생성합니다:

| Type | Name | Value |
|------|------|-------|
| A | @ | (KPanel의 사이트 IP 주소) |
| A | www | (KPanel의 사이트 IP 주소) |

도메인이 KapsuleHost에 등록되어 있으면 KPanel에 도메인을 추가할 때 자동으로 처리됩니다.

> **Note:** DNS 변경이 전 세계적으로 전파되는 데 최대 48시간이 걸릴 수 있지만, 대부분의 업데이트는 몇 시간 내에 확인됩니다.

### SSL 인증서

DNS가 전파되면 KPanel은 도메인에 대한 무료 SSL 인증서를 자동으로 발급합니다. 사이트는 `http://` 및 `https://`에서 모두 접근할 수 있으며, HTTP는 자동으로 HTTPS로 리디렉션됩니다.

자세한 내용은 [SSL 인증서](https://support.kapsulehost.com/ko-kr/ssl-certificates)를 참조합니다.

### 서브도메인 지정

`shop.yourdomain.com`와 같은 서브도메인을 사용하려면:

1. 위에서 설명한 대로 **Domains** 탭에서 서브도메인을 추가합니다
2. DNS 설정에서 호스트로 서브도메인 이름을 사용하여 A 레코드를 생성합니다

> **Tip:** 다른 곳에서 호스팅하는 서브도메인을 사용하려면(예: `mail.yourdomain.com`을 Google Workspace로 지정), 대신 CNAME 레코드를 사용합니다. [CNAME 레코드 설정](https://support.kapsulehost.com/ko-kr/cname-records)을 참조합니다.

### 문제 해결

**도메인이 내 사이트로 확인되지 않습니다.**
A 레코드가 KPanel에 표시된 올바른 IP 주소를 지정하고 있는지 확인합니다. [dnschecker.org](https://dnschecker.org)와 같은 도구를 사용하여 전파를 확인합니다.

**SSL 오류가 발생합니다.**
SSL 프로비저닝을 위해서는 도메인이 먼저 KapsuleHost의 서버를 지정하고 있어야 합니다. DNS가 완전히 전파될 때까지 기다리면 KPanel이 인증서를 자동으로 발급합니다.